Os campos que o sistema preenche com os dados de cada pessoa, e as regras simples para esconder o que está vazio ou usar um valor de reserva.
Um marcador entre chaves duplas que vira o dado da pessoa na hora em que a assinatura é montada.
No bloco de texto, {{user.displayName}} vira "Ana Beatriz Lima" para a Ana e "Carlos Souza" para o Carlos. O template é um só; a assinatura é de cada um. Os dados vêm do Entra ID (com os overrides feitos em Usuários sincronizados por cima), do estabelecimento da pessoa, da empresa (Empresa e marca) e dos atributos customizados.
Clique no texto da assinatura e use Placeholder na barra de ferramentas: escolha da lista e o marcador entra onde o cursor está. Na tela ele aparece como uma etiqueta azul com o nome do dado ("Nome de exibição", "Cargo"), não com as chaves; as condições aparecem em âmbar ("se houver Celular" … "fim"). A etiqueta se apaga como uma letra. Também dá para digitar direto, chaves e tudo: vira etiqueta ao reabrir. Pré-visualizar mostra o resultado com o usuário do "Ver como".
Um link pode ser um placeholder inteiro: {{company.website}} no botão, {{custom.linkedin}} na rede social, mailto:{{user.mail}} no texto. Quando o placeholder está vazio para a pessoa, o item some (uma rede social sem link não aparece).
Os fixos. Os atributos customizados aparecem na lista do editor com a chave que você deu a eles.
| Placeholder | De onde vem |
|---|---|
| user.displayName, user.givenName, user.surname | Nome de exibição, nome e sobrenome (Entra) |
| user.jobTitle, user.department, user.officeLocation, user.companyName | Cargo, departamento, escritório e empresa (Entra) |
| user.mail, user.userPrincipalName | E-mail e UPN |
| user.mobilePhone, user.businessPhone | Celular e telefone fixo. Use com formatPhone (página 03) |
| user.streetAddress, user.city, user.state, user.postalCode, user.country | Endereço da pessoa no Entra |
| user.employeeId | Matrícula |
| user.ext.attribute1 … attribute15 | Os extension attributes do Entra |
| custom.chave | Atributo customizado (Diretório › Atributos customizados), como custom.linkedin |
| establishment.name, .address, .city, .state, .phone, .website, .cnpj | O estabelecimento da pessoa. Vazio para quem não tem estabelecimento |
| company.name, .legalName, .website, .phone, .address, .cnpj | A empresa (Configurações › Empresa e marca) |
| date.year | O ano atual |
Foto, logo do estabelecimento, banner de campanha, disclaimer e QR não são placeholders de texto: são blocos, com o dado embutido.
Oito construções, e só estas. Nenhuma outra é aceita: o editor recusa ao publicar.
| Construção | O que faz | Exemplo |
|---|---|---|
| {{#if x}} … {{/if}} | Mostra o miolo só se x tiver valor | {{#if user.mobilePhone}}Cel.: {{user.mobilePhone}}{{/if}} |
| {{#if x}} … {{else}} … {{/if}} | Um ou outro | {{#if establishment.city}}{{establishment.city}}{{else}}Matriz{{/if}} |
| {{#unless x}} … {{/unless}} | Só se x estiver vazio | {{#unless user.jobTitle}}Colaborador{{/unless}} |
| {{#each lista}} … {{/each}} | Repete para cada item | {{#each user.businessPhones}}{{this}} {{/each}} |
| {{default a b}} | a, ou b se a estiver vazio | {{default establishment.phone company.phone}} |
| {{formatPhone x}} | +5585999158805 vira (85) 9 9915-8805 | {{formatPhone user.mobilePhone}} |
| {{upper x}}, {{lower x}} | Maiúsculas, minúsculas | {{upper user.state}} |
| {{#if (eq a "b")}} … {{/if}} | Compara com um valor fixo | {{#if (eq user.state "PE")}}Pernambuco{{/if}} |
{{default establishment.address company.address}}: o endereço da filial da pessoa; para quem não tem filial, o da matriz. Os seis modelos da galeria usam isso em endereço, telefone e site. Sem o default, quem não tem estabelecimento ficaria com o campo em branco.
Copie e adapte. O preview mostra o resultado com o "Ver como".
{{user.displayName}}
{{default user.jobTitle "Colaborador"}}{{#if user.department}} · {{user.department}}{{/if}}
{{#if user.mobilePhone}}{{formatPhone user.mobilePhone}}{{/if}}{{#if user.businessPhone}}{{#if user.mobilePhone}} · {{/if}}{{formatPhone user.businessPhone}}{{/if}}
{{default establishment.name company.name}}
{{default establishment.address company.address}}{{#if establishment.city}} · {{establishment.city}}/{{establishment.state}}{{/if}}