Processadores

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 2 min. de leitura

    • Os processadores fornecem um endpoint de URL personalizável que pode executar código JavaScript arbitrário do lado do servidor e produzir saída como TEXT ou JSON. A criação de processadores personalizados está obsoleta.

    Nota:
    Este recurso está obsoleto. Embora os processadores personalizados legados e existentes continuem sendo compatíveis, a criação de novos processadores personalizados foi descontinuada. Em vez disso, use o Scripted REST APIs.
    Aviso:
    Ao criar um processador, certifique-se de usar nomes de parâmetro que sejam específicos ao seu processador. Por exemplo, se o seu processador exportar uma lista de registros jurídicos e um parâmetro necessário for o endereço de e-mail do destinatário, não use "e-mail" como o nome do parâmetro. Crie um nome de parâmetro mais específico do processador, como legal_export_recipient_email. Se isso não for feito e o uso de nomes de parâmetro de instância, como id, table, sys_id, service, catalog_id ou view (e outros), pode causar resultados inesperados.

    Quando criar processadores

    Não crie processadores personalizados. Este recurso está obsoleto. Use as REST APIs em vez de criar processadores personalizados. As informações restantes são deixadas somente para processadores existentes.

    Formulário do processador

    Campo Descrição
    Nome Nome exclusivo do processador.
    Tipo

    Linguagem de programação do script do processador.

    As opções incluem:

    • java: não selecione esta opção
    • script
    Aplicação Aplicação que contém este registro.
    Ativo Sinalize para habilitar ou desabilitar o registro.
    Proteção de CSRF Opção para proteger o processador contra execução, a menos que a instância use um token CSRF.
    Descrição Descrição da função ou finalidade do processador.
    Parâmetros

    Lista de parâmetros de entrada disponíveis.

    Especifique valores de parâmetro no URL como <parameter name>=<parameter value>.

    Nota:
    Os nomes de parâmetro devem ser específicos do processador. Não escolha nomes de parâmetro comuns que outro processador possa usar. Se você usar um nome de parâmetro comum, como id, sys_id ou table em um processador, ele poderá interromper outra funcionalidade, já que o processador vence quando esse parâmetro existe em um URL. Por exemplo, um processador com um parâmetro de id, independentemente do valor de caminho no mesmo registro, quebra o Portal de serviços, que depende desse parâmetro para identificação de página.
    Caminho

    Caminho do URI usado para chamar este processador.

    Chame um processador a partir do URL como:

    https://<instance name> .service-now.com/<Path> .fazer
    Script

    Expressão de função invocada imediatamente a ser executada quando o sistema chamar este processador.

    A função fornece automaticamente parâmetros de entrada para os seguintes objetos de API.

    • g_request
    • resposta_g
    • g_processador
    Política de proteção

    Política a ser usada para proteger o script deste registro.

    As opções incluem:

    • Nenhum(a)
    • Somente leitura
    • Protegido