Certificados

Os Certificados são PDF imutáveis gerados a partir dos dados de um Registo. Crie uma única vez um Formulário de certificado reutilizável — um fundo em PDF ou imagem com zonas de dados posicionadas — e utilize-o para gerar certificados para qualquer Registo cujos dados satisfaçam o formulário. Depois de emitido, um certificado é uma cópia permanente: editar posteriormente o Registo ou o formulário nunca altera um PDF já emitido.

Quem pode fazer o quê

As pré-visualizações, as verificações prévias e a geração de certificados utilizam apenas os Campos, Identificadores e Recursos de imagem que tem permissão para ver. Um Registo partilhado não concede acesso aos respetivos recursos privados, e uma referência a um Recurso, por si só, não concede permissão para o incorporar.

As listas, os detalhes e as transferências de certificados também respeitam a privacidade do ficheiro PDF. Conhecer o ID de um Certificado não concede acesso a um PDF privado. Os designs dos Formulários de certificado exigem que seja atualmente membro da Equipa proprietária.

O acesso depende da sua função na Equipa ativa:

Os administradores da Equipa gerem os formulários: podem criá-los, editar o design e as vinculações de campos, importá-los e arquivá-los.
Todos os membros da equipa podem consultar os formulários e utilizar os que estejam ativos para gerar certificados PDF a partir dos dados dos Registos.

Formulários de certificado

Abra Formulários de certificado na barra lateral (/app/certificates/forms). Os formulários são «designs reutilizáveis que vinculam dados dos Registos a Certificados PDF gerados». A lista apresenta o nome, o estado, o número de vinculações e a última atualização de cada formulário; utilize Mostrar arquivados para incluir os formulários arquivados.

Na lista, pode criar um formulário (Novo formulário — atribua-lhe um nome; adicionará o design em seguida), Copiar formulário, Importar uma definição de formulário exportada anteriormente e Arquivar ou Restaurar um formulário. O estado de um formulário pode ser Ativo ou Arquivado — apenas são disponibilizados formulários ativos durante a geração.

O editor de formulários

Ao abrir um formulário, é iniciado o Editor de Formulários de certificado. Um formulário tem dois componentes:

Um design — carregue um PDF ou uma imagem (Carregar design (PDF ou imagem)) para utilizar como fundo do certificado. É necessário um design para poder posicionar campos. Substituir posteriormente o design remove todos os campos posicionados e as respetivas posições; os certificados já emitidos não são afetados.
Campos posicionados — zonas que coloca no design com um clique, cada uma vinculada a uma fonte de dados.

Para ver valores realistas durante a criação do design, escolha um Contexto do design («A criar o design com base em»): um Registo (dados reais de pré-visualização) ou um Modelo de Registo (apenas nomes de campos) a partir do qual serão criadas as vinculações iniciais. Mudar de contexto nunca altera os campos já posicionados.

Fontes dos campos

Cada zona posicionada obtém o respetivo valor de uma de quatro fontes:

Campos do Registo — elementos que apresentam os campos do Registo ou Modelo no qual está a basear o design. Os campos já abrangidos pelo formulário são assinalados, e pode adicionar o nome de um campo como alias a uma zona existente em vez de o posicionar novamente.
Fontes do sistema — valores que o DICE preenche no momento da geração: Nome do Registo, Descrição do Registo, Miniatura do Registo, UUID do Registo, Identificadores do Registo, Data de emissão, Nome da equipa emissora e o nome próprio, apelido e nome completo do emissor. As fontes do sistema também podem ser associadas como alternativas a uma zona de campo, sendo «utilizadas por ordem quando nenhum campo do Registo corresponde».
Campo personalizado — introduza o nome de um campo (bem como aliases opcionais e um tipo) para dados que ainda não sejam apresentados pelo contexto do design.
Texto estático — texto literal, «impresso exatamente como foi escrito — não é obtido a partir do registo».

Os tipos de campo são Texto, Número, Data, Booleano e Imagem, e uma zona pode ser apresentada como Texto simples ou como um código: QR, Code 128, Code 39 ou PDF417. As zonas têm posição/dimensões em milímetros, tipo de letra, tamanho, cor, alinhamento, rotação, opacidade e, no caso das datas, um formato de data. As zonas de texto também permitem aplicar os estilos negrito, itálico e sublinhado — estas opções aplicam-se à zona inteira.

Qualquer zona QR pode incluir um logótipo central: escolha uma imagem (PNG, JPEG ou WebP) nas propriedades da zona e o DICE desenha-a sobre o centro do código, numa área de margem com a cor de fundo da zona. O tamanho e a posição do logótipo são definidos automaticamente, e a correção de erros do QR é aumentada para que o código continue a poder ser digitalizado — não é necessário configurar nada.

Zonas QR Vlink estáveis

Adicione a fonte do sistema URL Vlink quando um Certificado precisar de um código QR permanente. Pode posicioná-la mais do que uma vez. Cada posicionamento recebe o seu próprio Vlink quando o Certificado é gerado, pelo que duas zonas QR podem conduzir a destinos diferentes e ser geridas de forma independente posteriormente.

Durante a geração, o DICE apresenta um cartão de configuração para cada posicionamento Vlink. Cada cartão pode apontar para a Página pública do Registo, utilizar um URL HTTP(S) personalizado ou permanecer sem configuração como rascunho. A Página pública é selecionada por predefinição quando existe, mas não é obrigatória para os outros posicionamentos. Os códigos QR de pré-visualização são representativos e distintos; os respetivos URLs Vlink permanentes só são criados quando clica em Gerar.

Como os campos são resolvidos — pelo nome, não pelo modelo

Um formulário não está associado a um Modelo de Registo. No momento da geração, o nome e os aliases do campo de cada zona são comparados com os nomes dos campos do Registo sem distinção entre maiúsculas e minúsculas — «Nome», «nome» e «NOME» são todos resolvidos para o mesmo campo. Qualquer Registo cujos nomes de campos correspondam pode utilizar o formulário, independentemente do modelo (se existir) que o criou.

Marcar uma zona como Obrigatória «impede a geração quando não é possível resolver este valor». As zonas não obrigatórias são simplesmente apresentadas vazias quando não existe qualquer correspondência.

Quando está selecionado um Registo como contexto do design, a pré-visualização assinala as zonas que não serão resolvidas, indicando motivos como sem valor, incompatibilidade de tipo, ambíguo, não será resolvido ou não será codificado (para formatos de código), e apresenta uma faixa com os campos obrigatórios que «não serão resolvidos para este Registo».

Verificação prévia

Sempre que escolhe um formulário para um Registo, o DICE executa uma verificação prévia: indica quantos campos obrigatórios são resolvidos («Resolve 3 de 4 campos obrigatórios») e apresenta um resultado geral de Compatível ou Não compatível. Os campos satisfeitos através de um alias são assinalados com o alias correspondente. A geração só é permitida quando a verificação prévia é bem-sucedida.

Gerar um certificado para um Registo

Abra o Registo e localize o respetivo cartão Certificados («PDF imutáveis gerados a partir dos dados deste registo.»).
Clique em Gerar certificado. Na caixa de diálogo, escolha um Formulário de certificado — ou selecione ＋ Novo formulário a partir deste registo… para criar um formulário preenchido inicialmente com os campos deste Registo.
Reveja o resultado da verificação prévia do formulário selecionado para este Registo.
Opcionalmente, defina um Nome do certificado — este é «apresentado na lista de certificados e utilizado como nome do ficheiro transferido» e, por predefinição, corresponde ao nome do formulário. Se o formulário contiver zonas QR Vlink, configure cada destino de forma independente. Clique em Pré-visualizar certificado para inspecionar primeiro o PDF gerado.
Clique em Gerar. Em caso de êxito, verá Certificado emitido, e o certificado será apresentado no cartão com a respetiva data de emissão.

No cartão, cada certificado disponibiliza as opções Transferir (o PDF) e Anular.

Geração em lote

Para emitir o mesmo certificado para vários Registos de uma só vez:

Na lista de Registos, selecione vários Registos e escolha Gerar certificados. Esta ação abre Gerar certificados em lote (/app/certificates/batch) com a sua seleção em fila de espera. Cada lote está limitado a 100 registos.
Selecione um Formulário de certificado. O DICE executa a verificação prévia de todos os Registos em fila de espera e classifica cada um como Conforme, Não conforme (com os campos em falta indicados) ou Não visível (não pode ver esse Registo neste contexto). Utilize a ação de nova verificação depois de corrigir os dados dos Registos.
Clique em Emitir N conformes. Os certificados são «emitidos individualmente»; cada linha passa de A emitir… para Emitido ou Falhou.
Em seguida, utilize Tentar novamente N com falha para as falhas, remova linhas com Remover do lote e utilize Exportar CSV para obter um registo da execução.

Anular um certificado

Os certificados emitidos não podem ser editados nem eliminados — podem ser anulados. «A anulação assinala o certificado como já não sendo válido para efeitos de consulta. O PDF e o respetivo hash permanecem inalterados.»

No cartão Certificados do Registo, clique em Anular junto ao certificado.
Escolha um Motivo: Emitido por engano, Dados incorretos do registo, Formulário errado, Certificado duplicado ou Outro.
Opcionalmente, adicione uma Nota interna (privada) e, em seguida, confirme com Anular.

Os certificados anulados permanecem na lista com a indicação Anulado e continuam disponíveis para transferência para os seus registos.

Sugestões sobre o ciclo de vida dos formulários

Arquivar retira um formulário de utilização sem afetar os certificados já emitidos a partir dele; Restaurar volta a disponibilizá-lo. Os formulários arquivados não são apresentados na caixa de diálogo de geração.
Copiar formulário duplica um formulário (incluindo o respetivo design e as vinculações), permitindo-lhe aperfeiçoá-lo sem alterar o original.
Exporte um formulário a partir do editor e Importe-o a partir da lista de formulários para mover um design entre Equipas — um formulário precisa de ter um design e um nome antes de poder ser exportado.

Registos — os dados a partir dos quais os certificados são gerados
Introdução — orientação para novos utilizadores
Perguntas frequentes — disponibilidade dos módulos e resolução de problemas

Comunicar um problema na documentação