API-Endpunkt: Template/Task/Create

Einleitung

Der Endpunkt ermöglicht das Hinzufügen einer Aufgabe basierend auf einer Aufgabenvorlage.

Das Hinzufügen von Aufgaben basierend auf einer Aufgabenvorlage wird durch verschiedene Attribute definiert, die im XML-Format in der Anfrage übermittelt werden können.

Jeder Endpunkt erfordert die Verwendung eines personalisierten Tokens, der aus dem Admin Center bezogen werden kann und im Header gesetzt werden muss. Mehr Informationen zum Header.

Endpunkt

**POST** `https://WORKSPACENAME.smenso.cloud/skyisland/api/Integration/template/task/create/{templateId}

(Geschweifte Klammern nach Einfügen der templateid entfernen)

Felder

Die folgenden Felder können bei der Aufgabenanlage aus einer Aufgabenvorlage über die smenso API angesprochen werden.

Anfragedaten

Die Anfrage enthält Informationen für das Hinzufügen einer Aufgabe basierend auf einer Aufgabenvorlage im XML-Format. Alle sonstigen Felder werden von der Aufgabenvorlage übernommen.

Beispiel:

<create> 
  <BaseItem>
    <ProjectId>8df6402c-524f-4a4f-989f-60e258df0f4</ProjectId> <!-- Plichtfeld -->
    <Title>Ava Cadavra</Title> <!-- Plichtfeld -->
  </BaseItem>
</create>

Antwort

Nach erfolgreicher Ausführung wird folgende Meldung ausgegeben, inklusive der TaskId der angelegten Aufgabe:

<Result>
  <HasErrors>false</HasErrors>
  <TaskId>2919899c-69a9-4ccb-9844-7b3e790570ad</TaskId>
</Result>

Bei fehlerhafter Ausführung werden Details zum Fehler zurückgegeben, z.B. 

<Result>
    <HasErrors>true</HasErrors>
    <Errors>
        <ErrorDetail>Invalid root tag in XML for requested operation.</ErrorDetail>
    </Errors>
</Result>