Ações

Os pacotes nomeados de etiquetas, relatórios, ações da Logic e linhas no banco de dados que uma execução emite no Início ou na Conclusão, os comandos deles, os mapeamentos de marcador de uma etiqueta, as colunas de uma linha no banco de dados, 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, um relatório, a execução de uma ação da Logic ou uma linha num banco de dados da fábrica), quando (no Início ou na Conclusão), com qual modelo de documento da biblioteca da estação, qual ação da Logic ou qual tabela de banco de dados 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 exige a 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 globais de etiqueta: …" 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 desta 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. Adicione uma quando um procedimento deste modelo tiver de emitir etiquetas ou relatórios, executar ações da Logic ou gravar linhas no banco de dados."; 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 própria, 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> (<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. Um comando de ação da Logic não imprime nada e não tem slot.

Comandos de ação da Logic

Um comando de ação da Logic é o gancho que uma execução deixa para quem programa a estação: numa fronteira, ele executa uma ação da Logic, que pode mandar a execução para outro sistema por qualquer driver, acender uma lâmpada ou zerar um contador. A ação é escolhida pela identidade, então renomeá-la na página Logic não muda nada aqui; o editor dela lista este comando no cartão Usada por.

Vários comandos de ação da Logic do mesmo momento rodam um depois do outro, na ordem de emissão abaixo, e nenhum é pulado porque um anterior ainda está rodando: toda execução ganha a sua. O que uma execução faz à ação é dito na página da ação: o trilho ÚLTIMA EXECUÇÃO nomeia a execução como Process · <unit> · <action>, com o erro e as escritas recusadas quando houve, e o diário os guarda; nada é escrito no arquivo da execução. Uma ação excluída depois que o comando foi configurado é pulada e um aviso vai para o diário; uma desabilitada se recusa a executar e registra o motivo.

Comandos de linha no banco de dados

Um comando Linha no banco de dados acrescenta uma linha a uma tabela de um banco de dados da fábrica, a tabela de rastreabilidade que um MES já mantém: o número de série, o veredito e os valores medidos da peça, com os nomes de coluna que essa tabela já tem. A linha passa por um dispositivo do driver Database da página Connector, que guarda a conexão e o login, então o comando não nomeia servidor nenhum nem guarda senha nenhuma. A tabela já existe: a estação nunca cria nem altera uma, só acrescenta linhas a ela.

Enquanto as tabelas são lidas, a linha sob o seletor diz "Lendo as tabelas do banco de dados…"; quando não podem ser lidas, diz por quê ("Não foi possível ler as tabelas de <device>: <cause>"), e um banco de dados com mais de 500 tabelas diz "O banco de dados tem mais tabelas do que a lista mostra: as primeiras 500 estão listadas." Uma linha no banco de dados nasce, como um relatório, para todos os vereditos finais.

Sob os campos, Colunas da tabela lista uma linha por coluna da tabela, na ordem da tabela, cada uma com o tipo dela como o banco de dados o escreve e, onde a tabela recusa uma linha sem valor nela (a coluna não aceita valor vazio, não tem valor padrão e não é coluna de identidade, autoincremento nem calculada), a etiqueta Obrigatória na tabela. Cada coluna recebe um Valor; uma coluna deixada para o banco de dados fica fora da linha, então o banco de dados a preenche com o próprio valor padrão.

Os valores na Conclusão são os que o LastRun da unidade serve à Logic, um critério dobrado sobre cada ciclo em que foi julgado; um campo que a execução não pediu, e um critério que ela não julgou, não dão valor (NULL). Ler as colunas de novo, no cabeçalho da lista, lê de novo as colunas da tabela no banco de dados: uma coluna mantém o valor que recebeu, uma nova entra na lista sem nenhum, e uma que a tabela não tem mais sai dela.

A linha é um único INSERT que nomeia as colunas que têm valor, cada valor um parâmetro do próprio tipo e nunca texto escrito no comando SQL, então um número de série com aspas ou palavras de SQL é guardado como o texto que é. O banco de dados converte cada valor para o tipo da coluna dele como converte qualquer valor. Um banco de dados que recusa a linha, não responde nos 10 segundos do driver ou não pode ser alcançado só avisa: a execução não é afetada, o diário grava a recusa, e o registro da execução guarda a linha com a recusa e o motivo dela no dossiê Linhas no banco de dados de Históricos. Nada é guardado para envio posterior; Reenviar, ali, envia os mesmos valores à mão. Várias linhas no banco de dados do mesmo momento saem uma depois da outra, na ordem de emissão abaixo.

O que falta a um comando de linha no banco de dados entra na lista de Prontidão abaixo, na ordem em que se conserta: "Escolha um dispositivo Database.", "O dispositivo Database que ele indica não existe mais.", "O dispositivo que ele indica, <device>, não é um dispositivo Database.", "Escolha uma tabela.", "Dê valor a pelo menos uma coluna: uma linha sem coluna não é gravada.", "<column> é obrigatória na tabela e não tem valor.", "<column>: este valor ainda não existe no início; então só existem um campo de metadados ou um texto fixo.", "<column>: selecione um campo do catálogo de metadados deste modelo." e "<column>: selecione um critério de uma das avaliações deste modelo." O que só o banco de dados pode dizer é lido enquanto o comando está aberto nesta página, e entra ali na mesma lista: "A tabela <table> não está mais no banco de dados.", "<column> não é mais uma coluna da tabela. Leia as colunas de novo.", "A tabela tem colunas que este comando ainda não leu: <columns>. Leia as colunas de novo." e "Não foi possível ler a tabela no banco de dados: <cause>". Um procedimento que escolhe a ação diz o que falta a ele para uma coluna: "A coluna <column> lê um campo de metadados que este procedimento não pede. Marque-o em Metadados acima.", "A coluna <column> lê o resultado de um critério, e este procedimento não julga por nenhuma avaliação." ou "A coluna <column> lê um critério que a avaliação deste procedimento não declara."

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 selecionado e precisam ser removidos."), cada um com Remover o 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 selecionado não existe mais."
• "Escolha uma ação da Logic." / "A ação da Logic que ele indica não existe mais." / "A ação da Logic que ele indica está desabilitada, então é recusada cada vez que é disparada."
• "Escolha um modelo de etiqueta." / "O modelo foi limpo ou excluído; os mapeamentos guardados são preservados." / "O modelo global selecionado não existe mais."
• "O modelo selecionado ainda não tem comandos de impressora; escreva-os ou importe-os antes que uma execução chegue a este comando."
• "Não foi possível ler os marcadores do modelo: <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", "selecione um campo do catálogo de metadados deste modelo", "selecione um critério de uma das avaliações deste modelo", "defina um ciclo explícito, contado do 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 ficar 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 "Ainda não emite nada: 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 pede. Marque-o em Metadados acima."
• "{{M}} lê o resultado de um critério, e este procedimento não julga por nenhuma avaliação."
• "{{M}} lê um critério que a avaliação deste procedimento não declara."
• "{{M}} lê o ciclo <c>, e este procedimento executa um único ciclo." / "… roda <n>."
• "A ação da Logic que ele indica não existe mais." (um comando de ação da Logic da ação, cuja ação foi excluída: o procedimento não executaria nada no lugar dela)

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 em 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. Um comando de ação da Logic mantém essa ordem entre os comandos de ação da Logic do momento dele; quando ele roda está dito em Comandos de ação da Logic. 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.
• Ela não espera uma ação da Logic e não a grava na execução. O resultado da ação está na página dela na Logic e no diário.
• Ela não cria nem altera tabela nenhuma, e não guarda uma linha recusada para enviá-la depois. Uma linha no banco de dados vai para uma tabela que o banco de dados da fábrica já tem; uma recusa fica gravada na execução e é reenviada à mão em Históricos.