È possibile creare valori di processo esposti (EPV) per definire una serie di variabili che si desidera esporre a utenti specifici. Queste variabili possono essere modificate dagli utenti mentre le istanze di un processo sono in esecuzione. Ad esempio, se si crea un processo per gestire il rimborso spese, è possibile abilitare i supervisori a modificare gli importi consentiti per le spese giornaliere o l'importo in dollari che coincide con vari livelli di approvatori. Con la creazione di EPV, è possibile fornire questo tipo di flessibilità, consentendo agli utenti di regolare valori di variabili specifiche come costanti, influenzando così il flusso di tutte le istanze del processo in esecuzione, le assegnazioni di attività e così via.
Informazioni su questa attività
L'EPV restituito dipende dal fatto che Utilizza nuovi valori sia impostato in EPV; l'impostazione è annullata per impostazione predefinita.
- Se Utilizza nuovi valori è impostato, l'API tw.epv restituisce l'EPV che ha una data Effettiva il che è nel passato ed è più vicina all'ora corrente.
- Se Utilizza nuovi valori non è impostato, l'API tw.epv utilizza l'ora in cui l'istanza dell'attività è stata avviata, il che significa che trova l'EPV che ha una data Effettivo il nel passato ed è più vicina all'ora in cui è stata avviata l'istanza dell'attività.
Nota: le istruzioni in questo argomento spiegano come creare un EPV
nuovo ed esporlo a un team i cui membri possono gestire l'EPV e modificarne i valori di variabili. Se si dispone di un EPV
esistente che non è ancora esposto, è necessario esporlo a un team nel designer e creare una nuova
versione per modificare i valori predefiniti. Altrimenti, l'EPV non sarà utilizzabile. L'EPV può essere modificato solo dal team a cui è esposto. Non può essere modificato dagli amministratori. Dopo che l'EPV è stato esposto ad un team specifico, è possibile modificare il contenuto del team in fase di runtime utilizzando i normali metodi di modifica del team. Per ulteriori informazioni sugli EPV, consultare l'argomento
Gestione dei valori di processo esposti (EPV).
Limitazione: è necessario utilizzare il nome della variabile all'interno degli script lato client di un servizio umano lato client per ottenere un valore per un EPV. Non è possibile raggiungere una variabile EPV utilizzando il nome esterno su un servizio con interazione dell'utente lato client.
Procedura
Per creare un EPV:
- Aprire il designer.
- espandere Dati e selezionare Valore processo esposto.
Si apre la finestra Nuovo valore di processo esposto .
- Nel campo Nome , immettere un nome per il valore e fare clic su Fine.
Viene aperta la vista di configurazione EPV.
- Configurazione di EPV
- Nel campo Documentazione , immettere una descrizione dell'EPV per gli sviluppatori.
- Per consentire agli utenti di inviare un feedback su questo EPV, immettere un indirizzo email nel campo Contatto e-mail di feedback .
La pagina Gestisci valori processo esposti in Process Admin Console contiene un link di feedback che utilizza questo indirizzo email.
- Nel campo Descrizione esterna , immettere una descrizione dell'EPV per gli utenti.
La descrizione qui fornita viene visualizzata nella pagina Gestisci valori del processo esposto in Process Admin Console.
- Aggiungere una o più variabili all'EPV applicando la seguente procedura:
- Nella sezione Variabili valore del processo esposto , fare clic su + per aggiungere una variabile a questo EPV.
Ad esempio, se si desidera consentire agli utenti di modificare gli importi in dollari che corrispondono a vari livelli di responsabili dell'approvazione per un processo di rimborso spese, aggiungere una variabile per ogni livello disponibile.
- Nella sezione Dettagli variabile , nel campo Nome esterno , immettere il nome della variabile per gli utenti.
Questo nome viene visualizzato nell'Elenco variabili per questo EPV in Process Admin Console.
- Nel campo Nome variabile , immettere il nome della variabile per l'elaborazione interna.
Nota: i nomi delle variabili devono iniziare con una lettera minuscola, con le parole successive in maiuscolo: myVar. Non utilizzare spazi nei nomi delle variabili. I nomi delle variabili sono sensibili al maiuscolo / minuscolo.
- Nel campo Descrizione esterna , immettere il testo per descrivere questa variabile agli utenti.
Questa descrizione viene visualizzata nell'elenco di variabili per questo EPV in Process Admin Console.
- Facoltativo: nella casella di testo Valore predefinito , immettere un valore predefinito valido per questa variabile.
- Per consentire alle attività in corso di utilizzare il valore aggiornato di questa variabile quando gli utenti ne modifica il valore, selezionare la check box Utilizza nuovi valori .
- Per selezionare un tipo di variabile, selezionare Seleziona ... e selezionare un oggetto di business o fare clic su Nuovo per creare un nuovo oggetto di business personalizzato (tipo di variabile).
Nota: è necessario prestare attenzione quando si utilizza un tipo non stringa per le variabili EPV. L'utilizzo di tipi non stringa non è consigliato e può causare problemi con la conversione di tipo JavaScript . Se è necessario utilizzare un tipo non stringa per le variabili EPV, consultare la sezione "Esempio" di seguito.
- Nella sezione Esposizione , fare clic su Seleziona per selezionare il team i cui membri possono gestire questo EPV e modificarne i valori di variabile.
Per impostazione predefinita, un EPV non è esposto ad alcun team. È necessario esporre un EPV selezionando un team per modificare i valori dell'EPV. L'EPV può essere modificato solo dal gruppo selezionato in Process Admin Console. Gli amministratori non possono modificare l'EPV. Dopo che l'EPV è stato esposto a un team specifico, è possibile modificare il contenuto del team al runtime utilizzando i normali metodi di modifica del team. Per ulteriori informazioni sugli EPV, consultare l'argomento Gestione dei valori di processo esposti (EPV).
- Fare clic su Salva o Termina modifica.
Risultati
L'EPV viene creato, è possibile collegarlo a un processo, a un servizio o a un report.
Puoi fare riferimento al nome dell'EPV e alle sue variabili come: tw.epv.[epv_name].[epv_variable_name].
È possibile utilizzare l'EPV in un gateway di decisione per controllare il flusso di un processo. È anche possibile fare riferimento a EPV da qualsiasi codice JavaScript in un processo collegato, come il codice all'interno di un componente del servizio script del server.
Esempio
Per utilizzare un tipo intero o decimale per una variabile EPV (piuttosto che il tipo stringa consigliato), è necessario considerare la creazione di una variabile locale corrispondente di tipo intero o decimale. L'operazione deve essere eseguita sulla variabile locale, ad esempio
tw.local.number = tw.epv.myepvs.number; tw.local.number = tw.local.number + 1;
In alternativa, per utilizzare le variabili EPV nel codice JavaScript , è necessario utilizzare il cast di tipo, ad esempio
var mynumber = parseFloat(tw.epv.myepvs.number);
È anche possibile utilizzare una variabile complessa eseguendo il casting della variabile EPV al tipo che si utilizza. Per esempio
// for a string use the following:
tw.local.myString = String(tw.epv.kbexample.myString);
// for an integer use:
tw.local.myInt = Number(tw.epv.kbexample.myInt);
//for a boolean use:
tw.local.myBoolean = String(tw.epv.kbexample.myBoolean);
Nota: è necessario eseguire il cast di una stringa come se si esegue il cast di un valore booleano che restituisce sempre true. Quando viene assegnata a un valore booleano, la stringa ottenuta viene implicitamente assegnata a un valore booleano.
Cosa fare successivamente
Dopo aver creato un EPV, è possibile collegarlo a un processo o a un servizio selezionandolo dall'elenco delle variabili del processo esposto nella scheda Variabili.