Ir para o conteúdo

Atividade de Adicionar Entrada LDAP

Introdução

Uma atividade de Adicionar Entrada LDAP adiciona entradas em um endpoint LDAP e é destinada a ser usada como um alvo para consumir dados em uma operação. Após configurar uma conexão LDAP, você pode configurar quantas atividades LDAP desejar para cada conexão LDAP.

Criar uma atividade LDAP

Uma instância de uma atividade é criada a partir de uma conexão usando um tipo de atividade.

Para criar uma instância de uma atividade, arraste o tipo de atividade para a tela de design ou copie o tipo de atividade e cole-o na tela de design. Para detalhes, veja Criar uma instância de atividade ou ferramenta em Reutilização de componentes.

Uma atividade existente pode ser editada a partir destes locais:

Configurar uma atividade de Adicionar Entrada LDAP

Siga estas etapas para configurar uma atividade de Adicionar Entrada LDAP:

Etapa 1: Insira um nome, selecione a classe estrutural e especifique as configurações

Configuração da atividade de Adicionar Entrada LDAP etapa 1

  • Nome: Insira um nome para identificar a atividade de Adicionar Entrada LDAP. O nome deve ser único para cada atividade de Adicionar Entrada LDAP e não deve conter barras (/) ou dois-pontos (:).

  • Selecionar Classe Estrutural: Esta seção exibe as classes de objetos estruturais disponíveis no endpoint LDAP. Ao reabrir uma configuração de atividade existente, apenas a classe de objeto selecionada é exibida em vez de recarregar toda a lista de classes de objetos.

    • Classe Estrutural Selecionada: Após uma classe de objeto ser selecionada, ela é listada aqui.

    • Pesquisar: Insira o valor de qualquer coluna na caixa de pesquisa para filtrar a lista de classes de objetos. A pesquisa não diferencia maiúsculas de minúsculas. Se as classes de objetos já estiverem exibidas na tabela, os resultados da tabela são filtrados em tempo real a cada tecla pressionada. Para recarregar as classes de objetos do endpoint ao pesquisar, insira os critérios de pesquisa e, em seguida, atualize, conforme descrito abaixo.

    • Atualizar: Clique no ícone de atualizar ou na palavra Atualizar para recarregar as classes de objetos do endpoint LDAP. Isso pode ser útil se você adicionou recentemente classes de objetos ao endpoint LDAP. Esta ação atualiza todos os metadados usados para construir a tabela de classes de objetos exibida na configuração.

    • Selecionando uma Classe Estrutural: Dentro da tabela, clique em qualquer lugar de uma linha para selecionar uma classe de objeto. Apenas uma classe de objeto pode ser selecionada. As informações disponíveis para cada classe de objeto são obtidas do endpoint LDAP:

      • Nome: O nome da classe de objeto do endpoint LDAP.
      • Descrição: A descrição da classe de objeto do endpoint LDAP.

    Dica

    Se a tabela não for preenchida com classes de objetos disponíveis, a conexão LDAP pode não ter sido bem-sucedida. Certifique-se de que está conectado reabrindo a conexão e retestando as credenciais.

  • Continuar em Caso de Erro: Selecione para continuar a execução da atividade se um erro for encontrado para um conjunto de dados em uma solicitação em lote. Se algum erro for encontrado, ele será registrado no log de operações.

  • Salvar e Sair: Se habilitado, clique para salvar a configuração para esta etapa e fechar a configuração da atividade.

  • Próximo: Clique para armazenar temporariamente a configuração para esta etapa e continuar para a próxima etapa. A configuração não será salva até que você clique no botão Concluído na última etapa.

  • Descartar Alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em qualquer etapa. Uma mensagem solicita que você confirme que deseja descartar as alterações.

Etapa 2: Selecionar classe auxiliar

Configuração da atividade LDAP Adicionar Entrada etapa 2

  • Classes de Objetos: Esta seção é usada para selecionar classes de objetos adicionais para definir características adicionais da entrada LDAP. Pelo menos uma classe de objeto auxiliar deve ser selecionada.

    • Classes Auxiliares Disponíveis: Esta coluna exibe classes auxiliares para seleção.

      Nota

      Embora ícones para classes abstratas e estruturais estejam definidos, apenas a seleção de classes auxiliares é suportada.

      • Pesquisar: Insira o valor de qualquer coluna na caixa de pesquisa para filtrar a lista de classes de objetos. A pesquisa não diferencia maiúsculas de minúsculas. Se as classes de objetos já estiverem exibidas na tabela, os resultados da tabela são filtrados em tempo real a cada tecla pressionada. Para recarregar classes de objetos do endpoint ao pesquisar, insira os critérios de pesquisa e, em seguida, atualize, conforme descrito abaixo.

      • Atualizar: Clique no ícone de atualizar para recarregar classes de objetos do endpoint LDAP. Isso pode ser útil se você adicionou recentemente classes de objetos ao endpoint LDAP.

      • Adicionar uma Classe Auxiliar: Dentro da coluna, clique em qualquer lugar em uma linha para selecionar uma ou mais classes de objetos. Em seguida, clique no ícone de adicionar para adicionar as classes selecionadas à coluna Classes Auxiliares Selecionadas.

    • Classes Auxiliares Selecionadas: Esta coluna exibe classes auxiliares selecionadas.

      • Remover uma Classe Auxiliar: Dentro da coluna, clique em qualquer lugar em uma linha para selecionar uma ou mais classes de objetos. Em seguida, clique no ícone de remover para retornar as classes selecionadas à coluna Classes Auxiliares Disponíveis.

  • Voltar: Clique para armazenar temporariamente a configuração para esta etapa e retornar à etapa anterior.

  • Próximo: Clique para armazenar temporariamente a configuração para esta etapa e continuar para a próxima etapa. A configuração não será salva até que você clique no botão Concluído na última etapa.

  • Descartar Alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em qualquer etapa. Uma mensagem solicita que você confirme que deseja descartar as alterações.

Etapa 3: Revisar os esquemas de dados

Configuração da atividade LDAP Adicionar Entrada etapa 3

  • Esquema de Dados: Os esquemas de dados de solicitação e resposta para LDAP são exibidos. Se a operação usar uma transformação, os esquemas de dados serão exibidos novamente mais tarde durante o processo de mapeamento de transformação, onde você pode mapear para campos de destino usando objetos de origem, scripts, variáveis, valores personalizados e mais.

    O conector LDAP utiliza a API LDAP do Apache Directory versão 1.0.1. Esta API suporta todos os tipos de servidores LDAP, não apenas o ApacheDS. Consulte a Documentação da API LDAP do Apache 1.0.1 e a documentação sobre o servidor LDAP específico para informações sobre os campos do esquema.

    Estes são os campos do esquema mostrados na captura de tela de exemplo acima:

    • Solicitação:

      Campo/Nó do Esquema de Solicitação Notas
      json O formato do esquema de solicitação
      addEntryRequest A solicitação da Linguagem de Marcação de Serviços de Diretório (DSML)
      item Uma entrada LDAP
      dn O nome distinto representando uma posição em uma hierarquia
      attributes Atributos da entrada LDAP
      supportedAlgorithms Algoritmos suportados
      item O item do algoritmo suportado
      #text Valor do item do algoritmo suportado
      userPassword Senha do usuário
      item O item da senha do usuário
      #text Valor do item da senha do usuário

    • Resposta:

      Campo/Nó do Esquema de Resposta Notas
      json O formato do esquema de resposta
      addEntryResponse A resposta do servidor LDAP
      item O item de resposta
      success Um booleano indicando se a solicitação foi bem-sucedida
      errorDetails Os detalhes do erro
      errorMsg Uma mensagem de erro retornada pelo servidor LDAP

  • Atualizar: Clique no ícone de atualizar ou na palavra Atualizar para regenerar esquemas do endpoint LDAP. Esta ação também regenera o esquema em outros locais ao longo do projeto onde o mesmo esquema é referenciado, como em uma transformação adjacente.

  • Voltar: Clique para armazenar temporariamente a configuração para esta etapa e retornar à etapa anterior.

  • Concluído: Clique para salvar a configuração de todas as etapas e fechar a configuração da atividade.

  • Descartar Alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em qualquer etapa. Uma mensagem pede para você confirmar que deseja descartar as alterações.

Próximas etapas

Após configurar uma atividade de Adicionar Entrada LDAP, complete a configuração da operação adicionando e configurando outras atividades ou ferramentas como etapas da operação. Você também pode configurar as configurações da operação, que incluem a capacidade de encadear operações que estão no mesmo ou em diferentes fluxos de trabalho.

Após a criação de uma atividade LDAP, as ações do menu para essa atividade estão acessíveis no painel do projeto nas abas Workflows ou Components, e a partir da tela de design. Veja o menu de ações da atividade para mais detalhes.

As atividades LDAP Add Entry podem ser usadas como um alvo com estes padrões de operação:

Outros padrões não são válidos usando atividades LDAP Add Entry. Veja os padrões de validação na página de Validade da operação.

Para usar a atividade com funções de script, escreva os dados em um local temporário e, em seguida, use esse local temporário na função de script.

Quando estiver pronto, implante e execute a operação e valide o comportamento verificando os logs da operação.