Atividade de Adição de Entrada do LDAP¶
Introdução¶
Uma atividade LDAP Add Entry adiciona entradas em um endpoint LDAP e deve ser usada como um destino para consumir dados em uma operação. Depois de configurar uma conexão LDAP, você pode configurar quantas atividades LDAP quiser 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 quadro de design ou copie o tipo de atividade e cole-o na quadro de design. Para obter detalhes, consulte Criando uma instância de atividade em Reutilização de componente.
Uma atividade existente pode ser editada a partir destes locais:
- A quadro de design (consulte Menu de ações do componente em Quadro de Design).
- A aba Componentes do painel do projeto (consulte Menu de ações do componente na Guia Componentes do painel do projeto).
Configurar uma Atividade de Adição de Entrada do LDAP¶
Siga estas etapas para configurar uma atividade Adicionar entrada LDAP:
- Etapa 1: Insira um nome, selecione a classe estrutural e especifique as configurações
- Etapa 2: Selecione a Classe Auxiliar
- Etapa 3: Revise os Esquemas de Dados
Etapa 1: Insira um Nome, Selecione a Classe Estrutural e Especifique as Configurações¶
-
Nome: Digite um nome a ser usado para identificar a atividade Adicionar entrada LDAP. O nome deve ser único para cada atividade de adição de 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. Quando reabrindo uma configuração de atividade existente, apenas a classe de objeto selecionada é exibida em vez de recarregar o lista inteira de classes de objetos.
-
Classe estrutural selecionada: Depois que uma classe de objeto é selecionada, ela é listada aqui.
-
Pesquisar: Digite qualquer parte do nome da classe do objeto na caixa de pesquisa para filtrar a lista de classes de objetos. A busca não diferencia maiúsculas de minúsculas. Se as classes de objeto já forem exibidas dentro a tabela, os resultados da tabela são filtrados em tempo real com cada pressionamento de tecla. Para recarregar classes de objeto no endpoint ao pesquisar, insira os critérios de pesquisa e atualize, conforme descrito abaixo.
-
Atualizar: Clique no ícone de atualização
ou a palavra Atualizar para recarregue as classes de objeto do endpoint LDAP. Isso pode ser útil se você adicionou recentemente classes de objeto para o endpoint LDAP. Esta ação atualiza todos os metadados usados para construir o tabela de classes de objetos exibidas na configuração.
-
Selecionando uma Classe Estrutural: Dentro da tabela, clique em qualquer lugar em uma linha para selecionar uma classe de objeto. Apenas uma classe de objeto pode ser selecionada. As informações disponíveis para cada a classe de objeto é obtida 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 as classes de objetos disponíveis, a conexão LDAP pode não ser bem-sucedido. Verifique se você está conectado reabrindo a conexão e testando novamente as credenciais.
-
-
Continue on Error: 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á gravado no log de operação.
-
Save & Exit: Se ativado, clique para salvar a configuração desta etapa e fechar a configuração da atividade.
-
Avançar: Clique para armazenar temporariamente a configuração desta etapa e continuar na próxima etapa. O 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 as alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhum passo. Uma mensagem solicita que você confirme que deseja descartar as alterações.
Passo 2: Selecione Classe Auxiliar¶
-
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 sejam definidos, apenas a seleção de classe auxiliar é suportada.
-
Pesquisar: Digite qualquer parte do nome da classe de objeto na caixa de pesquisa para filtrar a lista de classes de objeto. 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 com cada pressionamento de tecla. Para recarregar as classes de objeto do endpoint ao pesquisar, insira os critérios de pesquisa e atualize, conforme descrito abaixo.
-
Atualizar: Clique no ícone de atualização
para recarregar classes de objeto de o endpoint LDAP. Isso pode ser útil se você tiver adicionado recentemente classes de objeto ao endpoint LDAP.
-
Adicionando uma Classe Auxiliar: Dentro da coluna, clique em qualquer lugar em uma linha para selecionar um ou mais objetos aulas. Em seguida, clique no ícone adicionar para adicionar as classes selecionadas à coluna Selected Auxiliary Class:
-
-
Classes auxiliares selecionadas: Esta coluna exibe as classes auxiliares selecionadas.
-
Removendo uma Classe Auxiliar: Dentro da coluna, clique em qualquer lugar em uma linha para selecionar um ou mais objetos aulas. Em seguida, clique no ícone remover para retornar as aulas selecionadas à coluna Available Auxiliary Classes:
-
-
-
Voltar: Clique para armazenar temporariamente a configuração desta etapa e retornar à etapa anterior.
-
Avançar: Clique para armazenar temporariamente a configuração desta etapa e continuar na próxima etapa. O 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 as alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhum passo. Uma mensagem solicita que você confirme que deseja descartar as alterações.
Etapa 3: Revisar os Esquemas de Dados¶
-
Esquema de dados: São exibidos os esquemas de dados de solicitação e resposta para LDAP. Se a operação usa uma transformação, os esquemas de dados sã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 muito mais.
O conector LDAP usa a Apache Directory LDAP API versão 1.0.1. esta API suporta todos os tipos de servidores LDAP, não apenas ApacheDS. Consulte o Documentação Apache LDAP API 1.0.1 e documentação no servidor LDAP específico para obter informações sobre os campos do esquema.
Estes são os campos de esquema mostrados na captura de tela de exemplo acima:
-
Pedido:
Campo/nó do esquema de solicitação Notas json O formato do esquema de solicitação addEntryRequest A solicitação DSML (Directory Services Markup Language) item Uma entrada LDAP dn O nome distinto que representa uma posição em uma hierarquia atributos Atributos da entrada LDAP Algoritmos suportados Algoritmos suportados item O item de algoritmo suportado #texto Valor do item de algoritmo suportado senha do usuário Senha do usuário item O item de senha do usuário #texto Valor do item 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 sucesso Um booleano indicando se a solicitação foi bem-sucedida Detalhes do erro Os detalhes do erro mensagem de erro Uma mensagem de erro retornada pelo servidor LDAP
-
-
Atualizar: Clique no ícone de atualização
ou a 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 desta 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 as alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhum passo. Uma mensagem solicita que você confirme que deseja descartar as alterações.
Próximos Passos¶
Depois de configurar uma atividade LDAP Add Entry, conclua a configuração da operação adicionando e configurando outras atividades, transformações ou scripts como etapas da operação. Você também pode configurar a operação de uma operação configurações, que incluem a capacidade de encadear operações que estão no mesmo workflows ou em diferentes.
Após a criação de uma atividade LDAP, as ações de menu dessa atividade ficam acessíveis no painel do projeto nas guias Workflows ou Componentes e na quadro de design. Ver Menu de Ações de Atividade para detalhes.
As atividades de inclusão de entrada do LDAP podem ser usadas como destino com estes padrões de operação:
- Padrão de transformação
- Padrão de duas transformações (como primeiro ou segundo alvo)
Outros padrões não são válidos usando as atividades de inclusão de entrada do LDAP. Veja os padrões de validação no Validade da Operação página.
Um caso de uso típico é usar uma atividade Adicionar entrada LDAP no Padrão de duas transformações. Neste exemplo, o primeira transformação (LDAP Add Entry Request) cria uma estrutura de solicitação que é passada para o LDAP Add Entry atividade. A segunda transformação (LDAP Add Entry Response) recebe a estrutura de resposta, que é então gravada em uma variável por uma atividade Variable Write (Write LDAP Add Entry Response) e uma mensagem é então registrada por o script Write to Operation Log:
Para usar a atividade com funções de script, grave os dados em um local temporário e use esse localização na função de script.
Quando estiver pronto, implantar e execute a operação e valide o comportamento verificando o registros de operação.