Ir para o conteúdo

Atividade de Entrada de Pesquisa LDAP

Introdução

Uma atividade de entrada de pesquisa LDAP retorna entradas em um endpoint LDAP e deve ser usada como uma fonte para fornecer dados para 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:

Configurar uma Atividade de Entrada de Pesquisa LDAP

Siga estas etapas para configurar uma atividade de entrada de pesquisa LDAP:

Etapa 1: Insira um Nome e Selecione a Classe Estrutural

Etapa 1 da configuração da atividade de entrada de pesquisa LDAP

  • Nome: Digite um nome a ser usado 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. Quando reabrindo 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: Depois que uma classe estrutural é selecionada, ela é listada aqui.

    • Pesquisar: Digite qualquer parte do nome da classe estrutural na caixa de pesquisa para filtrar a lista de classes estruturais. A busca não diferencia maiúsculas de minúsculas. Se as classes estruturais já forem exibidas dentro a tabela, os resultados da tabela são filtrados em tempo real com cada pressionamento de tecla. Para recarregar classes estruturais no endpoint ao pesquisar, insira os critérios de pesquisa e atualize, conforme descrito abaixo.

    • Atualizar: Clique no ícone de atualização Ícone de atualização ou a palavra Atualizar para recarregue as classes estruturais do endpoint LDAP. Isso pode ser útil se você adicionou recentemente classes estruturais para o endpoint LDAP. Esta ação atualiza todos os metadados usados para construir o 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 é buscada no 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 as classes estruturais 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.

  • 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 as Classes Auxiliares

Etapa 2 da configuração da atividade de entrada de pesquisa LDAP

  • Classes de Objetos: Esta seção é usada para restringir ainda mais a pesquisa selecionando classes auxiliares. Esse a seção é opcional e pode ser ignorada selecionando Next.

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

      • Pesquisar: Digite qualquer parte do nome da classe auxiliar na caixa de pesquisa para filtrar a lista de auxiliares aulas. A busca não diferencia maiúsculas de minúsculas. Se as classes de objeto já estiverem exibidas na tabela, a tabela os resultados são filtrados em tempo real com cada pressionamento de tecla. Para recarregar classes auxiliares do endpoint quando pesquisar, insira os critérios de pesquisa e atualize, conforme descrito abaixo.

      • Atualizar: Clique no ícone de atualização Ícone de atualização para recarregar classes auxiliares do endpoint LDAP. Isso pode ser útil se você tiver adicionado recentemente classes auxiliares ao endpoint LDAP.

      • Adicionando uma classe auxiliar: Dentro da coluna, clique em qualquer lugar em uma linha para selecionar um ou mais auxiliares aulas. Em seguida, clique no ícone adicionar para adicionar as classes selecionadas à coluna Selected Auxiliary Class:

        Adicionar ícone

    • 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 auxiliares aulas. Em seguida, clique no ícone remover para retornar as aulas selecionadas à coluna Available Auxiliary Classes:

        Remover ícone

  • 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: Especifique as Configurações

Etapa 3 da configuração da atividade de entrada de pesquisa LDAP

Dica

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

  • Base DN: Digite o nome distinto base para usar como ponto de partida para a pesquisa.

  • Atributos disponíveis: Esta coluna exibe atributos para seleção.

    • Pesquisar: Digite qualquer parte do nome do atributo na caixa de pesquisa para filtrar a lista de atributos. O a pesquisa não diferencia maiúsculas de minúsculas. Se os atributos já forem exibidos na tabela, os resultados da tabela serão filtrado em tempo real com cada pressionamento de tecla. Para recarregar atributos do endpoint ao pesquisar, digite search critérios e atualize, conforme descrito abaixo.

    • Atualizar: Clique no ícone de atualização Ícone de atualização para recarregar os atributos do endpoint LDAP. Isso pode ser útil se você tiver adicionado recentemente atributos ao endpoint LDAP.

    • Adicionando um atributo: Dentro da coluna, clique duas vezes em qualquer lugar em uma linha para adicionar o atributo à coluna Filter Expression à direita. Em seguida, edite Filter Expression conforme necessário para criar um válido expressão.

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

    No mínimo, a expressão de filtro deve incluir a classe estrutural pré-preenchida selecionada em Etapa 1: Digite um nome e selecione uma classe estrutural. Ao alterar a classe estrutural selecionada na etapa 1, a expressão de filtro existente é totalmente substituída pela classe estrutural pré-preenchida recentemente.

    Você pode adicionar atributos e outros filtros conforme documentado em Tipos de filtro LDAP. A inclusão de classes de objetos estruturais adicionais não é suportada.

    Nota

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

  • Scope: Especifique o escopo a ser usado para a pesquisa, um de Object (Base), One Level ou Subtree:

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

    • Um nível: Somente os filhos imediatos da entrada especificada no campo Base DN serão pesquisados, não incluindo a própria entrada Base DN.

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

  • Tamanho da página: Informe a quantidade de registros a serem retornados para cada requisição. A atividade envia tantos pedidos quanto necessário 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 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 4: Revisar os Esquemas de Dados

Etapa 4 da configuração da atividade de entrada de pesquisa LDAP

  • Esquema de dados: O esquema de dados de resposta para uma atividade de entrada de pesquisa LDAP é exibido. 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:

    Campo/nó do esquema de resposta Notas
    json O formato do esquema de resposta
    resposta de pesquisa A resposta de pesquisa DSML (Directory Services Markup Language)
    entradas Entradas LDAP, cada uma contendo um nome distinto (dn) e uma lista de atributos
    item Uma entrada LDAP
    ClasseObjeto Uma definição de classe de objeto
    item O item de classe de objeto
    #texto Valor do item da classe de objeto
    dn O nome distinto que representa uma posição em uma hierarquia
    atributos Os atributos LDAP
    senha do usuário A senha do usuário
    item O item de senha do usuário
    #texto Valor do item senha do usuário

  • Atualizar: Clique no ícone de atualização Í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 em todo o projeto onde o mesmo esquema é referenciado, como em uma transformação adjacente.

  • Editar: Clique no ícone de edição Editar ícone 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 somente após consultar qualquer documentação disponível para o endpoint.

  • 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 de entrada de pesquisa LDAP, conclua a configuração da operação adicionando e configurar outras atividades, transformações ou scripts como etapas da operação. Você também pode configurar uma operação configurações de operação, que incluem a capacidade de encadear operações que estão no mesmo ou em diferentes workflows.

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 entrada de pesquisa LDAP podem ser usadas como uma fonte com estes 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 no Validade da Operação página.

Um caso de uso típico é usar uma atividade de entrada de pesquisa LDAP no Padrão de duas transformações. Neste exemplo, o primeira transformação (LDAP Search Entry Request) cria uma estrutura de solicitação que é passada para o LDAP Search Atividade de entrada. A segunda transformação (LDAP Search Entry Response) recebe a estrutura de resposta, que é em seguida, gravado em uma variável por uma atividade Variable Write (Write LDAP Search Entry Response) e uma mensagem é então registrado pelo script Write to Operation Log:

operação de entrada de pesquisa LDAP

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.