Erstellen eines Zeitplans für Notebook-Tasks

Es besteht die Möglichkeit, Tasks zur Planung der automatisierten Ausführung eines Notebooks zu erstellen. Bei jeder Ausführung des Notebooks gemäß dem festgelegten Zeitplan wird die Site mit einem neuen Container geöffnet und das Notebook wird ausgeführt, ohne dass Sie es öffnen müssen. In allen Notebooks zusammen können maximal zehn Tasks aktiv sein.

Im Bereich Tasks des Notebook-Editors können Sie einen oder mehrere geplante Tasks zur Ausführung des Notebooks erstellen. Sie haben die Möglichkeit, für die Zukunft eine einmalige Ausführung oder die Ausführung auf wiederkehrender Basis zu planen. Dabei reichen die Zeitintervalle von alle 15 Minuten bis hin zu einmal alle sechs Monate.

Wenn Sie ein Notebook für eine automatisierte Ausführung vorbereiten, z. B. für eine Ausführung auf regelmäßiger Basis, beachten Sie Folgendes:

• Die maximale Häufigkeit, mit der ein geplanter Task ausgeführt werden kann, lautet "Alle 15 Minuten".
• Sie können nur Tasks für Notebook-Elemente erstellen, deren Besitzer Sie sind. Dies gilt für alle Benutzertypen einschließlich Administratoren.
• Administratoren können Tasks für alle Notebook-Elemente in der Organisation anzeigen und bearbeiten.
• Wenn ein Notebook mit geplanten Tasks gelöscht oder an den Papierkorb gesendet wird, werden die Tasks dauerhaft gelöscht und können nicht wiederhergestellt werden.

Vorbereiten des Notebooks

Sie können Eingabe- und Ausgabeparameter für ein Notebook konfigurieren. Eingabeparameter entsprechen Eingabevariablen in einem Notebook, die Sie für einen geplanten Task externalisieren möchten. Bei der Ausführung eines geplanten Tasks werden die Eingabeparameter – ähnlich wie globale Variablen – oben in das Notebook eingefügt. Auf diese Weise können Sie generische Notebooks erstellen und die Werte für die Eingabevariablen zur Laufzeit modifizieren.

Task-Parameter werden standardmäßig in eine Zelle am Anfang eines Notebooks eingefügt. Klicken Sie alternativ im Menü auf View > Activate Command Palette, suchen Sie nach Edit Notebook Metadata, und öffnen Sie diese, um Zellen- und Notebook-Metadaten zu bearbeiten und ein Tag für eine Zelle mit dem Namen injected-parameters zu erstellen. Task-Parameter werden in die Zelle eingefügt, die auf das Tag injected-parameters folgt.

Überlegungen für Inhalte

Mit Ausnahme der Zelle "parameters", die eingefügt werden kann, wird bei der Planung eines Notebooks keine Benutzerinteraktion mit den Notebooks unterstützt. Sie sollten daher keine Inhalte hinzufügen, die eine Benutzerinteraktion, z. B. das Klicken auf einen Punkt auf der Karte, während der Notebook-Ausführung erforderlich machen.

Alle Anmeldeinformationen und neuen Variablen, die zum Zeitpunkt der automatisierten Ausführung hinzugefügt werden sollen, müssen wie zuvor beschrieben in die Zelle "parameters" eingefügt werden. Vergewissern Sie sich, dass das Notebook keine Inhalte enthält, die eine erfolgreiche Ausführung des Notebooks verhindern.

Hinweis:

Verwenden Sie beim Erstellen von Notebooks vollständige Pfade zu Verzeichnissen und Dateien im Workspace-Verzeichnis.

Verwenden Sie also beispielsweise anstelle von /arcgis/home/test.gdb den Pfad home/test.gdb.

Erstellen eines Tasks

Wenn das Notebook fertig ist, können Sie einen Task zur Planung der Ausführung erstellen. Im Bereich Tasks im Notebook-Editor können Sie mindestens einen Task erstellen, um die Notebook-Ausführung zu automatisieren und den Zeitplan des Tasks anzugeben.

Führen Sie die folgenden Schritte aus, um einen Task zu erstellen:

1. Überprüfen Sie, ob Sie mit Berechtigungen zum Erstellen von und zum Festlegen eines Zeitplans für Notebooks angemeldet sind.
2. Speichern Sie das Notebook mit einem Titel, sofern dies noch nicht erfolgt ist.

   Die Schaltfläche Tasks wird auf dem oberen Menüband des Notebook-Editors verfügbar.

3. Klicken Sie dazu auf dem Menüband oben im Notebook-Editor auf Tasks.
4. Klicken Sie auf Task erstellen, um das Dialogfeld zu öffnen.

   Hinweis:

   Sie haben auch die Möglichkeit, Tasks über die Registerkarte Tasks auf der Elementseite des Notebooks zu erstellen.

5. Geben Sie im Textfeld Titel einen beschreibenden Titel für den Task-Zeitplan ein, z. B. Weekly data cleaning run.
6. Falls Sie keine Parameter für das Notebook konfiguriert haben und es Parameter gibt, die Sie dem Notebook bei der Ausführung durch den Task hinzufügen möchten, geben Sie diese im Abschnitt Parameter an, und klicken Sie auf Hinzufügen, um den Parameter im Workflow hinzuzufügen.
7. Geben Sie für die einzelnen Parameter unter Schlüssel einen Schlüssel und unter Wert einen paarigen Wert an.
8. Klicken Sie auf Weiter.
9. Geben Sie auf der Seite Details für Task-Zeitplan festlegen den Zeitplan für den Task an.

   Der von Ihnen angegebene Zeitplan wird auf der Grundlage der lokalen Zeitzone Ihres Webbrowsers gespeichert.

   Tipp:

   Wenn Sie den Wert für Wiederholungstyp ändern, werden die Optionen darunter entsprechend geändert. Wenn Sie z. B. Monat auswählen, erscheint das Feld Tag des Monats, in dem Sie einen Tag des Monats oder einen Bereich von Tagen für die Ausführung des Tasks festlegen können.

10. Blenden Sie optional den Abschnitt Erweitert ein, und führen Sie einen der folgenden Schritte aus:
    • Geben Sie die maximale Anzahl der Minuten für die Ausführung des Tasks ein.
    • Aktivieren Sie die Umschaltfläche Workspace verwenden, wenn das Notebook, das Sie planen möchten, Dateien im Workspace-Verzeichnis liest oder erstellt (/arcgis/home).

      Hinweis:

      Auch wenn die Schaltfläche Workspace verwenden für eine Notebook-Task deaktiviert ist, können Sie während einer Task-Ausführung weiterhin Dateien schreiben. Die geschriebenen Dateien werden jedoch nur für die Dauer der Ausführung an einem temporären Speicherort aufbewahrt und nach Abschluss der Ausführung entfernt.

    • Wenn Sie Parameter hinzugefügt haben, aktivieren Sie die Umschaltfläche Parameter im Notebook speichern, um die eingefügte Zelle mit den neuen Parametern im Notebook zu speichern, wenn sie ausgeführt wird.
    • Aktivieren Sie die Umschaltfläche Notebook nach Abschluss aktualisieren, um das Notebook mit den Ergebnissen der einzelnen Ausführungen zu aktualisieren.
11. Wenn Sie mit dem Titel, den optionalen Parametern und dem Zeitplan des Tasks zufrieden sind, klicken Sie auf Task erstellen.

    Der Task ist aktiviert und führt das Notebook gemäß dem festgelegten Zeitplan aus.

Für mehrere Zeitpläne können Sie mit demselben Workflow mehrere Tasks für das Notebook erstellen. In allen Notebooks zusammen können maximal zehn Tasks aktiv sein. Wenn zehn Tasks aktiv sind und Sie weitere Tasks planen möchten, halten Sie aktive Tasks an, oder löschen Sie aktive Tasks.

Verwenden vorhandener Tasks

Wenn Sie einen Task für ein Notebook erstellt haben, können Sie seine Details anzeigen und jederzeit bearbeiten oder löschen. Sie können die Tasks entweder im Bereich Tasks des Notebook-Editors oder über die Registerkarte Tasks der Elementseite des Notebooks ändern. An beiden Stellen können Sie alle Tasks für das Notebook mit dem jeweiligen Zeitpunkt der Erstellung und der letzten Änderung sowie dem aktuellen Status der Tasks anzeigen.

Führen Sie die folgenden Schritte aus, um vorhandene Tasks zu verwenden:

1. Überprüfen Sie, ob Sie mit Berechtigungen zum Erstellen von Notebooks angemeldet sind.
2. Klicken Sie dazu auf dem Menüband oben im Notebook-Editor auf Tasks.
3. Suchen Sie im Abschnitt Geplante Tasks den Task, den Sie bearbeiten möchten.
4. Klicken Sie neben dem Task auf Aktionen , und führen Sie einen der folgenden Schritte aus:
   • Klicken Sie auf Details, wenn Sie die Details und den Status der einzelnen Task-Ausführungen sehen möchten. Klicken Sie auf Ergebnisse, wenn Sie die Ausführungsergebnisse sehen möchten. Ein Task kann einen der folgenden Status aufweisen:
     • Erfolgreich abgeschlossen: Der Task wurde erfolgreich abgeschlossen.
     • Wird ausgeführt: Der Task befindet sich derzeit in der Ausführung.
     • Nicht erfolgreich: Der Task konnte nicht erfolgreich ausgeführt werden. Nach fünf Fehlversuchen wird die Ausführung eines Tasks abgebrochen.
     • Übersprungen: Der Task wurde übersprungen, weil sich ein vorheriger Task noch in der Ausführung befand.
   • Klicken Sie auf Bearbeiten, um den Titel, die Parameter oder den Zeitplan für den Task zu ändern.
   • Klicken Sie auf Anhalten, um einen aktiven Task anzuhalten, und auf Fortsetzen, um den Task fortzusetzen.
   • Klicken Sie zum Entfernen eines Tasks auf Löschen.

     Hinweis:

     Beim Löschen eines Tasks wird ebenfalls der Ausführungsverlauf des Tasks gelöscht. Um den Verlauf eines aktiven Task beizubehalten, können Sie stattdessen den Task anhalten, sodass er nicht mehr ausgeführt wird.

Wird der Besitzer eines Notebooks geändert, ändert sich ebenfalls der Besitzer der Tasks im entsprechenden Notebook. Die Tasks werden im inaktiven Zustand an den neuen Benutzer übertragen. Der neue Besitzer kann die Tasks im Bereich Tasks des Notebook-Editors oder auf der Registerkarte Tasks der Elementseite des Notebooks aktivieren.