Ir para o conteúdo

Transforme as suas conexões em um bônus de fim de ano com o nosso novo Programa de Indicação de Clientes! Saiba mais

✕

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 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 quadro de design ou copie o tipo de atividade e cole-o na quadro de design. Para obter detalhes, consulte 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 entrada de pesquisa LDAP

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

Etapa 1: insira um nome e selecione uma classe estrutural

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

  • Nome: Insira um nome para identificar a atividade de entrada de pesquisa LDAP. O nome deve ser exclusivo. 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 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: Depois que uma classe estrutural é 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 dentro a tabela, os resultados da tabela são filtrados em tempo real a 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 ou a palavra Atualizar para recarregar 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 a classe estrutural é obtida 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 ser bem-sucedida. Certifique-se de estar conectado reabrindo a conexão e testando as credenciais novamente.

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

  • Próximo: Clique para armazenar temporariamente a configuração desta etapa e prosseguir para a próxima. 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 nenhuma etapa. Uma mensagem solicitará que você confirme se deseja descartar as alterações.

Etapa 2: Selecione 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 busca, selecionando classes auxiliares. A seção é opcional e pode ser ignorada selecionando Avançar.

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

      • Pesquisar: Insira o valor de qualquer coluna na caixa de pesquisa para filtrar a lista de auxiliares classes. A pesquisa 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 a cada pressionamento de tecla. Para recarregar classes auxiliares do endpoint quando pesquisando, 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ê adicionou classes auxiliares ao endpoint LDAP recentemente.

      • Adicionando uma classe auxiliar: Dentro da coluna, clique em qualquer lugar em uma linha para selecionar uma ou mais classes auxiliares aulas. Em seguida, clique no ícone adicionar para adicionar classes selecionadas à coluna Classes Auxiliares Selecionadas.

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

      • Removendo uma Classe Auxiliar: Dentro da coluna, clique em qualquer lugar de uma linha para selecionar uma ou mais classes auxiliares. Em seguida, clique no ícone de remoção para retornar as classes selecionadas à coluna Classes Auxiliares Disponíveis.

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

  • Próximo: Clique para armazenar temporariamente a configuração desta etapa e prosseguir para a próxima. 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 nenhuma etapa. Uma mensagem solicitará que você confirme se 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 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.

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

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

    • 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 serão filtrado em tempo real a cada pressionamento de tecla. Para recarregar atributos do endpoint durante a pesquisa, digite search critérios e depois atualize, conforme descrito abaixo.

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

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

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

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

    Você pode adicionar atributos e outros filtros conforme documentado em Tipos de filtros 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 a caixa da expressão de filtro pré-preenchida para a classe estrutural. Por exemplo, altere ObjectClass para objectClass.

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

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

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

    • Subárvore: A entrada especificada no campo DN base e todos os seus subordinados em 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. 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.

  • Próximo: Clique para armazenar temporariamente a configuração desta etapa e prosseguir para a próxima. 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 nenhuma passo. Uma mensagem solicita que você confirme se deseja descartar as alterações.

Etapa 4: Revise 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 da 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 API do Apache Directory versão 1.0.1. Esta API suporta todos os tipos de servidores LDAP, não apenas o ApacheDS. Consulte o Documentação da API LDAP do Apache 1.0.1 e documentação no servidor LDAP específico para obter informações sobre os campos de 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
    searchResponse A resposta de pesquisa da Linguagem de Marcação de Serviços de Diretório (DSML)
    entradas 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 A classe de objeto item
    #texto Valor do item da classe de objeto
    dn O nome distinto que representa uma posição em uma hierarquia
    atributos Os atributos LDAP
    userPassword A senha do usuário
    item O item de senha do usuário
    #texto Valor do item de senha do usuário

  • Atualizar: Clique no ícone de atualização ou a palavra Atualizar para regenera 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 acima do esquema de dados de resposta para entrar no editor. O editor permite adicionar, excluir e reorganizar nós e campos, além de 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 consulta à documentação disponível para o endpoint. Após fazer edições no esquema, a data da última edição é exibida na parte superior do esquema aplicável para indicar que o esquema passou por edições manuais. Atualizar o esquema o redefinirá para sua estrutura padrão.

  • 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 nenhuma passo. Uma mensagem solicita que você confirme se deseja descartar as alterações.

Próximos passos

Após configurar uma atividade de entrada de pesquisa LDAP, conclua a configuração da operação adicionando e configurando outras atividades ou ferramentas 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 do menu para essa atividade ficam acessíveis no painel do projeto nas guias Workflows ou Componentes e na quadro de design. Veja menu de ações da atividade para mais 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. Consulte os padrões de validação na página Validade da operação página.

Para usar a atividade com funções de script, grave os dados em um local temporário e use esse local temporário 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.