Glossário

O vocabulário da plataforma DUST, por ordem alfabética. A documentação utiliza estes termos de forma consistente; os caminhos dos endpoints da API e os nomes dos campos mantêm, por vezes, nomes de implementação mais antigos (assinalados em cada termo).

Ativar

Tornar as marcações DUST de uma Etiqueta identificáveis, para que uma digitalização de Identificação consiga encontrar a Etiqueta ou, depois de vinculada, o respetivo Registo. As Etiquetas inscritas por uma estação de inscrição chegam no modo Apenas verificação e permanecem assim até serem ativadas. Qualquer membro da Equipa pode ativar uma Etiqueta ou um Rolo inteiro — não é uma ação de administrador. Consulte Etiquetas e Rolos.

Incorporar

Incorporar na sua própria cópia de um Registo uma alteração que uma fonte a montante tenha divulgado. A incorporação é uma decisão, não uma sincronização: os dados divulgados permanecem visíveis sem serem incorporados, e uma cópia que já tenha incorporado permanece consigo mesmo que, posteriormente, a fonte a oculte. Consulte Divulgações.

Alinhamento

Indica se duas digitalizações de um Identificador podem ser alinhadas entre si com precisão suficiente para serem comparadas. É uma condição prévia para uma Análise de adulteração, nunca um resultado — um alinhamento deficiente significa que a comparação não pode ser utilizada, não que exista algo de errado com o item.

Chave de API

A credencial emitida para uma Conta de serviço, trocada por um bearer token de curta duração antes de chamar a API. Não existem chaves de API pessoais. As chaves e os tokens conferem o acesso integral da Conta de serviço e devem ser utilizados num servidor, nunca num navegador. Consulte Autenticação.

Arquivar (Identificador)

Ocultar um Identificador da vista predefinida de um Registo sem o desvincular. É a regra de apresentação oposta a Anular, que mantém o Identificador visível e assinalado. As duas opções são independentes: um Identificador pode estar arquivado, anulado ou em ambos os estados. Consulte Identificadores e digitalização.

Conjunto

Um Registo que agrega outros Registos como peças anexadas, continuando a ser, por si só, um Registo de pleno direito — com o seu próprio nome, Campos, Identificadores e Certificado. Um Conjunto pode estar aninhado noutro Conjunto. Todos os Registos acessíveis dentro de um Conjunto pertencem à mesma Equipa proprietária.

Vincular

O ato de associar um Identificador a um Registo, realizado através dos endpoints de Identificadores. Depois de vinculado, a digitalização do Identificador remete para esse Registo.

Vincular em massa

Uma única operação que vincula um Intervalo do rolo a uma seleção ordenada de Registos — a primeira Etiqueta do intervalo ao primeiro Registo, a segunda ao segundo e assim sucessivamente. A operação é realizada na totalidade ou não é realizada de todo e nunca ignora uma posição, pois isso deslocaria silenciosamente todas as correspondências seguintes. Pré-visualize as correspondências na Lista de correspondências antes de efetuar a vinculação. Consulte Etiquetas e Rolos.

Controlos da câmara

A aplicação para computador DUST Camera Controls, que permite a um site controlar um Dragon ligado — incluindo definições de focagem e captura às quais um navegador não consegue aceder sozinho. É opcional: o Dragon também funciona como uma câmara comum sem a aplicação. Consulte Dispositivos suportados.

Categoria

Um agrupamento transversal que classifica Registos. Ao contrário de uma Pasta, um Registo pode pertencer simultaneamente a várias Categorias. As Categorias podem estar aninhadas sob uma Categoria principal (subcategorias); a associação é direta e não é agregada.

Certificado

Um PDF imutável, relativo a um momento específico, gerado a partir dos dados de um Registo e emitido pela plataforma. É armazenado como um Recurso anexado ao Registo, juntamente com um registo que contém o seu estado de confiança (emitido ou anulado) e a proveniência. A soma de verificação do Recurso é o hash do certificado.

Formulário de certificado

Um design reutilizável, pertencente à Equipa, que define a disposição de um Certificado e os dados do Registo que o preenchem. Um Formulário de certificado localiza valores pelo nome do campo (com aliases opcionais), não pelo Modelo, pelo que pode gerar Certificados para Registos próprios, partilhados e transferidos.

Ligação

A relação permanente entre duas Equipas de Organizações diferentes — o canal para todas as trocas entre equipas. A partilha e os Envios apenas são iniciados através de uma Ligação, e o respetivo ciclo de vida (pendente, ligada, em pausa ou eliminada) e direção (enviar, receber ou ambos) determinam o que pode circular entre as duas Equipas. As Equipas da mesma Organização colaboram sem uma Ligação.

Cortar (Rolo)

Mover um segmento contíguo de Etiquetas de um Rolo para outro — a representação no registo contabilístico do corte da bobina e a forma como uma encomenda de cliente sai do seu inventário. O segmento é delimitado através da digitalização da primeira e da última Etiqueta ou pela introdução das posições. As posições dentro do segmento que não possam ser movidas (por estarem arquivadas, enviadas ou nunca terem sido inscritas) ficam para trás como lacunas, e a contagem resultante é pré-visualizada — e aplicada, caso indique uma quantidade da encomenda. Consulte Etiquetas e Rolos.

Transação declarada

Uma entrada de proveniência declarada por uma pessoa ou um sistema empresarial, em vez de testemunhada pela plataforma — uma receção de mercadorias, a aprovação de uma inspeção ou uma venda. Cada entrada é atribuída e permanente: acompanha o histórico do item e pode ser retirada, mas nunca eliminada. A plataforma regista a declaração; não a verifica. Consulte Registar eventos anteriores e Proveniência de ERP.

Versão do design

Uma versão imutável e numerada de um Design de página pública — v1, v2, v3 — fixada quando o design é publicado, sendo este o único conceito designado por «versão» no módulo Páginas públicas (as publicações da própria página são identificadas pela data, nunca por um número). Publicar uma versão não altera nenhuma página em produção; as páginas só passam a utilizá-la através de uma implementação, que ocorre apenas no sentido progressivo: uma Versão do design nunca é restaurada e uma versão incorreta é corrigida através da publicação de uma versão mais recente.

Divulgação

O ato explícito através do qual o proprietário de um Registo torna dados selecionados — Campos, Recursos, Identificadores ou Certificados — visíveis a jusante através do Fabric. As cópias transferidas são instantâneos: as alterações na fonte só se propagam quando o proprietário as divulga explicitamente, e uma divulgação efetuada fica visível para todos os consumidores a jusante na cadeia.

Dragon

O scanner DUST USB. Lê uma marcação DUST através da sua própria ótica, pelo que efetua a captura em vez de auxiliar a câmara de um telemóvel como faz uma Loupe. Numa secretária, liga-se a um computador, onde a aplicação DUST Camera Controls adiciona o controlo de focagem; no Android, liga-se ao telemóvel, onde o DUST Go o controla diretamente. Consulte Dispositivos suportados.

DUST (identificador)

A marca DUST física aplicada a um objeto, digitalizada como uma captura de imagem e resolvida no servidor através da identificação ou verificação da sua correspondência com Identificadores inscritos. Um Identificador DUST representa uma identidade física e nunca é copiado entre Registos. Consulte Identificadores e digitalização.

DUST Go

O ponto de entrada móvel para experiências Web compatíveis com DUST: uma aplicação anfitriã que executa uma página Web e lhe dá acesso ao hardware de digitalização do dispositivo — a câmara do telemóvel com uma Loupe no iPhone ou um Dragon por USB no Android. As aplicações Web comunicam com ela através da bridge dust-go-connect. Consulte DUST Go.

Estação de inscrição

Uma estação que inscreve Etiquetas num Rolo através da API, geralmente junto da máquina que as imprime ou aplica. Por predefinição, as estações que funcionam sem supervisão inscrevem no modo Apenas verificação, pelo que as Etiquetas têm de ser ativadas antes de poderem ser encontradas por uma digitalização de Identificação.

Composição esperada

O número de Identificadores de cada tipo existente numa Etiqueta de determinado Rolo, introduzido como um número por tipo. Orienta a inscrição — um espaço de captura por Identificador esperado — mas nunca limita o que uma Etiqueta pode efetivamente conter. Consulte Etiquetas e Rolos.

Fabric

O grafo de proveniência entre equipas da plataforma. Quando um Registo é transferido ou dividido, o Fabric regista as ligações resultantes entre os Registos de origem e os derivados e transporta as Divulgações através dessas ligações — independentemente da partilha em direto ou do estado da Ligação.

Campo

Um valor com nome e tipo num Registo — texto, números, datas, imagens e outros atributos que descrevem o item representado pelo Registo. Os Modelos definem conjuntos reutilizáveis de Campos.

Pasta

Um contentor aninhável que organiza Registos e outras Pastas. Um Registo encontra-se, no máximo, numa Pasta (uma única localização — em contraste com uma Categoria). Partilhar uma Pasta concede, em cascata, acesso ao respetivo conteúdo.

Identificável

Um Identificador DUST que foi indexado, para que possa ser encontrado por uma digitalização de Identificação. É o oposto de Apenas verificação. As marcações DUST inscritas no DICE são identificáveis por predefinição; as provenientes de uma estação de inscrição tornam-se identificáveis quando são ativadas.

Identificador

Um código físico ou digital digitalizável associado a um Registo: DUST, QR, código de barras, Data Matrix ou NFC. É o termo apresentado ao utilizador para aquilo a que a API chama tag — os caminhos dos endpoints e os nomes dos campos mantêm a nomenclatura antiga (/api/v1/tags, tagType). Consulte Identificadores e Identificadores e digitalização.

Identificar

O ato de encontrar um Registo através da digitalização ou introdução de um Identificador. As Equipas pesquisadas são definidas em cada pedido (o searchTeamIds da API), sendo a predefinição a Equipa em cujo contexto o pedido atua. Consulte Identificadores.

Etiqueta

Uma etiqueta física que contém um ou mais Identificadores — um identificador de texto impresso, uma marcação DUST, um código QR, um chip NFC, um código de barras ou um símbolo Data Matrix, em qualquer combinação. As Etiquetas são fabricadas num Rolo e mantêm nele a sua posição física. Até uma Etiqueta ser vinculada a um Registo, pertence ao inventário; a vinculação associa todos os respetivos Identificadores de uma só vez. Consulte Etiquetas e Rolos.

Coleção de etiquetas

Uma pasta que agrupa Rolos. Serve apenas para organização e nunca é enviada — ao contrário de uma Pasta, que organiza Registos. Um Rolo que não pertença a qualquer Coleção está sem coleção.

Loupe

Um acessório ótico montado sobre a câmara traseira de um telemóvel para ampliar uma marcação DUST, permitindo que seja fotografada pela própria câmara do telemóvel. Não é uma câmara e é específico para cada modelo: cada Loupe adapta-se a um determinado telemóvel numa capa MagSafe compatível. Consulte Dispositivos suportados.

Manifesto

O conteúdo em rascunho de um Envio ou de outra operação do Fabric: os Registos selecionados, os respetivos recursos selecionados e qualquer estrutura de Conjunto, Pasta ou Categoria a transportar. O manifesto é fixado quando o Envio é expedido.

Marcador

Uma das partículas DUST que uma Análise de adulteração contabiliza ao comparar uma nova digitalização com a referência capturada durante a Vinculação. Distingue-se de um Identificador: os marcadores são os elementos que compõem uma marcação DUST individual. Consulte Análise de adulteração.

Organização

O limite de conta de nível superior, que contém Equipas e os respetivos membros. Os pedidos da API incluem a Organização ativa no cabeçalho Dust-Ctx-Org-Id. Consulte Convenções.

Peça / Posição

Uma Peça é um Registo anexado a um Conjunto — cada Registo é peça de, no máximo, um Conjunto e, por predefinição, herda o acesso do Conjunto. Uma Posição é um Campo com nome e valor de Registo num Conjunto, atribuído a um dos respetivos Registos anexados (por exemplo, «roda dianteira»). Distingue-se da posição de uma Etiqueta no respetivo Rolo, que é uma chave de ordenação no inventário físico, em vez de um espaço num Conjunto.

Lista de correspondências

A tabela de correspondências entre posições e Registos que uma operação de Vincular em massa apresenta antes da vinculação e conserva posteriormente, podendo ser transferida em formato CSV — para que a pessoa na bancada aplique a Etiqueta correta ao item correto. É derivada do Intervalo do rolo e da seleção, nunca sendo armazenada como um registo próprio.

Página pública

A vista Web pública e não autenticada de um Registo — o passaporte digital do produto ao qual um consumidor acede através da digitalização de um Identificador ou de uma ligação impressa. O respetivo URL é permanente e pode ser reservado (e o respetivo código QR impresso) antes de qualquer conteúdo ser publicado; até esse momento, apresenta um aviso de «registado». Uma Página pública não contém uma configuração de conteúdo própria: apresenta exatamente o que o respetivo Design de página pública obtém, fixando uma Versão do design e uma publicação dos respetivos dados. Consulte Páginas públicas.

Design de página pública

Um design reutilizável, pertencente à Equipa, que determina o conteúdo e o aspeto de todas as Páginas públicas publicadas através dele — uma pilha ordenada de blocos que obtêm os dados do Registo pelo nome do campo, tal como faz um Formulário de certificado. Um único design serve toda uma linha de produtos; editá-lo não altera nada que esteja público até ser publicada e implementada uma Versão do design.

Publicação em massa

Uma execução em segundo plano com âmbito definido que publica ou republica todas as Páginas públicas de uma Pasta, Categoria, Modelo ou seleção explícita através de uma Versão do design, contabilizando os êxitos e as falhas de cada Registo. Uma publicação em massa pode ser repetida para os casos que falharam ou cancelada — o que interrompe o processamento das páginas restantes sem reverter as que já foram publicadas.

Editor

Uma permissão atribuída à pertença a uma Equipa que significa «pode tornar públicos os dados desta Equipa». Controla todas as alterações no módulo Páginas públicas — criar e publicar Designs de página pública, publicar e retirar páginas da publicação, fazer implementações e executar Publicações em massa. Os administradores da Equipa têm sempre esta permissão; os membros que não a tenham dispõem de acesso só de leitura ao módulo. As Contas de serviço podem tê-la para realizar publicações através de pipelines.

Criação rápida

Um fluxo alternativo para criar um Novo Registo, que apresenta um passo opcional de captura de fotografia seguido de um passo breve de criação, com a opção Adicionar detalhes / formulário completo para aceder ao formulário completo. É ativado por organização, pelo que muitas Equipas veem diretamente o formulário completo. Consulte Introdução.

Ocultar

Retirar um recurso de uma Divulgação efetuada anteriormente. As Equipas a jusante deixam de ver detalhes adicionais, mas tudo o que já tenham incorporado permanece com elas — uma divulgação não pode deixar de ter sido vista, apenas pode ser interrompida. Consulte Divulgações.

Rolo

O rolo físico no qual as Etiquetas são fabricadas e a unidade através da qual o DICE as controla. Um Rolo tem um nome (geralmente o número impresso na bobina), uma descrição opcional e uma composição esperada. Cada Etiqueta mantém a sua posição no Rolo — uma chave de ordenação que não está impressa na própria Etiqueta e na qual é normal existirem lacunas. Os Rolos encontram-se no nível superior do inventário de uma Equipa ou dentro de uma Coleção de etiquetas. Consulte Etiquetas e Rolos.

Intervalo do rolo

Um segmento contíguo e inclusivo de posições num único Rolo, lido pela ordem do rolo — a seleção utilizada por uma operação de Vincular em massa. Não é uma operação de Cortar: as Etiquetas permanecem onde estão.

Relação

Um tipo de ligação direcional utilizado para ligar dois Registos pertencentes à mesma Equipa (por exemplo, «fornecido por»). As ligações de Relação são anotações de formato livre; ao contrário da associação de uma Peça, não concedem acesso nem criam aninhamento.

Recurso

Um ficheiro anexado a um Registo — documentos, imagens e outros carregamentos. Os Recursos podem ser selecionados para Manifestos, Divisões e Divulgações.

Retirar

A única correção disponível para uma entrada registada, como uma Transação declarada — uma errata, não uma eliminação. A entrada original e a respetiva retirada permanecem no registo de transações, porque o registo é partilhado com futuros proprietários.

Âmbito da digitalização

O conjunto de Equipas pesquisado por uma operação de Identificação. Todas as interfaces de digitalização utilizam este nome; a API representa-o como searchTeamIds, sendo a predefinição a Equipa em cujo contexto o pedido atua. Consulte Identificadores e digitalização.

Conta de serviço

Uma identidade de máquina pertencente a uma Organização. As integrações de API atuam como uma Conta de serviço, nunca como uma pessoa, e é esta conta que detém uma chave de API. Uma Conta de serviço é membro das Equipas nas quais pode atuar, tal como uma pessoa. Consulte Autenticação.

Partilhar

Conceder a outra Equipa acesso em direto a um Registo ou uma Pasta, enquanto a sua Equipa permanece proprietária. A outra Equipa vê-o na respetiva vista Partilhado, com a função que lhe foi concedida, e o acesso pode ser revogado — ao contrário de uma Transferência, que transfere definitivamente a propriedade. Consulte Partilha e acesso.

Envio

O nome apresentado aos utilizadores no DICE para uma Transferência: um pacote de Registos enviado ou recebido entre Equipas ligadas, que passa pelos estados de rascunho, enviado, aceite e em processamento, podendo o destinatário aceitá-lo, rejeitá-lo ou solicitar alterações.

Dividir

Derivar novos Registos de um Registo de origem através da cópia ou ligação de Campos, ficheiros e Identificadores selecionados, com o Fabric a registar a linhagem. Os Identificadores DUST representam uma identidade física e nunca são copiados para um Registo derivado.

Análise de adulteração

Uma comparação entre uma nova digitalização de um Identificador DUST e a referência capturada quando este foi vinculado, produzindo medições da cobertura dos marcadores e camadas de evidência visual — sem qualquer conclusão. A plataforma comunica o que mediu e apresenta a evidência; nunca declara se o Identificador foi adulterado e não fornece qualquer número de resumo, classificação ou limiar. Consulte Análise de adulteração.

Observação de adulteração

A conclusão de uma pessoa, obtida a partir de uma Análise de adulteração — a única conclusão que a plataforma armazena. O resultado pode ser Consistente, Esperado (desgaste normal para o caso de utilização e o substrato do identificador), Inconsistente ou Indeterminado, sendo escolhido ativamente e sem valor predefinido. As Observações são atribuídas, imutáveis e nunca substituídas: uma Análise conserva toda a série. O objeto em avaliação é a superfície do Identificador, não o Registo nem os bens que este representa.

Equipa

O âmbito de acesso e colaboração dentro de uma Organização. As Equipas são proprietárias de Registos e Pastas e constituem a unidade de partilha, de Ligações e do contexto dos pedidos. O cabeçalho do pedido é Dust-Ctx-Team-Id; Dust-Ctx-Grp-Id é a grafia antiga, ainda aceite como alias do cabeçalho (Dust-Ctx-Team-Id prevalece quando ambos são enviados). Esse alias é o único nome «group» que ainda existe na interface de comunicação — os campos do corpo dos pedidos utilizam a grafia atual, como searchTeamIds na identificação. Alguns códigos de erro (GROUP_ID_REQUIRED) também são anteriores à alteração do nome. Consulte Convenções.

Modelo

Uma definição reutilizável dos Campos de um Registo, utilizada ao criar Registos individualmente ou ao importá-los em massa (por exemplo, a partir de CSV).

Identificador de texto

O Identificador impresso e legível por pessoas existente numa Etiqueta, introduzido através do teclado em vez de digitalizado. É a opção de último recurso quando uma câmara não consegue ler um código — e a que funciona numa Etiqueta no modo Apenas verificação.

Registo

O registo principal da plataforma: uma identidade digital para uma coisa física ou um item. Um Registo contém Campos, Recursos, Identificadores e Certificados, encontra-se numa Pasta e pode ser classificado, partilhado, enviado, dividido e divulgado.

Versão do registo

Um Registo tal como existia num determinado ponto da respetiva cadeia do Fabric: o seu estado Atual — os dados atuais, quando existe acesso em direto — e uma versão fixa por cada ocasião em que foi transferido, dividido ou em que uma Divulgação foi propagada pela respetiva cadeia. Consulte Fabric.

Registo de transações

O registo permanente e atribuído de tudo o que aconteceu a um Registo — eventos testemunhados pela plataforma juntamente com Transações declaradas. Acompanha o item quando este passa para futuros proprietários, e as entradas nunca são eliminadas, apenas retiradas. Consulte Atividade.

Transferência

Mover Registos de uma Equipa para outra através de uma Ligação: o destinatário recebe novos Registos dos quais passa a ser o proprietário pleno, os Registos de origem são encerrados e o Fabric liga os dois lados. É apresentada no DICE como Envios; a aceitação é o ponto sem retorno.

Verificação

Confirmar se um Identificador digitalizado corresponde a um Identificador esperado, vinculado a um Registo específico — uma verificação de sim ou não face a uma identidade declarada, em contraste com a pesquisa aberta da Identificação. Consulte Identificadores.

Apenas verificação

Um Identificador DUST cuja correspondência com um Registo declarado pode ser confirmada pela Verificação, mas que não pode ser encontrado através da Identificação, por não ter sido indexado. É o oposto de identificável. É uma opção intencional para inventário que deva permanecer excluído da pesquisa até ser ativado.

Vlink

Um URL público permanente que redireciona para um destino sob o seu controlo — impresso num item como código QR e posteriormente redirecionado sem ser necessário voltar a imprimir. Consulte Vlinks.

Anular (Identificador)

Assinalar um Identificador como já não sendo a marcação atual de um item — o DUST foi destruído, reaplicado ou o material marcado foi cortado. A anulação é uma etiqueta: o Identificador permanece vinculado ao respetivo Registo, com todo o seu histórico, continua visível na lista de Identificadores (a vermelho, assinalado como Anulado) e ainda pode ser identificado, verificado e desvinculado. É reversível e não altera o registo DUST subjacente. Distingue-se do arquivamento, que oculta um Identificador da vista predefinida, e da anulação de um Certificado, que é permanente. Consulte Identificadores e digitalização.