# Etichette e rapporti

> I dossier Rapporto, Etichette e Righe di database di una prova: ogni registrazione, ogni artefatto e ogni riga con i suoi tentativi di consegna, il selettore di coda, Apri PDF, Rinvia il rapporto, Stampa e Ristampa, Invia di nuovo, e i due modi di registrare un nuovo documento.

Il registro tiene i documenti prodotti dalla prova in due dossier, **Rapporto** ed
**Etichette**, fra i criteri giudicati e le occorrenze. I due sono prima di tutto prove
documentali e solo dopo una superficie di comando: ogni artefatto elenca ogni tentativo di
consegna con la coda a cui è andato e il suo stato duraturo, e nessuno dei due chiama mai
"stampato" un documento messo in coda. I due portano la stessa coppia di gesti, distinti
soltanto dal supporto: registrare un documento **nuovo** dalle prove congelate della prova,
e **riemettere** un documento registrato senza comporre di nuovo alcunché. La consultazione
segue Visualizzare gli storici; i verbi nominano più sotto le proprie condizioni.

Un permesso che il ruolo non porta e un momento che rifiuta sono due cose diverse, e i
dossier vi rispondono in modo diverso. A un ruolo senza uno dei permessi qui sotto non è
disegnato nessuno dei comandi che esso copre: la riga di invio, il suo selettore di coda e
il blocco che registra un nuovo documento sono semplicemente assenti, un avviso in testa al
dossier dice perché ("Azioni sulle etichette non disponibili", "Azioni sui rapporti non
disponibili"), e ogni artefatto, valore risolto e tentativo di consegna resta leggibile,
che è quello per cui quel ruolo è venuto. Un comando che soltanto il momento rifiuta resta
dov'è, in grigio, e dice su di sé che cosa manca.

I due dossier offrono un selettore di coda per artefatto ai ruoli che ne possono inviare
uno, precaricato con la coda in vigore sull'unità della prova per il genere e il momento di
emissione di quel documento ([Stampanti](process-printers)) quando quella coda è
installata, altrimenti "Scegliere una coda installata". Senza alcuna coda installata una riga
lo dice, e il selettore e il verbo restano in grigio su "Su questa stazione non è installata
alcuna coda di stampa di Windows."

## Stati {#statuses}

| Stato | Significato |
| --- | --- |
| Non inviato | L'artefatto o la registrazione esiste e non è mai stato registrato alcun tentativo. |
| Inviato alla coda | Windows ha accettato il documento. Non conferma che sia uscita della carta. |
| Non riuscito | La coda ha rifiutato; l'errore è mostrato accanto al tentativo. |
| Invio incerto | L'applicazione si è fermata dopo aver registrato il tentativo e prima di registrare la risposta della coda. Non viene mai ritentato automaticamente, perché la stampante potrebbe avere già prodotto il documento. |
| Generazione non riuscita | Un'etichetta i cui comandi non si sono potuti generare; il motivo è mostrato e non c'è niente da stampare. |

Ogni tentativo mostra il proprio stato, la propria coda, la propria finestra ("avviato →
completato", oppure "avviato → nessuna risposta durevole") e il proprio errore.

## Rapporto {#report}

Il dossier conta i rapporti registrati sulla prova: uno per comando di rapporto che ha
scelto di stampare automaticamente o di conservare una copia, e nulla per un comando che
non ha chiesto né l'una né l'altra cosa, dato che una semplice generazione è
un'esportazione. Senza nessuno dice "Su questa prova non è registrato alcun rapporto. Il PDF
di fine prova è registrato qui quando la procedura ne conserva una copia nella prova o lo
stampa automaticamente", e chiude con "; qui sotto se ne può sempre comporre uno nuovo."
soltanto per un ruolo a cui è disegnato il blocco che ne compone uno.

Ogni registrazione è una sezione a scomparsa intitolata con il nome del gruppo, il nome del
layout, l'istante e lo stato. Dentro: il nome del file pubblicato, che cosa la prova ne
conserva ("copia conservata nella prova · 312,4 KB" oppure "solo riferimento", con una
nota che dice che cosa invierà un rinvio), l'identificatore dell'artefatto, poi:

| Comando | Che cosa fa | In grigio quando | Richiede |
| --- | --- | --- | --- |
| Apri il PDF (sulla stazione) o Scarica il PDF (in un browser) | Apre il PDF pubblicato dalla cartella dei rapporti nel visualizzatore di sistema, oppure, in un browser, lo apre in una nuova scheda (un browser che blocca la scheda lo scarica al suo posto). Una registrazione il cui nome conservato non è quello di un rapporto pubblicato su questa stazione, cioè quello che porta con sé una prova importata da un'altra installazione, è rifiutata prima di leggere qualsiasi cosa: "Questa registrazione non nomina alcun rapporto conservato su questa stazione. Rigenerarlo dagli Storici." Un nome che è davvero quello di un rapporto pubblicato ma il cui file non c'è più dice "Il PDF del rapporto non è più conservato su questa stazione. Rigenerarlo dagli Storici." | Una generazione, un rinvio o un'altra apertura è in volo. | Visualizzare gli storici |
| Tentativi di invio alla coda | L'elenco dei tentativi, dal più recente. | | |
| Invia di nuovo il rapporto | Invia un documento alla coda scelta e aggiunge un tentativo a questa registrazione, mai una nuova registrazione. Una registrazione con una copia conservata nella prova invia quella copia byte per byte; una con solo riferimento invia il PDF pubblicato così com'è, quindi ciò che esce è una composizione successiva, e un PDF sparito è rifiutato ("Il PDF del rapporto non è più conservato nella cartella dei rapporti. Rigeneralo prima di rinviarlo."). | Nessuna coda scelta, un altro verbo in volo, la stazione in sola lettura. | Visualizzare gli storici, Eseguire le procedure |

Consultare ciò che la prova ha pubblicato è lettura, mentre produrre o riemettere un
documento non lo è, e così i tre gesti sono condizionati separatamente: la riga di file è
disegnata a ogni ruolo che legge il dossier, a uno senza Eseguire le procedure non spettano
né il selettore di coda né il rinvio, e a uno senza Esportare/importare gli storici non
spetta la sezione che compone un PDF nuovo. Ciò che il momento rifiuta è detto sul comando
in grigio stesso: "Un rapporto è ancora in apertura.", "Un rapporto è ancora in invio.", "Un rapporto
è ancora in generazione.", "Runtime fermo", "Su questa stazione non è
installata alcuna coda di stampa di Windows.", "Scegliere la coda di stampa a cui va questo
rapporto."

**Nuovo PDF con un rapporto attuale**, la sezione a scomparsa sotto l'elenco, è l'altra metà
della coppia: un selettore **Rapporto** ("(rapporto della procedura)" o un qualsiasi layout
della biblioteca) e **Genera il rapporto**, che compone di nuovo il PDF della prova dal file
della prova stessa, lo ripubblica nella cartella dei rapporti con il nome semplice della
prova, non registra nulla e non raggiunge alcuna coda. L'intera sezione è disegnata soltanto
per un ruolo con Esportare/importare gli storici, e mentre la prova sta ancora registrando
porta l'avviso "Un rapporto si genera quando la prova si è conclusa e le sue evidenze finali
sono congelate." sopra un selettore e un verbo in grigio su "Questa prova
sta ancora registrando, quindi non ha ancora un'istantanea congelata."; la stessa
composizione è il Genera il PDF della striscia, che apre anche il risultato
([Esportare una prova](histories-export#pdf)). Un layout eliminato mentre il dossier è
aperto esce dal selettore, che ripiega su quello proprio della procedura.

## Etichette {#labels}

Il dossier conta gli artefatti conservati nella prova, dal più recente: le etichette che la
procedura ha emesso all'Avvio e al Completamento, e ogni etichetta registrata in seguito, il cui
nome dice per quale via è arrivata: `<gruppo> · Generated from Histories` per una composta da
**Nuova etichetta** sulla striscia, e solo `Generated from Histories` per una composta da
**Nuova etichetta con un modello attuale**, che non appartiene ad alcun gruppo. Il nome è
registrato in inglese, qualunque sia la lingua dello schermo. Senza nessuno dice "In questa prova
non è conservato alcun artefatto di etichetta. Le azioni automatiche e ogni etichetta emessa
in seguito per essa compaiono qui."

Ogni artefatto è una sezione a scomparsa intitolata con il nome del gruppo, il nome del
modello, il momento di emissione (Avvio o Completamento), l'istante e lo stato. Dentro:
l'errore di generazione quando c'è; la striscia RAW (il conteggio di byte congelato o
"NESSUN CONTENUTO", il file sorgente del modello, lo SHA-256 della versione di modello
usata, l'identificatore dell'artefatto); **Valori risolti**, una riga per segnaposto con il
valore sostituito e la sorgente da cui è venuto ("Nessun segnaposto in questo file di
comandi fisso." per un'etichetta fissa); **Tentativi di invio alla coda**; e, per un artefatto con
comandi, la riga di invio:

| Comando | Che cosa fa | In grigio quando | Richiede |
| --- | --- | --- | --- |
| Stampa (Ristampa una volta che esiste un tentativo) | Invia alla coda scelta esattamente i byte congelati e aggiunge un tentativo. Nessun segnaposto viene risolto di nuovo e il modello non viene mai letto, quindi la coda riceve questo artefatto byte per byte, qualunque cosa sia cambiata da allora. | Nessuna coda scelta, un altro invio in volo, la stazione in sola lettura. | Visualizzare gli storici, Eseguire le procedure |

A un ruolo senza entrambi i permessi non è disegnata alcuna riga di invio, e nemmeno alcun
blocco di composizione: legge gli artefatti, i loro valori risolti e i loro tentativi, e il
dossier non gli offre nulla da premere. Ciò che il momento rifiuta è detto sul comando in
grigio stesso: "Un'etichetta è ancora in invio.", "Runtime fermo", "Su
questa stazione non è installata alcuna coda di stampa di Windows.", "Scegliere la coda di
stampa a cui va questo artefatto."

Una nuova etichetta per la prova si registra in due modi, e nessuno dei due la invia: il
nuovo artefatto compare in cima al dossier appena viene registrato, e lo stampi in seguito
dalla sua stessa voce.

- **Nuova etichetta**, sulla striscia sopra il registro, compone una delle etichette che la
  procedura della prova configura, la quale accoppia già un modello con le sue associazioni
  di segnaposto confermate, quindi non serve alcun modulo. Il suo selettore parte da
  "(etichetta della procedura)", la prima etichetta di completamento in ordine di emissione
  (la prima etichetta di avvio per una procedura che non ne emette al Completamento), ed
  elenca ogni comando di etichetta della procedura nominato dal suo gruppo (con "·
  all'Avvio" o "· al Completamento" quando un gruppo ne contiene più d'uno). Una scelta il
  cui modello ha lasciato la biblioteca dice "· nessun modello", una il cui modello non ha
  comandi "· nessun comando"; le due restano elencate e non si possono generare. Il filtro
  di esito del comando è ignorato: questa etichetta è stata chiesta esplicitamente. Una prova la cui
  procedura non c'è più, e una prova importata, non configurano alcuna etichetta ("La
  procedura di questa prova non configura alcuna etichetta."). Genera soltanto una prova
  terminata.
- **Nuova etichetta con un modello attuale**, la sezione a scomparsa sotto gli artefatti,
  prende un qualsiasi modello della biblioteca che contenga comandi e associa a mano ogni
  segnaposto a prove già congelate in questa prova. Per ogni segnaposto: un selettore di
  **sorgente** che elenca i valori congelati con la loro anteprima ("Identità della prova ·
  Nome del modello: Climatic chamber", "Metadati · Serial: A12", "Criterio · Overshoot ·
  ciclo 1 · Risultato: OK"), un formato per una sorgente di data (Data e ora della stazione,
  Data della stazione, Ora della stazione, ISO 8601) o un numero di cifre decimali per una
  numerica ("Come registrato", da 0 a 9), e una casella **Conferma la corrispondenza**. La riga
  sotto le righe conta "n segnaposto su m confermati esplicitamente" e **Genera l'etichetta**
  resta in grigio su "Confermare prima ogni segnaposto rispetto a una sorgente congelata."
  finché ogni segnaposto non è confermato con una sorgente vera; un modello senza segnaposti
  genera comandi fissi, e uno senza comandi è rifiutato ("Questo modello non ha ancora
  comandi di stampante."). I valori offerti sono soltanto quelli congelati: non si legge nulla
  dal vivo, e una prova che sta ancora registrando non ha un'istantanea finale da cui
  generare ("Istantanea finale non disponibile", il verbo in grigio su "Questa prova sta
  ancora registrando, quindi non ha ancora un'istantanea congelata.").

I due modi richiedono Visualizzare gli storici ed Eseguire le procedure, senza i quali non è
disegnato né l'uno né l'altro, e una stazione che accetti scritture, la quale li fa soltanto
passare in grigio ("Runtime fermo"); l'artefatto che registrano è
immutabile, e l'esito arriva nel registro delle azioni ("Nuova etichetta registrata ·
modello").

## Righe di database {#database-rows}

Una prova le cui azioni scrivono in un database della fabbrica
([comandi di riga di database](process-actions#database-row-commands)) porta un terzo dossier,
**Righe di database**, sotto gli altri due; una prova senza una riga del genere non ne disegna
nessuno. Conta le righe che la prova ha scritto o ha tentato di scrivere ("1 riga", "`<n>` righe").
Ogni riga è una voce espandibile intestata con il nome del gruppo, la tabella e il dispositivo a cui
è andata ("`<table>` tramite `<device>`"), il momento e l'istante, e lo stato del suo ultimo
tentativo. Dentro, **Valori** elenca una riga per colonna con il valore che la prova ha fissato
quando il suo comando è scattato ("(nessun valore)" per uno vuoto), e **Tentativi** elenca ogni
tentativo con il suo stato, la sua finestra e la risposta del database.

| Stato | Significato |
| --- | --- |
| Riga scritta | Il database ha accettato la riga. |
| Riga non scritta | Il database l'ha rifiutata, non ha risposto in tempo o non era raggiungibile; il motivo sta accanto al tentativo, con le parole del driver. |
| Scrittura incerta | La stazione si è fermata dopo aver annotato il tentativo e prima che il database rispondesse. Non viene mai inviata di nuovo da sola, perché il database potrebbe già contenere la riga. |
| Mai inviata | La riga è annotata e non è stato fatto alcun tentativo. |

| Comando | Che cosa fa | In grigio quando | Richiede |
| --- | --- | --- | --- |
| Invia di nuovo | Invia i valori che questa prova ha fissato, invariati, alla stessa tabella tramite il dispositivo come è configurato ora, e aggiunge un tentativo a questa riga. Nulla si risolve di nuovo dalla configurazione. Una riga che il database ha già accettato viene aggiunta una seconda volta. | Una riga è ancora in invio, la stazione in sola lettura. | Visualizzare gli storici, Eseguire le procedure |

Un ruolo senza entrambi i permessi legge le righe e i loro tentativi e non vede alcuna riga di
invio; l'intestazione del dossier dice "Inviare di nuovo una riga richiede sia l'accesso agli
storici sia il permesso Eseguire le procedure. Le righe e i loro tentativi restano consultabili."
L'esito di un invio arriva nel registro delle azioni: "La riga è stata scritta in `<table>`." oppure
"La riga non è stata scritta: `<reason>`".

## Che cosa i dossier non fanno {#what-the-dossiers-do-not-do}

Non compongono mai di nuovo un'etichetta o un rapporto registrato per riemetterlo: una
ristampa invia byte congelati e un rinvio invia il documento registrato. Non cambiano mai un
artefatto più vecchio. Non stampano la pagina di prova di un modello (quella è la pagina
propria del modello sotto
[Modelli di documento](process-labels#test-send)), e non decidono attraverso quale coda
stampa una procedura: il selettore che sta qui è per artefatto e per invio.