Ir para o conteúdo

Use Origens e Destinos LDAP em uma Transformação

LDAP Como Fonte

O mapeamento de uma origem LDAP é semelhante ao mapeamento de XML, banco de dados ou qualquer outro tipo de origem no Jitterbit. Você pode arrastar e soltar dos atributos de origem para o destino. Você pode usar condições, várias pastas, qualquer função de transformação, etc.

ldapmappingimage01

Você pode carregar dados de origem de seu servidor LDAP se não tiver certeza do que determinados atributos representam. Ao testar uma transformação e o LDAP é o destino, o Jitterbit na verdade não grava no servidor LDAP. Ele apenas exibe quais dados seriam enviados para o servidor LDAP. Para afetar os dados no LDAP, você precisará testar a operação ou executar a operação.

LDAP Como Destino

Existem algumas características exclusivas para usar o LDAP como destino.

Para explicá-los, é útil entender as funções que o Harmony possui disponível para acessar o LDAP:

  • LDAPadd: para adicionar objetos, atributos e valores ao Servidor LDAP.

  • LDAPDeleteEntry: para excluir entradas do diretório. Por exemplo, exclua um usuário ou um computador.

  • LDAPRemove: para remover um atributo.

  • LDAPRenome: para renomear uma entrada. Este é o mesmo que o comando Mod RDN.

  • LDAPReplace: para substituir/atualizar um valor de atributo.

Esses são os métodos fornecidos pelo protocolo LDAP baseado em padrões. Assim, quando você mapear para um destino LDAP, o seguinte será executado:

Cada objeto LDAP possui um Nome Distinto (DN) exclusivo. Ao mapear um valor para o DN da classe de objeto, se o objeto existir, o Jitterbit executará uma série de instruções de substituição do LDAP. Ele executará uma adição de LDAP para todos os atributos que não existiam no objeto, mesmo que o objeto já existisse.

Se o DN não existir, o Jitterbit adiciona o objeto e seus atributos mapeados.

Você também pode definir explicitamente o Comando de entrada. Isso instruirá o Jitterbit a executar o comando especificado de forma estática ou dinâmica por meio de uma fórmula. Comando de entrada incluem:

  • Adicionar: para adicionar uma entrada

  • Atualizar: para substituir valores de atributos em uma entrada. Isso é análogo a uma atualização de banco de dados, portanto, se o DN não existir, nada acontecerá.

  • Remover: para excluir uma entrada do LDAP.

ldapmappingimage01

O LDAP possui atributos que podem incluir vários valores. No exemplo acima, DepartmentNumber é um atributo de vários valores. Para atributos de vários valores, o Jitterbit permite executar estas operações:

  • Remover Atributo: Se você mapear um valor para o atributo "Valor Antigo" apenas o valor com este atributo será excluído. Se você não mapear nada para "Valor antigo", todas as instâncias do atributo serão removidas.

  • Atualizar atributo: Atualize um atributo específico. Você precisa especificar o valor antigo a ser removido.

  • Attribute Replace All: remove todos os atributos existentes e os substitui pelos valores que foram mapeados para este atributo.

Se Substituir tudo for selecionado, o Jitterbit não removerá os valores antigos, a menos que haja novos valores para substituí-los. Se você realmente deseja remover todos os valores antigos e substituí-los por novos - mesmo que não esteja criando novos valores - você precisa criar uma cópia do nó e selecionar Remover Atributo na cópia e Substituir Tudo no original ( ou o contrário, não importa).

Atributos de valor único, como displayName no exemplo acima, são mais diretos. Jitterbit só permite executar as seguintes operações:

  • Remover Atributo: Remove este atributo. Nenhum valor antigo precisa ser especificado para atributos de instância única.

  • Atualizar atributo: atualiza o atributo e descarta o valor antigo.

Quando o Jitterbit executa o LDAP como destino, o Jitterbit executará os comandos LDAP necessários para criar/atualizar o destino. Se a API LDAP relatar erros, eles serão relatados junto com as modificações que foram tentadas.