Ações

Os pacotes nomeados de etiquetas e relatórios que uma execução emite no Início ou na Conclusão, os comandos deles, os mapeamentos de marcador de uma etiqueta, e como um procedimento os escolhe.

Uma ação é um pacote nomeado de papelada que uma execução emite: dentro dela, um comando por emissão, cada um dizendo o que sai (uma etiqueta ou um relatório), quando (no Início ou na Conclusão), com qual modelo de documento da biblioteca da estação e, na Conclusão, para quais vereditos. Um procedimento escolhe ações inteiras, então um pacote escrito uma vez serve todo procedimento que o emite, e corrigir um comando é uma edição em vez de uma por procedimento. As ações vivem em Process > Modelos > modelo > Preparação > Ações. Criá-las, removê-las e editar o nome de uma ação, os comandos dela e os mapeamentos deles dependem todos da mesma permissão Editar receitas e avaliações, e as páginas dizem isso ("Mudar ações precisa da permissão “Editar receitas e avaliações”.").

A pasta Ações

Selecionar a linha Ações abre uma página diferente das outras pastas da Preparação: uma lista das ações do modelo ao lado daquela escolhida nela, porque uma ação é lida contra as irmãs dela. A ordem da lista é a ordem em que todo procedimento emite as ações, então os verbos de linha movem uma ação e nunca um comando. A página carrega as duas bibliotecas da estação (modelos de etiqueta e layouts de relatório) para julgar a prontidão; quando uma não pode ser carregada, um aviso diz "Não foi possível carregar os modelos de etiqueta globais: …" ou "Não foi possível carregar os relatórios globais: …".

A coluna ao lado da lista é encabeçada por Ação e mostra o Nome da ação escolhida (editável aqui também), os Comandos dela como frases somente para leitura, com uma pílula Pronta / Revisar em cada uma ("Os comandos são editados na página da própria ação, na coluna, nesta ordem."), e um aviso Precisa de revisão listando tudo o que falta. Sem nenhuma ação, a lista diz "Nenhuma ação. Acrescente uma quando um procedimento deste modelo tiver de emitir etiquetas ou relatórios."; sem nenhuma escolhida, a coluna diz "Selecione uma ação para ler o que ela emite. Os comandos dela são editados na página dela, na coluna."

A página da ação

Selecionar uma ação na árvore a abre: o cabeçalho com o nome da ação e uma pílula contando os comandos dela, os avisos de permissão e de biblioteca, um cartão Ação com o campo Nome (confirmado ao sair; em branco é recusado), e a lista de Comandos ao lado do comando escolhido nela.

A lista de Comandos

Sem nenhum comando, a lista diz "Nenhum comando. Acrescente um quando esta ação tiver de emitir uma etiqueta ou um relatório."; sem nenhum escolhido, a coluna diz "Selecione um comando para editá-lo inteiro num lugar só. Acrescente um pela barra acima quando esta ação tiver de emitir uma etiqueta ou um relatório."

O comando por inteiro

A coluna abre o comando escolhido, encabeçado por Comando <n> · <Tipo> na <Gatilho>. Ela mostra apenas os campos que o tipo escolhido tem.

Um aviso Precisa de revisão sob os campos lista tudo o que falta ao comando (veja Prontidão abaixo).

A fila para onde um documento impresso vai não é um campo do comando: ela é resolvida pelo tipo e pelo gatilho do comando, pelos quatro slots de impressora da unidade, então dois comandos da mesma combinação compartilham a impressora de propósito. Veja Impressoras.

Marcadores

Marcadores são os campos {{NAME}} que um modelo de etiqueta deixa para a execução preencher, então esta seção é desenhada para um comando de etiqueta e para mais nada. O estado dela acompanha o modelo:

As origens, na ordem em que o seletor as lista:

Sob as linhas de marcador, Marcadores removidos lista os mapeamentos guardados de marcadores que o modelo atual não declara mais ("<n> obsoletos"; "Estes mapeamentos não existem mais no modelo escolhido e precisam ser removidos."), cada um com Remover mapeamento de marcador obsoleto.

Prontidão

As pílulas Pronto / Revisar das duas páginas, e as linhas que a página Validação lista, vêm de um julgamento só. Uma ação sem comando está incompleta: "Acrescente um comando: esta ação ainda não emite nada." Um comando está incompleto por, na ordem em que se conserta:

• "Selecione ao menos um veredito de conclusão." (um comando de Conclusão sem veredito marcado)
• "Escolha um relatório." / "O relatório escolhido não existe mais."
• "Escolha um modelo de etiqueta." / "O modelo foi limpo ou excluído; os mapeamentos guardados estão preservados." / "O modelo global escolhido não existe mais."
• "O modelo escolhido ainda não tem comandos de impressora; escreva-os ou importe-os antes de uma execução chegar a este comando."
• "Os marcadores do modelo não podem ser lidos: <error>"
• "{{M}} precisa de uma origem." / "{{M}} está mapeado mais de uma vez."
• "{{M}}: escolha uma origem", "esta origem não está disponível no Início", "escolha um campo do catálogo de metadados deste modelo", "escolha um critério de uma das avaliações deste modelo", "defina um ciclo explícito começando em zero, de 0 a <n>", "remova as casas decimais desta origem de data e hora", "use o formato padrão para esta origem numérica", "as casas decimais precisam estar entre 0 e 9", "remova a formatação numérica ou de data desta origem de texto"
• "{{M}} foi removido do modelo atual; remova o mapeamento guardado dele."

Um comando em revisão ainda roda: nada é descartado na emissão, e um marcador que não resolve reprova aquela etiqueta, como sempre reprovou. A tela de configuração é onde isso se aprende, não a etiqueta impressa.

Como um procedimento escolhe ações

A página de um procedimento carrega o cartão Ações que este procedimento emite com uma pílula "<n> selecionadas" e uma caixa de seleção por ação do modelo, na ordem da lista. Cada linha mostra a frase de emissão da ação ("Etiqueta no Início, Etiqueta e relatório na Conclusão", ou "Não emite nada ainda: esta ação não tem comandos.") e, depois de escolhida, uma pílula Pronta ou Revisar. Revisar lista o que este procedimento não tem para os marcadores da ação, uma observação por marcador, porque um marcador resolvido por execução só resolve onde o procedimento tem a coisa que ele nomeia:

• "{{M}} lê um campo de metadados que este Procedimento não pergunta. Marque-o em Metadados acima."
• "{{M}} lê um resultado de critério, e este Procedimento não julga por avaliação nenhuma."
• "{{M}} lê um critério que a avaliação deste Procedimento não declara."
• "{{M}} lê o ciclo <c>, e este Procedimento roda um ciclo só." / "… roda <n>."

A ação não é escondida nem recusada: o procedimento diz o que lhe falta, e o remédio está na mesma página. Sem nenhuma ação no modelo, o cartão diz "Nenhuma ação neste modelo ainda. Acrescente algumas nas Ações do modelo."

A ordem de emissão

Numa fronteira de execução, as ações escolhidas emitem na ordem da lista do modelo e, dentro de cada ação, na ordem dos comandos dela, filtradas pelo gatilho daquela fronteira: uma resposta para o modelo inteiro, nunca uma por procedimento. Os comandos de Início rodam depois que a execução se materializou (depois de os metadados sequenciais serem reservados), e os comandos de Conclusão depois que o veredito terminal é selado. Cada comando é isolado: uma falha não publica nada, não muda nada da execução e nunca para os comandos atrás dela. Um relatório é nomeado a partir da execução e da ação que o emitiu; uma renderização posterior do mesmo comando substitui o documento daquele comando e nada mais. O que cada emissão grava na execução, e como ela é reemitida pelos Históricos, está em Emitir etiquetas e relatórios.

O que uma ação não faz

• Ela não emite nada sozinha. Um procedimento precisa escolhê-la, e uma execução daquele procedimento precisa chegar à fronteira.
• Ela não confere o procedimento. Se um procedimento pergunta o campo ou julga pela avaliação que um marcador nomeia é declarado na página do procedimento, ao lado da escolha.
• Ela não escolhe a impressora. A fila é da unidade, por tipo e gatilho, em Impressoras.
• Ela não edita modelos de documento. Comandos de etiqueta e layouts de relatório são escritos em Modelos de documento; a ação apenas os nomeia.
• Ela não confirma a impressão física. A aceitação pela fila é o que uma etiqueta ou um relatório impresso grava, nunca prova de que saiu papel.