Biblioteca de modelos da plataforma: versões, publicação, retirada e desativação de emergência
Como a equipe da plataforma mantém os modelos integrados de etiquetas UCC e packing lists: clonar ou criar rascunhos, publicar versões, enviar cópias aos tenants, retirar versões antigas e usar a desativação de emergência só quando necessário.
A biblioteca de modelos da plataforma guarda os modelos integrados com os quais cada tenant começa. Os modelos são organizados por família e versão: uma família (por exemplo, a UCC de palete 4×6 de um varejista) pode ter várias linhas de versão. Rascunhos são editáveis livremente; quando uma versão é publicada, seu conteúdo congela e qualquer mudança vai por uma nova versão. Tenants novos recebem automaticamente a versão publicada mais recente de cada família, e suas cópias nunca são sobrescritas por ações da plataforma.
Etapa 1: Crie um modelo — clonar é o caminho principal#
- Clonar (recomendado): em qualquer modelo publicado, abra Ações → "Clonar como novo modelo". Você recebe um rascunho novo com outro nome (sufixo -copy; renomeie conforme a convenção). Ajuste o layout e publique como sua própria família.
- Novo em branco: "Novo modelo" começa um rascunho vazio. Ao salvar, cada [[VARIÁVEL]] é conferida no registro de variáveis da plataforma — variável desconhecida é rejeitada com a dica "você quis dizer…?", porque variável com erro de digitação imprime em branco.
- As imagens de um modelo de documento — o logo ou o banner de um varejista, por exemplo — devem usar um endereço da biblioteca de imagens da plataforma. Ao salvar, as referências de imagem são conferidas como as variáveis: um endereço não registrado, ou qualquer link de imagem de outro site, é rejeitado com um aviso em linguagem simples. Peça primeiro à equipe da plataforma para registrar a imagem e depois cole o endereço registrado. Uma imagem colada como dados incorporados salva, mas incha cada cópia dos tenants — ao ver esse aviso, troque por um endereço registrado.
- Gerar com IA: envie uma amostra (foto, digitalização, PDF ou arquivo ZPL). Depois da análise, você decide, elemento a elemento, o que cada peça vira — uma variável, a variável mais próxima, texto fixo ou um pedido de nova variável. Texto que pareça dado real de pedido não pode ser congelado como está: mascare primeiro. O resultado é sempre um rascunho.
Etapa 2: Publique e depois envie — duas ações separadas#
- "Publicar como versão oficial" (em um rascunho) congela o conteúdo e a torna a versão que tenants novos recebem automaticamente. Nada é enviado aos existentes ainda.
- "Enviar aos tenants" (em uma versão publicada) envia cópias só aos tenants existentes que ainda não têm um modelo com este nome. Quem já tem é ignorado — nunca sobrescrito — e o resultado mostra enviados / ignorados / falhos. Antes de enviar ou retirar, abra "Tenants que usam" para ver exatamente quem tem cópia.
- Para mudar uma versão publicada, use "Nova versão": ela copia a versão para um rascunho novo (o número sobe um). Edite e publique; a versão antiga fica intacta para quem ainda a usa.
Etapa 3: Retire para o fim de vida normal; desativação de emergência só para problema real#
- Retirar: a versão para de ser distribuída — tenants novos não a recebem mais e os envios a ignoram. As cópias existentes continuam imprimindo sem mudanças, e a lista delas mostra um pequeno selo "Retirado pela plataforma" como aviso. Retirar é a forma normal de encerrar a vida de um modelo.
- Desativação de emergência: só para defeitos graves — por exemplo, um texto de conformidade ou regra de código de barras errados que precisam parar de imprimir em todo lugar agora. As cópias dos tenants são desativadas imediatamente e eles veem o motivo que você digitar, num alerta vermelho no modelo. O motivo é obrigatório, e cada desativação e restauração fica registrada. Use "Restaurar da desativação" para trazer de volta exatamente as cópias que aquela ação desativou.
- A "Lista de variáveis desejadas" reúne os elementos que você marcou como "precisa de variável nova" nas confirmações de IA — é a lista de entrada para as próximas inclusões no registro, então escreva os significados esperados em palavras claras.
Funções usadas neste artigo: Biblioteca de modelos da plataforma (famílias e versões), Clonar como novo modelo, Nova versão, Publicar como versão oficial, Enviar aos tenants, Tenants que usam, Retirar, Desativação de emergência e restauração, Geração com IA com confirmação por elemento, Lista de variáveis desejadas.