---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Projekt-Portfoliomanagement-API

# Projekt-Portfoliomanagement-API {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 Minuten Lesedauer

Die Projekt-Portfoliomanagement Die API stellt Endpunkte zum Massenimport von Kostenplänen und Projektaufgaben bereit.
Das PPM-Standard-Plugin (com.snc.Financial_Planning_pmo) ist für den Zugriff auf diese API erforderlich. Der aufrufende Anwender muss über die Rolle „IT_project_Manager" verfügen.

Diese API wird in bereitgestellt `Jetzt `Namespace.

## Projekt-Portfoliomanagement -- POSTEN SIE /now/ppm/insert_Cost_Plans {#ariaid-title2}

Erstellt Kostenpläne in der Tabelle „Kostenplan" \[Cost_Plan\].

### URL-Format

Standard-URL: /api/now/ppm/insert_Cost_Plans

### Unterstützte Anforderungsparameter

{#ppm-POST-costplans__entry__2}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 1. Pfad-Parameter]

{#ppm-POST-costplans__entry__6}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 2. Abfrageparameter]

{#ppm-POST-costplans__entry__10}

| Name | Beschreibung |
|-|-|
| End_Fiskalperiode | Erforderlich. SYS_ID der Endgeschäftsperiode für den Kostenplan. Datentyp: Zeichenfolge Tabelle: Geschäftsperiode \[Fiskalperiode\] |
| name | Erforderlich. Name des Kostenplans. Datentyp: Zeichenfolge |
| resource_type | Erforderlich. SYS_ID des Ressourcentyps. Datentyp: Zeichenfolge Tabelle: Ressourcentypdefinition \[resource_type_Definition\] |
| Start_Fiskalperiode | Erforderlich. SYS_ID der ersten Geschäftsperiode für den Kostenplan. Datentyp: Zeichenfolge Tabelle: Geschäftsperiode \[Fiskalperiode\] |
| Aufgabe | Erforderlich. SYS_ID des Projekts oder Bedarfs für den Kostenplan. Datentyp: Zeichenfolge Tabelle: Projekt \[pm_project\] oder Bedarf \[dmn_Demand\] |
| Unit_Cost | Erforderlich. Stückkosten für den Kostenplan. Datentyp: Zeichenfolge |
[Tabelle : 3. Anforderungstext-Parameter (JSON)]

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#ppm-POST-costplans__entry__24}{#ppm-POST-costplans__accept-JSON-only-entry-RESTAPI}{#ppm-POST-costplans__content_type-JSON-only-entry-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Nur unterstützt application/json. |
| Inhaltstyp | Datenformat des Anforderungstexts. Nur unterstützt application/json. |
[Tabelle : 4. Anforderungskopfzeilen.]

{#ppm-POST-costplans__entry__30}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 5. Antwort-Header]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#ppm-POST-costplans__entry__34}{#ppm-POST-costplans__entry-200-status-code}{#ppm-POST-costplans__entry-401-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch oder wurden nicht übergeben. |
[Tabelle : 6. Statuscodes]

### Antworttext-Parameter (JSON)

{#ppm-POST-costplans__entry__40}

| Name | Beschreibung |
|-|-|
| Ergebnis | Objekt mit Informationen zum Status der API-Anforderung. Datentyp: Objekt "result": { "status": "String" } |
| Ergebnis.Status | Status der API-Anforderung. Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung

In diesem Beispiel werden zwei Kostenpläne importiert.

    curl "https://instance.servicenow.com/api/now/ppm/insert_cost_plans" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "[
       {
          "name": "Cost plan 1",
          "resource_type": "3d16eaf79330120064f572edb67ffb04",
          "start_fiscal_period": "ed47e5d90b3010108d9ac74363673a98",
          "end_fiscal_period": "0a47e5d90b3010108d9ac74363673afd",
          "task": "0fc9f992db601810852ca6dc13961951",
          "unit_cost": 1200
       },
       {
          "name": "Cost plan 2",
          "resource_type": "3d16eaf79330120064f572edb67ffb04",
          "start_fiscal_period": "ed47e5d90b3010108d9ac74363673a98",
          "end_fiscal_period": "7947e5d90b3010108d9ac74363673ac9",
          "task": "0fc9f992db601810852ca6dc13961951",
          "unit_cost": 3600
       }
    ]" \
    --user 'username':'password'

Antworttext.

    {
       "result": {
          "status": "success"
       }
    }

## Projekt-Portfoliomanagement -- POSTEN SIE /now/ppm/insert_project_Tasks {#ariaid-title3}

Erstellt ein Projekt und zugehörige Projektaufgaben.
Projekte werden in der Tabelle „Projekt" \[pm_project\] erstellt, und Projektaufgaben werden in der Tabelle „Projektaufgabe" \[pm_project_Task\] erstellt.

### URL-Format

Standard-URL: /api/now/ppm/insert_project_Tasks

### Unterstützte Anforderungsparameter

{#ppm-POST-projecttasks__table_m1f_w5s_bwb__entry__2}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 7. Pfad-Parameter]

{#ppm-POST-projecttasks__table_m1f_w5s_bwb} {#ppm-POST-projecttasks__table_nhq_w5s_bwb__entry__2}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 8. Abfrageparameter]

{#ppm-POST-projecttasks__table_nhq_w5s_bwb} {#ppm-POST-projecttasks__table_qqf_x5s_bwb__entry__2}

| Name | Beschreibung |
|-|-|
| Child_Tasks | Array von Aufgaben für das Projekt. Jede Aufgabe ist ein Objekt im Array. Datentyp: Array "child_tasks": [ { "child_tasks": [Array], "external_id": "String", "short_description": "String" } ] |
| child_tasks.child_tasks | Array von untergeordneten Aufgaben für die übergeordnete Aufgabe. Jede untergeordnete Aufgabe ist ein Objekt im Array. Jede untergeordnete Aufgabe kann ein eigenes Array von untergeordneten Aufgaben haben. Datentyp: Array "child_tasks": [ { "child_tasks": [Array], "external_id": "String", "short_description": "String" } ] |
| Child_Tasks.external_ID | Eindeutiger Bezeichner der Aufgabe aus dem externen System. Datentyp: Zeichenfolge |
| Child_Tasks.short_description | Kurze Beschreibung der Aufgabe. Datentyp: Zeichenfolge |
| end_date | Enddatum für das Projekt. Datentyp: Zeichenfolge |
| external_id | Eindeutiger Bezeichner des Projekts aus dem externen System. Datentyp: Zeichenfolge |
| short_description | Kurzbeschreibung des Projekts. Datentyp: Zeichenfolge |
| start_date | Startdatum für das Projekt. Datentyp: Zeichenfolge |
[Tabelle : 9. Anforderungstext-Parameter (JSON)]

{#ppm-POST-projecttasks__table_qqf_x5s_bwb}

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#ppm-POST-projecttasks__table_gtc_jbt_bwb__entry__2}{#ppm-POST-projecttasks__accept-JSON-only-entry-RESTAPI}{#ppm-POST-projecttasks__content_type-JSON-only-entry-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Nur unterstützt application/json. |
| Inhaltstyp | Datenformat des Anforderungstexts. Nur unterstützt application/json. |
[Tabelle : 10. Anforderungskopfzeilen.]

{#ppm-POST-projecttasks__table_gtc_jbt_bwb} {#ppm-POST-projecttasks__entry__34}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 11. Antwort-Header]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#ppm-POST-projecttasks__table_acm_3bt_bwb__entry__2}{#ppm-POST-projecttasks__entry-200-status-code}{#ppm-POST-projecttasks__entry-401-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch oder wurden nicht übergeben. |
[Tabelle : 12. Statuscodes]

{#ppm-POST-projecttasks__table_acm_3bt_bwb}

### Antworttext-Parameter (JSON) {#ppm-POST-projecttasks__section_vtd_kbt_bwb}

{#ppm-POST-projecttasks__table_wtd_kbt_bwb__entry__2}

| Name | Beschreibung |
|-|-|
| Ergebnis | Objekt mit Informationen zum Status der API-Anforderung. Datentyp: Objekt "result": { "status": "String" } |
| Ergebnis.Status | Status der API-Anforderung. Datentyp: Zeichenfolge |
[ ]

{#ppm-POST-projecttasks__table_wtd_kbt_bwb}  

### Curl-Anforderung

Dieses Beispiel importiert ein Projekt mit zwei Aufgaben (zpq_T1 und zpq_T2). Die erste Aufgabe enthält mehrere untergeordnete Aufgaben, und die zweite Aufgabe hat Abhängigkeiten von den untergeordneten Aufgaben aus der ersten Aufgabe.

    curl "https://instance.servicenow.com/api/now/ppm/insert_project_tasks" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
       "start_date": "2022-05-18 08:00:00",
       "end_date": "2022-05-18 17:00:00",
       "short_description": "zpq_Project",
       "external_id": "0",
       "child_tasks": [
          {
             "short_description": "zpq_T1",
             "external_id": "1",
             "child_tasks": [
                {
                   "external_id": "1.1",
                   "short_description": "zpq_T11",
                   "child_tasks": [
                      {
                         "external_id": "1.1.1",
                         "short_description": "zpq_T111"
                      }
                   ]
                },
                {
                   "external_id": "1.2",
                   "short_description": "zpq_T12"
                }
             ]
          },
          {
             "short_description": "zpq_T2",
             "external_id": "2",
             "dependencies": [
                {
                   "external_id": "1.1",
                   "lag": -1,
                   "type": "fs"
                },
                {
                   "external_id": "1.2",
                   "lag": 2,
                   "type": "fs"
                }
             ]
          }
       ]
    }" \
    --user 'username':'password'

Antworttext.

    {
       "result": {
          "status": "success"
       }
    }


