Ab Version 10.8.1 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 öffnet die Site einen neuen Container und führt das Notebook ohne Benutzersteuerung aus.
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 einmal pro Minute bis hin zu einmal alle fünf Monate.
Wenn Sie ein Notebook für die automatisierte Ausführung vorbereiten, z. B. für eine Ausführung auf regelmäßiger Basis, müssen Sie einige Punkte beachten.
Vorbereiten des Notebooks
Mit der Funktion Parameters des Notebook-Editors können Sie Eingabe- und Ausgabeparameter für ein Notebook konfigurieren. Eingabeparameter entsprechen Eingabevariablen in einem Notebook, die Sie für einen geplanten Task oder ein Web-Werkzeug 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.
Beim Erstellen eines Notebooks werden die Variablen mit der Funktion Parameters externalisiert und konfiguriert. Weitere Informationen zum Einrichten von Eingabeparametern für Ihr Notebook finden Sie im Abschnitt Konfigurieren von Eingabeparametern des Themas "Veröffentlichen eines Notebooks als Web-Werkzeug".
Task-Parameter werden standardmäßig in eine Zelle am Anfang eines Notebooks eingefügt. Alternativ können Sie die Zellenoption Tags auf der Werkzeugleiste verwenden, mit der Sie Tags für jede Zelle im Notebook-Workspace erstellen und verwalten können, um ein Tag für eine Zelle mit der Bezeichnung injected-parameters zu erstellen. Task-Parameter werden in die Zelle eingefügt, die auf das Tag injected-parameters folgt. Um Tags zu aktivieren, können Sie die Optionen der Zellen-Werkzeugleiste ändern, indem Sie auf View > Cell Toolbar > Tags klicken.
Ü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 home/test.gdb den Pfad /arcgis/home/test.gdb.
Erstellen eines Task
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.
- 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.
- Klicken Sie auf Task erstellen, um das Dialogfeld zu öffnen.
Hinweis:
Sie haben auch die Möglichkeit, Tasks über die Registerkarte Tasks der Elementdetailseite des Notebooks zu erstellen. - Geben Sie im Textfeld Titel einen beschreibenden Titel für den Task-Zeitplan ein, z. B. Weekly data cleaning run.
- Falls Sie zuvor 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. Geben Sie für die einzelnen Parameter unter Schlüssel einen Schlüssel und unter Wert einen paarigen Wert ein, und klicken Sie zum Speichern des Parameters auf Hinzufügen.
Wenn Sie zuvor Eingabeparameter mit der Option Parameter eingerichtet haben, werden diese Parameter automatisch für den Task übernommen. Sie können taskspezifische Parameter hinzufügen, entfernen oder aktualisieren. Die Standardparameter für das Notebook, die mit der Option "Parameters" konfiguriert wurden, werden dadurch nicht geändert.
- Klicken Sie auf Weiter, um zur Seite Details für Task-Zeitplan festlegen zu gelangen.
Hier können Sie den Zeitplan für diesen Task angeben.
Tipp:
Wenn Sie den Wert für Wiederholungstyp ändern, werden die Optionen unten entsprechend geändert. Wählen Sie z. B. den Wiederholungstyp Woche aus, werden Kontrollkästchen für jeden Wochentag angezeigt. - Blenden Sie optional den Abschnitt Erweitert ein, um die maximale Anzahl der Minuten für die Ausführung des Tasks einzugeben.
- Wenn Sie Parameter hinzugefügt haben, erscheint im Abschnitt Erweitert die Umschaltfläche Parameter im Notebook speichern. Sie können diese Option aktivieren, um die eingefügte Zelle mit den neuen Parametern bei der Ausführung im Notebook zu speichern.
- Aktivieren Sie im Abschnitt Erweitert die Umschaltfläche Notebook nach Abschluss aktualisieren, wenn Sie das Notebook mit den Ergebnissen der einzelnen Ausführungen aktualisieren möchten.
- Wenn Sie mit der Kachel, 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.
Falls Sie mehrere Zeitpläne anlegen möchten, in die möglicherweise unterschiedliche Parameter eingefügt werden, können Sie mit demselben Workflow mehrere Tasks für das Notebook erstellen.
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 Elementdetailseite 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.
- Klicken Sie dazu auf dem Menüband oben im Notebook-Editor auf Tasks.
- Suchen Sie im Abschnitt Geplante Tasks den Task, den Sie bearbeiten möchten.
- Klicken Sie neben dem Task auf Aktionen
, und führen Sie einen der folgenden Schritte aus:- Klicken Sie auf Details, wenn Sie sich die Ergebnisse der einzelnen Task-Ausführungen ansehen möchten. Zusammen mit den Details der Task-Ausführung wird eine Vorschau des Notebooks gespeichert.
Hinweis:
In der Notebook-Vorschau werden Karten-Widgets, die im Notebook enthalten sind, nicht gerendert. Karten-Widgets werden nur im Notebook gerendert. Die statische Vorschau, die zusammen mit dem Ergebnis eines geplanten Tasks ausgegeben wird, umfasst kein Rendering.
- Klicken Sie auf Bearbeiten, um den Titel, die Parameter oder den Zeitplan für den Task zu ändern.
- Klicken Sie auf Unterbrechen, um einen aktiven Task anzuhalten. Wenn Sie die Ausführung eines angehaltenen Tasks fortsetzen möchten, klicken Sie auf Fortsetzen.
- 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.
- Klicken Sie auf Details, wenn Sie sich die Ergebnisse der einzelnen Task-Ausführungen ansehen möchten. Zusammen mit den Details der Task-Ausführung wird eine Vorschau des Notebooks gespeichert.
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 über die Registerkarte Tasks der Elementdetailseite des Notebooks aktivieren.