ExecuteAction-Endpunkt

Zusätzlich zu Abfragen und CRUD-Operationen können Sie über die Web API von time cockpit auch Ihre eigene Geschäftslogik ausführen. In time cockpit heißt eigene Geschäftslogik Aktion. Ähnlich wie Skriptlisten in time cockpit sind Aktionen IronPython-Code, der in Ihrer time cockpit Instanz läuft. Im Gegensatz zu Skriptlisten verändern Aktionen time cockpit üblicherweise auf die eine oder andere Weise.

Hinweis

Da eine Aktion Code ist, der auf unserer Infrastruktur läuft, muss sie von software architects geprüft und digital signiert werden. Diese Maßnahme schützt unsere Kunden vor dem Noisy-Neighbor-Problem.

Anwendungsfälle

Routineaufgaben durchführen, z. B. größere Datenmengen vorab generieren
Webhooks (mit serverlosen Komponenten wie Azure Functions)
Geschäftslogik sowohl in der Benutzeroberfläche als auch über die Web API wiederverwenden.

Service-Endpunkt

Die Adresse unseres Query-Endpunkts ist https://api.timecockpit.com/action. Beispiel: https://api.timecockpit.com/action/USR_SetHomeOfficeFlag

Authentifizierung

Um den Query-Endpunkt zu verwenden, müssen Sie sich zuerst beim Dienst authentifizieren. Wie Sie sich authentifizieren, lesen Sie unter Authentifizierung.

C#-Beispiel

Das folgende Beispiel zeigt einfachen C#-Code, der das Home-Office-Kennzeichen bei allen Zeitbuchungen eines bestimmten Tages setzt.

var actionRequestParam = new
	{
		inputSet = new
		{
			entityName = "APP_Timesheet",
			listName = string.Empty,
			listParameters = new string[0],
			items = new string[] { "a2788e0c-9484-4f3d-ad0c-236d0a628cf8" }
		},
		fetchModifications = false,
		parameter = new
		{
			entityName = "",
			value = new object()
		}
	};

	var jsonPayload = JsonConvert.SerializeObject(actionRequestParam);
	var jsonContent = new StringContent(jsonPayload, Encoding.UTF8, "application/json");
	var response = await httpClient.PostAsync($"https://api.timecockpit.com/action/USR_SetHomeOfficeFlag", jsonContent);
	if (response.IsSuccessStatusCode)
	{
		var result = await response.Content.ReadAsStringAsync();
	}
	else
	{
		var content = await response.Content.ReadAsStringAsync();
		throw new Exception(content);
	}

Zur Referenz zeigt der folgende Code die Aktion USR_SetHomeOfficeFlag.