> Source: https://docs.cyberelements.io/identity/7.0/it/UserDocumentation/WorkflowManagement/WorkflowConfiguration/WorkflowParameters/

# Impostazioni dei workflow

Un modello di workflow è definito da:

- le sue impostazioni generali,
- le sue impostazioni di inizializzazione,
- i suoi utenti reali o di sistema autorizzati ad avviarlo,
- un'autorizzazione di esecuzione sul richiedente,
- i suoi manager,
- il suo ambito: persone destinatarie del workflow (ad esempio: interni, persone di un reparto),
- la sua regola di convalida, che dipende dallo stato dei passaggi,
- i suoi passaggi,
- le sue azioni e attività.

![](https://docs.cyberelements.io/identity/7.0/img/Identity/IdU_ConfigDetailsWorkflow.png)

## Impostazioni generali

![](https://docs.cyberelements.io/identity/7.0/img/Identity/IdU_ConfigWorkflowParametresGeneraux.png)

| Parametro | Description | Tipo e valori possibili |
|---|---|---|
| Created by | Nome visualizzato del creatore del modello di workflow. | Visibile solo in modalità di consultazione.  Non modificabile. |
| Put into production by | Nome visualizzato dell'identità che ha messo in produzione il workflow. | Visibile solo in modalità di consultazione.  Non modificabile. |
| Workflow ID | Identificativo univoco assegnato da CyberElements Identity. | Visibile solo in modalità di consultazione.  Non modificabile. |
| Version | Identificativo univoco assegnato da CyberElements Identity.  Viene incrementato automaticamente a ogni modifica del modello di workflow. | Visibile solo in modalità di consultazione.  Non modificabile. |
| Category | Consente di classificare il modello di workflow in una categoria. | Elenco di valori definiti dalle categorie di workflow. |
| Name | Nome del workflow.  Viene visualizzato nell'elenco Workflows dell'interfaccia di amministrazione e nell'interfaccia utente.  È possibile personalizzare il nome con un valore specifico dell'istanza di workflow includendo una parola chiave. | Obbligatorio.  Stringa di caratteri che può contenere parole chiave. In tal caso, la stringa di caratteri non deve contenere spazi né caratteri speciali.  Esempio:  Request_Right_#TARGET#ATTRIBUTE#displayname#  A ogni richiesta di diritti verrà aggiunto come suffisso il nome delle persone per le quali sono state effettuate le richieste di diritti.  ![](https://docs.cyberelements.io/identity/7.0/img/Identity/IdU_SuffixeDemandeDroitsParametresGeneraux.png) |
| Code | Codice che identifica la configurazione di un Workflow; deve essere univoco. | Obbligatorio.  Stringa di caratteri, senza spazi né caratteri speciali. |
| Description | Descrizione del workflow.  Verrà visualizzata nell'interfaccia utente per i workflow di richiesta utente. | Stringa di caratteri. |
| Title | Titolo del Workflow così come verrà visualizzato nell'interfaccia utente. | Stringa di caratteri. |
| Allow note(s) to be added | Consente di autorizzare o vietare l'aggiunta di note alle istanze di workflow dall'interfaccia utente. | Yes/No.  Valore predefinito = No |
| Archiving period (days) | Definisce il periodo di tempo durante il quale le istanze di workflow archiviate rimangono nel database. | Numerico.  Il periodo di archiviazione inizia appena il workflow è completato. Una volta scaduto il periodo di archiviazione, l'istanza di workflow viene eliminata automaticamente dal database. (Non valido per i workflow differiti, che non vengono mai eliminati)  Valore predefinito = 0. |

## Impostazioni di inizializzazione

Le impostazioni di inizializzazione consentono di definire il tipo di workflow e le sue caratteristiche, nonché la modalità di attivazione. I campi di configurazione variano in funzione del tipo di workflow selezionato.

![](https://docs.cyberelements.io/identity/7.0/img/Identity/IdU_ConfigWorkflowParametresInitialisation.png)

Le impostazioni di inizializzazione comuni a tutti i tipi di workflow sono le seguenti:

| Parametro | Description | Tipo e valori possibili |
|---|---|---|
| Statut | Parametro che indica lo stato del workflow. Solo i workflow in produzione verranno eseguiti dal motore di workflow e saranno disponibili nell'elenco delle richieste di un utente. | Under construction  In production  Suspended  Enabled |
| Workflow type | Scelta del tipo di workflow. | At the request of users: nel menu «workflow» della console operativa è disponibile una maschera di richiesta utente.  On an event: attivazione del workflow condizionata da un evento di CyberElements Identity che può essere sottoposto a convalida, come le assegnazioni o gli annullamenti di assegnazione (account, profili, delega, risorse, persone), le creazioni, modifiche o eliminazioni (persone, diritti, strutture, regole di autorizzazione, enumerazioni, sincronizzazioni), le deleghe e le eliminazioni di deleghe, le certificazioni e le decertificazioni di diritti, i cambi di contesto, le riconciliazioni di identità e i trasferimenti di personale.  Delayed triggering: attivazione del workflow a partire da un attributo di tipo data della persona (ad esempio: data di inizio, data di fine, data di nascita) oppure a partire dalla data di scadenza di un diritto.  Periodic: workflow attivato a partire da una frequenza di esecuzione. |

I parametri di inizializzazione in funzione del tipo di workflow sono descritti di seguito:

- Tipo di workflow «User request»: sono disponibili diversi tipi di workflow «user request» e la configurazione dei parametri di inizializzazione varia in funzione del tipo scelto.

  | Parametro | Description | Tipo e valori possibili |
  |---|---|---|
  | Request | Natura della richiesta utente. | Rights request |
  | Check SOD | Richiede la verifica delle regole di separazione dei compiti durante la compilazione della maschera di richiesta. L'utente non potrà convalidare la propria richiesta se i diritti richiesti non rispettano le regole SOD. | Yes/No |
  | Right | Elenco dei diritti che l'utente che avvia il workflow può richiedere. | Elenco di diritti. |
  | Additional fields | Consente di configurare campi di testo o enumerati aggiuntivi nella maschera di richiesta. | Selezione di uno o più attributi (solo di tipo stringa di caratteri o enumerato) dall'elenco degli attributi esistenti. |

  | Parametro | Description | Tipo e valori possibili |
  |---|---|---|
  | Request | Natura della richiesta utente. | Request for attribute modification |
  | Attribute selection | Elenco degli attributi che l'utente che avvia il workflow può modificare. | Elenco degli attributi.  Visibile se: Request = «Request to modify attributes» |

  | Parametro | Description | Tipo e valori possibili |
  |---|---|---|
  | Request | Natura della richiesta utente. | Resource request |
  | Resource type | Tipo di risorse che l'utente che avvia il workflow può richiedere. | Tipo di risorsa. (Si noti che, per utilizzare correttamente questa funzionalità, occorre selezionare un solo tipo di risorsa per workflow) |

  | Parametro | Description | Tipo e valori possibili |
  |---|---|---|
  | Request | Natura della richiesta utente. | Manual provisioning request |
  | Check SOD | Richiede la verifica delle regole di separazione dei compiti durante la compilazione della maschera di richiesta. L'utente non potrà convalidare la propria richiesta se i diritti richiesti non rispettano le regole SOD. | Yes/No |
  | Right | Elenco dei diritti che l'utente che avvia il workflow può richiedere. | Elenco di diritti. |
  | Additional fields | Consente di configurare campi di testo o enumerati aggiuntivi nella maschera di richiesta. | Selezione di uno o più attributi (solo di tipo stringa di caratteri o enumerato) dall'elenco degli attributi esistenti. |

  | Parametro | Description | Tipo e valori possibili |
  |---|---|---|
  | Request | Natura della richiesta utente. | Other request |
  | Description of the request | Description | Stringa di caratteri. |
    - Richiesta di diritti: consente a un utente di richiedere diritti tramite una maschera. Può presentare la richiesta per se stesso o per una o più altre persone.
    - Richiesta di modifica di attributi: consente a un utente di richiedere la modifica del valore di uno o più attributi tramite una maschera. Può presentare la richiesta per se stesso o per una o più altre persone.
    - Richiesta di risorse: consente a un utente di inviare una richiesta di assegnazione di risorse tramite una maschera. Può presentare la richiesta per se stesso o per una o più altre persone.
    - Richiesta di provisioning manuale: consente a un utente di inviare una richiesta di provisioning manuale tramite una maschera. Può presentare la richiesta per se stesso o per una o più altre persone.
    - Altra richiesta: consente a un utente di effettuare una richiesta personalizzata tramite una maschera. La richiesta viene formulata in forma di testo. Può presentarla per se stesso o per una o più altre persone.
- Tipo di workflow «On an event»: gli eventi vengono generati da CyberElements Identity per ogni operazione compresa nell'elenco seguente.

| Parametro | Description | Tipo e valori possibili |
|---|---|---|
| Event | Parametro che indica l'evento o gli eventi che attivano il workflow. | Elenco degli eventi (vedere l'elenco seguente) |
| Opzione di attivazione in funzione dello stato dell'azione | Condizione di attivazione collegata allo stato dell'azione che ha generato l'evento. | Success/Failure/Both |
| Opzione di attivazione del workflow in funzione della sequenza temporale dell'azione | Condizione di attivazione del workflow | Before/After/Both.  Before: selezionare questa opzione per creare una convalida prima che l'evento si verifichi effettivamente (esempio: convalida della creazione di una persona).  After: selezionare questa opzione affinché il primo passaggio venga attivato dopo che l'evento si è verificato. |
| Conditions to be validated | Workflow attivato se vengono convalidati tutti gli eventi inviati o una parte di essi. | Almeno una delle condizioni deve essere convalidata,  Tutte le condizioni devono essere convalidate. |
| Grouping | Consente di attivare un solo workflow quando viene inviato contemporaneamente un lotto di eventi simili. | Yes/No.  Questa opzione è disponibile per i sei eventi seguenti:  Assegnazione di diritti  Modifica di diritti  Modifica di una persona  Riconciliazione delle identità di una persona  Ritiro di diritti  Eliminazione della riconciliazione delle identità di una persona |

Elenco degli eventi e dei parametri opzionali

- Tipo di workflow «Delayed Trigger»: è possibile attivare un workflow X giorni prima o dopo la data di un attributo definito o la data di fine di un diritto indicato.

| Parametro | Description | Tipo e valori possibili |
|---|---|---|
| Based on | Parametro che consente di indicare l'attributo di tipo data su cui si baserà il workflow. | «On attribute»: elenco degli attributi di tipo data.  «On expiration of a right»: si applica a tutti i diritti per i quali è indicata una data di fine. |
| Time period | «Before» (numero di giorni): esecuzione anticipata del workflow a partire dal valore dell'attributo di tipo data di destinazione.  «After» (numero di giorni): esecuzione differita del workflow a partire dal valore dell'attributo di tipo data di destinazione. | Numero intero. |

- Tipo di workflow «Periodic»: consente di inviare workflow con una frequenza determinata

| Parametro | Description | Tipo e valori possibili |
|---|---|---|
| Every | Parametri che consentono di indicare la frequenza con cui viene attivato un workflow periodico. | Frequenza da selezionare nell'elenco: - Day(s) - Week(s) - Month - Hour(s) |
| Sending time | Ora alla quale viene attivato il workflow periodico. | Numeri interi. Definiscono l'ora di invio quando la frequenza selezionata è giorno, settimana o mese, oppure l'ora del primo invio quando la frequenza è di tipo «hour». |

## User(s)

La sezione «Users» consente di definire quali persone o identità possono eseguire un workflow. Le possibilità variano in funzione del tipo di workflow scelto.

![](https://docs.cyberelements.io/identity/7.0/img/Identity/IdU_ConfigWorkflowUtilisateurs.png)

| Parametro | Description | Tipo e valori possibili |
|---|---|---|
| Authorized user(s) | Persona o persone, reali o di sistema, autorizzate ad avviare il workflow. | - Everyone (persone reali), - A list of people (valido per i workflow per evento o per richiesta utente), - An SQL evaluation (valido per i workflow per evento), - System (HPP, ILM - valido solo per i workflow per evento, con attivazione differita o periodica), - Any person (sistema + persone reali. Valido solo sui workflow per evento o con attivazione differita). |
| Filter | Tipo di filtro che definisce come viene recuperato l'elenco delle persone autorizzate ad avviare il workflow.  Esempio: utenti con diritti di amministrazione di CyberElements Identity o responsabili di un servizio. | Visibile se «Authorized user(s)» = «A list of persons»: - List (IDs), - List of IDs returned by an SQL evaluation. |
| Selection | Elenco risultante dalla selezione di persone effettuata durante la configurazione. | Visibile se «Authorized user(s)» = «A list of persons» e se «Filter» = «List (ids)».  Elenco delle persone da selezionare. ![](https://docs.cyberelements.io/identity/7.0/img/Identity/IdU_SelectionUtilisateurs.png) |
| Filter query | Parametro che consente di indicare una query SQL per filtrare le persone desiderate. | Visibile se «Authorized user(s)» = «A list of persons» e se «Filter» = «List of IDs returned by an SQL evaluation».  Stringa di caratteri: query SQL utilizzata per filtrare le persone desiderate. Consultare [questa pagina](https://docs.cyberelements.io/identity/7.0/it/UserDocumentation/GeneralConfigurations/ManagingKeywordsInWorkflows/) per l'uso delle parole chiave. ![](https://docs.cyberelements.io/identity/7.0/img/Identity/IdU_ConfigRequeteFiltreUtilisateurs.png) |

## Consentire l'esecuzione per se stessi?

Questa opzione è visibile solo se il tipo di workflow è impostato su «On User Request». Consente di autorizzare o negare a un utente l'invio di una richiesta per se stesso.

Anche il numero di utenti autorizzati a presentare una richiesta per se stessi può essere ridotto mediante filtri.

È inoltre possibile configurare un workflow per consentire l'esecuzione solo per se stessi. Le configurazioni da applicare sono descritte di seguito.

![](https://docs.cyberelements.io/identity/7.0/img/Identity/IdU_ConfigWorkflowAutoriserExecutionPourMoiMeme.png)

| Parametro | Description | Tipo e valori possibili |
|---|---|---|
| Allow | Parametro che indica se l'utente che presenta una richiesta può farlo a proprio nome. | - Yes (selezionata), - No (non selezionata). |
| Filter | Tipo di filtro che definisce come viene recuperato l'elenco delle persone autorizzate a presentare una richiesta.  Esempio: utenti con diritti di amministrazione di CyberElements Identity o responsabili di un servizio. | Visibile se «Allow» = Yes (selezionata). - List (IDs) - List of IDs returned by an SQL evaluation: opzione da selezionare se il workflow può essere eseguito solo per se stessi. |
| Selection | Elenco risultante dalla selezione di persone effettuata durante la configurazione. | Visibile se «Authorized user(s)» = «A list of persons» e se «Filter» = «List (ids)».  Elenco delle persone da selezionare. ![](https://docs.cyberelements.io/identity/7.0/img/Identity/IdU_SelectionUtilisateurs.png) |
| Filter query | Parametro che consente di indicare una query SQL per filtrare le persone desiderate. | Visibile se «Authorized User(s)» = «A list of persons» e se «Filter» = «List of IDs returned by an SQL evaluation».  Stringa di caratteri: query SQL utilizzata per filtrare le persone desiderate.  ![](https://docs.cyberelements.io/identity/7.0/img/Identity/IdU_ConfigRequeteFiltreUtilisateurs.png)  Se il workflow può essere eseguito solo per se stessi, utilizzare la sintassi seguente:  §PERSON§ATTRIBUTE§UID§=#STARTER#ATTRIBUTE#UID#  Consultare [questa pagina](https://docs.cyberelements.io/identity/7.0/it/UserDocumentation/GeneralConfigurations/ManagingKeywordsInWorkflows/) per l'uso delle parole chiave. |

## Manager

La sezione «Manager» consente di definire quali persone possono gestire le istanze di questo workflow, ossia quali persone saranno autorizzate a consultare le istanze di workflow e a intervenire su di esse fino a quando il workflow non è in stato completato/archiviato.

![](https://docs.cyberelements.io/identity/7.0/img/Identity/IdU_ConfigWorkflowManager.png)

| Parametro | Description | Tipo e valori possibili |
|---|---|---|
| Workflow administrator(s) | Persona o persone reali autorizzate a gestire il workflow, ossia a metterlo in pausa, riavviarlo, arrestarlo e convalidare azioni come le approvazioni. | Elenco di persone. |
| Filter | Filtro che definisce come viene recuperato l'elenco delle persone autorizzate ad amministrare il workflow. | - List (IDs) - List of IDs returned by an SQL evaluation. |
| Selection | Elenco risultante dalla selezione di persone effettuata durante la configurazione. | Visibile se «Authorized user(s)» = «A list of persons» e se «Filter» = «List (ids)».  Elenco delle persone da selezionare. ![](https://docs.cyberelements.io/identity/7.0/img/Identity/IdU_SelectionUtilisateurs.png) |
| Filter query | Parametro che consente di indicare una query SQL per filtrare le persone desiderate. | Visibile se «Authorized user(s)» = «A list of persons» e se «Filter» = «List of IDs returned by an SQL evaluation».  Stringa di caratteri: query SQL utilizzata per filtrare le persone desiderate. Consultare [questa pagina](https://docs.cyberelements.io/identity/7.0/it/UserDocumentation/GeneralConfigurations/ManagingKeywordsInWorkflows/) per l'uso delle parole chiave.  -->![](https://docs.cyberelements.io/identity/7.0/img/Identity/IdU_ConfigRequeteFiltreUtilisateurs.png) |

## Scope

La sezione «Scope» consente di definire condizioni per filtrare le identità che possono essere destinatarie del workflow. L'ambito del workflow si applica solo ai workflow di tipo «On event», «Delayed trigger» o «On user request».

![](https://docs.cyberelements.io/identity/7.0/img/Identity/IdU_ConfigWorkflowPerimetre.png)

| Parametro | Description | Tipo e valori possibili |
|---|---|---|
| Ambito del workflow: | Persona o persone reali per le quali viene eseguito il workflow (consente di filtrare il destinatario del workflow). | - «All»: tutte le identità, - «List»: consente di limitare l'ambito Esempio: per un workflow su un evento di creazione di una persona, l'ambito potrebbe essere limitato alle creazioni di persone esterne. Per le richieste di diritti, le richieste potrebbero essere limitate agli utenti di un servizio. |
| Filter | Tipo di filtro che definisce come viene recuperato l'elenco delle persone destinatarie del workflow. | - List (IDs) - List of IDs returned by an SQL evaluation. |
| Selection | Elenco risultante dalla selezione di persone effettuata durante la configurazione. | Visibile se «Authorized user(s)» = «A list of persons» e se «Filter» = «List (ids)».  Elenco delle persone da selezionare. ![](https://docs.cyberelements.io/identity/7.0/img/Identity/IdU_SelectionUtilisateurs.png) |
| Filter query | Parametro che consente di indicare una query SQL per filtrare le persone desiderate. | Visibile se «Authorized user(s)» = «A list of persons» e se «Filter» = «List of IDs returned by an SQL evaluation».  Stringa di caratteri: query SQL utilizzata per filtrare le persone desiderate. Consultare [questa pagina](https://docs.cyberelements.io/identity/7.0/it/UserDocumentation/GeneralConfigurations/ManagingKeywordsInWorkflows/) per l'uso delle parole chiave.  ![](https://docs.cyberelements.io/identity/7.0/img/Identity/IdU_ConfigRequeteFiltreUtilisateurs.png) |

## Workflow validation

La sezione «Workflow validation» consiste nel definire lo stato dell'istanza di workflow a partire dagli stati dei passaggi che compongono il workflow. I manager del workflow possono inoltre essere autorizzati a convalidare (i passaggi di convalida) a nome dei validatori (per sbloccare i workflow in caso di assenza, ad esempio).

![](https://docs.cyberelements.io/identity/7.0/img/Identity/IdU_ConfigWorkflowValidationWorkflow.png)

| Parametro | Description | Tipo e valori possibili |
|---|---|---|
| Allow validation by manager | Consente la convalida del workflow da parte dei manager del workflow (in aggiunta ai validatori definiti nei passaggi del workflow). | - Yes (selezionata), - No (non selezionata). |
| Validation rule | Parametro che consente di definire la regola da verificare per indicare se il workflow è riuscito o è fallito. | - The workflow succeeds if the last step has succeeded, - The workflow fails if at least one step fails, - Evaluation rule determining whether the workflow has succeeded. |
| Query | Parametro che consente di indicare una query SQL per definire con maggiore precisione gli elementi che determineranno se un workflow sarà nello stato «Successful». | Visibile se «Validation Rule» = «Evaluation rule determining whether the workflow succeeds».  Stringa di caratteri: query SQL utilizzata per estrarre gli elementi che determineranno se un workflow è nello stato «Successful» o «Failed». La query deve restituire un valore booleano. Se il valore restituito è 1, il workflow sarà nello stato «Successful»; in caso contrario, sarà nello stato «Failed». Consultare [questa pagina](https://docs.cyberelements.io/identity/7.0/it/UserDocumentation/GeneralConfigurations/ManagingKeywordsInWorkflows/) per l'uso delle parole chiave. ![](https://docs.cyberelements.io/identity/7.0/img/Identity/IdU_ConfigWorkflowValidationWorkflowRequete.png) |

Nota sulla convalida del workflow:

Quando un'azione (o un passaggio) non viene eseguita perché il contesto non soddisfa le condizioni di esecuzione dell'azione (o del passaggio), nel database non viene creata alcuna istanza di azione (o di passaggio).

Non è quindi possibile recuperare lo stato dell'azione o del passaggio.

Se, per un determinato passaggio senza condizioni di esecuzione, nessuna delle sue azioni è stata eseguita, l'istanza del passaggio esiste nel database e il suo stato è riuscito.

Le operazioni sottoposte a convalida vengono convalidate solo se il workflow termina correttamente.
