Ir para o conteúdo

Atividade de Pesquisa de Entrada LDAP

Introdução

Uma atividade de Pesquisa de Entrada LDAP retorna entradas em um endpoint LDAP e é destinada a ser usada como uma fonte para fornecer dados a 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 Pesquisa de Entrada LDAP

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

Etapa 1: Insira um nome e selecione uma classe estrutural

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

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

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

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

    • Pesquisar: Insira o valor de qualquer coluna na caixa de pesquisa para filtrar a lista de classes estruturais. A pesquisa não diferencia maiúsculas de minúsculas. Se as classes estruturais já estiverem exibidas na tabela, os resultados da tabela são filtrados em tempo real a cada tecla pressionada. Para recarregar as classes estruturais 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 estruturais do endpoint LDAP. Isso pode ser útil se você adicionou recentemente classes estruturais ao endpoint LDAP. Esta ação atualiza todos os metadados usados para construir a tabela de classes estruturais exibidas na configuração.

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

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

    Dica

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

  • 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 pede para você confirmar que deseja descartar as alterações.

Etapa 2: Selecionar classes auxiliares

Configuração da atividade de Pesquisa LDAP etapa 2

  • Classes de Objetos: Esta seção é usada para restringir ainda mais a pesquisa selecionando classes auxiliares. Esta seção é opcional e pode ser pulada selecionando Próximo.

    • Classes Auxiliares Disponíveis: Esta coluna exibe classes auxiliares para selecionar.

      • Pesquisar: Insira o valor de qualquer coluna na caixa de pesquisa para filtrar a lista de classes auxiliares. 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 auxiliares 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 auxiliares do endpoint LDAP. Isso pode ser útil se você adicionou recentemente classes auxiliares ao endpoint LDAP.

      • Adicionar uma Classe Auxiliar: Dentro da coluna, clique em qualquer lugar em uma linha para selecionar uma ou mais classes auxiliares. 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 auxiliares. 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 pede para você confirmar que deseja descartar as alterações.

Etapa 3: Especificar configurações

Configuração da atividade de Pesquisa LDAP etapa 3

Dica

Campos com um ícone de variável suportam o uso de variáveis globais, variáveis de projeto e variáveis Jitterbit. Comece digitando um colchete aberto [ no campo ou clicando no ícone de variável para exibir uma lista das variáveis existentes para escolher.

  • Base DN: Insira o nome distinto base a ser usado como ponto de partida para a pesquisa.

  • Atributos Disponíveis: Esta coluna exibe os atributos para selecionar.

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

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

    • Adicionar um Atributo: Dentro da coluna, clique duas vezes em qualquer lugar de uma linha para adicionar o atributo à coluna Expressão de Filtro à direita. Em seguida, edite a Expressão de Filtro conforme necessário para criar uma expressão válida.

  • Expressão de Filtro: Insira uma expressão de filtro.

    No mínimo, a expressão de filtro deve incluir a classe estrutural pré-populada selecionada em Passo 1: Insira um nome e selecione uma classe estrutural. Ao alterar a classe estrutural selecionada no passo 1, a expressão de filtro existente é substituída completamente pela nova classe estrutural pré-populada.

    Você pode adicionar atributos e outros filtros conforme documentado em tipos de filtro LDAP. Incluir classes de objetos estruturais adicionais não é suportado.

    Nota

    Dependendo dos requisitos do endpoint LDAP, pode ser necessário alterar a capitalização da expressão de filtro pré-populada para a classe estrutural. Por exemplo, alterar ObjectClass para objectClass.

  • Escopo: Especifique o escopo a ser usado para a pesquisa, um dos Objeto (Base), Um Nível, ou Subárvore:

    • Objeto (Base): Apenas a entrada especificada no campo Base DN será pesquisada, não incluindo subordinados.

    • Um Nível: Apenas os filhos imediatos da entrada especificada no campo Base DN serão pesquisados, não incluindo a entrada Base DN em si.

    • Subárvore: A entrada especificada no campo Base DN e todos os seus subordinados a qualquer profundidade serão pesquisados.

  • Tamanho da Página: Insira o número de registros a serem retornados para cada solicitação. A atividade envia quantas solicitações forem necessárias para retornar todos os registros. Este parâmetro pode ser limitado pelo limite de tamanho configurado no servidor LDAP específico.

  • Voltar: Clique para armazenar temporariamente a configuração para este passo e retornar ao passo anterior.

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

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

Etapa 4: Revisar os esquemas de dados

Configuração da atividade de Pesquisa LDAP passo 4

  • Esquema de Dados: O esquema de dados de resposta para uma atividade de Pesquisa LDAP é exibido. 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 Apache Directory LDAP API versão 1.0.1. Esta API suporta todos os tipos de servidores LDAP, não apenas o ApacheDS. Consulte a Documentação da Apache LDAP API 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 do exemplo acima:

    Campo/Nó do Esquema de Resposta Notas
    json O formato do esquema de resposta
    searchResponse A resposta de pesquisa da Linguagem de Marcação de Serviços de Diretório (DSML)
    entries Entradas LDAP, cada uma contendo um nome distinto (dn) e uma lista de atributos
    item Uma entrada LDAP
    ObjectClass Uma definição de classe de objeto
    item O item da classe de objeto
    #text Valor do item da classe de objeto
    dn O nome distinto representando uma posição em uma hierarquia
    attributes Os atributos LDAP
    userPassword A senha do usuário
    item O item da senha do usuário
    #text Valor do item da senha do usuário

  • 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.

  • Editar: Clique no ícone de editar acima do esquema de dados de resposta para entrar no editor. O editor permite adicionar, excluir e reorganizar nós e campos e alterar seus tipos de dados. Todos os nós e campos recém-adicionados são definidos como [0, 1] cardinalidade. As alterações feitas no esquema de dados de resposta devem ser aceitáveis para o endpoint e devem ser feitas apenas após consultar qualquer documentação disponível para o endpoint. Após fazer edições no esquema, uma data de última edição é exibida na parte superior do esquema aplicável para indicar que o esquema teve edições manuais. Atualizar o esquema irá redefinir o esquema para sua estrutura padrão.

  • 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 que você confirme que deseja descartar as alterações.

Próximas etapas

Após configurar uma atividade de Entrada de Pesquisa 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 uma atividade LDAP ter sido criada, as ações do menu para essa atividade estão acessíveis no painel do projeto nas abas Fluxos de Trabalho ou Componentes, e no canvas de design. Veja Menu de ações da atividade para detalhes.

As atividades de Entrada de Pesquisa LDAP podem ser usadas como uma fonte com esses padrões de operação:

Outros padrões não são válidos usando atividades de Entrada de Pesquisa LDAP. 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.