Standard Setup für windows-basierte Systeme:
Im Folgenden stellen wir ein Upload Skript, sowie eine Erklärung zum Scheduling desselben zur Verfügung. Stellen Sie sicher, dass zum Ausführen die nötigen Voraussetzungen Ihres Systems erfüllt sind.
Schritt 1: Voraussetzungen
Bitte installieren Sie die folgenden in der Tabelle aufgeführten Programme und fügen Sie diese entsprechend zu Ihrem System-PATH hinzu. Eine ausführliche Beschreibung zu diesem Prozess finden Sie weiter unten
Hinzufügen von Systemumgebungsvariablen zum PATH
In dieser Anleitung führen wir Sie durch den Prozess, ein benutzerdefiniertes Verzeichnis zur PATH-Umgebungsvariable des Systems hinzuzufügen. Wir beschreiben die Vorgehensweise für das Programm Azcopy, welches wir unserem PATH hinzufügen wollen.
Der PATH ist eine wichtige Umgebungsvariable und enthält eine Liste von Ordnern / Verzeichnissen, in denen das System nach ausführbaren Programmen sucht. Damit ein beliebiges Programm über den Terminal ausgeführt werden kann, muss die ausführbare Datei in einem der im PATH gelisteten Ordner abgelegt sein.
Überprüfen Sie: Wird das Programm bereits im Terminal erkannt:
where azcopy
Ist dies nicht der Fall wird folgende Information angezeigt:
INFORMATION: Es konnten keine Dateien mit dem angegebenen Muster gefunden werden
Identifizieren des Verzeichnisses: Bestimmen Sie den Pfad zum Verzeichnis in dem die Ausführungsdatei enthalten ist und kopieren Sie diesen.
Beispiel: C:\tacto\azcopy_download_folder
Öffnen Sie dann die Systemeigenschaften: Geben Sie im Suchfeld neben „Start” auf der Taskleiste "Systemumgebungsvariablen bearbeiten" ein. Wählen Sie das Programm aus der Ergebnisliste aus.
Umgebungsvariablen öffnen: Im Fenster für Systemeigenschaften klicken Sie auf die Schaltfläche "Umgebungsvariablen".
Systemumgebungsvariablen bearbeiten: In den Umgebungsvariablen finden Sie den Abschnitt "Benutzervariablen" und suchen die Variable "Path". Markieren Sie sie und klicken Sie auf die Schaltfläche "Bearbeiten".
Neues Verzeichnis hinzufügen: Im Fenster "Umgebungsvariablen bearbeiten" klicken Sie auf "Neu" und fügen Sie dann den Verzeichnispfad hinzu, den Sie in Schritt 2 kopiert haben. Bestätigen Sie mit "OK".
Überprüfen: Öffnen Sie einen neuen Terminal und geben Sie ein:
echo %PATH%
Sie sehen den aktualisierten PATH mit dem hinzugefügten Verzeichnis, welches jetzt dauerhaft verfügbar ist.
Bei erneutem Ausführen des folgenden Befehls sollte azcopy nun zu erkennen sein und der Installationspfad angezeigt werden
where azcopy
Um zu überprüfen ob die Tools richtig installiert wurden und auch zum Pfad hinzugefügt wurden, öffnen Sie ein Terminal und geben sie die in der Tabelle aufgeführten Befehle ein.
Schritt 2: Aufsetzen des Datentransfers:
Unter windowsbasierten Systemen kann der Upload über ein Batch-Skript durchgeführt werden. Sie erhalten das für Sie vorbereitete Skript mit Ihren Zugangsdaten von dem für Ihr Onboarding zuständigen Ansprechpartner. Damit können Sie dann die folgenden Schritte ausführen:
Ordnerstruktur aufsetzen
Erstellen Sie einen Ordner “tacto” innerhalb Ihres Benutzernamen, von dem aus Sie die Daten-Exporte an Tacto übertragen.
Den Pfad zu ihrem Benutzernamen können Sie mit folgendem Befehl im Terminal herausfinden. Auf dieser Ebene sollte der "tacto" Ordner erstellt werden.
echo %userprofile%
Bsp: C:\Users\<Ihr Benutzername>\tacto
Innerhalb des angelegten Ordners "tacto" müssen Sie dann noch 3 weitere Ordner erstellen:
"data-export"
"logs"
"skript"
Ihre Ordnerstruktur sollte also wie folgt aussehen:
C:\Users\<ihr Benutzername>\tacto\data-export
C:\Users\<ihr Benutzername>\tacto\logs
C:\Users\<ihr Benutzername>\tacto\skript
Legen Sie innerhalb des "data-export" Ordners Ihr erstes Bündel an Exportdateien ab.
Erstellen Sie zusätzlich innerhalb des "logs" Ordners eine .log-Datei, mit dem Namen "scheduled-task.log”. In dieser Datei werden zukünftig Logdaten während der Datenübertragung gespeichert.
Speichern Sie das Batch-Skript welches Sie via E-Mail erhalten haben im erstellten "skript" Ordner ab.
Wichtig ❗
Falls Sie die vorgeschlagene Ordnerstruktur nicht übernehmen und andere Dateipfade oder Benennungen gewählt haben, müssen Sie folgende Änderungen vornehmen:
Öffnen Sie das Skript und ersetzen Sie den Wert von “SOURCE_FOLDER” mit dem von Ihnen gewählten Ordnerpfad, wo Sie die Datenexporte ablegen. Ersetzen Sie "LOGPATH" mit dem absoluten Dateipfad zu der von Ihnen erstellten .log-Datei.
Schritt 3: Planung des automatisierten Datentransfers mit Windows Aufgabenplanung
Für die Automatisierung des regelmäßigen Datenaustauschs in windowsbasierten Systemen wird die Windows Aufgabenplanung (Task Scheduler) verwendet.
Dafür befolgen Sie bitte die folgenden Schritte:
Um einen Task mit der Windows Aufgabenplanung zu erstellen, öffnen Sie diesen und klicken unter "Aktion" auf "Aufgabe erstellen". (Create Task)
Geben Sie einen Namen und eine Beschreibung für die Aufgabe ein.
Wählen Sie die Registerkarte "Trigger"(Triggers) aus und fügen Sie einen neuen Auslöser hinzu.
Wählen Sie die Option "Nach einem Zeitplan" (On a schedule) und geben einen Zeitplan für die Ausführung der Aufgabe ein.
Wählen Sie die Registerkarte "Actions" aus und fügen Sie eine neue Aktion hinzu.
Wählen Sie die Option "Programm Starten" (Start a program) und geben Sie den Pfad zur "data-update-script.bat"-Datei ein.
Falls Sie die vorgeschlagene Ordnerstruktur übernommen haben sollte die Datei unter folgendem Dateipfad zu finden sein:
Bsp: C:\Users\<ihr Benutzername>\tacto\skript\data-update-script.bat
Klicken Sie auf "OK", um die Aufgabe zu speichern.
🏁 Damit haben Sie den automatischen Datenupload auf die Tacto-Cloud erfolgreich eingerichtet!
Überwachung des Upload-Tasks
Bevor Sie den Task überwachen können, stellen Sie sicher, dass die Task Historie aktiviert wurde. Dies geht über einen Rechtsklick auf die Aufgabenplanungshistorie (Task Scheduler Library). Dort kann die Aufgabenhistorie für alle Tasks aktiviert werden.
Um den Task dann zu überwachen, können die folgenden Schritte ausgeführt werden:
Öffnen Sie die Aufgabenplanung und suchen den Task in der Liste der geplanten Tasks.
Klicken Sie doppelt auf die Aufgabe, um ihre Eigenschaften zu öffnen
Überprüfen Sie die Registerkarte "Verlauf" (History), um den Verlauf der Ausführung der Aufgabe zu sehen. Die Spalte "Vorgangscode" (Operational Code) gibt dabei eine Auskunft ob der Task erfolgreich ausgeführt wurde
Zusätzlich können auch die Einstellungen für die entsprechende Aufgabe überprüft werden:
Überprüfen Sie die Registerkarte "Bedingungen" (Conditions), um sicherzustellen, dass alle Bedingungen erfüllt sind, um die Aufgabe auszuführen.
Überprüfen Sie die Registerkarte "Einstellungen" (Settings), um sicherzustellen, dass die Aufgabe wie erwartet ausgeführt wird.
Überprüfen Sie die Registerkarte "Aktionen" (Actions), um sicherzustellen, dass die richtige Anwendung gestartet wird und die richtigen Argumente verwendet werden.