---
sourceDocument: Referência de API do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# hr_Utils - com escopo

# hr_Utils - com escopo {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 min. de leitura

A API hr_Utils fornece funcionalidade básica para a aplicação de Recursos Humanos (RH).

Esta API requer o plug-in principal de RH (com.sn_hr_core) e é executada no namespace `sn_hr_core`.

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

Instancia uma instância da classe hr_Utils.
{#hrU-hr_Utils__table_wyr_ql2_vhb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 1. Parâmetros]

{#hrU-hr_Utils__table_wyr_ql2_vhb}

## hr_Utils -- getPrimaryJob(cadeia de caracteres userId) {#ariaid-title3}

Obtém o SYS ID do trabalho primário ativo para um usuário fornecido.
{#hrU-getPrimaryJob_S__table_jsg_hn2_vhb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| userID | Cadeia de caracteres | SYS ID do usuário de RH da tabela Usuário \[sys_user\] atribuído a um trabalho ativo ou futuro no qual Primário é verdadeiro. |
[Tabela 2. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Se presente e ativo, SYS ID do trabalho primário da tabela Trabalhos \[sn_hr_core_job\], caso contrário, será nulo. |
[Tabela 3. Retorna]

{#hrU-getPrimaryJob_S__table_ksg_hn2_vhb}  

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

Saída:

    Result: eb3c69463cd63740964fb8b1ce04f9ae

## hr_Utils -- switchPrimaryJob(cadeia de caracteres userId cadeia de caracteres jobId) {#ariaid-title4}

Alterna o trabalho primário de um usuário.
{#hrU-switchPrimaryJob_S_S__table_jz3_jn2_vhb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| userId | Cadeia de caracteres | SYS ID do usuário de RH da tabela Usuários \[sys_user\]. |
| jobId | Cadeia de caracteres | SYS ID do trabalho da tabela Trabalhos \[sn_hr_core_job\]. |
[Tabela 4. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | JSON codificado com mensagem e status, caso contrário, ocorrerá erro. |
[Tabela 5. Retorna]

{#hrU-switchPrimaryJob_S_S__table_kz3_jn2_vhb}  

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

Saída:

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