Conjuntos de apelidos

Conjuntos nomeados de nomes de canal, um por produto por exemplo, aplicados a uma unidade ao lado dos vínculos dela ou fixados num procedimento, de modo que prepará-lo os aplique.

Ver como Markdown

Um conjunto de apelidos é uma coluna nomeada de nomes de canal: para cada canal do modelo que uma unidade pode renomear, o nome sob o qual aquela unidade lê o canal depois que o conjunto é aplicado. É o jeito de renomear uma unidade inteira num gesto só, para um produto ou um cliente, em vez de redigitar cada apelido. Ele vive em Process > Modelos > modelo > Preparação > Apelidos, e exige a permissão Editar receitas e avaliações. Um conjunto de apelidos é apresentação apenas: o nome do próprio canal continua sendo a chave que todo artefato do modelo referencia.

A pasta Apelidos

Selecionar a linha Apelidos abre a página da pasta ("Conjuntos nomeados de nomes de canal, um por produto por exemplo. Aplicar um conjunto a uma unidade renomeia os canais dela num gesto só, e um procedimento pode fixar um, de modo que iniciá-lo aplique o conjunto.") com um cartão por conjunto; clicar num cartão o abre, e o X o remove. Sem nenhum, a página diz "Nenhum conjunto de apelidos ainda. Acrescente um para nomear os canais deste modelo para um produto ou um cliente, e depois aplique-o a uma unidade ao lado dos vínculos dela."

Comando	O que faz	Fica cinza quando (situação)	Não é desenhado quando (papel)
Conjunto de apelidos (barra de detalhe, com a pasta selecionada; clique direito Adicionar conjunto de apelidos)	Acrescenta `Conjunto de apelidos <n>`, ainda sem nomear nada, e o seleciona.	Alguma unidade tem uma execução, ou o runtime está parado.	Sem Editar receitas e avaliações.

A página do conjunto

O cabeçalho carrega o nome do conjunto e uma pílula contando o que ele renomeia: "1 canal nomeado" ou "<n> canais nomeados". Um conjunto que não nomeia nada não muda nada quando é aplicado.

Definição

Campo	O que é	Valores / padrão	Efeito
Nome	Como o conjunto se chama na árvore, no seletor Aplicar da tela Canais e no seletor de Conjunto de apelidos de um procedimento.	Texto livre, confirmado quando você deixa o campo; `Conjunto de apelidos <n>` na criação.	Renomeia a linha da árvore.

Nomes de canal

O cartão explica a regra dele: "Um apelido em branco deixa aquele canal com o nome sob o qual ele já é lido. Aplicar este conjunto a uma unidade sobrescreve todo apelido daquela unidade, então o que ele não nomeia volta para o nome do próprio canal." Sob ele fica uma grade com uma linha por canal do modelo, na ordem dos canais do modelo, então um canal é nomeado no máximo uma vez, por construção.

Coluna	O que é	Valores / padrão
Canal	O canal, como `Ch<número> · <nome>`.	Somente leitura.
Apelido	O nome que este conjunto dá ao canal. O texto de exemplo mostra o nome sob o qual o canal é lido no modelo (o apelido dele, ou o nome dele).	Texto livre, confirmado quando você deixa o campo; em branco por padrão. Digitar um nome cria a entrada; esvaziá-lo remove a entrada, então o conjunto guarda apenas os canais que você realmente nomeou.

Um canal que o modelo mantém num nome só (o interruptor Permitir apelido por unidade dele desligado na grade de Canais) recusa a entrada: a célula fica desabilitada com a dica "Este canal mantém um nome para toda unidade. Permita que ele mude por unidade na grade de Canais primeiro." Um conjunto é como uma unidade é renomeada, então ele não pode ser o contorno daquela declaração.

Quem aplica um conjunto

Um conjunto não faz nada sozinho. Dois gestos o aplicam a uma unidade, e os dois são uma sobrescrita completa e visível dos apelidos por unidade daquela unidade: todo canal que o conjunto nomeia toma o nome do conjunto (o vínculo é criado se o canal ainda não tinha um), todo canal renomeável que o conjunto não nomeia tem o apelido limpo e volta para o nome do próprio canal, e um canal que o modelo mantém num nome só fica intocado nos dois casos.

Gesto	Onde	O que acontece
Aplicar ao lado dos vínculos de uma unidade	Definição > Canais: escolha uma unidade na lista de unidades; o seletor de conjunto e Aplicar ficam junto à tabela de vínculos daquela unidade ("Aplique um conjunto nomeado de nomes de canal aos apelidos acima. As edições manuais vencem até você aplicar de novo."). Veja Canais e vínculos.	O conjunto é escrito nos apelidos daquela unidade na hora e salvo. Os apelidos que você editar à mão depois ficam até você aplicar um conjunto de novo.
Um procedimento fixa um conjunto	Preparação > Procedimentos: o estágio Nome do procedimento tem um seletor de Conjunto de apelidos.	A fixação é conferida quando o procedimento é preparado numa unidade: se os apelidos daquela unidade já batem com o conjunto, nada é escrito; se diferem, o conjunto é aplicado à unidade e salvo enquanto o procedimento é preparado, e o diário grava "Conjunto de apelidos fixado: '`<set>`' aplicado a '`<model>` · `<unit>`' ao preparar '`<procedure>`'". Escrever o conjunto é uma mudança de configuração, então preparar é recusado enquanto uma unidade está em execução, com "Este procedimento fixa um conjunto de apelidos de canal. Aplicá-lo muda a configuração, que está travada enquanto uma unidade está em execução.", e a unidade mantém o procedimento que já tinha preparado. Se o conjunto ou os apelidos da unidade se mexerem depois, o Iniciar é recusado com "O conjunto de apelidos fixado pelo procedimento não está aplicado nesta unidade. Prepare o procedimento de novo."

A frase de preparação na página do procedimento diz "Renomeia <n> canais na unidade quando este procedimento é preparado nela", que nomeia o momento em que a escrita acontece, como acima.

Os dois gestos são escritas de configuração: eles recusam enquanto qualquer unidade tem uma execução e enquanto o runtime está parado, e o botão Aplicar da tela Canais exige a permissão Gerenciar o Process que aquela tela pede.

Onde o apelido aparece

O nome em vigor para um canal numa unidade é uma regra só: o apelido da própria unidade quando o canal permite um e a unidade tem um; fora isso, o apelido do próprio canal; fora isso, o nome do canal. Um conjunto de apelidos só escreve o primeiro dos três.

Superfície	O que ela lê
O cartão Canais de um painel sob a Operação e na página View	Cada série é nomeada pelo nome em vigor naquela unidade.
Um dashboard resolvido do modelo	O token `{channel.name:...}` vira o nome em vigor (veja Dashboards de um modelo).
O arquivo da execução	O Início congela o apelido em vigor de toda coluna gravada, ao lado do nome e do número do canal.
O gráfico da execução nos Históricos	Cada coluna se lê `Ch<número> · <apelido>`, ou o nome do canal quando nenhum apelido estava em vigor.
O relatório em PDF	O apelido congelado na execução, ou o nome do canal quando não havia nenhum.
As exportações CSV e XLSX	O nome do canal (com a unidade de engenharia dele), nunca o apelido.
Endereços da Logic, condições de ocorrência	O nome do canal. Um apelido nunca muda `Process.<Model>.<Unit>.Channels.<Channel>` nem `Channels.<Channel>` numa condição.

Remover conjunto de apelidos

Remover conjunto de apelidos fica no grupo de perigo da barra de detalhe com o conjunto selecionado, no menu de clique direito dele, e como o X no cartão da página da pasta. Ele pergunta antes ("Excluir conjunto de apelidos", "Isto remove o conjunto de apelidos e as entradas dele."). Um procedimento que fixou o conjunto esvazia a referência de Conjunto de apelidos dele; uma unidade a que o conjunto foi aplicado mantém os apelidos já escritos, porque eles são da própria unidade. Ele exige Editar receitas e avaliações e fica cinza sob a trava de engenharia e o runtime parado.

O que um conjunto de apelidos não faz

Ele não renomeia canal nenhum nem endereço nenhum. Os nomes de canal do modelo, o espaço de endereços da Logic, as condições de ocorrência e as exportações mantêm o nome do próprio canal.
Ele não se aplica sozinho. Editar um conjunto depois de aplicado não muda nada em unidade alguma até o conjunto ser aplicado de novo, à mão ou ao iniciar um procedimento que o fixa.
Ele não consegue nomear um canal que o modelo mantém num nome só, e não consegue ligar aquele interruptor: essa decisão é do canal, na grade de Canais.
Ele não escreve nada numa unidade em execução: aplicar é uma escrita de configuração e espera a trava de engenharia como qualquer outra.