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

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# hr_Utils: Bereichsbezogen

# hr_Utils: Bereichsbezogen {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 Minute Lesedauer

Die hr_Utils- API bietet grundlegende Funktionen für die Anwendung Human Resource (HR).

Diese API erfordert das HR-Core-Plugin (com.sn_hr_core) und wird im Namespace `sn_hr_core ausgeführt`.

## hr_Utils: hr_Utils() {#ariaid-title2}

Instanziiert eine Instanz der Klasse „hr_Utils".
{#hrU-hr_Utils__table_wyr_ql2_vhb__entry__3}

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

{#hrU-hr_Utils__table_wyr_ql2_vhb}

## hr_Utils -- getPrimaryJob(Zeichenfolge userId) {#ariaid-title3}

Ruft die Sys-ID des aktiven primären Auftrags für einen angegebenen Anwender ab.
{#hrU-getPrimaryJob_S__table_jsg_hn2_vhb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| userID | Zeichenfolge | Sys-ID des HR-Anwenders aus der Anwendertabelle \[sys_user\], der eine aktive oder zukünftige Aufgabe zugewiesen ist, in der „Primär" auf „wahr" festgelegt ist. |
[Tabelle : 2. Parameter]

{#hrU-getPrimaryJob_S__table_jsg_hn2_vhb} {#hrU-getPrimaryJob_S__table_ksg_hn2_vhb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Falls vorhanden und aktiv, Sys-ID des primären Auftrags aus der Tabelle „Aufträge" \[sn_hr_core_job\], andernfalls null. |
[Tabelle : 3. Ergebnisse]

{#hrU-getPrimaryJob_S__table_ksg_hn2_vhb}  

    var result = new sn_hr_core.hr_Utils().getPrimaryJob('5137153cc611227c000bbd1bd8cd2007');
    gs.info('Result: ' + result);

Ausgabe:

    Result: eb3c69463cd63740964fb8b1ce04f9ae

## hr_Utils - SwitchPrimaryJob (Zeichenfolge userId Zeichenfolge jobId) {#ariaid-title4}

Wechselt den primären Auftrag eines Anwenders.
{#hrU-switchPrimaryJob_S_S__table_jz3_jn2_vhb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| userId | Zeichenfolge | Sys-ID des HR-Anwenders aus der Tabelle „Anwender" \[sys_user\]. |
| jobId | Zeichenfolge | Auftrags-Sys-ID aus der Tabelle „Aufträge" \[sn_hr_core_job\]. |
[Tabelle : 4. Parameter]

{#hrU-switchPrimaryJob_S_S__table_jz3_jn2_vhb} {#hrU-switchPrimaryJob_S_S__table_kz3_jn2_vhb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Codiertes JSON mit Nachricht und Status, andernfalls Fehler. |
[Tabelle : 5. Ergebnisse]

{#hrU-switchPrimaryJob_S_S__table_kz3_jn2_vhb}  

    var result = new sn_hr_core.hr_Utils().switchPrimaryJob('5137153cc611227c000bbd1bd8cd2007', 'bc884e723c0ebf00964fb8b1ce04f9d7');
    gs.info('Result: ' + result);

Ausgabe:

    Result: {"message":"Switched primary job for the user successfully","status":"success"}