Ao preparar documentos na Assinatura Eletrônica para RH, é possível usar parâmetros de modificação. Eles consistem em códigos especiais que ajustam o formato e a apresentação dos dados no documento. Com um modificador, é possível exibir, por exemplo, uma data ou um endereço em um formato específico.

Tipos de parâmetros de modificação

Na Assinatura Eletrônica para RH, é possível usar diferentes tipos de parâmetros de modificação:

• Data e hora,
• Número de telefone,
• Endereço,
• Formatação de texto.

Os parâmetros de modificação são utilizados em campos simbólicos do modelo de documento. Para aplicar um parâmetro, adicione-o ao campo simbólico com um til (~). Exemplo: No código {Ext.Emp.Date~d.m.Y H\:i\:s}, Ext.Emp.Date é o código do campo e d.m.Y H\:i\:s é o parâmetro de modificação. O formato é definido por um padrão, onde cada letra representa um componente da data ou hora (ex.: d para dia, m para mês, Y para ano).

Existem dois tipos de parâmetros de modificação:

• Parâmetros de modificação simples – por exemplo, o formato de data d.m.Y, que especifica o formato diretamente,
• Parâmetros com valor atribuído – no formato Parâmetro=Valor, ex.: format=E.164.

Ao usar vários parâmetros, separe-os por vírgulas: {...~Case=0,letterCase=upper}.

Parâmetros de modificação para data e hora: Permitem exibir data e hora em um formato personalizado. Por exemplo, a data de criação de um documento pode ser exibida como 28 de março de 2026.

Exemplos de formatos de data:

• d.m.y – 28.03.26,
• d.m.Y – 28.03.2026,
• j, n, Y – 28, 3, 2026,
• j F, Y – 28 de março, 2026.

Exemplos de formatos de hora:

• H\:i\:s – 10:24:18.

Parâmetros combinados de formatação de data e hora:

• Y-m-d H\:i\:s – 2026-03-28 10:24:18.

Exemplo: Para exibir a data de criação de um documento no formato 28.03.2026 10:24:18, adicione ao código simbólico {Ext.Emp.Date} o parâmetro de modificação ~d.m.Y H\:i\:s. O código completo é: {Ext.Emp.Date~d.m.Y H\:i\:s}.

Parâmetros de modificação para números de telefone: Alteram o formato de um número de telefone. Use o parâmetro de modificação ~format=.

Formatos disponíveis:

• E.164 – +49171xxxxxxx
• International – +49 171 xxxxxxx
• National – 0171 xxxxxxx

Exemplo: Para exibir o número de telefone de uma empresa no formato +49 sem espaços, use o código {Com.Rep.Phone~format=E.164}. No documento, o número de telefone será exibido no formato +49171xxxxxxx.

Parâmetros de modificação para endereços: Permitem alterar o formato do endereço e o separador entre as partes.

Um endereço é composto por vários campos:

• ADDRESS_1 – rua, número, edifício,
• ADDRESS_2 – apartamento ou sala,
• CITY – cidade,
• REGION – bairro/distrito,
• PROVINCE – estado,
• POSTAL_CODE – CEP,
• COUNTRY – país.

Para definir o formato do endereço, use o parâmetro de modificação ~Format= com os seguintes valores:

• 1 – Europa: rua, CEP, cidade, região e país em uma linha, ex.: Friedrichstraße 123, 10117 Berlim, Brandemburgo, Alemanha.
• 2 – Reino Unido: cada campo em sua própria linha, cidade, região e CEP em maiúsculas, ex.: 221B Baker Street, LONDON, NW1 6XE, United Kingdom.
• 3 – América do Norte: rua, cidade, região e CEP em uma linha, país em maiúsculas, ex.: 1600 Pennsylvania Avenue, Washington DC 20500, UNITED STATES.

Para definir o separador entre os componentes do endereço, use ~Separator=:

• 3 – quebra de linha (equivalente a <br>).

Exemplo de código combinado: {Com.Rep.AddrPrim~Format=1,Separator=3}. No documento, cada componente do endereço será exibido em uma nova linha. Por exemplo:

Friedrichstraße 123
10117 Berlim
Alemanha

Parâmetros de modificação para formatação de texto: Alteram as maiúsculas e minúsculas do texto no documento. Por exemplo, uma data pode ser escrita em letras minúsculas – 25 de abril de 2026 em vez de 25 DE ABRIL DE 2026.

Para definir as maiúsculas/minúsculas, use o parâmetro ~letterCase=.

Valores disponíveis:

• upper – MAIÚSCULAS,
• lower – minúsculas,
• title – Primeira Letra De Cada Palavra Em Maiúscula.

Exemplo: Para exibir o sobrenome de um colaborador em maiúsculas, use o código {User.Emp.LastName~letterCase=upper}. No documento, o sobrenome será exibido em maiúsculas, ex.: MUSTERMANN.

Exibir todos os valores de um campo

Na Assinatura Eletrônica para RH, alguns campos podem conter vários valores, como vários números de telefone ou documentos de um colaborador.

Com os parâmetros de modificação, você pode escolher o que exibir no documento: apenas um valor ou todos os valores.

Exibir o primeiro valor da lista: Use o parâmetro de modificação ~mfirst=y.

Exemplo: Para exibir apenas o primeiro número de telefone de um colaborador, use o código {User.Emp.Str1731454357238~mfirst=y,mseparator=2} (onde mseparator=2 define o separador entre valores, se houvesse mais de um). No documento, será exibido o primeiro número de telefone, ex.: +4912345678.

Exibir um valor específico: Use o parâmetro de modificação ~index=:

• 0 – primeiro valor,
• 1 – segundo valor,
• 2 – terceiro valor.

Exemplo: Para exibir o primeiro valor do campo “Número de colaboradores”, use o código {Com.Rep.Employees~index=0}. No documento, será exibido o primeiro valor, ex.: 1–5.

Exibir todos os valores: Use o parâmetro de modificação ~all=y. Exemplo: O código {User.Emp.Str1731454357238~all=y} exibe todos os números de telefone de um colaborador.

Em cada conta Bitrix24, os códigos de campo podem ser diferentes. Os códigos atuais podem ser encontrados no slider de códigos simbólicos na Assinatura Eletrônica para RH.