---
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


---

# UniversalRequestUtilsSNC - Com escopo

# UniversalRequestUtilsSNC - 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) 2 min. de leitura

A API UniversalRequestUtilsSNC permite lidar com ciclos de vida de solicitação universal. Fornecido como um registro de inclusão de script.
Esta API requer o plug-in Solicitação universal (com.snc.universal_request) e é fornecida no namespace `sn_uni_req`.

Para obter informações, consulte [Solicitação universal](https://www.servicenow.com/docs/access?context=ur-landing-limitedaccess&version=xanadu&pubname=xanadu-employee-service-management&ft:locale=en-US).

## UniversalRequestUtilsSNC - createUniversalRequest(Object copyFields) {#ariaid-title2}

Cria uma solicitação universal e retorna o sys_id do registro de solicitação universal recém-criado.
Este método é chamado usando o protótipo UniversalRequestUtils no namespace `sn_uni_req`. Por exemplo, `sn_uni_req.UniversalRequestUtils().createUniversalRequest(`\<copyFields\> ) .
{#URUS-createUniversalRequest_O__table_agv_xrd_gnb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| copyFields | Objeto | Objeto JSON que contém nomes de campo e valores a serem definidos em um novo registro na tabela Solicitações universais \[universal_request\]. Forneça detalhes por nome de campo e valor de campo no formato `{ '`\<field_name\> ': '\<field_value\> ' } . Os campos a seguir são considerados os detalhes mais úteis a serem atribuídos a um tíquete primário. { 'assignment_group': 'String', 'assigned_to': 'String', 'contact_type': 'String', 'description': 'String', 'opened_by': 'String', 'opened_for': 'String', 'priority': 'String', 'restricted': Boolean, 'short_description': 'String' }; Outros campos não listados podem estar qualificados para o seu caso de uso. Para obter uma lista de campos de tabela e campos relacionados no sistema, exiba o [Data dictionary tables](https://www.servicenow.com/docs/access?context=c_DataDictionaryTables&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). Nota: Não inclua os campos primary_ticket ou sys_id no objeto JSON copyFields. |
| copyFields.atribuição_grupo | Cadeia de caracteres | Opcional. Sys_id do grupo atribuído ao recurso. Localizado na tabela Grupo \[sys_user_group\]. Padrão: o grupo de atribuição padrão é definido por regras de atribuição. |
| copyFields.contact_type | Cadeia de caracteres | Opcional. Método pelo qual o recurso foi relatado inicialmente. Valores possíveis: * bate-papo * e-mail * telefone * social * web Tamanho máximo: 40 |
| copyFields.description | Cadeia de caracteres | Opcional. Descrição detalhada do problema associado ao recurso. Tamanho máximo: 4.000 |
| copyFields.opened_by | Cadeia de caracteres | Opcional. Sys_id da pessoa que abriu o recurso inicialmente. Localizado na tabela Usuário \[sys_user\]. |
| copyFields.opened_for | Cadeia de caracteres | Opcional. Necessário para Prestação de serviços de RH casos. O sys_id do usuário para o qual o recurso foi aberto. |
| copyFields.priority | Cadeia de caracteres | Opcional. Prioridade do recurso. Especificado como um número. Valores possíveis: * 1: Crítico * 2: Alto * 3: Moderado * 4: Baixo Padrão: 3 |
| copyFields.restricted | Booliano | Opcional. Sinalizador que indica se a solicitação universal tem acesso restrito. Consulte [Funções e grupos da Solicitação universal](https://www.servicenow.com/docs/access?context=ur-roles&version=xanadu&pubname=xanadu-employee-service-management&ft:locale=en-US). Valores válidos: * verdadeiro: a Solicitação universal só pode ser acessada por usuários com a função `sn_uni_req.sensitiveinfo_agent`. Usuários com esta função têm permissões para exibir informações confidenciais, como detalhes da folha de pagamento. * falso: o acesso à Solicitação universal é irrestrito. {#URUS-createUniversalRequest_O__ul_ghk_csg_knb} Padrão: falso |
| copyFields.short_description | Cadeia de caracteres | Descrição concisa do recurso. Tamanho máximo: 160 |
[Tabela 1. Parâmetros]

{#URUS-createUniversalRequest_O__table_agv_xrd_gnb} {#URUS-createUniversalRequest_O__table_bgv_xrd_gnb__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Sys_id do registro de solicitação universal recém-criado. |
[Tabela 2. Retorna]

{#URUS-createUniversalRequest_O__table_bgv_xrd_gnb}  
O exemplo a seguir mostra como definir campos em uma nova solicitação universal. Neste caso de uso, este código é adicionado ao início do script Criar caso de RH com escopo Ações de e-mail de entrada \[sysevent_in_email_action\]. Se o caso não se aplicar ao RH, os agentes poderão transferir o caso para o departamento apropriado.

    var copiedFields = {
      'opened_for': "<user_sys_id>",    
      'short_description': email.subject,
      'restricted': false,
      'priority': '1'
    };

    // createUniversalRequest() must be called to create the universal request prior to creating the child case

    var ur = new sn_uni_req.UniversalRequestUtils().createUniversalRequest(copiedFields);
    current.universal_request = ur;