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 no lado do servidor e produzir saída como TEXTO ou JSON. A criação de processadores personalizados está obsoleta.

    Nota:
    Este recurso está obsoleto. Embora os processadores personalizados existentes e legados continuem a ser compatíveis, a criação de novos processadores personalizados foi descontinuada. Em vez disso, use Scripted REST APIs.
    Aviso:
    Ao criar um processador, certifique-se de usar nomes de parâmetros específicos do seu processador. Por exemplo, se o 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 jurídico_export_recipient_email. Caso isso não seja feito e use nomes de parâmetros de instância, como ID, tabela, sys_id, serviço, catalog_id, ou view (e outros), pode causar resultados inesperados.

    Quando criar processadores

    Não crie processadores personalizados. Este recurso está obsoleto. Use as APIs REST 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 Sinalizador 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 dos parâmetros devem ser específicos do processador. Não escolha nomes de parâmetros comuns que outro processador possa usar. Se você usar um nome de parâmetro comum, como id , sys_id ou tabela Em um processador, ele pode quebrar outras funcionalidades, já que o processador ganha quando esse parâmetro existe em uma URL. Por exemplo, um processador com um id O parâmetro, 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 de URI usado para chamar este processador.

    Chame um processador do URL como:

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

    Expressão de função invocada imediatamente para executar quando o sistema chamar este processador.

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

    • g_request
    • g_response
    • g_processor
    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