Glosario
El vocabulario de la plataforma DUST, en orden alfabético. La documentación utiliza estos términos de manera coherente; las rutas de los endpoints de la API y los nombres de los campos conservan en ocasiones nombres de implementación anteriores (indicados en cada término).
Activar
Sección titulada «Activar»Hacer que las marcas DUST de una Etiqueta sean identificables, de modo que un escaneo de Identificación pueda encontrar la Etiqueta o, una vez vinculada, su Ficha. Las Etiquetas inscritas por una estación de inscripción llegan en modo de solo verificación y permanecen así hasta que se activan. Cualquier miembro del Equipo puede activar una Etiqueta o una Bobina completa; no es una acción de administrador. Consulta Etiquetas y bobinas.
Adoptar
Sección titulada «Adoptar»Incorporar a tu propia copia de una Ficha un cambio que una fuente anterior ha divulgado. La adopción es una decisión, no una sincronización: los datos divulgados permanecen visibles sin necesidad de adoptarlos, y una copia que ya hayas adoptado permanece contigo incluso si la fuente la oculta posteriormente. Consulta Divulgaciones.
Alineación
Sección titulada «Alineación»Indica si dos escaneos de un Identificador pueden registrarse entre sí con la precisión suficiente para compararlos. Es una condición previa para un Análisis de alteraciones, nunca un resultado: una alineación deficiente significa que la comparación no es utilizable, no que haya algún problema con el artículo.
Clave de API
Sección titulada «Clave de API»La credencial emitida a una Cuenta de servicio, que se intercambia por un token de portador de corta duración antes de llamar a la API. No existen claves de API personales. Las claves y los tokens conceden el acceso completo de la Cuenta de servicio y deben utilizarse en un servidor, nunca en un navegador. Consulta Autenticación.
Archivar (Identificador)
Sección titulada «Archivar (Identificador)»Ocultar un Identificador de la vista predeterminada de una Ficha sin desvincularlo. Es la regla de visualización opuesta a Anular, que mantiene el Identificador visible y marcado. Ambas son independientes: un Identificador puede estar archivado, anulado o ambas cosas. Consulta Identificadores y escaneo.
Ensamblaje
Sección titulada «Ensamblaje»Una Ficha que agrupa otras Fichas como piezas adjuntas, pero que sigue siendo por sí misma una Ficha plenamente autónoma, con su propio nombre, Campos, Identificadores y Certificado. Un Ensamblaje puede estar anidado dentro de otro Ensamblaje. Todas las Fichas accesibles dentro de un Ensamblaje pertenecen al mismo Equipo propietario.
Vincular
Sección titulada «Vincular»El acto de asociar un Identificador con una Ficha, realizado mediante los endpoints de Identificadores. Una vez vinculado, el escaneo del Identificador permite resolverlo hasta esa Ficha.
Vinculación en bloque
Sección titulada «Vinculación en bloque»Una operación que vincula un Intervalo de la bobina con una selección ordenada de Fichas: la primera Etiqueta del intervalo con la primera Ficha, la segunda con la segunda y así sucesivamente. Es una operación indivisible y nunca omite una posición, porque una omisión desplazaría silenciosamente todos los emparejamientos posteriores. Previsualiza el emparejamiento en la Lista de emparejamientos antes de vincular. Consulta Etiquetas y bobinas.
Controles de la cámara
Sección titulada «Controles de la cámara»La aplicación de escritorio DUST Camera Controls, que permite que un sitio web controle un Dragon conectado: opciones de enfoque y captura a las que un navegador no puede acceder por sí solo. Es opcional: Dragon también funciona como una cámara convencional sin ella. Consulta Dispositivos compatibles.
Categoría
Sección titulada «Categoría»Una agrupación transversal que clasifica Fichas. A diferencia de una Carpeta, una Ficha puede pertenecer a varias Categorías a la vez. Las Categorías pueden anidarse bajo una Categoría superior (subcategorías); la pertenencia es directa, no se acumula en los niveles superiores.
Certificado
Sección titulada «Certificado»Un PDF inmutable de un momento concreto, generado a partir de los datos de una Ficha y emitido por la plataforma. Se almacena como un Recurso adjunto a la Ficha, con un registro que contiene su estado de confianza (emitido o anulado) y su procedencia. La suma de comprobación del Recurso es el hash del certificado.
Formulario de certificado
Sección titulada «Formulario de certificado»Un diseño reutilizable propiedad del Equipo que define la disposición de un Certificado y qué datos de la Ficha lo completan. Un Formulario de certificado localiza los valores por el nombre del campo (con alias opcionales), no por la Plantilla, por lo que puede generar Certificados tanto para Fichas propias como compartidas y transferidas.
Conexión
Sección titulada «Conexión»La relación permanente entre dos Equipos de distintas Organizaciones: el canal para todos los intercambios entre equipos. El uso compartido y los Envíos solo se inician mediante una Conexión, y su ciclo de vida (pendiente, conectada, pausada o eliminada) y dirección (enviar, recibir o ambas) determinan qué puede circular entre ambos. Los Equipos de una misma Organización colaboran sin una Conexión.
Cortar (Bobina)
Sección titulada «Cortar (Bobina)»Mover un tramo contiguo de Etiquetas de una Bobina a otra: la representación en el registro de cortar físicamente el rollo y la forma en que un pedido de cliente sale de tu inventario. El tramo se delimita escaneando la primera y la última Etiqueta o introduciendo las posiciones. Las posiciones del tramo que no pueden moverse (porque están archivadas, enviadas o nunca se inscribieron) se quedan atrás como huecos, y el recuento resultante se previsualiza y se aplica obligatoriamente si indicas una cantidad de pedido. Consulta Etiquetas y bobinas.
Transacción declarada
Sección titulada «Transacción declarada»Una entrada de procedencia afirmada por una persona o un sistema empresarial, en lugar de una observada por la plataforma: la recepción de mercancías, la aprobación de una inspección o una venta. Cada entrada tiene una atribución y es permanente: acompaña al historial del artículo y puede retractarse, pero nunca eliminarse. La plataforma registra la declaración; no la verifica. Consulta Registrar eventos pasados y Procedencia de ERP.
Versión del diseño
Sección titulada «Versión del diseño»Una versión inmutable y numerada de un Diseño de página pública —v1, v2, v3— que queda fijada cuando se publica el diseño y que es lo único a lo que se denomina «versión» en el módulo de Páginas públicas (las publicaciones propias de una página se identifican por fecha, nunca se numeran). Publicar una versión no modifica ninguna página en línea; las páginas solo pasan a utilizarla mediante un despliegue, que avanza en una única dirección: una Versión del diseño nunca se restaura y una versión incorrecta se corrige publicando otra más reciente.
Divulgación
Sección titulada «Divulgación»El acto explícito mediante el cual el propietario de una Ficha hace visibles determinados datos —Campos, Recursos, Identificadores o Certificados— en los niveles posteriores a través de Fabric. Las copias transferidas son instantáneas: las modificaciones de la fuente solo se propagan cuando el propietario las divulga expresamente, y una divulgación realizada queda visible para todos los consumidores posteriores de la cadena.
El escáner DUST USB. Lee una marca DUST mediante su propio sistema óptico, por lo que realiza la captura en lugar de asistir a la cámara de un teléfono como hace una Loupe. En un escritorio se conecta a un ordenador, donde la aplicación Controles de la cámara añade el control del enfoque; en Android se conecta al teléfono, donde DUST Go lo controla directamente. Consulta Dispositivos compatibles.
DUST (identificador)
Sección titulada «DUST (identificador)»La marca DUST física aplicada a un objeto, escaneada como una captura de imagen y resuelta en el servidor mediante su identificación o verificación respecto a los Identificadores inscritos. Un Identificador DUST representa una identidad física y nunca se copia entre Fichas. Consulta Identificadores y escaneo.
DUST Go
Sección titulada «DUST Go»El punto de entrada móvil para experiencias web compatibles con DUST: una aplicación anfitriona que ejecuta una página web y le da acceso al hardware de escaneo del dispositivo, ya sea la cámara del teléfono con una Loupe en iPhone o un Dragon conectado por USB en Android. Las aplicaciones web se comunican con ella mediante el puente dust-go-connect. Consulta DUST Go.
Estación de inscripción
Sección titulada «Estación de inscripción»Una estación que inscribe Etiquetas en una Bobina mediante la API, normalmente junto a la máquina que las imprime o aplica. Las estaciones que funcionan sin supervisión realizan la inscripción en modo de solo verificación de manera predeterminada, por lo que las Etiquetas deben activarse antes de que un escaneo de Identificación pueda encontrarlas.
Composición prevista
Sección titulada «Composición prevista»La cantidad de Identificadores de cada tipo que contiene una Etiqueta de una Bobina determinada, introducida como un número por tipo. Sirve de guía para la inscripción —una ranura de captura por cada Identificador previsto—, pero nunca limita lo que una Etiqueta puede contener realmente. Consulta Etiquetas y bobinas.
El grafo de procedencia entre equipos de la plataforma. Cuando se transfiere o divide una Ficha, Fabric registra las relaciones resultantes entre las Fichas de origen y las derivadas, y propaga las Divulgaciones a través de ellas, independientemente del uso compartido en directo o del estado de la Conexión.
Un valor con nombre y tipo de una Ficha: texto, números, fechas, imágenes y otros atributos que describen el artículo representado por la Ficha. Las Plantillas definen conjuntos reutilizables de Campos.
Carpeta
Sección titulada «Carpeta»Un contenedor que admite anidamiento y organiza Fichas y otras Carpetas. Una Ficha reside como máximo en una Carpeta (un único hogar; compáralo con Categoría). Compartir una Carpeta concede acceso en cascada a su contenido.
Identificable
Sección titulada «Identificable»Un Identificador DUST que se ha indexado para que un escaneo de Identificación pueda encontrarlo. Es lo contrario de solo verificación. Las marcas DUST inscritas en DICE son identificables de manera predeterminada; las procedentes de una estación de inscripción se vuelven identificables cuando se activan.
Identificador
Sección titulada «Identificador»Un código físico o digital escaneable asociado con una Ficha: DUST, QR, código de barras, Data Matrix o NFC. Es el término orientado a los usuarios para lo que la API denomina tag; las rutas de los endpoints y los nombres de los campos conservan la denominación heredada (/api/v1/tags, tagType). Consulta Identificadores e Identificadores y escaneo.
Identificación
Sección titulada «Identificación»El acto de encontrar una Ficha escaneando o introduciendo un Identificador. Los Equipos en los que se busca se establecen en cada solicitud (el campo searchTeamIds de la API); de manera predeterminada, se utiliza el Equipo en cuyo contexto actúa la solicitud. Consulta Identificadores.
Etiqueta
Sección titulada «Etiqueta»Una etiqueta física que contiene uno o varios Identificadores: un código de texto impreso, una marca DUST, un código QR, un chip NFC, un código de barras o un símbolo Data Matrix, en cualquier combinación. Las Etiquetas se fabrican en una Bobina y conservan su posición física en ella. Hasta que una Etiqueta se vincula con una Ficha, forma parte del inventario; al vincularla se adjuntan todos sus Identificadores a la vez. Consulta Etiquetas y bobinas.
Colección de etiquetas
Sección titulada «Colección de etiquetas»Una carpeta que agrupa Bobinas. Es únicamente una herramienta organizativa y nunca se envía, a diferencia de una Carpeta, que organiza Fichas. Una Bobina que no está dentro de ninguna Colección está sin colección.
Un accesorio óptico que se monta sobre la cámara trasera de un teléfono para ampliar una marca DUST y permitir que la propia cámara del teléfono la fotografíe. No es una cámara en sí misma y es específica para cada modelo: cada Loupe se adapta a un teléfono concreto dentro de una funda MagSafe compatible. Consulta Dispositivos compatibles.
Manifiesto
Sección titulada «Manifiesto»El borrador del contenido de un Envío u otra operación de Fabric: las Fichas seleccionadas, sus activos seleccionados y cualquier estructura de Ensamblaje, Carpeta o Categoría que deba incluirse. El manifiesto queda fijado cuando se envía el Envío.
Marcador
Sección titulada «Marcador»Una de las partículas DUST que contabiliza un Análisis de alteraciones al comparar un escaneo reciente con la referencia capturada durante la Vinculación. Es distinto de un Identificador: los marcadores son los componentes de una marca DUST concreta. Consulta Análisis de alteraciones.
Organización
Sección titulada «Organización»El límite de cuenta de nivel superior, que contiene Equipos y sus miembros. Las solicitudes de la API indican la Organización activa en el encabezado Dust-Ctx-Org-Id. Consulta Convenciones.
Pieza / Posición
Sección titulada «Pieza / Posición»Una Pieza es una Ficha adjunta a un Ensamblaje: cada Ficha es una pieza de un solo Ensamblaje como máximo y, de manera predeterminada, hereda el acceso del Ensamblaje. Una Posición es un Campo con nombre y valor de tipo Ficha de un Ensamblaje, asignado a una de sus Fichas adjuntas (por ejemplo, «rueda delantera»). Es distinta de la posición de una Etiqueta en su Bobina, que es una clave de ordenación del inventario físico, no una ranura de un Ensamblaje.
Lista de emparejamientos
Sección titulada «Lista de emparejamientos»La tabla de emparejamiento entre posiciones y Fichas que una Vinculación en bloque muestra antes de vincular y conserva después, y que puede descargarse como CSV, para que la persona del banco aplique la Etiqueta correcta al artículo correcto. Se deriva del Intervalo de la bobina y de la selección; nunca se almacena como un registro independiente.
Página pública
Sección titulada «Página pública»La vista web pública y sin autenticación de una Ficha: el pasaporte digital del producto al que llega un consumidor al escanear un Identificador o seguir un enlace impreso. Su URL es permanente y puede reservarse (e imprimirse su código QR) antes de publicar contenido; hasta entonces, muestra un aviso de «registrado». Una Página pública no tiene una configuración de contenido propia: muestra exactamente lo que obtiene su Diseño de página pública, fijando una Versión del diseño y una publicación de sus datos. Consulta Páginas públicas.
Diseño de página pública
Sección titulada «Diseño de página pública»Un diseño reutilizable propiedad de un Equipo que determina el contenido y la apariencia de cada Página pública publicada mediante él: una pila ordenada de bloques que obtiene datos de la Ficha por el nombre del campo, del mismo modo que lo hace un Formulario de certificado. Un diseño sirve para una línea de productos completa; editarlo no modifica nada público hasta que se publica y despliega una Versión del diseño.
Publicación en bloque
Sección titulada «Publicación en bloque»Una ejecución en segundo plano con un ámbito definido que publica o vuelve a publicar cada Página pública de una Carpeta, Categoría, Plantilla o selección explícita mediante una Versión del diseño, contabilizando los éxitos y errores por Ficha. Una publicación en bloque puede reintentarse para los casos fallidos o cancelarse, lo que detiene las páginas restantes sin revertir las que ya se han publicado.
Publicador
Sección titulada «Publicador»Un permiso asociado a la pertenencia a un Equipo que significa «puede hacer públicos los datos de este Equipo». Controla todos los cambios del módulo de Páginas públicas: la creación y publicación de Diseños de página pública, la publicación y retirada de páginas, los despliegues y las Publicaciones en bloque. Los administradores del Equipo siempre lo poseen; los miembros que no lo tienen disponen de acceso de solo lectura al módulo. Las Cuentas de servicio pueden tenerlo para publicar mediante procesos automatizados.
Creación rápida
Sección titulada «Creación rápida»Un flujo alternativo de Nueva ficha que abre un paso opcional de captura de una foto, seguido de un paso breve de creación, con una opción Añadir detalles / formulario completo para pasar al formulario completo. Se habilita por organización, por lo que muchos Equipos ven directamente el formulario completo. Consulta Primeros pasos.
Ocultar
Sección titulada «Ocultar»Retirar un activo de una Divulgación realizada anteriormente. Los Equipos posteriores dejan de ver información adicional, pero todo lo que ya hayan adoptado permanece con ellos: una divulgación no puede dejar de haberse visto; solo puede detenerse. Consulta Divulgaciones.
El rollo físico en el que se fabrican las Etiquetas y la unidad en la que DICE realiza su seguimiento. Una Bobina tiene un nombre (normalmente el número impreso en el rollo), una descripción opcional y una composición prevista. Cada Etiqueta conserva su posición en la Bobina: una clave de ordenación que no aparece impresa en la propia Etiqueta y en la que es normal que haya huecos. Las Bobinas se encuentran en el nivel superior del inventario de un Equipo o dentro de una Colección de etiquetas. Consulta Etiquetas y bobinas.
Intervalo de la bobina
Sección titulada «Intervalo de la bobina»Un tramo contiguo e inclusivo de posiciones de una Bobina, leído en el orden de la bobina: la selección que consume una Vinculación en bloque. No es un Corte: las Etiquetas permanecen donde están.
Relación
Sección titulada «Relación»Un tipo de relación direccional utilizado para conectar dos Fichas que pertenecen al mismo Equipo (por ejemplo, «suministrado por»). Las relaciones son anotaciones de formato libre; a diferencia de la asociación de Piezas, no conceden acceso ni admiten anidamiento.
Recurso
Sección titulada «Recurso»Un archivo adjunto a una Ficha: documentos, imágenes y otros archivos cargados. Los Recursos pueden seleccionarse para incluirlos en Manifiestos, Divisiones y Divulgaciones.
Retractar
Sección titulada «Retractar»La única corrección disponible para una entrada registrada, como una Transacción declarada: una fe de erratas, no una eliminación. Tanto la entrada original como su retractación permanecen en el registro de transacciones, porque el registro se comparte con futuros propietarios.
Ámbito de escaneo
Sección titulada «Ámbito de escaneo»El conjunto de Equipos en los que busca una Identificación. Todas las interfaces de escaneo utilizan este nombre; la API lo expresa como searchTeamIds y, de manera predeterminada, utiliza el Equipo en cuyo contexto actúa la solicitud. Consulta Identificadores y escaneo.
Cuenta de servicio
Sección titulada «Cuenta de servicio»Una identidad de máquina propiedad de una Organización. Las integraciones de API actúan como una Cuenta de servicio, nunca como una persona, y esta es la titular de una clave de API. Una Cuenta de servicio pertenece a los Equipos en los que puede actuar, exactamente igual que una persona. Consulta Autenticación.
Compartir
Sección titulada «Compartir»Conceder a otro Equipo acceso en directo a una Ficha o Carpeta mientras tu Equipo sigue siendo el propietario. El otro Equipo la ve en su vista Compartido con el rol que le hayas concedido, y el acceso puede revocarse, a diferencia de una Transferencia, que cede la propiedad de forma definitiva. Consulta Uso compartido y acceso.
El nombre orientado a los usuarios que DICE utiliza para una Transferencia: un paquete entrante o saliente de Fichas intercambiado entre Equipos conectados, que pasa por los estados de borrador, enviado, aceptado y en procesamiento, y que el destinatario puede aceptar, rechazar o devolver con una solicitud de cambios.
Dividir
Sección titulada «Dividir»Derivar nuevas Fichas de una Ficha de origen copiando o relacionando determinados Campos, archivos e Identificadores, mientras Fabric registra el linaje. Los Identificadores DUST representan una identidad física y nunca se copian en una división.
Análisis de alteraciones
Sección titulada «Análisis de alteraciones»Una comparación de un escaneo reciente de un Identificador DUST con la referencia capturada cuando se vinculó, que genera mediciones de cobertura de marcadores y capas de evidencias visuales, pero ninguna conclusión. La plataforma informa de lo que ha medido y muestra las evidencias; nunca indica si el Identificador ha sido alterado ni ofrece una cifra de resumen, una valoración o un umbral. Consulta Análisis de alteraciones.
Observación de alteraciones
Sección titulada «Observación de alteraciones»La conclusión que extrae una persona de un Análisis de alteraciones: la única conclusión que almacena la plataforma. Su resultado es Coherente, Esperado (desgaste normal para el caso de uso y el sustrato del identificador), Incoherente o Indeterminado, y debe elegirse activamente, sin una opción predeterminada. Las Observaciones tienen atribución, son inmutables y nunca se sustituyen: cada Análisis conserva la serie completa. El sujeto es la superficie del Identificador, no la Ficha ni los bienes que esta representa.
El ámbito de acceso y colaboración dentro de una Organización. Los Equipos son propietarios de Fichas y Carpetas, y constituyen la unidad de uso compartido, Conexiones y contexto de solicitud. El encabezado de la solicitud es Dust-Ctx-Team-Id; Dust-Ctx-Grp-Id es la denominación heredada, que todavía se acepta como alias del encabezado (Dust-Ctx-Team-Id prevalece cuando se envían ambos). Ese alias es el único nombre «group» que se conserva en el protocolo; los campos del cuerpo de la solicitud utilizan la denominación actual, como searchTeamIds en la identificación. Algunos códigos de error (GROUP_ID_REQUIRED) también son anteriores al cambio de nombre. Consulta Convenciones.
Plantilla
Sección titulada «Plantilla»Una definición reutilizable de los Campos que contiene una Ficha, utilizada al crear Fichas individualmente o importarlas en bloque (por ejemplo, desde un archivo CSV).
Código de texto
Sección titulada «Código de texto»El Identificador impreso y legible por humanos de una Etiqueta, que se introduce con un teclado en lugar de escanearse. Es el método de último recurso cuando una cámara no puede leer un código, y el que funciona con una Etiqueta de solo verificación.
El registro central de la plataforma: una identidad digital para una cosa física o un artículo. Una Ficha contiene Campos, Recursos, Identificadores y Certificados, reside en una Carpeta y puede clasificarse, compartirse, enviarse, dividirse y divulgarse.
Versión de la ficha
Sección titulada «Versión de la ficha»Una Ficha tal como se encontraba en un momento determinado de su cadena de Fabric: su estado Actual —los datos actuales, cuando tienes acceso en directo— más una versión fija por cada ocasión en que se transfirió, se dividió o se propagó una Divulgación por su cadena. Consulta Fabric.
Registro de transacciones
Sección titulada «Registro de transacciones»El registro permanente y atribuido de todo lo que ha sucedido a una Ficha: los eventos observados por la plataforma junto con las Transacciones declaradas. Acompaña al artículo cuando pasa a futuros propietarios y sus entradas nunca se eliminan, solo se retractan. Consulta Actividad.
Transferencia
Sección titulada «Transferencia»Mover Fichas de un Equipo a otro mediante una Conexión: el destinatario recibe nuevas Fichas de las que es propietario absoluto, las Fichas de origen se cierran y Fabric relaciona ambos lados. En DICE se presenta como Envíos; la aceptación es el punto de no retorno.
Verificación
Sección titulada «Verificación»Confirmar que un Identificador escaneado coincide con un Identificador previsto vinculado a una Ficha específica: una comprobación de sí o no respecto a una identidad declarada, a diferencia de la búsqueda abierta de la Identificación. Consulta Identificadores.
Solo verificación
Sección titulada «Solo verificación»Un Identificador DUST cuya coincidencia con una Ficha declarada puede confirmar la Verificación, pero que no puede encontrar la Identificación porque no se ha indexado. Es lo contrario de identificable. Se utiliza deliberadamente para el inventario que debe permanecer fuera de las búsquedas hasta que se active.
Una URL pública permanente que redirige a un destino bajo tu control; se imprime como código QR en un artículo y puede redirigirse posteriormente sin necesidad de volver a imprimir nada. Consulta Vlinks.
Anular (Identificador)
Sección titulada «Anular (Identificador)»Marcar un Identificador para indicar que ya no es la marca actual de un artículo: la marca DUST se destruyó, se volvió a aplicar o se cortó el material marcado. La anulación es una etiqueta: el Identificador permanece vinculado a su Ficha con todo su historial, continúa visible en la lista de Identificadores (en rojo y marcado como Anulado) y todavía puede identificarse, verificarse y desvincularse. Es reversible y no modifica el registro DUST subyacente. Es distinta del archivado, que oculta un Identificador de la vista predeterminada, y de la anulación de un Certificado, que es permanente. Consulta Identificadores y escaneo.