--- 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 --- # Registro de macros de IU personalizadas em relação aos pontos de extensão de IU # Registro de macros de IU personalizadas em relação aos pontos 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) 2 min. de leitura Registre macros de IU personalizadas em relação a um ponto de extensão de IU selecionado no código da aplicação. Ao registrar macros de IU personalizadas, você cria um registro de instância de extensão que vincula a definição do ponto de extensão de IU à sua implementação na macro de IU personalizada. ## Registrar uma macro de IU personalizada {#ariaid-title2} Crie uma macro de IU personalizada e um código ao registrá-la em relação a um ponto de extensão de IU selecionado. ### Antes de Iniciar Função necessária: desenvolvedor específico da aplicação, administrador específico da aplicação ou administrador 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. Navegar até TodosPontos de Extensão do SistemaPontos de Extensão da IU. 2. Na tabela Ponto de extensão de IU \[sys_ui_extension-point\], selecione o ponto de extensão no qual você deseja registrar uma macro de IU personalizada. Nota: Esta listagem inclui pontos de extensão de IU que você criou e todos os pontos de extensão de IU predefinidos que estão incorporados em funções Now Platform (por exemplo, Customer Service Management e Gestão de serviços de campo). Para saber mais sobre funções que contêm pontos de extensão predefinidos, consulte os links dos Tópicos relacionados em [Usando pontos de extensão para estender a funcionalidade da aplicação](https://servicenow-prod.fluidtopics.net/ItedJghnFrSfOOiWnOQqgA "Use pontos de extensão para estender a funcionalidade de uma aplicação sem alterar o código da aplicação original. Você pode usar pontos de extensão pré-existentes disponíveis em aplicações Now Platform selecionadas ou pode adicionar pontos de extensão ao desenvolver aplicações personalizadas em sua própria instância."). 3. No registro de Ponto de extensão de IU, clique no link relacionado Criar implementação para criar uma nova macro de IU personalizada e registrá-la no ponto de extensão de IU selecionado. 4. No formulário Macro de IU, crie o código personalizado. Para saber mais sobre como criar macros de IU, 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."). 5. Clique em Atualizar. {#register-custom-ui-macros-ui-ext-pt__steps_tkt_jtq_qfb} ### Resultado A macro de IU personalizada é criada e registrada em relação ao ponto de extensão de IU. ## Revisar instâncias de extensão de IU {#ariaid-title3} Revise a lista de macros de IU personalizadas registradas em relação a um ponto de extensão de IU. As instâncias de extensão indicam o escopo da aplicação no qual as macros de IU personalizadas registradas são usadas e fornecem um link para cada uma. Você também pode ativar ou desativar uma instância de extensão. ### 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). ### Procedimento 1. Navegar até TodosPontos de Extensão do SistemaPontos de Extensão da IU. 2. Na tabela Ponto de extensão de IU \[sys_ui_extension_point\], selecione o ponto de extensão de IU para o qual você deseja exibir instâncias extensas. 3. Na lista relacionada Implementações do registro de Ponto de Extensão de IU, selecione uma instância de extensão de IU. O sistema exibe o registro de Instância de Extensão de IU.{#review-ui-extension-instances__table_r32_ytq_qfb__entry__2} | Campo | Descrição | |-|-| | Ponto | Nome exclusivo para o ponto de extensão de IU. O nome pode ter até 100 caracteres alfanuméricos, incluindo caracteres especiais. | | Classe | Macro de IU no código da aplicação em que o ponto de extensão de IU é implementado. | | 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). | | Ativo | Ponto de extensão ativo na instância atual. Para desativar um ponto de extensão, desmarque a caixa de seleção. | [Tabela 1. Registro de instância de extensão de IU] {#review-ui-extension-instances__table_r32_ytq_qfb} 4. Clique em Enviar. {#review-ui-extension-instances__steps_q32_ytq_qfb} **Conceitos relacionados** * [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.") * [Usando pontos de extensão para estender a funcionalidade da aplicação](https://servicenow-prod.fluidtopics.net/ItedJghnFrSfOOiWnOQqgA "Use pontos de extensão para estender a funcionalidade de uma aplicação sem alterar o código da aplicação original. Você pode usar pontos de extensão pré-existentes disponíveis em aplicações Now Platform selecionadas ou pode adicionar pontos de extensão ao desenvolver aplicações personalizadas em sua própria instância.")