Un componente fondamentale dell’ambiente di progettazione collaborativa Altium 365 Workspace è il supporto per i Workflows basati su processi, che guidano strettamente i progettisti attraverso i tipici processi di progettazione quotidiani, come la richiesta di nuove parti gestite, l’esecuzione di attività di revisione e la creazione di nuovi progetti gestiti.
Ogni Workflow utilizzato per implementare uno specifico processo di progettazione viene creato come parte di un Process Definition. Può quindi essere indicato come il Workflow sottostante di quel processo, o semplicemente come un Process Workflow. Nuovi processi possono essere creati e quelli esistenti modificati utilizzando il dedicato Process Workflow Editor. Questo documento illustra come accedere all’editor e come usarlo per produrre il workflow di processo richiesto.
Accesso al Process Workflow Editor
I processi vengono creati e gestiti dall’area Processes (Admin – Processes) dell’interfaccia di Altium 365 Workspace.
Per poter visualizzare la pagina Admin – Processes dell’interfaccia, è necessario aver effettuato l’accesso come Administrator del proprio Workspace.
Per accedere al Process Workflow Editor, attivare la scheda del tema di processo in cui si desidera creare il nuovo processo – Part Requests, Project Activities o Project Creations – quindi fare clic sul pulsante
in alto a destra nella pagina.
È importante attivare prima il tema, in modo che il processo venga creato con il corretto Type.
Accesso al Process Workflow Editor. Assicurarsi che il tema di processo desiderato sia attivo prima dell’accesso garantirà che la nuova definizione di processo venga impostata sul tipo di tema corretto.
Il Process Workflow Editor fornisce un’area di lavoro con cui costruire il workflow desiderato in forma diagrammatica. L’area principale dell’editor è quella in cui si crea il diagramma del workflow, mentre il pannello Properties sul lato destro presenta le proprietà relative all’elemento del diagramma attualmente selezionato.
Quando nel diagramma non è selezionato alcun elemento posizionato, il pannello Properties rifletterà il Name e il Type (a quale tema di processo appartiene) della definizione di processo. Assegnare al processo un nome significativo, poiché questo apparirà nell’interfaccia del Workspace, così come nei punti di accesso applicabili della GUI di Altium Designer, affinché i progettisti possano avviare un’istanza del processo (a condizione che sia attivato per l’uso).
Il diagramma del workflow
Un diagramma di workflow di processo viene costruito utilizzando vari elementi, disponibili nella palette nella parte superiore dell’area.
Un diagramma di workflow viene costruito utilizzando elementi della palette disponibile.
La tabella seguente elenca tutti i possibili elementi del diagramma:
| Icona |
Tipo |
Descrizione |
 |
Connection |
Questo elemento consente l’interconnessione tra gli elementi punto-evento nel workflow. La sua forma può essere modificata graficamente e, sebbene per impostazione predefinita il suo Name venga lasciato vuoto, questo può essere utile per indicare/descrivere i vari percorsi che si diramano da un elemento di diramazione nel flusso. |
 |
Start |
Questo è il punto di partenza di un workflow. Il Name viene precompilato per impostazione predefinita in base al tema – Submit Request (Richieste parti), Start Activity/Review/Release (Attività di progetto), Create Project (Creazioni di progetto). Questo può essere modificato secondo necessità. Per informazioni sui campi predefiniti aggiunti al modulo associato a questo elemento, vedere Built-in Fields e Default Fields.
Per il tema di processo Project Activities, questo elemento offre supporto per due tipi di avvio specializzati:
Start Release – utilizzato per un workflow in cui un progetto rilasciato deve essere pubblicato in un’istanza PLM integrata, il tutto come parte del Project Releaser di Altium Designer.
Start Review – utilizzato per un workflow che controllerà la funzionalità Workspace Design Review, accessibile tramite la vista progetto del Workspace.
Per il tema di processo Project Creations, una proprietà aggiuntiva Default server folder consente di specificare un percorso di cartella di base in cui verrà salvato il nuovo progetto. Se definito, diventa la posizione predefinita per questo workflow e può essere sostituito dall’utente nel campo Server Folder del modulo New Project (scheda Advanced). In caso contrario, il percorso è quello specificato dalla voce Default path for new projects nella pagina Admin - Settings - Projects.
Per ulteriori informazioni sul cambio di tipo per questo elemento, vedere Changing the Type for a Workflow Element.
|
 |
Event |
Questo elemento può essere utilizzato per acquisire il risultato di un’azione all’interno di un’istanza PLM integrata (fornendo un output di stato pari a OK o FAIL, insieme a un messaggio e a un log). Per farlo, impostare il Type per il tema di conseguenza – PLM Part Completed (Richieste parti), PLM Publish Completed (Attività di progetto), PLM Initialise Completed (Creazioni di progetto). Per impostazione predefinita il Name viene precompilato con la voce Type , ma può essere modificato secondo necessità.
Per Project Activities, il Type per questo elemento può anche essere impostato su Related Tasks Completed. Questo viene utilizzato quando i Comments del progetto sono stati aggiunti e assegnati come Tasks a persone specifiche, associati all’attività di un progetto stesso. Ciò significa che il workflow di processo per l’attività non può essere completato finché tutte le attività correlate – sia le azioni di processo richieste sia i commenti assegnati – non sono state risolte.
|
 |
End |
Questo è il punto finale del workflow o di un ramo di tale workflow. Il Name per l’elemento può essere impostato su Completed, Rejected o Cancelled. |
 |
Task |
Questo elemento rappresenta un’attività da svolgere, ovvero qualcosa che uno o più utenti devono eseguire. In un workflow Project Activity basato sulla revisione, questo potrebbe consistere nel fornire feedback come parte di una revisione. In un workflow Part Request, questo potrebbe consistere nel lavorare su un particolare componente richiesto, o magari solo sul suo simbolo o footprint.
Ogni attività fornisce o acquisisce dati dall’utente tramite un Form dedicato, costruito con tutti i campi, le variabili e le informazioni necessarie per raggiungere lo scopo dell’attività. Per ulteriori informazioni, vedere Building a Form.
Oltre ai tipi standard User Task (definito tramite un modulo) e Change State (definito tramite Settings), ogni tema di processo supporta uno o più tipi aggiuntivi – Create Part in PLM (Richieste parti), Collect Project Data, Publish to PLM e Reviewer Task (Attività di progetto), Create Project e Initialise in PLM (Creazioni di progetto). In ogni caso, il Name viene impostato per impostazione predefinita sul tipo dell’attività, ma può essere modificato secondo necessità. Devono essere definite impostazioni aggiuntive per ciascun tipo, che differiscono di conseguenza tra i vari tipi, come Assignee e Task Ownership. Per un’attività di tipo correlata al PLM, viene utilizzata per acquisire il risultato dell’azione con l’istanza PLM (fornendo un output di OK o FAIL), insieme a un messaggio e (per i temi Project Activities e Project Creations) alle proprietà.
Con il tema di processo Project Creations, una proprietà aggiuntiva Default server folder consente di specificare un percorso di cartella di base in cui verrà salvato il nuovo progetto. Se definito, diventa la posizione predefinita per questo workflow e può essere sostituito dall’utente nel campo Server Folder del modulo New Project (scheda Advanced). In caso contrario, il percorso è quello specificato dalla voce Default path for new projects nella pagina Admin - Settings - Projects.
Per ulteriori informazioni sul cambio di tipo per questo elemento, vedere Changing the Type for a Workflow Element.
|
 |
Branch |
Questo elemento consente la diramazione del workflow, in base ai risultati acquisiti da un punto precedente del flusso (ad esempio acquisizione della scelta dell’utente o di una decisione). Per impostazione predefinita il Name viene lasciato vuoto. È possibile aggiungere una logica di rilevamento dei risultati alle connessioni di uscita del ramo per controllare esplicitamente il flusso. Vedere Default Process Definitions per esempi.
|
 |
Comment |
Questo elemento consente di commentare il workflow, in genere aggiungendo un commento informativo in ogni punto del flusso, che descriva in dettaglio cosa dovrebbe accadere in quel punto. Per impostazione predefinita il Name viene lasciato vuoto. |
Posizionamento degli elementi del workflow
Per posizionare un elemento dalla palette:
-
Fare clic sulla voce dell’elemento nella palette. Apparirà un’istanza dell’elemento, evidenziata in blu, che seguirà il cursore.
-
Posizionare l’elemento nella posizione richiesta sull’area di lavoro del workflow e fare clic (o clic con il pulsante destro) per effettuarne il posizionamento. Mentre si sposta l’elemento sull’area di lavoro, appariranno guide di allineamento in relazione ai centri orizzontali e verticali degli elementi già posizionati.
-
Per annullare il posizionamento, premere Esc.
Esempio di posizionamento di elementi sull’area di lavoro del workflow (Start, End e un User Task). Notare le guide di allineamento dinamiche che forniscono assistenza durante il posizionamento.
Connessione degli elementi del workflow
Per collegare due elementi del workflow:
-
Fare clic sulla voce
nella palette.
-
Posizionare il cursore sul primo elemento (origine) da collegare e fare clic.
-
Spostare il cursore per vedere una linea di connessione che inizia a estendersi dall’elemento. Posizionare il cursore sul secondo elemento (destinazione) da collegare e fare clic.
La connessione tra gli elementi dovrebbe procedere da sinistra a destra, poiché questo è il flusso logico. Non sarà possibile selezionare un elemento di destinazione per il quale la connessione è considerata non valida (ad esempio tentando di collegare un elemento
End a un elemento
Start). In tal caso l’elemento di destinazione apparirà con un riempimento rosso e l’estremità della linea di connessione rimarrà con un’icona di “vietato”
(
).
-
Continuare a posizionare ulteriori connessioni, oppure fare clic con il pulsante destro, oppure premere Esc per uscire.
Esempio di connessione di elementi in un workflow.
Spostamento degli elementi del workflowPer spostare un elemento, fare clic su di esso e trascinarlo nella nuova posizione desiderata. Se l'elemento è collegato a uno o più altri elementi tramite connessioni, tali connessioni verranno mantenute e il/i percorso/i della linea di connessione verrà/verranno modificato/i di conseguenza. Utilizzare le guide di allineamento dinamiche che compaiono per facilitare il posizionamento.
Per spostare più elementi, selezionarli prima, in uno dei seguenti modi: facendo Ctrl+clic su ciascun elemento richiesto oppure facendo clic e trascinando un riquadro di selezione attorno a tali elementi.
Esempio di spostamento di uno, quindi di più elementi posizionati. Si noti che le connessioni, a meno che non facciano parte della selezione, verranno modificate per mantenere gli elementi opportunamente collegati.
Modifica di una connessione
Quando si passa il cursore sopra una connessione, diventano disponibili vari controlli di modifica, o "maniglie". Questi consentono di apportare graficamente le seguenti modifiche a una connessione:
-
Fare clic e trascinare la maniglia
per spostare la connessione solo sul piano verticale.
-
Fare clic e trascinare la maniglia
per spostare la connessione solo sul piano orizzontale.
-
Spostare il cursore lungo la connessione; la maniglia
seguirà il cursore. Fare clic e trascinare questa maniglia per creare un nuovo punto vertice per la connessione.
-
Fare clic e trascinare la maniglia
per spostare il punto iniziale della connessione. È necessario trascinare questo punto su un altro elemento esistente.
-
Fare clic e trascinare la maniglia
per spostare il punto finale della connessione. È necessario trascinare questo punto su un altro elemento esistente.
Un punto di rilascio non valido durante lo spostamento del punto iniziale o finale di una connessione viene evidenziato dal riempimento rosso dell'elemento (e dalla comparsa dell'icona

all'estremità della connessione). Ciò può accadere, ad esempio, se si tenta di spostare il punto iniziale della connessione sullo stesso elemento a cui è già collegato il punto finale di quella connessione. In questo caso, spostare prima il punto finale, poi il punto iniziale.
Inoltre, il percorso di una connessione verrà modificato automaticamente per mantenerla collegata a un elemento che viene spostato e a cui è attualmente connessa.
Esempio di modifica di connessioni esistenti, utilizzando le varie maniglie di modifica che compaiono quando si passa sopra una connessione.
Modifica delle proprietà dell'elemento
Come accennato in precedenza, il lato destro di Process Workflow Editor fornisce un riquadro Properties, che presenta le proprietà dell'elemento del flusso di lavoro attualmente selezionato. Per alcuni elementi, come Branch, End e Comment, la loro unica proprietà modificabile è il relativo Name. Per altri, come Start e Task, sono disponibili impostazioni che possono essere definite, nonché un Form associato che può essere costruito secondo necessità. Ricordare inoltre che le proprietà di un elemento del flusso di lavoro possono cambiare a seconda del tema di processo in base al quale il processo viene definito (e del tipo scelto per un elemento, laddove per quell'elemento siano supportati più tipi).
Apportare le modifiche necessarie alle proprietà di un elemento del flusso di lavoro selezionato tramite il riquadro Properties. Per un elemento per il quale è possibile definire un Form, sarà necessario creare il form (fare clic sul pulsante
nella sezione Form del riquadro) oppure modificarlo (fare clic sulla voce
nella sezione Form del riquadro). Per ulteriori informazioni, vedere Creazione di un form.
Note: Se al momento non è selezionato alcun elemento del flusso di lavoro, il riquadro Properties presenta le proprietà della definizione del processo padre stessa. Inoltre, senza alcun elemento del flusso di lavoro selezionato, è possibile configurare i dati parametrici visibili all'utente standard nella scheda Data per un flusso di lavoro di processo. Per maggiori dettagli, vedere Configurazione della visibilità dei dati per un utente standard.
Un Comment può anche essere modificato graficamente, per quanto riguarda le sue dimensioni, selezionandolo e quindi facendo clic e trascinando le relative maniglie di modifica.
Modifica del tipo per un elemento del flusso di lavoro
I seguenti temi di processo dispongono di elementi del flusso di lavoro che supportano più tipi:
-
Part Requests tema:
-
Task – supporta i tipi: User Task, Change State, Create Part in PLM.
-
Event – supporta i tipi: Notify User, PLM Part Completed.
-
Project Activities tema:
-
Start – supporta i tipi: Start Activity, Start Review, Start Release.
-
Task – supporta i tipi: User Task, Change State, Collect Project Data, Publish to PLM, Review Task (disponibile quando viene utilizzato Start Review).
-
Event – supporta i tipi: Notify User, PLM Publish Completed, Related Tasks Completed.
-
Project Creations tema:
-
Start – supporta i tipi: Create Project, Request Project Creation (una variante Create Project).
-
Task – supporta i tipi: User Task, Create Project, Change State, Initialise in PLM.
-
Event – supporta i tipi: Notify User, PLM Initialise Completed.
Dopo aver posizionato un elemento nell'area di disegno del diagramma del flusso di lavoro, è possibile passare tra i tipi disponibili utilizzando il menu associato al pulsante
, che compare all'interno dell'elemento o accanto a esso una volta selezionato.
Selezione dei tipi supportati per gli elementi Start, Task ed Event durante la definizione del flusso di lavoro per un processo che fa parte del tema Project Activities.
È inoltre possibile cambiare tipo utilizzando l'elenco a discesa del campo Type nel riquadro Properties , quando l'elemento è selezionato.
Assegnazione delle attività
Il modo in cui un'attività all'interno del flusso di lavoro viene assegnata dipende dalle impostazioni definite per Assignee, Except e Task ownership:
-
Assignee – può essere un singolo utente del Workspace, più utenti o un gruppo specifico di utenti. Anche qui è possibile utilizzare variabili, ad esempio
$Initiator (la persona che ha avviato l'istanza del processo) oppure $Review Coordinator (l'utente scelto come Review Coordinator in un'attività precedente).
Le variabili non vengono immesse testualmente, ma cercate e poi scelte dall'elenco dinamico delle possibili voci. Per aggiungere, ad esempio, la variabile $Initiator, iniziare a digitare In in un campo, quindi selezionare la voce dall'elenco.
-
Except – chi non è autorizzato a lavorare sull'attività, anche se fa parte dell'ambito degli assegnatari. Ad esempio, il richiedente di un componente non dovrebbe approvare la propria richiesta di componente. Un altro esempio potrebbe essere l'uso della variabile
$Rework executed by nel campo Except per l'attività Verify rework di un processo Milestone Review, per impedire all'utente che ha eseguito l'attività precedente (Rework) di poter verificare il proprio lavoro.
-
Task ownership – determina chi può agire su un'attività, in relazione all'utente o agli utenti specificati nel campo Assignee. Sono disponibili le seguenti opzioni:
-
One of assigned users – se nel campo Assignee è presente un solo utente, l'attività iniziale di lavorazione della richiesta viene assegnata direttamente a quell'utente. Se sono presenti più assegnatari, tutti gli utenti vedono l'attività nel proprio tasklist e uno di essi assegna l'attività a sé stesso.
-
All assigned users – tutti gli assegnatari ricevono l'attività.
L'immagine seguente mostra le impostazioni di assegnazione per una definizione di processo Part Request. Il Assignee è definito come gli amministratori del Workspace (membri del gruppo Administrators). Task ownership è impostato su One of assigned users, il che significa che uno di quegli utenti amministrativi deve prendere in carico la richiesta.
L'utente che riceve inizialmente l'attività di lavorazione di una nuova richiesta di componente dipende da come sono state definite le impostazioni per Assignee, Except e Task ownership per l'attività utente iniziale nel flusso di lavoro sottostante della definizione di processo applicabile. L'immagine sopra mostra le impostazioni per la definizione di processo predefinita New Part Request.
Se si desidera impedire al mittente originale della richiesta di componente di poter lavorare sulla richiesta, immettere la variabile $Initiator nel campo Except .
Configurazione della visibilità dei dati per un utente standard
È possibile configurare i dati parametrici visibili all'utente standard nella scheda Data per un flusso di lavoro di processo, durante la visualizzazione dell'avanzamento di un processo attivo o quando è stato completato. Durante la modifica del flusso di lavoro per un processo, e senza alcun elemento selezionato, i dati che possono essere presentati nella scheda Data sono elencati nel riquadro Properties . Fare clic sul controllo
per accedere al relativo form (<ProcessName> Data).
Da questo form, è possibile determinare se un parametro viene reso visibile o meno nella scheda Data . Per impostazione predefinita, un parametro è visibile (
). Fare clic su questo controllo per renderlo non visibile (
). Inoltre, è possibile controllare l'ordine in cui i dati vengono presentati. Quando si passa sopra una voce di parametro, il controllo
compare alla sua sinistra. Fare clic e tenerlo premuto, quindi trascinare il parametro in una nuova posizione.
Questa funzionalità influisce solo su ciò che un utente standard (non amministrativo) può vedere. Se si è connessi al Workspace come amministratore, saranno visibili tutti i dati, indipendentemente dall'impostazione di visibilità.
L'immagine seguente mostra la relazione tra il Form e ciò che un utente amministrativo e un utente standard (non amministrativo) vedono nella scheda Data per il processo, qui accessibile visualizzando i processi Closed nella pagina Activities della vista progetto. In questo esempio di Project Creation, i parametri Description, PCB Project Type e Project Template sono nascosti all'utente standard.
Eliminazione di un elemento del flusso di lavoro
Per eliminare un elemento del flusso di lavoro, selezionalo, quindi usa la scorciatoia da tastiera Delete. Per eliminare più elementi, fai clic e trascina un riquadro di selezione attorno a essi, oppure usa Ctrl+clic per creare la selezione individualmente, quindi usa la scorciatoia Delete.
Creazione di un modulo
Due elementi del flusso di lavoro – Start e Task – prevedono di chiedere a un utente di eseguire un'azione. Potrebbe trattarsi di una richiesta di informazioni di inizializzazione (nome e tipo di progetto, set di dati iniziale per la revisione, codice parte richiesto, produttore e datasheet) oppure di un'altra attività lungo il flusso che richiede in qualche modo un input aggiuntivo da parte dell'utente (decisione di revisione, dati aggiuntivi, commenti, parte completata per una richiesta e così via). Entrambi questi elementi possono essere considerati come task-oriented.
Per presentare i campi e le variabili necessari a facilitare tale interazione con l'utente, viene creato un Form. In alcuni casi, un modulo esiste già con campi incorporati che non possono essere rimossi, mentre in altri è disponibile un modulo con campi predefiniti che però possono essere modificati secondo necessità. In altri casi ancora, un modulo non esiste e quindi hai una libertà relativamente ampia di creare un modulo semplice o complesso quanto richiesto dalle esigenze della tua azienda.
Il seguente elenco mostra tutte le varianti di questi due task che usano/richiedono un modulo:
-
Start (tema Part Requests) – modulo esistente con campi predefiniti. Questi possono essere modificati o rimossi e, ove applicabile, è possibile definire valori predefiniti. È possibile aggiungere campi supplementari secondo necessità.
-
Start di tipo Start Activity (tema Project Activities) – modulo esistente con un campo incorporato. Questo non può essere rimosso. È possibile aggiungere campi supplementari secondo necessità.
-
Start di tipo Design Review (tema Project Activities) – modulo esistente con campi incorporati. Questi non possono essere rimossi né ampliati. Utilizzato nello sviluppo di un processo di Design Review.
-
Start (tema Project Creations) – modulo esistente con campi incorporati. Questi non possono essere rimossi. Ove applicabile, è possibile definire valori predefiniti. È possibile aggiungere campi supplementari secondo necessità.
-
Task di tipo User Task (tutti i temi di processo) – nessun modulo esistente. Creare secondo necessità.
-
Task di tipo Collect Project Data (solo tema Project Activities) – modulo esistente con un campo incorporato. Questo non può essere rimosso. È possibile aggiungere campi supplementari secondo necessità.
-
Task di tipo Review Task (solo tema Project Activities) – modulo esistente con un campo incorporato. Questo non può essere rimosso. Le opzioni possono essere ridefinite. È possibile aggiungere campi supplementari secondo necessità. Utilizzato nello sviluppo di un processo di Design Review.
-
Task di tipo Create Project (tema Project Creations) – modulo esistente con campi incorporati. Questi non possono essere rimossi. Ove applicabile, è possibile definire valori predefiniti. È possibile aggiungere campi supplementari secondo necessità.
L'editor dei moduli utente
Un modulo viene costruito utilizzando User Form Editor. Per un elemento per il quale può essere definito un Form, dovrai creare il modulo se non esiste ancora (seleziona l'elemento nel flusso di lavoro e fai clic sul pulsante
nella sezione Form del pannello Properties) oppure modificarlo se esiste già (seleziona l'elemento nel flusso di lavoro e fai clic sulla voce
nella sezione Form del pannello Properties).
Un modulo viene creato aggiungendo campi – che rappresentano variabili denominate – dei tipi richiesti e impostando i flag (ove applicabile) che definiscono come tali campi devono essere utilizzati, creando in sostanza un'interfaccia con cui trasmettere informazioni a, e richiedere informazioni da, gli utenti destinatari che eseguiranno il task.
Quando il modulo viene salvato – fai clic sul pulsante
nella parte inferiore del modulo – un riepilogo di tutti i campi definiti, insieme ai relativi tipi di variabile, viene ripresentato nel pannello Properties per l'elemento del flusso di lavoro selezionato.
Esempio di User Form Editor popolato con il modulo per il task utente Provide review feedback (parte della definizione di processo Milestone Review, all'interno del tema Project Activities). Nota che il pannello Properties fornisce un pratico elenco riepilogativo di tutti i campi definiti nel modulo, insieme ai relativi tipi.
Le sezioni seguenti esaminano il funzionamento di User Form Editor, incluso il supporto per variabili e campi, i flag associati a ciascun campo/variabile, il lavoro all'interno di un modulo e i campi e le variabili incorporati/predefiniti.
Variabili e campi
Aspetti da tenere presenti riguardo a variabili e campi:
-
Una Variable è un elemento di dati con nome, tracciato come parte del flusso di lavoro di un processo.
-
Un Field è la rappresentazione di una variabile nel contesto di uno specifico modulo utente all'interno del flusso di lavoro di un processo.
-
Non esiste una funzionalità dedicata per gestire le variabili di un processo:
-
Una variabile definita dall'utente viene aggiunta al processo quando l'amministratore la aggiunge per la prima volta a un modulo all'interno del flusso di lavoro di quel processo.
-
Una variabile definita dall'utente viene rimossa dal processo quando viene rimossa da tutti i moduli utilizzati all'interno del flusso di lavoro di quel processo.
-
La maggior parte delle variabili verrà definita dall'amministratore durante la creazione dei moduli all'interno del flusso di lavoro per una definizione di processo. Esistono alcune variabili predefinite, incorporate in una definizione di processo per particolari elementi del flusso di lavoro. Queste possono essere utilizzate altrove in altri moduli definiti dall'utente, ma restano definite per il processo anche se vengono rimosse da tutti i moduli all'interno di un flusso di lavoro.
-
Nel processo esiste una sola definizione della variabile, il che significa che ovunque questa variabile venga modificata (in qualsiasi modulo), le modifiche si riflettono automaticamente su tutti gli altri moduli utilizzati all'interno di quel flusso di lavoro e nei quali la variabile è usata.
-
I nomi delle variabili non distinguono tra maiuscole e minuscole (ovvero non è possibile avere due variabili che differiscono solo per l'uso delle maiuscole).
Supported Variable Types
La tabella seguente elenca i tipi di variabile supportati per l'uso in un modulo.
Built-in Fields
Esistono alcuni campi "integrati" per specifici tipi di attività. Questi campi non possono essere rimossi dal modulo da cui hanno origine, non possono essere rinominati e il loro tipo non può essere modificato. Ove applicabile, è possibile definire un valore predefinito. Possono essere utilizzati in altri moduli utente, con le seguenti restrizioni:
-
I flag non vengono visualizzati: i campi sono di sola lettura e non sono obbligatori.
-
Il valore (ove applicabile) non può essere modificato, ma un valore predefinito (ove applicabile) sì.
Di seguito è riportato un elenco di tipi di attività con campi integrati. In ogni caso, il tipo di variabile/dati è mostrato tra parentesi dopo il nome del campo.
Project Activities theme:
-
Start elemento di tipo Start Activity:
-
Start elemento di tipo Start Review:
-
Project (Managed Project) – flag Modificabile e Obbligatorio attivi (non possono essere modificati).
-
Name (Single Line Text) – flag Modificabile e Obbligatorio attivi (non possono essere modificati). Valore predefinito non impostato.
-
Description (Multi Line Text) – flag Modificabile attivo (non può essere modificato), flag Obbligatorio inattivo (non può essere modificato). Valore predefinito non impostato.
-
Project Release/Commit Id (Single Line Text) – flag Modificabile attivo (non può essere modificato), flag Obbligatorio inattivo (non può essere modificato). Valore predefinito non impostato.
-
Design Review Mode (Dropdown) – flag Modificabile e Obbligatorio attivi (non possono essere modificati). Opzioni del menu a discesa fissate allo stato del progetto. Valore predefinito impostato su Nessuno.
-
Attachments (File Upload) – flag Modificabile attivo (non può essere modificato), flag Obbligatorio inattivo (non può essere modificato).
-
Dynamic Reviewers (User/Group) – flag Modificabile attivo (non può essere modificato), flag Obbligatorio inattivo (non può essere modificato).
-
Task elemento di tipo Collect Project Data:
-
Task elemento di tipo Publish to PLM:
Project Creations theme:
Default Fields
Esistono alcuni campi che vengono aggiunti per impostazione predefinita agli elementi del flusso di lavoro basati su attività. Questi si comportano esattamente come qualsiasi altro campo definito dall'utente e quindi possono essere modificati secondo necessità. Forniscono semplicemente un punto di partenza per il modulo in cui sono stati aggiunti.
Ad esempio, il seguente tipo di attività ha campi predefiniti. Per ciascun campo, il tipo di variabile/dati è mostrato tra parentesi dopo il nome del campo.
-
Start elemento (tema Richieste componente):
-
Part number (
Single Line Text) – flag Modificabile attivo (non può essere modificato), flag Obbligatorio attivo (ma può essere modificato se necessario). Valore predefinito non impostato (modificabile).
-
Manufacturer (
Single Line Text) – flag Modificabile attivo (non può essere modificato), flag Obbligatorio attivo (ma può essere modificato se necessario). Valore predefinito non impostato (modificabile).
-
Description (
Single Line Text) – flag Modificabile attivo (non può essere modificato), flag Obbligatorio inattivo (ma può essere modificato se necessario). Valore predefinito non impostato (modificabile).
-
Datasheets (
File Upload) – flag Modificabile attivo (non può essere modificato), flag Obbligatorio inattivo (ma può essere modificato se necessario).
Built-in Variables
Queste sono variabili integrate in un processo o in un'attività. Possono essere utilizzate in altri moduli utente, con le seguenti restrizioni:
-
Non viene visualizzato alcun flag: per impostazione predefinita sono di sola lettura e non obbligatorie.
-
Il loro tipo non può essere modificato.
-
Non possono essere rinominate.
-
Anche se rimosse da tutti i moduli in un flusso di lavoro, non vengono rimosse dalla definizione del processo (come avviene per un normale campo/variabile definito dall'utente).
Alcune variabili integrate, come Initiator e <TaskName> executed by, possono essere utilizzate in altri moduli utente, ad esempio incluse come informazioni, ma possono anche essere usate in campi condizionali che fanno parte delle impostazioni dell'attività e non del modulo stesso. L'immagine seguente mostra la variabile integrata Prepare review data executed by che verrà generata come output quando l'attività Prepare review data sarà completata. La persona autorizzata a lavorare sull'attività è definita come la stessa persona che ha avviato il processo, tramite l'uso della voce $Initiator nel campo Assignee .
Esempio di variabili integrate: la variabile Initiator usata per definire l'assegnatario dell'attività, mentre la variabile Prepare review data executed by verrà generata dall'attività al completamento.
Un altro esempio potrebbe essere l'uso di una tale variabile per impedire che a un utente venga assegnata un'attività. Nell'immagine seguente, la variabile $Rework executed by è usata nel campo Except per l'attività Verify rework di un processo di Milestone Review, per impedire all'utente che ha eseguito l'attività precedente (Rework) di poter verificare il proprio lavoro.
Esempio di utilizzo di una variabile integrata per impedire a un utente di verificare il proprio lavoro!
Di seguito è riportato un elenco di variabili integrate, per tema di processo. Per ciascuna variabile, il relativo tipo è indicato tra parentesi dopo il nome.
Part Requests:
-
Initiator (Single Line Text) – associata principalmente all'elemento Start. Il valore è il nome dell'utente che ha avviato questa specifica istanza della definizione di processo attivata.
-
<TaskName> executed by (Single Line Text) – associata principalmente all'elemento Task (di tipo User Task). Il valore è il nome dell'utente che ha eseguito l'attività.
-
Create Part in PLM Status (Dropdown) – associata principalmente all'elemento Task (di tipo Create Part in PLM). Il risultato del processo di creazione componente PLM. Il valore può essere OK o FAIL.
-
Create Part in PLM Message (Single Line Text) – associata principalmente all'elemento Task (di tipo Create Part in PLM). Il risultato del processo di creazione componente PLM. Il valore è un messaggio di testo su singola riga.
-
Change State Status (Dropdown) – associata principalmente all'elemento Task (di tipo Change State). Il risultato del processo Change Lifecycle State. Il valore può essere OK o FAIL.
-
Change State Success (Item/Revision) – associata principalmente all'elemento Task (di tipo Change State). Il risultato del processo Change Lifecycle State. Il valore è un elenco di revisioni di elementi con stati del ciclo di vita modificati correttamente.
-
Change State Failure (Item/Revision) – associata principalmente all'elemento Task (di tipo Change State). Il risultato del processo Change Lifecycle State. Il valore è un elenco di revisioni di elementi per cui non è stato possibile modificare lo stato del ciclo di vita.
-
PLM Part Completed Status (Dropdown) – associata principalmente all'elemento Event (di tipo PLM Part Completed). Il risultato del processo di creazione componente PLM, restituito dall'istanza PLM. Il valore può essere OK o FAIL.
-
PLM Part Completed Message(Multi Line Text) – associato principalmente all'elemento Event (di tipo PLM Part Completed). Il risultato del processo di creazione della parte PLM, restituito dall'istanza PLM. Il valore è un messaggio di testo su più righe.
-
PLM Part Completed Log (File Upload) – associato principalmente all'elemento Event (di tipo PLM Part Completed). Il risultato del processo di creazione della parte PLM, restituito dall'istanza PLM. Il valore è un collegamento a un file di log.
Project Activities:
-
Initiator (Single Line Text) – associato principalmente all'elemento Start. Il valore è il nome dell'utente che ha avviato questa particolare istanza della definizione di processo attivata.
-
Start Release Data (Data Set) – associato principalmente all'elemento Start (di tipo Start Release). Il valore è un elenco di revisioni generate da Project Releaser.
-
<TaskName> executed by (Single Line Text) – associato principalmente all'elemento Task (di tipo User Task o Collect Project Data). Il valore è il nome dell'utente che ha eseguito l'attività.
-
Publish to PLM Status (Dropdown) – associato principalmente all'elemento Task (di tipo Publish to PLM). Il risultato del processo di inizializzazione della pubblicazione PLM. Il valore può essere OK o FAIL.
-
Publish to PLM Message (Single Line Text) – associato principalmente all'elemento Task (di tipo Publish to PLM). Il risultato del processo di inizializzazione della pubblicazione PLM. Il valore è un messaggio di testo su una singola riga.
-
Publish to PLM Properties (Properties) – associato principalmente all'elemento Task (di tipo Publish to PLM). Il risultato del processo di inizializzazione della pubblicazione PLM. Il valore è una tabella di coppie chiave-valore delle proprietà.
-
Change State Status (Dropdown) – associato principalmente all'elemento Task (di tipo Change State). Il risultato del processo Change Lifecycle State. Il valore può essere OK o FAIL.
-
Change State Success (Item/Revision) – associato principalmente all'elemento Task (di tipo Change State). Il risultato del processo Change Lifecycle State. Il valore è un elenco di revisioni di elementi con stati del ciclo di vita modificati correttamente.
-
Change State Failure (Item/Revision) – associato principalmente all'elemento Task (di tipo Change State). Il risultato del processo Change Lifecycle State. Il valore è un elenco di revisioni di elementi per cui non è stato possibile modificare lo stato del ciclo di vita.
-
PLM Publish Completed Status (Dropdown) – associato principalmente all'elemento Event (di tipo PLM Publish Completed). Il risultato del processo di pubblicazione PLM, restituito dall'istanza PLM. Il valore può essere OK o FAIL.
-
PLM Publish Completed Message (Multi Line Text) – associato principalmente all'elemento Event (di tipo PLM Publish Completed). Il risultato del processo di pubblicazione PLM, restituito dall'istanza PLM. Il valore è un messaggio di testo su più righe.
-
PLM Publish Completed Log (File Upload) – associato principalmente all'elemento Event (di tipo PLM Publish Completed). Il risultato del processo di pubblicazione PLM, restituito dall'istanza PLM. Il valore è un collegamento a un file di log.
Project Creations:
-
Initiator (Single Line Text) – associato principalmente all'elemento Start. Il valore è il nome dell'utente che ha avviato questa particolare istanza della definizione di processo attivata.
-
<TaskName> executed by (Single Line Text) – associato principalmente all'elemento Task (di tipo User Task). Il valore è il nome dell'utente che ha eseguito l'attività.
-
Create Project executed by (Single Line Text) – associato principalmente all'elemento Task (di tipo Create Project). Il valore è il nome dell'utente che ha eseguito l'attività Create Project.
-
Create Project Status (Dropdown) – associato principalmente all'elemento Task (di tipo Create Project). Il risultato del processo Create Project. Il valore può essere OK o FAIL.
-
Initialise in PLM Status (Dropdown) – associato principalmente all'elemento Task (di tipo Initialise in PLM). Il risultato del processo di inizializzazione del progetto PLM. Il valore può essere OK o FAIL.
-
Initialise in PLM Message (Single Line Text) – associato principalmente all'elemento Task (di tipo Initialise in PLM). Il risultato del processo di inizializzazione del progetto PLM. Il valore è un messaggio di testo su una singola riga.
-
Initialise in PLM Properties (Properties) – associato principalmente all'elemento Task (di tipo Initialise in PLM). Il risultato del processo di inizializzazione del progetto PLM. Il valore è una tabella di coppie chiave-valore delle proprietà.
-
Change State Status (Dropdown) – associato principalmente all'elemento Task (di tipo Change State). Il risultato del processo Change Lifecycle State. Il valore può essere OK o FAIL.
-
Change State Success (Item/Revision) – associato principalmente all'elemento Task (di tipo Change State). Il risultato del processo Change Lifecycle State. Il valore è un elenco di revisioni di elementi con stati del ciclo di vita modificati correttamente.
-
Change State Failure (Item/Revision) – associato principalmente all'elemento Task (di tipo Change State). Il risultato del processo Change Lifecycle State. Il valore è un elenco di revisioni di elementi per cui non è stato possibile modificare lo stato del ciclo di vita.
-
PLM Initialise Completed Status (Dropdown) – associato principalmente all'elemento Event (di tipo PLM Initialise Completed). Il risultato del processo di inizializzazione del progetto PLM, restituito dall'istanza PLM. Il valore può essere OK o FAIL.
-
PLM Initialise Completed Message (Multi Line Text) – associato principalmente all'elemento Event (di tipo PLM Initialise Completed). Il risultato del processo di inizializzazione del progetto PLM, restituito dall'istanza PLM. Il valore è un messaggio di testo su più righe.
-
PLM Initialise Completed Message (File Upload) – associato principalmente all'elemento Event (di tipo PLM Initialise Completed). Il risultato del processo di inizializzazione del progetto PLM, restituito dall'istanza PLM. Il valore è un collegamento a un file di log.
Flag
A seconda del tipo di variabile per un campo definito in un Form, può avere fino a tre flag:
-
Editable – abilita questo flag per rendere il campo modificabile, ad esempio per poter inserire il nome di un progetto, inserire una data, aggiungere dati e così via.
-
Required – abilita questo flag per rendere il campo obbligatorio, il che significa che l'utente deve scegliere un'opzione o inserire dati per poter inviare l'attività.
-
Reset value – abilita questo flag per fare in modo che il valore del campo venga reimpostato all'ingresso nel form. Se è applicabile un valore predefinito ed è stato impostato, questo verrà caricato; in caso contrario il campo sarà vuoto (o mostrerà Choose option se si tratta di un campo a discesa).
Questo può essere molto utile in un flusso di lavoro che presenta un "loop". Un esempio potrebbe essere in un workflow di processo di richiesta parte, in cui un utente convalida una richiesta e imposta il campo Next step su Needs more info. Il richiedente aggiunge le informazioni e queste tornano indietro (qui il loop) per essere convalidate. Se il campo Next step ha il flag Reset value abilitato, allora il campo verrà reimpostato e non sarà più precompilato con Needs more info. Il validatore deve quindi selezionare consapevolmente il valore per il campo.
Fare riferimento alla tabella di Supported Variable Types per vedere l'applicabilità di questi tre flag per ciascuno dei tipi di variabile.
Esempi di campi definiti in un Form, insieme ai relativi flag.
In termini di visualizzazione, un flag può apparire come segue:
-
Blu – il flag può essere modificato ed è attualmente attivo.
-
Grigio – il flag può essere modificato ed è attualmente inattivo.
-
Blu attenuato – il flag è attivo e non può essere modificato.
-
Non visualizzato – il flag non è applicabile.
Quando un flag può essere modificato, fare clic su di esso per alternarne lo stato attivo.
Un campo non può essere reso Obbligatorio, a meno che non venga prima reso Modificabile.
Opzioni avanzate
Se un tipo di variabile supporta opzioni aggiuntive, sarà presente un controllo Advanced options: fare clic su di esso per espanderle e visualizzarle.
Esempi di Advanced options per vari campi definiti in un Form.
Qui si possono trovare le seguenti opzioni, a seconda del tipo di variabile:
-
Keep value provided by each user separately – consente di usare il campo per "raggruppare" i valori forniti nei form inviati da più utenti coinvolti in un'attività, ad esempio la revisione di un progetto.
-
Dropdown options – per una variabile di tipo
Dropdown, definire qui le voci che possono comparire per la selezione dell'utente nel menu a discesa associato ai campi.
-
Default value – fornisce un valore predefinito da presentare come valore "precompilato" del campo quando l'utente accede al form associato all'attività. Se il campo è di tipo
Dropdown, il valore predefinito può essere impostato su uno dei Dropdown options definiti, oppure su None.
-
Value – in genere per una variabile di tipo
Label, usare questo campo per definire il testo dell'etichetta, presentato all'utente nel form associato all'attività su cui sta lavorando, e descrittivo di ciò che deve fare.
Aggiunta di un campo
Per aggiungere un nuovo campo a un Form, fare clic sul controllo Add in basso a destra del form. Il nuovo campo viene aggiunto in fondo al Form, con il menu a discesa Name espanso e pronto per scegliere una variabile esistente già definita altrove nella definizione di processo, oppure per crearne una nuova.
Esempio di aggiunta di un nuovo campo a un Form. È possibile scegliere se fare riferimento a una variabile esistente definita per la definizione di processo padre, oppure inserire un nuovo nome e, così facendo, creare una nuova variabile per quella definizione (una volta salvato il Form).
Le variabili già utilizzate nel Form corrente non sono incluse nel menu a discesa, poiché in un Form utente può esserci una sola istanza di una variabile. L'elenco delle variabili viene filtrato durante la digitazione, consentendo di raggiungere rapidamente una variabile esistente, se necessario.
Se viene scelta una variabile esistente:
-
Viene aggiunta al Form come ulteriore riferimento alla variabile.
-
Il campo Name viene trasformato in un campo di testo standard, consentendo di modificare il nome, ma non di scegliere un'altra variabile.
-
I flag vengono impostati in conformità a come è stata definita la variabile originale.
Se viene immesso un nuovo nome di variabile:
-
Il campo Name diventa un normale campo di testo.
-
È possibile scegliere la variabile Type (il valore predefinito è
Single Line Text).
-
I flag vengono impostati di conseguenza su uno stato predefinito: Modificabile (attivo), Obbligatorio (inattivo), Reimposta valore (inattivo).
-
La nuova variabile viene aggiunta alla definizione del processo quando il Form viene salvato.
Per rinominare un campo, fare clic all'interno del campo
Name e modificarlo secondo necessità. Se il campo non può essere rinominato,
Name sarà disattivato e l'icona

apparirà passando il cursore sul campo.
Rimozione di un campo
Per rimuovere un campo definito dall'utente, fare clic sul controllo
all'estrema destra. La rimozione è immediata, senza alcuna conferma.
Il campo definito dall'utente viene rimosso solo dal Form corrente. Se il campo/variabile è utilizzato in un altro Form del flusso di lavoro, rimarrà definito per la definizione del processo. Solo quando viene rimosso da tutti i Form, verrà eliminato dall'elenco delle variabili definite per quella definizione di processo.
Riordinare i campi
Qualsiasi campo può essere spostato in qualsiasi posizione del Form facendo clic e trascinando il controllo
, che appare sul lato sinistro quando si passa il cursore su un campo. Questo consente di aggiungere rapidamente i campi al Form e successivamente definirne l'aspetto (l'ordine di tali campi).
Salva e distribuisci
Una volta che un processo è stato definito come richiesto, fare clic sul pulsante
(in alto a destra dell'editor) per aggiungerlo all'elenco dei processi disponibili per quel tema di processo. La nuova definizione di processo verrà attivata e sarà pronta per l'uso.
L'Editor segnalerà eventuali problemi nel diagramma del flusso di lavoro che ne impediscono il salvataggio e la distribuzione; ad esempio, un diagramma deve avere un evento Start e almeno un evento End definito. Inoltre, un'Attività utente deve avere almeno un campo del Form e un assegnatario.