latest
⚙️ Administration
Tasks & Jobs

Tasks & Jobs

Jobs sind zeitgesteuerte Dienste, die in regelmäßigen Abständen ausgeführt werden. Verschiedene Tasks (Aufgaben) können mit einem Job ausgeführt werden. Für einen Task können beliebig viele Jobs angelegt werden.

Tasks

In Terratwin sind verschiedene Tasks integriert, die Sie in Form von Jobs regelmäßig ausführen können.

Task fut.downgrade

Der Task fut.downgrade setzt die Benutzertypen und Rollen der Mitglieder einer Gruppe gemäß den downgradeOptions aus der Service-Konfiguration Floating UserTypes Downgrade zurück.

EigenschaftTypBeschreibung
portalURLURL zum Portal

Task backup.hosted_data_backup

Der Task backup.hosted_data_backup erstellt ein Backup der Hosted Feature Layer in einem Portal. Jeder Hosted Feature Layer wird als gezippte File-Geodatabase exportiert und im Dateisystem gespeichert. Damit können Sie als GIS-Administrator frühere Datenstände auf Featureklassen-Ebene oder sogar einzelne Objekte wiederherstellen.

EigenschaftTypBeschreibung
portal_urlURLURL zum Portal
backup_folderPathAbsoluter Pfad auf dem Dateisystem des Servers, der Terratwin hostet. Dort werden die gezippten File-Geodatabases gespeichert. Dateien werden bei erneuter Ausführung überschrieben.
group_idStringGruppen-ID des Portals. Alle zu berücksichtigenden Hosted Feature Layer müssen für diese Gruppe freigegeben sein. Es wird empfohlen, eine mitgliederlose Gruppe speziell für einen Backup-Job anzulegen.

Dieser Task steht nicht für Terratwin-Instanzen zur Verfügung, die von uns auf terratwin.de gehostet werden.

Jobs

        • [random-guid].json

    • Beispielkonfiguration

    {
	"taskId": "fut.downgrade",
	"title": "Downgrade der Floating User",
	"disabled": false,
	"cronOptions": {
		"day_of_week": "*",
		"hour": 4,
		"minute": 0,
		"timezone": "Europe/Berlin"
	},
	"params": {
		"portal": "https://www.arcgis.com"
	}
}

    Parameter

    EigenschaftTypBeschreibung
    taskIdStringEindeutiger Schlüssel für den Task, der ausgeführt werden soll
    titleStringTitel des Jobs
    disabledBooleanGibt an, ob der Job aktiviert oder deaktiviert ist
    cronOptionsObjectZeitgesteuerte Optionen für die Ausführung des Jobs. Siehe Cron Optionen
    paramsObjectParameter, die an den Task übergeben werden. Siehe Tasks

    Cron Optionen

    Alle zeitgesteuerten Dienste weisen den Parameter cronOptions auf. Dieser dient zum Festlegen des Intervals, in dem der Dienst ausgeführt werden soll.

    Bei den Parametern kann eine Vielzahl unterschiedlicher Ausdrücke angegeben werden, und bei der Bestimmung der nächsten Ausführungszeit wird die frühestmögliche Zeit gefunden, die die Bedingungen in allen Feldern erfüllt. Dieses Verhalten ähnelt dem „Cron“-Dienstprogramm, das in den meisten UNIX-ähnlichen Betriebssystemen zu finden ist.

    Parameter

    EigenschaftTypBeschreibung
    yearintJahr (4-stellig)
    monthintMonat 1-12
    dayintTag im Monat 1-31
    weekintISO Woche 1-53
    day_of_weekintTag in der Woche 0-6
    hourintStunde 0-23
    minuteintMinute 0-59
    secondintSekunde 0-59
    start_dateStringStartzeit im Format ISO 8601 (opens in a new tab)
    end_dateStringEndzeit im Format ISO 8601 (opens in a new tab)
    timezoneStringZeitzone z.B. Europe/Berlin

    Ausdrücke

    Die folgende Tabelle listet alle verfügbaren Ausdrücke auf, die in den Feldern von year bis second verwendet werden können. Mehrere Ausdrücke können in einem einzigen Feld angegeben und durch Kommas getrennt werden.

    AusdruckEigenschaftBeschreibung
    \*alleAuslösung bei jedem Wert
    \*/aalleAuslösung alle a Werte, beginnend mit dem Minimum
    a-balleAuslösung bei jedem Wert im Bereich von a bis b (a muss kleiner als b sein)
    a-b/calleAuslösung alle c Werte innerhalb des Bereichs a bis b
    xth ydayAuslösung am x-ten Auftreten des Wochentags y innerhalb des Monats
    last xdayAuslösung am letzten Auftreten des Wochentags x innerhalb des Monats
    lastdayAuslösung am letzten Tag des Monats
    x,y,zbeliebigAuslösung bei jedem passenden Ausdruck; kann eine beliebige Anzahl der oben genannten Ausdrücke kombinieren

    Beispielkonfiguration

    {
	"cronOptions": {
		"day_of_week": 0,
		"hour": 04,
		"minute": "*/15",
		"timezone": "Europe/Berlin"
	}
}

    Beispielinterval für jeden Montag 4 Uhr alle 15 Minuten, also 04:00, 04:15, 04:30 und 04:45 Uhr

    Layer exriMarkdown