--- 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 --- # Criar e adicionar um ponto de extensão de IU # Criar e adicionar um ponto de extensão de IU {#ariaid-title1} * Versão de lançamento: Xanadu * * Atualizado 1 de ago. de 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 min. de leitura Ao desenvolver uma aplicação, crie pontos de extensão de IU e adicione-os às macros de IU do lado do servidor, como extensões HTML, ou às páginas de IU no código da aplicação base. Use um ponto de extensão de IU para designar o local específico para onde dados ou objetos podem ser enviados para uma macro de IU personalizada registrada e onde os resultados retornados são processados. ## Criar um ponto de extensão de IU {#ariaid-title2} Crie um ponto de extensão de IU que você pode colocar nas macros de IU, como extensões HTML, no código da aplicação. Ao colocar o ponto de extensão de IU, você designa o local específico no código da aplicação para onde os dados ou objetos podem ser enviados para uma personalização e onde os dados são retornados. ### Antes de Iniciar Função necessária: administrador ou a função específica para o desenvolvedor ou administrador da aplicação Nota: Para saber mais sobre funções de administrador específicas da aplicação e desenvolvimento delegado, consulte [Regras de controle de acesso em apps de administração de aplicações](https://www.servicenow.com/docs/access?context=ACL-access-checks&version=xanadu&pubname=xanadu-application-development&ft:locale=en-US) e [Desenvolvimento e implantação delegados](https://www.servicenow.com/docs/access?context=c_DelegatedDevelopment&version=xanadu&pubname=xanadu-application-development&ft:locale=en-US). ### Por Que e Quando Desempenhar Esta Tarefa Definir o conteúdo e a estrutura de um ponto de extensão. Esta definição deve descrever como uma personalização deve ser estruturada, como ela interage com o código da aplicação e como os dados retornados por uma personalização no ponto de extensão são processados. Ao criar uma boa definição, você fornece uma estrutura para a funcionalidade das extensões. ### Procedimento 1. Navegar até TodosPontos de Extensão do SistemaPontos de Extensão da IU. 2. Clique em Nova. 3. No formulário, preencha os campos. {#create-ui-ext-pt__table_tqn_cfv_s1b__entry__2} | Campo | Descrição | |-|-| | Nome | Nome exclusivo do ponto de extensão. O nome pode ter até 100 caracteres alfanuméricos, incluindo caracteres especiais. | | Nome da API | Nome da API do ponto de extensão que é anexado ao escopo da aplicação ao qual se aplica. Este é um nome atribuído pelo sistema e não pode ser alterado. | | Aplicação | Escopo da aplicação em relação ao qual o ponto de extensão está atribuído. Isso é atribuído pelo sistema e não pode ser alterado. Para obter mais informações sobre as proteções oferecidas pelo uso da definição do escopo, consulte [Application scope](https://www.servicenow.com/docs/access?context=c_ApplicationScope&version=xanadu&pubname=xanadu-application-development&ft:locale=en-US). | | Restringir a este escopo | Opção para restringir o ponto de extensão somente ao escopo da aplicação. | | Permitir o acesso em AJAX/REST | Opção para habilitar ou desabilitar o acesso ao ponto de extensão de IU em AJAX ou REST. Para saber mais sobre essas arquiteturas e técnicas de desenvolvimento, consulte [AJAX](https://servicenow-prod.fluidtopics.net/M5ZNarV4DolhWDd2~K9JFg#p_AJAX "AJAX (JavaScript e XML assíncronos) é um grupo de técnicas de desenvolvimento inter-relacionadas do lado do cliente usadas para criar aplicações Web assíncronas.") e [REST APIs](https://servicenow-prod.fluidtopics.net/_wb_5~ll90zKaDApNe9ciw "REST (Transferência de Estado Representacional) é uma arquitetura sem estado simples que fornece padrões entre sistemas de computador na Web, facilitando a comunicação entre eles."). | | Descrição | Os requisitos para o script personalizado Macro de IU, por exemplo, como o script de IU deve ser estruturado e como ele deve operar com o código da aplicação. | | Exemplo | Exemplo de como uma macro de IU personalizada que interage com este ponto de extensão deve ser estruturado para operar com o código da aplicação. | [Tabela 1. Formulário de Ponto de Extensão de IU] {#create-ui-ext-pt__table_tqn_cfv_s1b} 4. Clique em Enviar. {#create-ui-ext-pt__steps_mfs_mgn_pdb} ## Adicionar um ponto de extensão de IU no código da aplicação base {#ariaid-title3} Adicione o ponto de extensão de IU a uma macro de IU ou extensão HTML no código da aplicação base. Para adicionar o ponto de extensão, faça uma chamada de API que identifica o local no qual os artefatos personalizados registrados são executados. ### Antes de Iniciar Função necessária: administrador ou a função específica para o desenvolvedor ou administrador da aplicação Você deve primeiro criar um ponto de extensão de IU antes de adicioná-lo a uma macro de IU ou página de IU no código da aplicação. Nota: Para saber mais sobre funções de administrador específicas da aplicação e desenvolvimento delegado, consulte [Regras de controle de acesso em apps de administração de aplicações](https://www.servicenow.com/docs/access?context=ACL-access-checks&version=xanadu&pubname=xanadu-application-development&ft:locale=en-US) e [Desenvolvimento e implantação delegados](https://www.servicenow.com/docs/access?context=c_DelegatedDevelopment&version=xanadu&pubname=xanadu-application-development&ft:locale=en-US). ### Procedimento 1. No código da aplicação, acesse a macro de IU existente à qual você deseja adicionar um ponto de extensão com script ou crie um novo. Para saber mais sobre como criar macros de IU com marcadores Jelly, consulte [Macros de IU](https://servicenow-prod.fluidtopics.net/dgFG18y~yGBcumzXueJ7Fw#c_UIMacros "Macros de IU são componentes discretos em script que os administradores podem adicionar à interface do usuário.") e [Marcadores Jelly](https://servicenow-prod.fluidtopics.net/ZBQAoF8x6R~JPehIgGM93A "Use Jelly para transformar XML em HTML."). 2. Na macro de IU, adicione um marcador Jelly com uma linha de código no local que você espera coletar e processar a saída da macro de IU personalizada. Normalmente, esta linha de código contém: * Um comando `call_extension` que identifica o nome do ponto de extensão de IU (por exemplo, `extension="global.KMArticle.ViewHeader"`) no qual as macros de IU personalizadas são registradas. * Argumentos que são passados para a macro de IU quando ela é renderizada. Por exemplo, para um artigo Base de conhecimento, `knowledgerecord="${knowledgeRecord}"` passa no registro de conhecimento atual.{#add-ui-ext-pt-base-ui-macro__li_fpg_bw2_ygb} {#add-ui-ext-pt-base-ui-macro__li_fpg_bw2_ygb} * (Opcional) Se houver várias implementações deste ponto de extensão, o uso de um comando de `limite` especificará que o número x de implementações deve ser retornado (por exemplo, `limit="1"`). Esta figura mostra uma macro de IU que contém esses comandos. {#add-ui-ext-pt-base-ui-macro__ul_gxz_4zv_bgb} {#add-ui-ext-pt-base-ui-macro__steps_mfs_mgn_pdb}