4.8 Importando, validando e distribuindo definições da camada de abstração do diretório

Importação, validação e distribuição das definições da camada de abstração do diretório são ações realizadas no modo de aprovisionamento do Designer.

4.8.1 Sobre como importar

O recurso de importação permite que você importe um conjunto de definições. Convém usá-lo quando:

Iniciar um novo projeto com base em um projeto distribuído.
Compartilhar definições com outros desenvolvedores que trabalham no mesmo projeto. Por exemplo, o outro desenvolvedor adiciona um atributo à entidade de usuário ou uma nova lista global. Se o desenvolvedor distribui a nova definição para o cofre de identidade, você poderá importá-la e assim vocês dois trabalharão com definições idênticas.

Para importar definições:

Abra o modo de aprovisionamento.
Determine se deseja importar:
- Um conjunto completo de definições
- Um conjunto de um tipo de definição, como todas as entidades ou todos os relacionamentos.
- Um objeto específico (como a entidade de usuário)
Para importar:
- Um objeto específico, selecione-o na lista, clique o botão direito do mouse e selecione Importar Objeto.
- Um conjunto completo de definições, selecione o nó da Camada de Abstração do Diretório, clique o botão direito do mouse e selecione Importar Tudo ou Importar Objeto.
Clique no ícone de pesquisa do eDirectory e navegue até o nó do Modelo de Diretório e selecione os objetos para a importação e, em seguida, clique em OK.
- Se houver uma correspondência entre os objetos, você será notificado de que não há diferenças e que a importação não prosseguirá.
- Se não houver correspondência, você poderá confirmar quais objetos serão importados. Verifique os itens selecionados para importação, efetue as mudanças necessárias e clique em OK.

Definindo preferências de importação

As preferências de importação permitem que você especifique como deseja que o Designer solucione conflitos entre os dados no cofre de identidade e os arquivos da camada de abstração do diretório local. Esses conflitos podem surgir devido ao acesso de diferentes usuários e ferramentas às definições da camada de abstração do diretório do cofre de identidade. As definições podem ser mudadas por outros administradores ou desenvolvedores com o uso de ferramentas do iManager ou projeto com base em seu próprio Designer. Se ocorrerem conflitos entre as definições no seu sistema de arquivos local e o cofre de identidade, essas preferências permitirão que você especifique como os conflitos serão tratados.

Para definir preferências de importação:

Escolha Janela>Preferências.
Abra o nó de aprovisionamento da árvore e clique em Importar.

Escolha as preferências.

Preferência	Descrição
Objeto externo modificado sobregravará objeto local modificado	As definições do arquivo local e do cofre de identidade contêm mudanças. As mudanças locais ainda não foram distribuídas. Selecione esta opção se quiser que o objeto do cofre de identidade sobregrave as mudanças efetuadas no arquivo local.
Cópia local não modificada sobregravada por objeto recriado externamente	O objeto do cofre de identidade foi apagado e depois recriado. O conjunto de arquivos locais inclui a definição original sem mudanças. Selecione esta opção se quiser que a importação sobregrave a cópia local.
Objeto externo sobregrava objeto local modificado	O arquivo local contém mudanças não distribuídas no cofre de identidade. Selecione esta opção se quiser que os arquivos locais sejam sobregravados durante a importação.
Objeto externo sobregrava objeto local apagado	Você apagou uma definição localmente mas não distribuiu as mudanças. Isso significa que o objeto permanece no cofre de identidade. Selecione esta opção se quiser que os objetos do cofre de identidade sejam copiados para o sistema de arquivos local. Se você escolher esta opção, perderá as mudanças não distribuídas.

4.8.2 Sobre a validação

Você pode validar as definições de dados da camada de abstração do diretório no sistema de arquivos local antes de tentar distribuí-las. A validação:

Verifica se o código XML está bem composto e compatível com o esquema que define os elementos necessários a entidades, atributos, listas, relacionamentos e outros itens.
Verifica em cada entidade se as referências a outras entidades e listas globais são válidas.

Por exemplo, ao validar uma entidade e seus atributos, o validador verifica se todas as referências a outras entidades feitas pelos campos Entidade de Edição, DN Lookup e Entidade de Detalhe fazem referência a entidades que realmente existem.

Verifica se cada entidade tem ao menos um atributo definido.
Garante que toda lista local e global contenha no mínimo um item.

Você valida definições seletivamente no modo de aprovisionamento. Para validar:

Todos os itens de um nó, selecione o nó, clique o botão direito do mouse e selecione Validar.
Um único objeto em um nó, selecione o objeto, clique o botão direito do mouse e selecione Validar.

Para validar todas as definições, clique no botão Validar Camada de Abstração na barra de ferramentas da camada de abstração do diretório.

NOTA:A validação não verifica a existência de objetos no cofre de identidade.

4.8.3 Sobre a distribuição

Você deve distribuir suas definições em um cofre de identidade para ver as mudanças resultantes no aplicativo de usuário do Identity Manager.

Para distribuir um conjunto de definições em um cofre de identidade:

Grave todas as mudanças efetuadas com o editor da camada de abstração do diretório.

Se você não gravar suas mudanças antes de tentar a distribuição, o editor exibirá uma caixa de diálogo com as definições que não foram gravadas. Você será solicitado a gravar as mudanças mais recentes. Caso você não grave as mudanças, o objeto será distribuído no servidor sem as mudanças que não foram gravadas. O fato de você não gravar as mudanças não cancela a distribuição.
Abra o modo de aprovisionamento.
Decida se você deseja distribuir todos os objetos definidos usando o editor da camada de abstração do diretório ou um subconjunto.
- Para distribuir tudo:
  Selecione o nó da raiz, clique o botão direito do mouse e escolha Distribuir Tudo
- Para distribuir uma entidade específica, relacionamentos, listas ou definições de configuração:
  Selecione o item em questão, clique o botão direito do mouse e escolha Distribuir objeto
Você talvez seja solicitado a informar as credenciais do cofre de identidade. O editor executa uma validação e exibe mensagens de validação em uma caixa de diálogo. Para responder às mensagens de validação, marque ou desmarque os itens a serem distribuídos. Depois de fazer suas seleções de distribuição e submetê-las, você será notificado sobre o sucesso ou a falha da distribuição.

Definindo preferências de distribuição

As preferências de distribuição permitem que você especifique como deseja que o Designer solucione conflitos entre os dados no cofre de identidade e os arquivos da camada de abstração do diretório local. Conflitos podem ocorrer quando outros usuários distribuem mudanças no cofre de identidade, e essas mudanças não são refletidas nas definições do sistema de arquivos local. Para que esses conflitos sejam tratados da forma que você deseja, defina preferências sobre a resolução do conflito.

Para definir preferências de distribuição:

Escolha Janela>Preferências.
Abra o nó de aprovisionamento da árvore e clique em Distribuir.

Especifique preferências gerais de distribuição:

Preferência	Descrição
Defina que a ação padrão de todas as caixas de diálogo “Confirmar Exclusão” seja apagar do cofre de identidade	Se você tentar apagar um objeto no modo de aprovisionamento ou no editor da camada de abstração do diretório, terá que confirmar a exclusão com uma caixa de diálogo semelhante a esta: Esta preferência determina se a caixa de confirmação de exclusão Apagar objeto do cofre de identidade ao distribuir será selecionada por padrão. Essa preferência indica que a ação padrão é apagar o objeto do cofre de identidade. O objeto local é sempre apagado.
Permitir as distribuições de objetos com erros de validação	Marcada — Selecione esta opção se quiser distribuir objetos que não passam na validação. O designer valida as definições que estão sendo distribuídas de acordo com as regras descritas na Seção 4.8, Importando, validando e distribuindo definições da camada de abstração do diretório. Desmarcada — Para impedir a distribuição de definições que não passam na validação.
Permitir a distribuição de objetos não modificados que sobregravarão uma versão mais recente modificada externamente	Marcada — Se seus arquivos locais não foram mudados, mas os objetos do cofre de identidade foram. Se desejar que os arquivos locais sobregravem os arquivos do cofre de identidade, selecione esta preferência. Desmarcada — Se quiser manter as versões mais recentes do cofre de identidade. Quando marcada, você pode definir o comportamento padrão selecionando a preferência de resolução de conflito Cópia local não modificada sobregrava versão mais recente modificada externamente.

Preferência

Descrição

Defina que a ação padrão de todas as caixas de diálogo “Confirmar Exclusão” seja apagar do cofre de identidade

Se você tentar apagar um objeto no modo de aprovisionamento ou no editor da camada de abstração do diretório, terá que confirmar a exclusão com uma caixa de diálogo semelhante a esta:

Esta preferência determina se a caixa de confirmação de exclusão Apagar objeto do cofre de identidade ao distribuir será selecionada por padrão. Essa preferência indica que a ação padrão é apagar o objeto do cofre de identidade.

O objeto local é sempre apagado.

Permitir as distribuições de objetos com erros de validação

Marcada — Selecione esta opção se quiser distribuir objetos que não passam na validação. O designer valida as definições que estão sendo distribuídas de acordo com as regras descritas na Seção 4.8, Importando, validando e distribuindo definições da camada de abstração do diretório.

Desmarcada — Para impedir a distribuição de definições que não passam na validação.

Permitir a distribuição de objetos não modificados que sobregravarão uma versão mais recente modificada externamente

Marcada — Se seus arquivos locais não foram mudados, mas os objetos do cofre de identidade foram. Se desejar que os arquivos locais sobregravem os arquivos do cofre de identidade, selecione esta preferência.

Desmarcada — Se quiser manter as versões mais recentes do cofre de identidade.

Quando marcada, você pode definir o comportamento padrão selecionando a preferência de resolução de conflito Cópia local não modificada sobregrava versão mais recente modificada externamente.

Especifique as preferências de resolução de conflito:

Preferência	Descrição
Mudança local sobregrava objeto criado externamente	Marcada — Se você quiser que o objeto que está distribuindo sobregrave o objeto que está no cofre de identidade. Desmarcada — A distribuição não ocorre quando há conflito.
Cópia local não modificada recria objeto apagado externamente	Marcada — Se você quiser que o objeto local que está distribuindo crie um objeto que já foi apagado do cofre de identidade. Desmarcada — A distribuição não ocorre quando há conflito.
Mudança local sobregrava objeto modificado externamente	Marcada — Se você quiser que a definição local sempre seja distribuída, mesmo que o cofre de identidade tenha sido mudado por outro usuário. Desmarcada — A distribuição não ocorre quando há conflito.
Cópia local sobregrava objeto apagado e recriado	Marcada — Se você quiser que o objeto local sempre seja distribuído, mesmo que o objeto do cofre de identidade tenha sido apagado ou apagado e recriado. Desmarcada — A distribuição não ocorre quando há conflito.
Cópia local não modificada sobregrava versão mais recente modificada externamente	Esta preferência só pode ser definida quando a preferência de distribuição geral Permitir distribuição de objetos não modificados que sobregravará versão mais recente modificada externamente está selecionada. Marcada — Se seus arquivos locais não mudaram, mas os objetos do cofre de identidade mudaram e você sempre quer que os arquivos locais sobregravem os arquivos do cofre de identidade como o comportamento padrão. Desmarcada — Se quiser manter as versões mais recentes do cofre de identidade.