System Status
  1. Zensai Hilfecenter
  2. Perform & Engage 365
  3. API

Rufen Sie Talent-Mapping-Zyklen über die Perform & Engage 365 API ab

Avatar

Die Perform & Engage 365 API ermöglicht Ihnen Folgendes:

 

Rufen Sie eine Liste der Talent-Mapping-Zyklen ab

GET /api/v2/talent_mapping_cycles/

Mit dieser Anfrage können Sie eine Liste der Talent-Mapping-Zyklen abrufen.

 

Optionale Abfrageparameter

  • Name (Zeichenkette). Der Name des Talent-Mapping-Zyklus oder ein Teil seines Namens.
  • Limit (Ganzzahl). Die maximale Anzahl von Talent-Mapping-Zyklen in der Antwort.
  • Offset (Ganzzahl). Der Startindex, ab dem die Ergebnisse in der Antwort zurückgegeben werden.

 

Beispiel für eine Anfrage

GET /api/v2/talent_mapping_cycles/?name=Q1

 

Parameter des Antworttexts

Der Antworttext umfasst:

  • Anzahl (Ganzzahl). Die Anzahl der Ergebnisse.
  • Weiter und Zurück (Strings). URLs zu den Weiter- und Zurück-Seiten (wenn Sie in der ursprünglichen Anfrage Paginierung verwendet haben).
  • results (Array). Die Liste der Talent-Mapping-Zyklen. Jeder Talent-Mapping-Zyklus hat diese Parameter:
    • api_id (String). Die Talent-Mapping-Zyklus-ID. Sie können diese ID verwenden, um weitere Details zum Talent-Mapping-Zyklus abzurufen.
    • name (String). Der Name des Talent-Mapping-Zyklus.
    • potentials (Array) und perfomances (Array). Die Listen enthalten Werte, die zur Bewertung des Potenzials bzw. der Leistung der Mitarbeitenden verwendet werden. Jeder Wert aus diesen Listen hat diese Parameter:
      • sort_order (Integer). Der Parameter zeigt, wie das Potenzial bzw. die Leistung in der Talent-Map angeordnet ist.  
      • value (Integer). Der Potenzial- bzw. Leistungswert.
      • name (String). Der Name des Potenzials bzw. der Leistung.
    • fields (Array). Die Liste der zusätzlichen Felder aus dem Talent-Mapping-Zyklus. Jedes Element hat diese Parameter:
      • sort_order (Integer). Der Parameter zeigt, wie das zusätzliche Feld in der Talent-Map angeordnet ist.  
      • Name (String). Der Name des zusätzlichen Felds.
    • Status (String). Der aktuelle Status des Talent-Mapping-Zyklus. 

 

Beispiel für den Response-Body

Die erfolgreiche 200-Antwort gibt einen Body zurück, der etwa wie folgt aussieht:

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "api_id": "9a7ae213-e227-46c1-8622-9aec5c66f43a",
      "name": "Q1",
      "template": {
        "api_id": "337e40c0-054b-4d4f-ae62-6864ddf02aa4",
        "name": "Talent Mapping",
        "potentials": [
          {
            "sort_order": 0,
            "value": 1,
            "name": "Niedrig"
          },
          {
            "sort_order": 1,
            "value": 2,
            "name": "Mittel"
          },
          {
            "sort_order": 2,
            "value": 3,
            "name": "Hoch"
          }
        ],
        "performances": [
          {
            "sort_order": 0,
            "value": 1,
            "name": "Niedrig"
          },
          {
            "sort_order": 1,
            "value": 2,
            "name": "Mittel"
          },
          {
            "sort_order": 2,
            "value": 3,
            "name": "Hoch"
          }
        ],
        "fields": [
          {
            "sort_order": 0,
            "name": "Risiko des Verlusts"
          },
          {
            "sort_order": 1,
            "name": "Auswirkung des Verlusts"
          }
        ]
      },
      "status": "aktiv"
    }
  ]
}

 

Rufen Sie die Details eines bestimmten Talent-Mapping-Zyklus anhand seiner ID ab

GET /api/v2/talent_mapping_cycles/{api_id}/

Nachdem Sie in der Antwort auf die previous request die Talent-Mapping-Zyklus-api_id erhalten haben, können Sie diese ID verwenden, um Informationen zum Talent-Mapping-Zyklus abzurufen.

 

Erforderlicher Pfadparameter

 

Beispielanfrage

GET /api/v2/talent_mapping_cycles/9a7ae213-e227-46c1-8622-9aec5c66f43a/

 

Parameter des Response-Bodys

Die Antwort auf GET api/v2/talent_mapping_cycles/{api_id}/ enthält dieselben Parameter wie das results-Array in der Antwort auf GET /api/v2/talent_mapping_cycles/.

 

Beispiel für den Response-Body

Die erfolgreiche 200-Antwort gibt einen Body zurück, der etwa wie folgt aussieht:

{
  "api_id": "9a7ae213-e227-46c1-8622-9aec5c66f43a",
  "name": "Q1",
  "template": {
    "api_id": "337e40c0-054b-4d4f-ae62-6864ddf02aa4",
    "name": "Talent Mapping",
    "potentials": [
      {
        "sort_order": 0,
        "value": 1,
        "name": "Niedrig"
      },
      {
        "sort_order": 1,
        "value": 2,
        "name": "Mittel"
      },
      {
        "sort_order": 2,
        "value": 3,
        "name": "Hoch"
      }
    ],
    "performances": [
      {
        "sort_order": 0,
        "value": 1,
        "name": "Niedrig"
      },
      {
        "sort_order": 1,
        "value": 2,
        "name": "Mittel"
      },
      {
        "sort_order": 2,
        "value": 3,
        "name": "Hoch"
      }
    ],
    "fields": [
      {
        "sort_order": 0,
        "name": "Risiko des Verlusts"
      },
      {
        "sort_order": 1,
        "name": "Auswirkung des Verlusts"
      }
    ]
  },
  "status": "aktiv"
}

 

Rufen Sie eine Liste der Reviews für einen Talent-Mapping-Zyklus ab

GET /api/v2/talent_mapping_cycles/{cycle_api_id}/users/

Mit dieser Anfrage können Sie eine Liste der Nutzer abrufen, die von einem bestimmten Talent-Mapping-Zyklus bewertet wurden, zusammen mit den Ergebnissen der Bewertung. 

 

Erforderlicher Pfadparameter

 

Optionale Abfrageparameter

  • person_name (string). Der vollständige Name oder ein Teil des Namens des Benutzers, der durch den Talent-Mapping-Zyklus beurteilt wird, ohne Berücksichtigung der Groß-/Kleinschreibung.
  • performance (string) und potential (string). Die Stufe der Leistung und des Potenzials des Benutzers im Talent-Mapping-Zyklus.
  • limit (integer). Die maximale Anzahl von Benutzern in der Antwort.
  • offset (integer). Der Startindex, ab dem die Ergebnisse in der Antwort zurückgegeben werden.

 

Anfragebeispiel

GET /api/v2/talent_mapping_cycles/9a7ae213-e227-46c1-8622-9aec5c66f43a/\nusers/?performance=Moderate&potential=Moderate

 

Antworttextparameter

Der Antworttext umfasst:

  • count (integer). Die Anzahl der Ergebnisse.
  • Weiter und Zurück (strings). URLs zu den Seiten Weiter und Zurück (falls Sie in der ursprünglichen Anfrage Paginierung verwendet haben).
  • results (array). Die Liste der Beurteilungen für den Talent-Mapping-Zyklus. Jede Beurteilung hat folgende Parameter:
    • api_id (string). Die Beurteilungs-ID. Mit dieser ID können Sie weitere Details zur Beurteilung abrufen.
    • person (object). Die Details des Nutzers umfassen folgende Parameter:
      • api_id (Zeichenkette). Die ID des Nutzers.
      • Name (Zeichenkette). Der vollständige Name des Nutzers.
      • E-Mail (Zeichenkette). Die E-Mail-Adresse des Nutzers.
      • Abteilung (Zeichenkette). Die Abteilung des Nutzers.
      • person_properties (Array). Die Eigenschaften des Nutzers als Zeichenfolgenparameter in Name- und Wert-Paaren. Zum Beispiel könnte das die Rolle des Nutzers im Unternehmen sein.
    • Leistung (Zeichenkette) und Potenzial (Zeichenkette). Der Grad der Leistung und des Potenzials des Nutzers im Talent-Mapping-Zyklus.
    • Daten (Array). Die Liste benutzerdefinierter Felder im Talent-Mapping-Zyklus als Feld- und Wert-Paare von Zeichenfolgenparametern.

 

Beispiel für Response-Körper

Die erfolgreiche 200-Antwort liefert den Textkörper ähnlich diesem zurück:

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "api_id": "8ac868ce-97e2-4076-b03c-a3b772544c03",
      "person": {
        "api_id": "580:4aeb7ade-f9b7-4b13-b9f3-b0ac7ead5610",
        "name": "Test User",
        "email": "test@test.net",
        "department": "F&E",
        "person_properties": [
          {
            "name": "Rolle",
            "value": "Direktor Engineering"
          }
        ]
      },
      "performance": "Mittel",
      "potential": "Mittel",
      "data": [
        {
          "field": "Team-Bindung",
          "value": "Hoch"
        }
      ]
    }
  ]
}

 

Rufen Sie die Details einer bestimmten Beurteilung anhand ihrer ID ab

GET /api/v2/talent_mapping_cycles/{cycle_api_id}/users/{api_id}/

Nachdem Sie nach Erhalt der Beurteilung des Talent-Mapping-Zyklus die api_id in der Antwort auf die previous request geprüft haben, können Sie diese ID verwenden, um Informationen zur Beurteilung abzurufen.

 

Erforderliche Pfadparameter

 

Anfragebeispiel

GET /api/v2/talent_mapping_cycles/f7462ff0-81ca-4def-a841-18ee14f6ace0/
users/bf6d91f6-74d9-47f7-8592-4b2ba6a23778/

 

Parameter des Response Bodys

Die GET-Antwort api/v2/talent_mapping_cycles/{cycle_api_id}/users/{api_id}/ enthält dieselben Parameter wie das results-Array in der GET-Antwort /api/v2/talent_mapping_cycles/{cycle_api_id}/users/, jedoch nur für eine Review, deren ID Sie in den Query-Parametern der Anfrage angegeben haben.

 

Response-Body-Beispiel

Die erfolgreiche 200-Antwort gibt einen Antworttext zurück, der diesem ähnelt:

{
  "api_id": "8ac868ce-97e2-4076-b03c-a3b772544c03",
  "person": {
    "api_id": "580:4aeb7ade-f9b7-4b13-b9f3-b0ac7ead5610",
    "name": "Test User",
    "email": "test@test.net",
    "department": "F&E",
    "person_properties": [
      {
        "name": "Rolle",
        "value": "Direktor Engineering"
      }
    ]
  },
  "performance": "Mittel",
  "potential": "Mittel",
  "data": [
    {
      "field": "Team-Bindung",
      "value": "Hoch"
    }
  ]
}

 

 

War dieser Beitrag hilfreich?
0 von 0 fanden dies hilfreich

Kommentare

Zu diesem Beitrag können keine Kommentare hinterlassen werden.