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


---

# Processadores

# Processadores {#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

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](https://servicenow-prod.fluidtopics.net/NkO~PM_OGwHpTRvBtL6ADg "O recurso de API REST de script permite que os desenvolvedores de aplicações criem APIs de serviço web personalizadas.").  
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

{#c_Processors__table_ck2_yr2_sr__entry__2}

| 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 {#c_Processors__ul_x5t_js2_sr} |
| 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: <kbd class="ph userinput">https://&lt;instance name&gt; .service-now.com/&lt;Path&gt; .fazer</kbd> |
| 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 {#c_Processors__ul_imr_j2k_sr} |
| 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 {#c_Processors__ul_ypd_cv2_sr} |
[ ]

{#c_Processors__table_ck2_yr2_sr}
* **[Componentes da API do processador](https://servicenow-prod.fluidtopics.net/lCDkSHPl2gnMoMrcW_9gag)**   
  Os processadores têm acesso a classes, objetos e métodos de API dedicados.
* **[Proteger e proteger um processador](https://servicenow-prod.fluidtopics.net/8zZ154tnLCDQboi3I83Fqg#t_SecureAProcessor)**   
  Você pode proteger seu processador contra uso não autorizado usando restrições de função e protegendo-o exigindo um token CSRF.
* **[Criar um processador simples](https://servicenow-prod.fluidtopics.net/zP6q0WUfdw8IBfQWTAVl5g)**   
  Crie um processador simples para executar um script a partir de uma consulta de URL. Este recurso está obsoleto.
* **[Criar um processador com várias tabelas](https://servicenow-prod.fluidtopics.net/LnZk1DEfc1WaNTmUzicWUw)**   
  Crie um processador de várias tabelas que relate o número de linhas em qualquer tabela em sua instância. Este recurso está obsoleto.
* **[Criar um processador personalizado](https://servicenow-prod.fluidtopics.net/BMuFzF5Wfj_Z6G_CJiAY6A)**   
  Crie um processador personalizado para executar um script a partir de uma consulta de URL. Este recurso está obsoleto.