Criar e adicionar um ponto de extensão de IU

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 as páginas de IU no código da aplicação de base.

Use um ponto de extensão de IU para designar o local específico onde os dados ou objetos podem ser enviados para uma macro de IU personalizada registrada e onde os resultados retornados são processados.

Crie um ponto de extensão de IU

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 posicionar 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 para onde os dados são retornados.

Antes de Iniciar

Função necessária: administrador ou a função específica do 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 e. Desenvolvimento e implantação delegados .

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é Tudo > Pontos de Extensão do Sistema > Pontos de Extensão da IU.
2. Clique em Nova.
3. No formulário, preencha os campos.

   Tabela 1. Formulário Ponto de extensão de IU

   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 de ponto de extensão que está pré-pendente com o escopo da aplicação ao qual ela se aplica. Este é um nome atribuído pelo sistema e não pode ser alterado.
   Aplicação	Escopo da aplicação contra o qual o ponto de extensão é 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 do escopo, consulte Application scope.
   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 e. REST APIs.
   Descrição	Requisitos para o 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.

4. Clique em Enviar.

Adicione um ponto de extensão de IU no código da aplicação de base

Adicione o ponto de extensão de IU a uma macro de IU ou extensão HTML no código da aplicação de base. Para adicionar o ponto de extensão, faça uma chamada de API que identifique o local em que os artefatos personalizados registrados são executados.

Antes de Iniciar

Função necessária: administrador ou a função específica do desenvolvedor ou administrador da aplicação

Primeiro, você deve 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 e. Desenvolvimento e implantação delegados .

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 e. Marcadores Jelly.
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 de macro de IU personalizada.
   Normalmente, esta linha de código contém:

   • . call_extension Comando que identifica o nome do ponto de extensão de IU (por exemplo, "GLOBAL.KMarticle.ViewHeader" Em relação ao qual as macros de IU personalizadas são registradas.
   • Argumentos passados para a macro de IU quando ela é renderizada. Por exemplo, para um Base de conhecimento artigo, "KnowledgeRecord" passa o registro de conhecimento atual.
   • (Opcional) Se houver várias implementações deste ponto de extensão, usando um limite o comando especifica que o número x de implementações deve ser retornado (por exemplo, "1" ). Esta figura mostra uma macro de IU que contém esses comandos.