Ir para o conteúdo

Cadeias de caracteres

UPPER

Converte uma cadeia de texto em maiúsculas.

Sintaxe da função:

<UPPER:[Expression]>

Modo de utilização:

  • A palavra-chave UPPER pode ser utilizada em todos os campos do tipo «expression», como as operações do tipo COPY, MODVALUE, etc.
  • A expressão avaliada pode conter palavras-chave para recuperar valores de atributos, por exemplo SyncAttSrc ou SyncAttDst.

LOWER

Converte uma cadeia de texto em minúsculas.

Sintaxe da função:

<LOWER:[Expression]>

Modo de utilização:

  • A palavra-chave LOWER pode ser utilizada em todos os campos do tipo «expression», como as operações do tipo COPY, MODVALUE, etc.
  • A expressão avaliada pode conter palavras-chave para recuperar valores de atributos, por exemplo SyncAttSrc ou SyncAttDst.

LEFT

Sintaxe da função:

<LEFT:[Character_number]:[Expression]>

Modo de utilização:

  • A palavra-chave LEFT pode ser utilizada em todos os campos do tipo «expression», como as operações do tipo COPY, MODVALUE, etc.
  • A expressão avaliada pode conter palavras-chave para recuperar valores de atributos, por exemplo SyncAttSrc ou SyncAttDst.

TOKLEFT

Recupera o n-ésimo objeto contado a partir da esquerda.

Sintaxe da função:

<TOKLEFT:[separator]:[Object_number]:[Expression]>

Um objeto está delimitado entre dois separadores. Não é necessário colocar um separador no início e no fim da cadeia de expressão.

Modo de utilização:

  • A palavra-chave TOKLEFT pode ser utilizada em todos os campos do tipo «expression», como as operações do tipo COPY, MODVALUE, etc.
  • A expressão avaliada pode conter palavras-chave para recuperar valores de atributos, por exemplo SyncAttSrc ou SyncAttDst.

Exemplos de configuração:

  • Exemplo:
    • <TOKLEFT:/:3:Level 1/Level 2/Level 3/Level 4/ Level 5>
    • Resultado devolvido: Level 3

Recupera um número de caracteres a partir da direita de um valor.

Sintaxe da função:

<RIGHT:[Character_number]:[Expression]>

Modo de utilização:

  • A palavra-chave RIGHT pode ser utilizada em todos os campos do tipo «expression», como as operações do tipo COPY, MODVALUE, etc.
  • A expressão avaliada pode conter palavras-chave para recuperar valores de atributos, por exemplo SyncAttSrc ou SyncAttDst.

SHA256

Cifra uma cadeia de caracteres em SHA256.

Sintaxe da função:

<SHA256:[string_encoding]:[Hex_B64]:[Expression]>

Com:

  • [string_encoding]: «UTF8» ou «UTF16». Codificação a indicar consoante o formato esperado pela aplicação de destino. Na maioria dos casos deve utilizar-se UTF8.
  • [Hex_B64]: «HEX» ou «B64» para escolher o formato da cadeia. HEX para hexadecimal, B64 para base 64.

Modo de utilização:

  • A palavra-chave SHA256 pode ser utilizada em todos os campos do tipo «expression», como as operações COPY, MODVALUE, etc.
  • A expressão avaliada pode conter palavras-chave para recuperar valores de atributos, por exemplo SyncAttSrc ou SyncAttDst.

TOKRIGHT

Recupera parte de uma cadeia de caracteres a partir do n-ésimo objeto contado a partir da direita.

Sintaxe da função:

<TOKRIGHT:[separator]:[Object_number]:[Expression]>

Um objeto está delimitado entre dois separadores. Não é necessário colocar um separador no início e no fim da cadeia de expressão.

Modo de utilização:

  • A palavra-chave TOKRIGHT pode ser utilizada em todos os campos do tipo «expression», como COPY, MODVALUE, etc.
  • A expressão avaliada pode conter palavras-chave para recuperar valores de atributos, por exemplo SyncAttSrc ou SyncAttDst.

Exemplos de configuração:

  • Exemplo:
    • <TOKLEFT:/:2:Level 1/Level 2/Level 3/Level 4/ Level 5>
    • Resultado devolvido: Level 4/ Level 5

CENTER

Recupera os caracteres do meio eliminando um número de caracteres à esquerda e à direita.

Sintaxe da função:

<CENTER:[Number_of_characters_to_the_left_to_delete]:[Number_of_characters_to_the_right_to_delete]:[Expression]>

Modo de utilização:

  • A palavra-chave CENTER pode ser utilizada em todos os campos do tipo «expression», como as operações do tipo COPY, MODVALUE, etc.
  • A expressão avaliada pode conter palavras-chave para recuperar valores de atributos, por exemplo SyncAttSrc ou SyncAttDst.

REWRITEURL

Reescrita de um URL.

Sintaxe da função:

<REWRITEURL:[url]>

Modo de utilização:

  • A palavra-chave REWRITEURL pode ser utilizada em todos os campos do tipo «expression», como COPY, MODVALUE, etc.

Exemplos de configuração:

  • Exemplo:

    • <REWRITEURL:http%3F%3A%3Awww.avencis.net>
    • Resultado devolvido: http://www.avencis.net

GEN_PASSWORD

Geração de uma palavra-passe a partir de uma máscara e com suporte dos caracteres especiais definidos nos parâmetros.

Sintaxe da função:

<GEN_PASSWORD:[pwd_format]:[special_characters]>

O formato da palavra-passe deve ser definido com os elementos seguintes:

  • U Uma letra maiúscula
  • L Uma letra minúscula
  • A Uma letra maiúscula ou minúscula
  • N Um número
  • S Um carácter especial da lista [special_characters]
  • X Todos os caracteres (U+L+N+S)

Modo de utilização:

  • A palavra-chave GEN_PASSWORD pode ser utilizada em todos os campos do tipo «expression», como as operações COPY, MODVALUE, etc.

Exemplos de configuração:

  • Exemplo:
    • <GEN_PASSWORD:ULNXXXXXXX:,$£!§&#>

B64ENCODEASCII

Converte uma expressão em ASCII e devolve depois a cadeia codificada em B64.

Sintaxe da função:

<B64ENCODEASCII:[Expression]>

Modo de utilização:

  • A palavra-chave B64ENCODEASCII pode ser utilizada em todos os campos do tipo «expression», como as operações COPY, MODVALUE, etc.
  • A expressão avaliada pode conter palavras-chave para recuperar valores de atributos, por exemplo SyncAttSrc ou SyncAttDst.

B64SID2STRING

Converte um SID em Base64 e devolve a cadeia em formato Unicode.

Sintaxe da função:

<B64SID2STRING:[Expression]>

Modo de utilização:

  • A palavra-chave B64SID2STRING pode ser utilizada em todos os campos do tipo «expression», como as operações COPY, MODVALUE, etc.
  • A expressão avaliada pode conter palavras-chave para recuperar valores de atributos, por exemplo SyncAttSrc ou SyncAttDst.

FIND

Função que permite encontrar a posição de uma cadeia de caracteres dentro de outra cadeia de caracteres. Devolve o índice da posição (a começar no índice 0) se a cadeia for encontrada; caso contrário, devolve o comprimento da cadeia.

Sintaxe da função:

<FIND:[chaîne_recherchée]:[chaîne_initiale]:[index_de_départ]>

O índice começa na posição 0.

Modo de utilização:

  • A operação FIND pode ser utilizada em todos os campos do tipo «expression», como COPY, MODVALUE, etc.
  • As diferentes cadeias utilizadas na expressão podem conter palavras-chave para recuperar valores de atributos, por exemplo SyncAttSrc ou SyncAttDst.

Exemplos de configuração:

  • Exemplo 1:
    • <FIND:E:<SyncAttSrc:FIRSTNAME>:0> com <SyncAttSrc:FIRSTNAME> = Emilie
    • Resultado = 0
  • Exemplo 2:
    • <FIND:I:<SyncAttSrc:FIRSTNAME>:0> com <SyncAttSrc:FIRSTNAME> = Emilie
    • Resultado = 2
  • Exemplo 3:
    • <FIND:E:<SyncAttSrc:FIRSTNAME>:0> com <SyncAttSrc:FIRSTNAME> = Paul
    • Resultado = 4

SUBSTRING

Função que extrai uma cadeia de caracteres de outra cadeia de caracteres. Devolve a cadeia de caracteres se os parâmetros passados forem válidos; caso contrário, devolve vazio. Sintaxe da função:

<SUBSTRING:[chaîne_initiale]:[index_début]:[longueur_chaîne]>

O índice começa na posição 0.

Modo de utilização:

  • A operação SUBSTRING pode ser utilizada em todos os campos do tipo «expression», como COPY, MODVALUE, etc.
  • As diferentes cadeias utilizadas na expressão podem conter palavras-chave para recuperar valores de atributos, por exemplo SyncAttSrc ou SyncAttDst.

Exemplos de configuração:

  • Exemplo 1:
    • <SUBSTRING:<SyncAttSrc:DisplayName>:0:<FIND: :<SyncAttSrc:DisplayName>:0>> com <SyncAttSrc:DisplayName> = Carine HOPFNER
    • Resultado = Carine

LEN

Função que devolve o comprimento de uma cadeia de caracteres. A função devolve 0 se existir um erro na configuração.

Sintaxe da função:

<LEN:[chaîne_initiale]>

Modo de utilização:

  • A operação LEN pode ser utilizada em todos os campos do tipo «expression», como COPY, MODVALUE, etc.
  • As diferentes cadeias utilizadas na expressão podem conter palavras-chave para recuperar valores de atributos, por exemplo SyncAttSrc ou SyncAttDst.

Exemplos de configuração:

  • Exemplo 1:
    • <LEN:<SyncAttSrc:DisplayName>> com <SyncAttSrc:DisplayName> = Emilie Paris
    • Resultado = 12

REPLACE

Disponível a partir da versão 7.0. Função que substitui a cadeia de caracteres «string_to_replace» numa dada cadeia «initial_string» pela cadeia «destination_string». Devolve a cadeia de caracteres modificada. A função é sensível a maiúsculas e minúsculas.

Sintaxe da função:

<REPLACE:[initial_string]:[string_to_replace]:[destination_string]:[Boolean_all_or_first]>

Boolean_all_or_first: pode assumir os valores 0 ou 1. Se 0, apenas a primeira ocorrência encontrada é substituída; se 1, todas as ocorrências encontradas são substituídas. O parâmetro é opcional; o valor predefinido é 0.

Destination_string pode estar vazia: neste caso, a cadeia a substituir é simplesmente eliminada.

Modo de utilização:

  • A operação REPLACE pode ser utilizada em todos os campos do tipo «expression», como COPY, MODVALUE, etc.
  • As diferentes cadeias utilizadas na expressão podem conter palavras-chave para recuperar valores de atributos, por exemplo SyncAttSrc ou SyncAttDst.

Exemplos de configuração:

  • <REPLACE:XXXstringXXX:string:newString> devolve XXXnewStringXXX
  • <REPLACE:XXXstringXXX:X::0> devolve XXstringXXX
  • <REPLACE:XXXstringXXX:X::1> devolve string
  • <REPLACE:XXXstringXXX:X:A:1> devolve AAAstringAAA