Atividade de entrada de pesquisa LDAP

Introdução

Uma atividade de entrada de pesquisa LDAP retorna entradas em um endpoint LDAP e se destina a 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 Criando uma instância de atividade em Reutilização de componentes.

Uma atividade existente pode ser editada a partir destes locais:

A quadro de design (veja menu de ações do componente em Tela de design).
A aba Componentes do painel do projeto (consulte menu de ações do componente na aba Componentes do painel Projeto).

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 2: Selecione classes auxiliares
Etapa 3: Especifique as configurações
Etapa 4: Revise os esquemas de dados

Etapa 1: insira um nome e selecione uma classe estrutural

Nome: Insira um nome para usar 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 reabrindo uma configuração de atividade existente, somente 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 com cada pressionamento de tecla. Para recarregar classes estruturais a partir do 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: Na 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-sucedido. Certifique-se de que você esteja 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 nenhuma etapa. Uma mensagem solicita que você confirme que deseja descartar as alterações.

Etapa 2: Selecione classes auxiliares

Classes de Objetos: Esta seção é usada para restringir ainda mais a busca selecionando classes auxiliares. Isto 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 para recarregar classes auxiliares do endpoint LDAP. Isso pode ser útil se você adicionou recentemente classes auxiliares ao endpoint LDAP.
  - Adicionando uma classe auxiliar: Dentro da coluna, clique em qualquer lugar em uma linha para selecionar uma ou mais classes auxiliares. classes. Em seguida, clique no ícone adicionar para adicionar classes selecionadas à coluna Selected Auxiliary Classes:
- 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 uma ou mais classes auxiliares. Em seguida, clique no ícone remover para retornar as classes selecionadas para a 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 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 nenhuma etapa. Uma mensagem solicita que você confirme que deseja descartar as alterações.

Etapa 3: especifique as configurações

Dica

Campos com um í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 de 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 qualquer valor de coluna 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á estiverem 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 depois atualizar, conforme descrito abaixo.
- Atualizar: Clique no í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 de filtro existente é substituída integralmente pela classe estrutural recém-preenchida.

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 o caso 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 de 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 entrada Base DN em si.
- 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 para esta etapa e continuar para a 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 nenhuma passo. Uma mensagem pede para você confirmar que deseja descartar as alterações.

Etapa 4: Revise os esquemas de dados

Data Schema: O esquema de dados de resposta para uma atividade LDAP Search Entry é 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 LDAP do Apache Directory versão 1.0.1. Esta API suporta todos os tipos de servidores LDAP, não apenas ApacheDS. Consulte o Documentação da API Apache LDAP 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 Directory Services Markup Language (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 que você adicione, exclua e reorganize nós e campos e altere 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 nenhuma passo. Uma mensagem pede para você confirmar que 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, transformações ou scripts como etapas de 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 para essa atividade ficam acessíveis do painel do projeto nas guias Workflows ou Components e na quadro de design. Veja menu de ações de atividade para mais detalhes.

As atividades de entrada de pesquisa LDAP podem ser usadas como uma fonte com estes padrões de operação:

Padrão de Transformação
Padrão de arquivo de dois alvos (apenas como primeira fonte)
Padrão de arquivo HTTP de dois alvos (apenas como primeira fonte)
Padrão de duas transformações (como primeira ou segunda fonte)

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.

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.