# Insiemi di alias

> Insiemi di nomi di canale con un nome proprio, per esempio uno per prodotto, applicati a un'unità accanto ai suoi collegamenti oppure fissati a una procedura perché prepararla li applichi.

Un **insieme di alias** è una colonna di nomi di canale con un nome proprio: per ogni canale del
modello che un'unità può rinominare, il nome sotto cui quell'unità legge il canale una volta
applicato l'insieme. È il modo di rinominare un'unità intera in un solo gesto, per un prodotto o per
un cliente, invece di riscrivere ogni alias. Sta sotto Process > Modelli > modello > Allestimento >
**Alias** e richiede il permesso **Modificare ricette e valutazioni**. Un insieme di alias è solo
presentazione: il nome proprio del canale resta la chiave a cui fa riferimento ogni oggetto del
modello.

## La cartella Alias {#the-aliases-folder}

Selezionare la riga **Alias** apre la pagina della cartella ("Insiemi di nomi di canale con un nome
proprio, per esempio uno per prodotto. Applicare un insieme a un'unità ne rinomina i canali in un
solo gesto, e una procedura può fissarne uno perché prepararla applichi l'insieme.") con un riquadro per
insieme; premere un riquadro lo apre e la X lo rimuove. Senza nessuno, la pagina dice "Ancora nessun
insieme di alias. Aggiungerne uno per nominare i canali di questo modello per un prodotto o un
cliente, poi applicarlo a un'unità accanto ai suoi collegamenti."

| Comando | Che cosa fa | In grigio quando (situazione) | Non disegnato quando (ruolo) |
| --- | --- | --- | --- |
| **Insieme di alias** (barra di dettaglio, cartella selezionata; tasto destro **Aggiungi un insieme di alias**) | Aggiunge `Insieme di alias <n>`, che non nomina ancora nulla. La riga si aggiunge al suo gruppo, evidenziata e portata in vista lì; il suo riquadro la apre. | Una qualsiasi unità tiene una prova, oppure il runtime è fermo. | Senza Modificare ricette e valutazioni. |

## La pagina dell'insieme {#the-sets-page}

L'intestazione porta il nome dell'insieme e una pastiglia che conta ciò che rinomina: "1 canale
nominato" oppure "`<n>` canali nominati". Un insieme che non nomina nulla non cambia nulla quando
viene applicato.

### Definizione {#definition}

| Campo | Che cos'è | Valori / predefinito | Effetto |
| --- | --- | --- | --- |
| **Nome** | Come si chiama l'insieme nell'albero, nel selettore di applicazione della schermata Canali e nel selettore Insieme di alias di una procedura. | Testo libero, applicato quando si lascia il campo; `Insieme di alias <n>` alla creazione. | Rinomina la riga dell'albero. |

### Nomi dei canali {#channel-names}

Il riquadro spiega la propria regola: "Un alias vuoto lascia quel canale sul nome sotto cui si legge
già. Applicare questo insieme a un'unità sovrascrive ogni alias di quell'unità, quindi ciò che non
nomina torna al nome proprio del canale." Sotto di essa sta una tabella con una riga per canale del
modello, nell'ordine dei canali del modello, così un canale è nominato al massimo una volta per
costruzione.

| Colonna | Che cos'è | Valori / predefinito |
| --- | --- | --- |
| **Canale** | Il canale, come `Ch<number> · <name>`. | In sola lettura. |
| **Nome alias** | Il nome che questo insieme dà al canale. Il testo segnaposto mostra il nome sotto cui il canale si legge sul modello (il suo alias proprio, oppure il suo nome). | Testo libero, applicato quando si lascia il campo; vuoto per impostazione predefinita. Scrivere un nome crea la voce; svuotarlo la rimuove, così l'insieme conserva soltanto i canali davvero nominati. |

Un canale che il modello mantiene su un solo nome (il suo **Ambito dell'alias** su **Intero modello** nella
tabella dei canali) rifiuta la voce: la cella è disabilitata con il
suggerimento "Questo canale mantiene un solo nome per ogni unità. Per nominarlo in un insieme,
impostare prima il suo Ambito dell'alias su Ogni unità nella tabella dei canali." Un insieme è il modo in cui un'unità viene rinominata, quindi non
può essere la scorciatoia per aggirare quella dichiarazione.

## Chi applica un insieme {#who-applies-a-set}

Un insieme non fa nulla da solo. Due gesti lo applicano a un'unità, e tutti e due sono una
sovrascrittura completa e visibile degli alias per unità di quell'unità: ogni canale che l'insieme
nomina prende il nome dell'insieme (il collegamento viene creato se il canale non era ancora
collegato), a ogni canale rinominabile che l'insieme non nomina l'alias viene azzerato e ricade sul
nome proprio del canale, e un canale che il modello mantiene su un solo nome è lasciato in pace nei
due casi.

| Gesto | Dove | Che cosa succede |
| --- | --- | --- |
| **Applica** accanto ai collegamenti di un'unità | Definizione > Canali: scegli un'unità nell'elenco delle unità; il selettore dell'insieme e **Applica** stanno con la tabella dei collegamenti di quell'unità ("Applicare agli alias qui sopra un insieme di nomi di canale con un nome proprio. Applicare questo insieme a un'unità sovrascrive ogni alias di quell'unità, quindi ciò che non nomina torna al nome proprio del canale. Le modifiche manuali prevalgono finché non si riapplica l'insieme."). Vedi [Canali e collegamenti](process-channels#the-binding-table-of-the-picked-unit). | L'insieme è scritto subito sugli alias di quell'unità e salvato. Gli alias che modifichi a mano dopo restano finché non applichi di nuovo un insieme. |
| Una procedura **fissa** un insieme | Allestimento > Procedure: il passo **Nome** della procedura ha un selettore **Insieme di alias**. | Il vincolo è verificato quando la procedura viene preparata su un'unità: se gli alias di quell'unità corrispondono già all'insieme, non viene scritto nulla; se differiscono, l'insieme è applicato all'unità e salvato mentre la procedura viene preparata, e il diario tecnico registra "Alias set pinned: '`<set>`' applied to '`<model>` · `<unit>`' by staging '`<procedure>`'". Scrivere l'insieme è una modifica di configurazione, quindi la preparazione è rifiutata mentre un'unità è in marcia, con "Questa procedura fissa un insieme di alias di canale. Applicarlo cambia la configurazione, che resta bloccata mentre un'unità è in marcia.", e l'unità mantiene la procedura che aveva preparato. Se l'insieme o gli alias dell'unità si spostano in seguito, l'Avvio è rifiutato con "L'insieme di alias fissato dalla procedura non è applicato su questa unità. Preparare di nuovo la procedura." |

La riga di passo della pagina della procedura dice "Rinomina `<n>` canali sull'unità quando questa
procedura vi viene preparata", che nomina il momento in cui avviene la scrittura, come qui sopra.

Tutti e due i gesti sono scritture di configurazione: si rifiutano mentre una qualsiasi unità tiene
una prova e mentre il runtime è fermo, e il pulsante Applica della schermata Canali richiede il
permesso Gestire Process che quella schermata esige.

## Dove si vede l'alias {#where-the-alias-shows}

Il nome in vigore per un canale su un'unità segue una regola sola: l'alias proprio dell'unità quando
il canale ne consente uno e l'unità ne tiene uno, altrimenti l'alias proprio del canale, altrimenti
il nome del canale. Un insieme di alias scrive soltanto il primo dei tre.

| Superficie | Che cosa legge |
| --- | --- |
| Il riquadro **Canali** di un pannello sotto Esercizio e sulla pagina View | Ogni serie è nominata con il nome in vigore su quell'unità. |
| Una dashboard del modello risolta | Il segnaposto `{channel.name:...}` diventa il nome in vigore (vedi [Dashboard di un modello](process-dashboards)). |
| Il file della prova | L'Avvio congela l'alias in vigore per ogni colonna registrata, accanto al nome e al numero del canale. |
| Il grafico della prova negli Storici | Ogni colonna si legge `Ch<number> · <alias>`, oppure con il nome del canale quando nessun alias era in vigore. |
| Il rapporto PDF | L'alias congelato nella prova, oppure il nome del canale quando non ce n'era alcuno. |
| Le esportazioni CSV e XLSX | Ogni colonna ha come intestazione l'alias congelato nella prova, oppure il nome del canale quando non ce n'era alcuno, con la sua unità di misura. |
| Gli indirizzi Logic e le condizioni delle occorrenze | Il nome del canale. Un alias non cambia mai `Process.<Model>.<Unit>.Channels.<Channel>` né `Channels.<Channel>` in una condizione. |

## Rimuovi l'insieme di alias {#remove-alias-set}

**Rimuovi l'insieme di alias** sta nel gruppo di pericolo della barra di dettaglio con l'insieme
selezionato, nel suo menu del tasto destro e come X sul riquadro della pagina della cartella. Chiede
prima ("Elimina l'insieme di alias", "Questo rimuove l'insieme di alias e le sue voci."). Una
procedura che aveva fissato l'insieme svuota il proprio riferimento Insieme di alias; un'unità a cui
l'insieme era stato applicato conserva gli alias già scritti, perché quelli sono propri dell'unità.
Richiede Modificare ricette e valutazioni ed è in grigio sotto il blocco di progettazione e con il
runtime fermo.

## Che cosa non fa un insieme di alias {#what-an-alias-set-does-not-do}

- Non rinomina alcun canale e alcun indirizzo. I nomi di canale del modello, lo spazio degli
  indirizzi di Logic e le condizioni delle occorrenze mantengono il nome proprio del canale.
- Non si applica da solo. Modificare un insieme dopo che è stato applicato non cambia nulla su
  nessuna unità finché l'insieme non viene applicato di nuovo, a mano oppure preparando una procedura
  che lo fissa.
- Non può nominare un canale che il modello mantiene su un solo nome, e non può accendere quel
  selettore: quella decisione è del canale, nella tabella dei canali.
- Non scrive nulla dentro un'unità in marcia: applicare è una scrittura di configurazione e aspetta
  il blocco di progettazione come tutte le altre.
