Einleitung
Der Endpunkt ermöglicht das Aktualisieren von Projektstammdaten in bestehenden Projekten, basierend auf einer Projektvorlage.
Die Aktualisierung von Projektstammdaten über eine Projektvorlage 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/project/updatemasterdata/{templateId}
(Geschweifte Klammern nach Einfügen der templateid entfernen)
Felder
Die folgenden Projektstammdatenfelder können aus einer Projektvorlage auf ein bestehendes Projekt über die smenso API angewendet werden:
| Name | Typ | Beschreibung |
|---|---|---|
| TemplateId* | GUID |
(Pflicht-Parameter) Die GUID der Projektvorlage (in der Endpunkt-URL anzugeben) |
| ProjectId* | GUID |
(Pflicht-Parameter) Die GUID des Projekts, auf das die Projektvoralge angewendet werden soll. |
| OverwriteValues | boolean | Auswahl-Toggle, ob Flavorwerte überschrieben werden sollen, falls in der Projektvorlage Werte existieren. |
| StartDate | boolean |
Startdatum des Projekts (Projektstammdaten) |
| EndDate | boolean |
Enddatum des Projekts (Projektstammdaten) |
| Flavors | boolean | Flavors (inkl. Gruppen) aus den Projektstammdaten. |
| FlavorGroupsLockStatus | boolean | Der Sperrstatus der Flavorgruppen aus den Projektstammdaten. |
| Labels | boolean | Labels aus den Projektstammdaten. |
| Manager | boolean | Das Feld Projektleitung aus den Projektstammdaten. |
|
Budget |
boolean | Das Feld Budget aus den Projektstammdaten. |
| Location | boolean | Das Feld Ort aus den Projektstammdaten. |
| Description | boolean |
Das Feld |
| Goal | boolean | Das Feld Projektziel aus den Projektstammdaten. |
| Benefit | boolean |
Das Feld |
| Icon | boolean | Das Projektsymbol aus den Projektstammdaten. |
| Files | boolean | Angehängte Dateien aus den Projektstammdaten. |
Anfragedaten
Die Anfrage enthält Informationen zur Aktualisierung von Projektstammdaten eines Projekts unter Verwendung einer Projektvorlage im XML-Format.
Alle Parameter stehen im Beispiel unten auf false, müssen also nicht angegeben werden wenn man sie nicht importieren (=auf true stellen) möchte.
<Updatemasterdata>
<ProjectId></ProjectId> <!-- Pflichtparameter -->
<OverwriteValues>false</OverwriteValues>
<StartDate>false</StartDate>
<EndDate>false</EndDate>
<Flavors>false</Flavors>
<FlavorGroupsLockStatus>false</FlavorGroupsLockStatus>
<Labels>false</Labels>
<Manager>false</Manager>
<Budget>false</Budget>
<Location>false</Location>
<Description>false</Description>
<Goal>false</Goal>
<Benefit>false</Benefit>
<Icon>false</Icon>
<Files>false</Files>
</Updatemasterdata>
Antwort
Nach erfolgreicher Ausführung wird folgende Meldung ausgegeben:
<Result>
<HasErrors>false</HasErrors>
<TemplateApplied>true</TemplateApplied>
</Result>
Bei fehlerhafter Ausführung werden Details zum Fehler zurückgegeben, z.B.
<Result>
<HasErrors>true</HasErrors>
<Errors>
<ErrorDetail>A template with Id '73669f07-07d5-4f3f-b462-5f0bf23389a' doesn't exist</ErrorDetail>
</Errors>
</Result>
Kommentare
0 Kommentare
Bitte melden Sie sich an, um einen Kommentar zu hinterlassen.