Lista das operações disponíveis por regras de sincronização

	Conversão	Regras de correspondência	Comparação	Criação	Modificação	Eliminação
ADDVALUE	X			X	X	X
CHANGE	X			X	X	X
COMPAREATTNAME			X
COMPARE			X
CONVERT	X
COPY	X			X	X	X
DELETE	X
DELVALUE	X			X	X	X
DELVALUEBYVALUE	X			X	X	X
DSTCOPY	X			X	X	X
EQ		X	X
FILTERAR	X
GETSTRUCTCHILD	X
GROUPAR	X
ISCONTAINED			X
MERGE	X
MODVALUE	X			X	X	X
MULTCOPY				X	X	X
MULTDSTCOPY				X	X	X
MULTIEVALEQ		X
MULTSET	X			X	X	X
MVEQ			X
RENAME	X
SET	X			X	X	X
SIMPLEEQ		X
SPLIT	X

Opções disponíveis para cada operação:

	B64	CI	DATE	DATE_FILETIME	DN	PARTIAL	PWD	USEMAP
ADDVALUE	X		X	X			X
CHANGE	X		X	X			X
COMPAREATTNAME		X			X
CONTAIN		X			X
CONVERT	X		X	X			X
COPY	X		X	X			X
DELETE	X		X	X			X
DELVALUE	X		X	X			X
DELVALUEBYVALUE	X		X	X			X
DSTCOPY	X		X	X			X
EQ**		X			X			X
FILTREAR	X		X	X			X
GETSTRUCTCHILD	X		X	X			X
GROUPAR	X		X	X			X
ISCONTAINED		X			X
MERGE	X		X	X			X
MODVALUE	X		X	X			X
MULTCOPY	X		X	X			X
MULTDSTCOPY	X		X	X			X
MULTIEVALEQ		X				X		X
MULTSET	X		X	X			X
MVEQ		X			X
RENAME	X		X	X			X
SET	X		X	X			X
SIMPLEEQ**		X			X			X
SPLIT	X		X	X			X

**: Os filtros diferem em função da regra que utiliza a operação.

• B64: converte o valor do atributo para o formato Base 64.
• CI: Case insensitive: a comparação é efetuada independentemente das maiúsculas e minúsculas.
• DATE: converte o valor do atributo para o formato DATE.
• DATE_FILETIME: converte o valor do atributo para o formato DATETIME.
• DN: comparação de DN.
• PARTIAL: compara parcialmente os dados. Devolve verdadeiro se pelo menos um valor estiver contido no atributo de comparação.
• PWD: permite a cifragem dos dados.
• USEMAP: utilização de um mapa para encontrar o atributo, acelera o processo de comparação.

ADDVALUE

Operação que permite adicionar valores a um atributo que, por definição, pode ser multivalor. Permite também concatenar valores de vários atributos.

Sintaxe da função:

• [Description]: texto livre para descrever a operação (opcional).
• [Attribute]: nome do atributo a modificar. Se o atributo não existir, será criado automaticamente.
• [Expression]: fórmula a introduzir. É possível utilizar palavras-chave ou introduzir a totalidade ou parte de valores fixos (texto codificado). Consulte o capítulo «Lista de palavras-chave» para conhecer a sintaxe a aplicar no seu caso de utilização.

Exemplo da configuração seguinte:

CHANGE

Operação que permite modificar o valor de um atributo. O atributo deve existir e ser monovalor. O valor inicial do atributo é substituído e já não pode ser reutilizado.

Sintaxe da função:

• [Description]: texto livre para descrever a operação (opcional).
• [Attribute]: nome do atributo a modificar. Se o atributo não existir, a operação não funcionará.
• [Expression]: fórmula a introduzir. É possível utilizar palavras-chave ou introduzir a totalidade ou parte de valores fixos (texto codificado). Consulte o capítulo «Lista de palavras-chave» para conhecer a sintaxe a aplicar no seu caso de utilização.

Exemplo da configuração seguinte:

COMPAREATTNAME

Operação que permite enumerar os atributos que não devem ser comparados e comparar todos os outros atributos que têm o mesmo nome em ambos os repositórios. Os nomes de atributos do repositório de origem que não tenham correspondente no repositório de destino serão ignorados e não comparados. Pode ser utilizada para substituir o mapeamento unitário dos atributos a comparar.

Tenha em conta que esta operação só está disponível a partir da versão 6.2 e só pode ser utilizada em regras OnCompare, numa operação MATCH, em conectores de aprovisionamento de estados de aprovisionamento (status).

Sintaxe da função:

• [Attribute] = lista dos atributos que não devem ser comparados. Os atributos devem ser separados por vírgulas e sem espaços.

Exemplo da configuração seguinte:

CONTAIN

Operação que efetua uma comparação para verificar se os valores do atributo da fonte autorizada estão presentes no atributo da fonte de destino. O resultado da operação será a concatenação dos valores do atributo da fonte de destino com os valores do atributo da fonte autorizada que não foram encontrados.

Exemplo

Authoritative_source_attribute_values =

• Val_1
• Val_2
• Val_3

Source_target_attribute_values =

• Val_4
• Val_5
• Val_6

Resultado no atributo da fonte de destino =

• Val_1
• Val_2
• Val_3
• Val_4
• Val_5
• Val_6

Não é possível utilizar palavras-chave nesta operação.

Sintaxe da função:

• [Description]: texto livre para descrever a operação (opcional).
• [Attribute]: nome do atributo presente na fonte de destino sobre o qual será efetuada a comparação.
• [Attribute Name]: nome do atributo presente na fonte autorizada sobre o qual será efetuada a comparação.

Exemplo da configuração seguinte:

CONVERT

COPY

Operação que permite copiar o valor de um atributo para outro atributo. Funciona para atributos monovalor e multivalor.

Sintaxe da função:

• [Description]: texto livre para descrever a operação (opcional).
• [Attribute]: nome do atributo a modificar. O atributo deve existir.
• [Attribute Name]: nome do atributo de origem cujo valor será copiado.

Exemplo da configuração seguinte:

O atributo «usual_name» assumirá o valor do atributo «birth_name».

DELETE

Operação que permite eliminar um atributo numa fonte especificada (fonte de exportação, destino de exportação ou DELTA).

Sintaxe da função:

• [Description]: texto livre para descrever a operação (opcional).
• [Attribute]: nome do atributo a eliminar.
• [Expression]: não preencha este campo.

DELVALUE

Operação que permite eliminar valores de um atributo com base numa expressão booleana: se a expressão devolver «True», os valores são eliminados. Aplica-se, por conseguinte, geralmente a atributos multivalor.

Sintaxe da função:

• [Description]: texto livre para descrever a operação (opcional).
• [Attribute]: nome do atributo a modificar.
• [Expression]: fórmula a introduzir. É possível utilizar palavras-chave ou introduzir a totalidade ou parte de valores fixos (texto codificado). Consulte o capítulo «Lista de palavras-chave» para conhecer a sintaxe a aplicar no seu caso de utilização.

Exemplo da configuração seguinte:

Se o atributo «groups» contiver o valor «GRP_ACCES_COMMUN», este será removido da lista de valores de «groups» e a lista modificada do atributo «groups» será copiada para o atributo «memberof@».

DELVALUEBYVALUE

Operação que permite eliminar valores de um atributo com base numa lista indicada. Aplica-se, por conseguinte, geralmente a atributos multivalor.

Sintaxe da função:

• [Description]: texto livre para descrever a operação (opcional).
• [Attribute]: nome do atributo a modificar.
• [Expression]: valores a introduzir, separados por «;». É possível utilizar palavras-chave ou introduzir a totalidade ou parte de valores fixos (texto codificado). Consulte o capítulo «Lista de palavras-chave» para conhecer a sintaxe a aplicar no seu caso de utilização.

Exemplo da configuração seguinte:

Os valores do atributo «groups_admin» e o valor «GRP_ACCES_COMMUN» são removidos da lista de valores contida em «memberof@».

DSTCOPY

Operação que copia o valor de um atributo encontrado na exportação de destino para outro atributo do ficheiro DELTA. Funciona para atributos monovalor e multivalor. É geralmente utilizada para transferir valores do repositório de destino que são desconhecidos no repositório de origem, muitas vezes no caso de uma eliminação (desconhecido na origem, mas ainda presente no destino).

Sintaxe da função:

• [Description]: texto livre para descrever a operação (opcional).
• [Attribute]: nome do atributo de destino.
• [Attribute Name]: nome do atributo de origem cujo valor será copiado.

Exemplo da configuração seguinte:

EQ

Operação que compara dois atributos monovalor.

Sintaxe da função:

• [Description]: texto livre para descrever a operação (opcional).
• [Attribute]: nome do atributo a comparar, presente na exportação de origem.
• [Expression]: fórmula a introduzir. É possível utilizar palavras-chave ou introduzir a totalidade ou parte de valores fixos (texto codificado). Consulte o capítulo «Lista de palavras-chave» para conhecer a sintaxe a aplicar no seu caso de utilização.

Exemplo da configuração seguinte:

GETSTRUCTCHILD

Permite recuperar a lista das estruturas filhas no atributo «Destination_attribute_name» de uma determinada estrutura em «Parent_structure_attribute_name». Esta operação só pode ser efetuada sobre dados do repositório Identity (por exemplo, sobre uma exportação de identidades que tenha um atributo do tipo estrutura).

Sintaxe da função:

• [Description]: texto livre para descrever a operação (opcional).
• [Attribute]: nome do atributo de destino que receberá a lista das estruturas filhas.
• [Expression]: nome do atributo da estrutura-mãe, sem palavras-chave.

Exemplo da configuração seguinte:

Devolve todas as estruturas filhas da estrutura com o código «Site».

ISCONTAINED

Operação que compara um atributo multivalor da fonte autorizada com um atributo multivalor da fonte de destino, a fim de extrair apenas a lista dos valores presentes em ambos os atributos.

Exemplo:

Authoritative_source_attribute_values =

• Val_1
• Val_2
• Val_3
• Val_4

Source_target_attribute_values =

• Val_3
• Val_4
• Val_5

Resultado no atributo da fonte de destino =

• Val_3
• Val_4

Não é possível utilizar palavras-chave nesta operação.

Sintaxe da função:

• [Description]: texto livre para descrever a operação (opcional).
• [Attribute]: nome do atributo presente na fonte de destino sobre o qual será efetuada a comparação.
• [Attribute Name]: nome do atributo presente na fonte autorizada sobre o qual será efetuada a comparação.

Exemplo da configuração seguinte:

MERGE

Operação que permite criar uma concatenação de valores a partir de um atributo multivalor e atribuí-la a um atributo monovalor.

Tenha em conta que esta operação só está disponível a partir da versão 6.2.

Sintaxe da função:

• [name_out_attribute_monovalue] = nome do atributo a fornecer como saída.
• [Expression] = [separator];[name_attribute_multivalues]
  • [separator]: o separador deve ser um único carácter e não pode ser ";", uma vez que este carácter é utilizado no ficheiro de configuração do conector.
  • [name_attribute_multivalues]: nome do atributo multivalor cujos valores devem ser concatenados.

Modo de utilização:

A operação MERGE pode ser utilizada em regras de sincronização e apenas em operações CONVERT.

Exemplo da configuração seguinte:

• Com o atributo "wiki_mod_1" igual a:
  • Droit_001
  • Droit_002
  • Droit_003
• Resultado: no ficheiro sync.xml, o atributo "lst_right" terá o seguinte valor:
  • Droit_001#Droit_002#Droit_003

MODVALUE

Operação que permite modificar o valor de um atributo. O atributo deve existir e ser monovalor. O valor inicial do atributo é substituído e já não pode ser reutilizado.

Sintaxe da função:

• [Description]: texto livre para descrever a operação (opcional).
• [Attribute]: nome do atributo a modificar. Se o atributo não existir, a operação não funcionará.
• [Expression]: fórmula a introduzir. É possível utilizar palavras-chave ou introduzir a totalidade ou parte de valores fixos (texto codificado). Consulte o capítulo «Lista de palavras-chave» para conhecer a sintaxe a aplicar no seu caso de utilização.

Exemplo da configuração seguinte:

MULTCOPY

Copiar atributos a partir da origem

Operação que copia os valores de atributo da exportação de origem para atributos do ficheiro DELTA. Funciona para atributos monovalor .

Sintaxe da função:

• [Description]: texto livre para descrever a operação (opcional).
• [Attribute name to copy]: nome do atributo que deve constar da exportação de origem. O atributo deve existir.
• [Target attribute name]: o atributo deve existir. Nome do atributo que deve constar da exportação de destino, o qual ficará no ficheiro DELTA.

A operação deve ser efetuada tantas vezes quantas as necessárias.

Exemplo da configuração seguinte:

MULTDSTCOPY

Operação que copia os valores de atributo encontrados na exportação de destino para atributos do ficheiro DELTA. Funciona para atributos monovalor . É geralmente utilizada para reportar valores do repositório de destino que são desconhecidos no repositório de origem, muitas vezes no caso de uma eliminação (já não conhecido na origem, mas ainda presente no destino).

Sintaxe da função:

• [Description]: texto livre para descrever a operação (opcional).
• [Attribute name to copy]: nome do atributo que deve constar da exportação de destino. O atributo deve existir.
• [Target attribute name]: nome do atributo de destino que deve constar do ficheiro DELTA.

A operação deve ser efetuada tantas vezes quantas as necessárias.

Exemplo da configuração seguinte:

MULTIEVALEQ

Operação que compara vários atributos multivalor.

Sintaxe da função:

• [Description]: texto livre para descrever a operação (opcional).
• [Source attribute name]: nome do atributo a comparar, presente na exportação de origem.
• [Destination attribute name]: nome do atributo a comparar, presente na exportação de destino.

A operação deve ser efetuada tantas vezes quantas as necessárias. Os objetos são emparelhados se todos os atributos forem iguais.

Exemplo da configuração seguinte:

MULTSET

Operação que permite fazer cópias de atributos multivalor, com a opção de adicionar um prefixo.

Sintaxe da função:

• [Nom_attribut_dest] = nome do atributo a fornecer como saída. O atributo não precisa de existir previamente.
• [Nom_attribut_src] = nome do atributo cujos valores serão copiados. Atenção: não utilize as palavras-chave <syncattsrc> ou <syncattdst>.
• [prefixe] = cadeia de caracteres a adicionar antes de cada valor do atributo [Nom_attribut_src]. O prefixo pode ser o valor de um atributo, utilizando a palavra-chave >. Se não quiser adicionar um prefixo, basta indicar <uid> no segundo parâmetro da expressão esperada.

Modo de utilização:

A operação MULTSET pode ser utilizada em regras de sincronização para as operações CONVERT e MATCH (OnCreate, OnModify e OnDelete).

Exemplo da configuração seguinte:

• Com o atributo "postal_code" igual a:
  • 68300
  • 68390
  • 38670
• Resultado: no ficheiro sync.xml, o atributo "Code_postal_prefix" terá os seguintes valores:
  • CP_68300
  • CP_68390
  • CP_38670

MVEQ

Operação que compara 2 atributos multivalor.

Sintaxe da função:

• [Description]: texto livre para descrever a operação (opcional).
• [Attribute]: nome do atributo a comparar, presente na exportação de destino.
• [Attribute Name]: nome do atributo a comparar, presente na exportação de origem.

Exemplo da configuração seguinte:

RENAME

Operação que renomeia um atributo.

Sintaxe da função:

• [Description]: texto livre para descrever a operação (opcional).
• [Attribute]: novo nome do atributo.
• [Expression]: nome do atributo a renomear.

Exemplo da configuração seguinte:

SET

Operação que permite atribuir um valor a um atributo, apenas monovalor, exista ou não.

Sintaxe da função:

• [Description]: texto livre para descrever a operação (opcional).
• [Attribute]: nome do atributo ao qual será atribuído um valor. Se o atributo existir, o valor inicial será substituído; se o atributo não existir, será criado.
• [Expression]: fórmula a introduzir. É possível utilizar palavras-chave ou introduzir a totalidade ou parte de valores fixos (texto codificado). Consulte o capítulo «Lista de palavras-chave» para conhecer a sintaxe a aplicar no seu caso de utilização.

Exemplo da configuração seguinte:

SIMPLEEQ

Operação que compara vários atributos monovalor.

Sintaxe da função:

• [Description]: texto livre para descrever a operação (opcional).
• [Source attribute name]: nome do atributo a comparar, presente na exportação de origem.
• [Destination attribute name]: nome do atributo a comparar, presente na exportação de destino.

A operação deve ser efetuada tantas vezes quantas as necessárias. Os objetos são emparelhados se todos os atributos forem iguais.

Exemplo da configuração seguinte:

SPLIT

Operação utilizada para criar uma separação de valores a partir de um atributo monovalor e de um separador, atribuindo-a em seguida a um atributo multivalor.

Tenha em conta que esta operação só está disponível a partir da versão 6.2.

Sintaxe da função:

• [name_out_attribute_multivalues] = nome do atributo a fornecer como saída.
• [Expression] = [separator];[name_attribute_monovalue]
  • [separator]: o separador deve ser um único carácter e não pode ser ";", uma vez que este carácter é utilizado no ficheiro de configuração do conector.
  • [name_attribute_multivalues]: nome do atributo multivalor cujos valores devem ser concatenados.

Resultados possíveis:

• Se o separador for encontrado pelo menos uma vez: devolve uma lista de valores
• Se o separador não for encontrado: devolve a cadeia completa

Resultados possíveis:

A operação SPLIT pode ser utilizada em regras de sincronização e apenas em operações CONVERT.

Exemplo da configuração seguinte:

• Com o atributo "string_rights" igual a:
  • Droit_001#Droit_002#Droit_003
• Resultado: no ficheiro sync.xml, o atributo «lst_right_multi» terá o seguinte valor:
  • Droit_001
  • Droit_002
  • Droit_003