SIGNL4 bietet eine komfortable Dienst- und Bereitschafts-Planung, um Alarme zur richtigen Zeit an die verantwortlichen Personen weiterzuleiten.
In einigen Fällen verwenden Kunden andere Tools als führendes System für die Dienst-Planung, zum Beispiel SAP, Excel, usw. Hier beschreiben wir, wie Sie Dienst-Pläne aus CSV-Dateien importieren können. Wenn Sie andere Tools oder andere Formate verwenden, können Sie Ihre Dienstpläne zunächst in eine entsprechende CSV-Datei exportieren und von dort aus fortfahren.
Verwendung und Beispiel-Code
Achtung! Dieser Code ist als Beispiel gedacht und bisher nur wenige getestet. Die Verwendung erfolgt ohne Garantie. Bitte verwenden Sie das Skript mit Vorsicht.
Achtung! Bestehende Dienstpläne werden überschrieben.
Wir stellen ein Beispiel-Node.js-Skript zum Importieren von Dienst-Plänen aus einer CSV-Datei zur Verfügung. Die Beispieldatei verwendet die SIGNL4 REST API wie hier dokumentiert: https://connect.signl4.com/api/docs/index.html
Sie finden das Import-Skript sowie weitere Informationen auf GitHub.
Voraussetzung ist Node.js, was sie von hier herunterladen und installieren können.
Der Beispiel-Code ist in der Datei „schedule-import.js“ enthalten. Sie können die Datei mit dem Befehl „node“ ausführen. Die Datei nimmt den Pfad zur CSV-Datei als Argument.
Kommando-Zeilen-Beispiel:
node schedule-import.js C:\schedule.csv
In der Quell-Datei müssen Sie den SIGNL4-API-Schlüssel und den Team-Namen anpassen:
const strAPIKey = 'YOUR-SIGNL4-API-KEY';
const strTeamName = 'Super SIGNL4';
Sie können den API-Schlüssel in Ihrem SIGNL4-Webportal unter Teams -> Developer erstellen.
Der Kommando-Zeilen-Aufruf gibt das Resultat (Erfolg oder Fehler) vom REST API zurück.
CSV-Datei
Die CSV-Datei hat das folgende Format.
Email,Start,End
Email: Die E-Mail-Adresse des Nutzers. Wird hier ‚DELETE‘ verwendet, werden alle Dienst-Pläne im angegebenen Zeitraum gelöscht.
Start: Begin des Dienst-Plans.
End: Ende des Dienst-Plans.
Achtung! Alle Zeiten sind UTC Zeiten.
Beispiel, um die Dienst-Pläne für zwei Nutzer anzulegen:
Email,Start,End
[email protected],2024-02-01T13:00:00.000Z,2024-02-01T14:00:00.000Z
[email protected],2024-02-01T13:00:00.000Z,2024-02-01T14:00:00.000Z
Beispiel, um alle Dienst-Pläne innerhalb eines zeitlichen Bereichs zu löschen:
Email,Start,End
DELETE,2024-02-01T13:00:00.000Z,2024-02-01T14:00:00.000Z