Standard Setup für windows-basierte Systeme
Im Folgenden stellen wir ein Download-Skript sowie eine Erklärung zum Scheduling desselben zur Verfügung. Das Skript holt die von Tacto bereitgestellten Export-Dateien aus der Tacto-Cloud auf Ihr System. Stellen Sie sicher, dass zum Ausführen die nötigen Voraussetzungen Ihres Systems erfüllt sind.
Schritt 1: Voraussetzungen
Bitte installieren Sie das folgende Programm und fügen Sie es zu Ihrem System-PATH hinzu.
Tool | Version | Befehl |
|
|
Anders als beim Upload wird die Azure CLI hier nicht benötigt. Das Skript authentifiziert sich direkt über AzCopy.
Hinzufügen von Systemumgebungsvariablen zum PATH
Der PATH ist eine wichtige Umgebungsvariable und enthält eine Liste von Ordnern / Verzeichnissen, in denen das System nach ausführbaren Programmen sucht. Damit AzCopy über das 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
azcopy.exeenthalten ist, und kopieren Sie diesen.
Beispiel: C:\tacto\azcopy_download_folder
Öffnen Sie 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". Suchen Sie die Variable "Path", markieren Sie sie und klicken Sie auf "Bearbeiten".
Neues Verzeichnis hinzufügen: Im Fenster "Umgebungsvariablen bearbeiten" klicken Sie auf "Neu" und fügen dann den Verzeichnispfad hinzu, den Sie im vorherigen Schritt kopiert haben. Bestätigen Sie mit "OK".
Überprüfen: Öffnen Sie ein neues 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 vonwhere azcopysollte AzCopy nun erkannt und der Installationspfad angezeigt werden.
Um zu überprüfen, ob das Tool richtig installiert und zum Pfad hinzugefügt wurde, öffnen Sie ein Terminal und geben Sie den in der Tabelle aufgeführten Befehl ein.
Schritt 2: Aufsetzen des Datentransfers
Unter windowsbasierten Systemen wird der Download über ein Batch-Skript durchgeführt. Sie erhalten das für Sie vorbereitete Skript mit Ihren Zugangsdaten von dem für Ihr Onboarding zuständigen Ansprechpartner.
Ordnerstruktur aufsetzen
Erstellen Sie einen Ordner "tacto" innerhalb Ihres Benutzerverzeichnisses. Den Pfad zu Ihrem Benutzerverzeichnis können Sie mit folgendem Befehl im Terminal herausfinden; auf dieser Ebene sollte der Ordner "tacto" erstellt werden.
echo %userprofile%
Bsp: C:\Users\<Ihr Benutzername>\tacto
Erstellen Sie innerhalb des Ordners "tacto" einen weiteren Ordner "skript" und speichern Sie das per E-Mail erhaltene Batch-Skript dort ab.
Bsp: C:\Users\<Ihr Benutzername>\tacto\skript\data-download-script.bat
Die übrigen Ordner legt das Skript beim ersten Lauf selbst an, Sie müssen dafür nichts vorbereiten:
C:\Users\<Ihr Benutzername>\tacto\tacto-exports - hier landen die Export-Dateien
C:\Users\<Ihr Benutzername>\tacto\logs\scheduled-download.log - hier werden die Logdaten während der Datenübertragung gespeichert
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 "TARGET_FOLDER" mit dem von Ihnen gewählten Zielordner, in dem die Export-Dateien abgelegt werden sollen. Ersetzen Sie "LOGPATH" mit dem absoluten Dateipfad zu der gewünschten Logdatei. Die Werte im Abschnitt "SETTINGS" am Anfang des Skripts (APP_ID, CLIENT_SECRET, TENANT_ID, EXPORT_FOLDER) dürfen nicht verändert werden.
Erster Testlauf
Führen Sie das Skript einmal manuell per Doppelklick oder über das Terminal aus. Im Fenster sollte "INFO: Authentication successful" und anschließend "INFO: Download successful" erscheinen. Danach liegen die Dateien in tacto\tacto-exports.
Schritt 3: Planung des automatisierten Datentransfers mit Windows Aufgabenplanung
Für die Automatisierung des regelmäßigen Datenabrufs 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 diese 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 Sie einen Zeitplan für die Ausführung der Aufgabe ein.
Der Zeitplan sollte hinter dem mit Tacto vereinbarten Export-Zeitpunkt liegen. Bei einer wöchentlichen Sicherung eignet sich beispielsweise Sonntagmorgen.
Wählen Sie die Registerkarte "Aktionen" (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 Skriptdatei 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-download-script.bat
Klicken Sie auf "OK", um die Aufgabe zu speichern.
Hinweis zum Benutzerkontext ❗
Wenn Sie die Aufgabe mit der Option "Unabhängig von der Benutzeranmeldung ausführen" unter einem technischen Konto laufen lassen, zeigt %USERPROFILE% auf das Profil dieses Kontos. Die Dateien landen dann nicht im erwarteten Ordner. Tragen Sie in diesem Fall in "TARGET_FOLDER" und "LOGPATH" absolute Pfade ein, zum Beispiel D:\tacto\tacto-exports.
🏁 Damit haben Sie den automatischen Datendownload aus der Tacto-Cloud erfolgreich eingerichtet!
Überwachung des Download-Tasks
Bevor Sie den Task überwachen können, stellen Sie sicher, dass die Task-Historie aktiviert wurde. Dies geht über einen Rechtsklick auf die Aufgabenplanungsbibliothek (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 Sie 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 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.
Ergänzend enthält tacto\logs\scheduled-download.log das Protokoll jedes Laufs. Bei Problemen schicken Sie diese Datei bitte an Ihren Tacto-Ansprechpartner.