# 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.

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 {#the-aliases-folder}

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 conjunto para que prepará-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. Adicione 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. A linha entra no grupo dela, destacada e rolada até ficar à vista ali; o cartão dela a abre. | Alguma unidade tem uma execução, ou o runtime está parado. | Sem Editar receitas e avaliações. |

## A página do conjunto {#the-sets-page}

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 {#definition}

| 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 dos canais {#channel-names}

O cartão explica a regra dele: "Um apelido em branco deixa esse canal com o nome sob o qual ele já é
lido. Aplicar este conjunto a uma unidade sobrescreve todos os apelidos daquela unidade, então o que
ele não nomeia volta ao 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 **Escopo do apelido** dele em **Modelo inteiro** na
grade de Canais) recusa a entrada: a célula fica desabilitada com a dica "Este canal mantém um nome
só para todas as unidades. Para nomeá-lo num conjunto, mude antes o Escopo do apelido dele para Cada
unidade na grade de Canais." Um
conjunto é como uma unidade é renomeada, então ele não pode ser o contorno daquela declaração.

## Quem aplica um conjunto {#who-applies-a-set}

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 aos apelidos acima um conjunto nomeado de nomes de canal. Aplicar este conjunto a uma unidade sobrescreve todos os apelidos daquela unidade, então o que ele não nomeia volta ao nome do próprio canal. As edições feitas à mão prevalecem até você aplicar de novo."). Veja [Canais e vínculos](process-channels#the-binding-table-of-the-picked-unit). | 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 "Alias set pinned: '`<set>`' applied to '`<model>` · `<unit>`' by staging '`<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 fica 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 {#where-the-alias-shows}

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](process-dashboards)). |
| 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 | Cada coluna tem por cabeçalho o apelido congelado na execução, ou o nome do canal quando não havia nenhum, com a unidade de engenharia dele. |
| 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 {#remove-alias-set}

**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", "Isso 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 {#what-an-alias-set-does-not-do}

- Ele não renomeia canal nenhum nem endereço nenhum. Os nomes de canal do modelo, o espaço de
  endereços da Logic e as condições de ocorrência 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 preparar 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.