---
sourceDocument: Référence de l’API Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Référence de l’API Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# hr_Utils - Dans le champ d'application

# hr_Utils - Dans le champ d'application {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute de lecture

L'API hr_Utils fournit des fonctionnalités de base pour l'application Human Resources (HR).

Cette API nécessite le module d'extension HR Core (com.sn_hr_core) et s'exécute dans l'espace de noms `sn_hr_core` .

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

Instancie une instance de la classe hr_Utils.
{#hrU-hr_Utils__table_wyr_ql2_vhb__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 1. Paramètres]

{#hrU-hr_Utils__table_wyr_ql2_vhb}

## hr_Utils : getPrimaryJob(String userId) {#ariaid-title3}

Obtient l'ID système de la tâche principale active pour un utilisateur fourni.
{#hrU-getPrimaryJob_S__table_jsg_hn2_vhb__entry__3}

| Nom | Type | Description |
|-|-|-|
| userID | Chaîne | ID système de l'utilisateur RH de la table Utilisateur \[sys_user\] affecté à une tâche active ou future dans laquelle Primaire est vrai. |
[Tableau 2. Paramètres]

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

| Type | Description |
|-|-|
| Chaîne | S'il est présent et actif, ID système de la tâche primaire de la table Tâches \[sn_hr_core_job\], nul dans les autres cas. |
[Tableau 3. Renvoie]

{#hrU-getPrimaryJob_S__table_ksg_hn2_vhb}  

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

Sortie :

    Result: eb3c69463cd63740964fb8b1ce04f9ae

## hr_Utils : switchPrimaryJob(String, userId, String, jobId) {#ariaid-title4}

Modifie le travail primaire d'un utilisateur.
{#hrU-switchPrimaryJob_S_S__table_jz3_jn2_vhb__entry__3}

| Nom | Type | Description |
|-|-|-|
| userId | Chaîne | ID système de l'utilisateur RH de la table Utilisateurs \[sys_user\]. |
| jobId | Chaîne | ID système de la tâche dans la table Tâches \[sn_hr_core_job\]. |
[Tableau 4. Paramètres]

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

| Type | Description |
|-|-|
| Chaîne | JSON codé avec message et état, erreur dans le cas contraire. |
[Tableau 5. Renvoie]

{#hrU-switchPrimaryJob_S_S__table_kz3_jn2_vhb}  

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

Sortie :

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