UniversalRequestUtilsSNC - Com escopo

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 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.

    UniversalRequestUtilsSNC - createUniversalRequest(Object copyFields)

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

    Tabela 1. Parâmetros
    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.

    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.

    Padrão: o grupo de atribuição padrão é definido por regras de atribuição.

    Tabela: tabela Grupo [sys_user_group].

    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.

    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.

    Padrão: falso

    copyFields.short_description Cadeia de caracteres Descrição concisa do recurso.

    Tamanho máximo: 160

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

    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;