Crie plugins do App Builder usando C# no Jitterbit App Builder

Plugins são extensões que expandem a funcionalidade do App Builder. Uma série de plugins vem com o App Builder e está disponível para uso imediato. No entanto, os desenvolvedores também podem criar seus próprios scripts para aumentar a gama de utilidades possíveis. Esta página descreve como fazer isso.

Detalhes do script personalizado

Scripts personalizados em C# são compilados com o compilador Roslyn .NET. Cada tipo de script define um conjunto de membros globais que fornecem acesso a objetos e serviços.

Cada script em C# tem um propósito, que determina como e onde o plugin pode ser usado. Um plugin também pode gerar um arquivo de relatório. Você seleciona um propósito para seu plugin personalizado ao criá-lo. Os propósitos que um script C# pode atender estão listados na seção Como criar um plugin C#.

Assemblies

Plugins do App Builder podem referenciar código externo por meio do uso de assemblies. Um assembly é um arquivo (geralmente terminando em .dll) que contém uma biblioteca de código pré-escrito que seu script pode utilizar para realizar tarefas específicas, por exemplo, matemática complexa ou consulta ao endereço IP de um site.

A partir do App Builder 4.57, é possível fazer o upload de um arquivo de biblioteca (arquivo ZIP) contendo as versões específicas dos assemblies que seu script precisa. Isso garante que seu script permaneça isolado e estável, mesmo quando o restante do sistema é atualizado.

Após fazer o upload do seu assembly para o App Builder, informe seus scripts para usá-lo adicionando uma diretiva de referência no topo do seu código (veja a seção Como criar um plugin C#).

Como criar um plugin C# no App Builder

Para criar um plugin C# no App Builder, siga estas etapas:

1. No servidor onde você deseja usar seu script, navegue até IDE > Configurações Adicionais.

2. Clique em Plugins.

3. O painel Assemblies lista os assemblies existentes. Se o assembly que você precisa já existir, selecione-o e passe para a Etapa 4. Se não existir, siga estas etapas para criá-lo:

4. Clique em + Assembly. Uma caixa de diálogo é aberta:

   ![Assembly creation dialog](/_download/images/app-builder/ide/assembly-creation-dialog.png){.z50}
   

5. Preencha os seguintes campos:

   -   **Nome:** Insira um nome para a nova assembly.
   
   -   **Descrição:** (_Opcional_) Insira uma breve descrição da assembly para ajudar outros desenvolvedores.
   
   -   **Tipo:** Selecione uma das opções:
   
       -   **Compilado:** Plugins são compilados como parte de uma assembly .NET.
   
       -   **Scripts:** Plugins são scriptados.
   
   -   **ID da Assembly:** Identificador único da assembly. Este campo é gerado automaticamente pelo App Builder.
   
   -   **Bibliotecas:** Localize e faça o upload do arquivo ZIP contendo quaisquer assemblies ou recursos necessários pelos scripts nesta assembly. O arquivo será extraído para o disco antes que quaisquer plugins sejam executados. Quaisquer assemblies serão registrados automaticamente e estarão disponíveis para os scripts.
   

6. O painel Plugins lista os plugins existentes. Clique em + Plugin para adicionar um novo. Uma caixa de diálogo é aberta:

   ![Plugin creation dialog](/_download/images/app-builder/ide/plugin-creation-dialog.png){.z50}
   

7. Preencha os seguintes campos:

   • Nome: Insira um nome para seu plugin.

   • Descrição: (Opcional) Insira uma breve descrição do plugin para ajudar outros desenvolvedores.

   • Propósito: Selecione um dos propósitos:

     • Padrão

     • Solicitação de Endpoint

     • Resposta de Endpoint

     • Relatório

     • Solicitação Rest

     • Resposta Rest

     • Ação de Linha

     • Ação de Tabela

     • Padrão de UI

     • Validação

     • Visibilidade

   • ID do Plugin: Identificador único do plugin. Este campo é gerado automaticamente pelo App Builder.

8. Clique em Salvar. O App Builder criará o plugin e o painel Script se tornará um campo editável onde você pode inserir seu código C#.

   Se você quiser usar uma biblioteca externa em seu script, é aqui que você a referenciaria usando a diretiva #r (que significa "referência") no topo do seu código. Por exemplo:

   #r "AssemblyName"