Configurare le azioni

 

Data di pubblicazione: novembre 2016

Si applica a: Dynamics CRM 2015

Puoi abilitare di un'azione personalizzata da un flusso di lavoro o un'interazione, senza scrivere codice.Ulteriori informazioni:Richiamare un'azione personalizzata da un flusso di lavoro o un'interazione.

Può essere necessario anche creare un'azione in modo che uno sviluppatore possa utilizzarla nel codice o può essere necessario modificare un'azione definita in precedenza. Analogamente ai processi di flusso di lavoro, tenere presente quanto segue:

• Cosa devono eseguire le azioni?

• In quali condizioni le azioni devono essere eseguite?

A differenza dei processi di flusso di lavoro, non è necessario impostare le opzioni seguenti:

• Avvia in caso di: le azioni vengono avviate quando il codice chiama i messaggi generati per le azioni stesse.

• Ambito: le azioni vengono eseguite sempre nel contesto dell'utente chiamante.

• Esegui in background: le azioni sono sempre flussi di lavoro in tempo reale.

Per un'azione sono inoltre presenti elementi che i processi di flusso di lavoro non hanno, ovvero argomenti di input e output.Ulteriori informazioni:Definire gli argomenti del processo

In questo argomento

Creare un'azione

Modificare un'azione

Creare un'azione

Importante

Se si crea un'azione che verrà inclusa nell'ambito di una soluzione che verrà distribuita, crearla nel contesto della soluzione. Passare a Impostazioni > Soluzioni e individuare la soluzione non gestita di cui l'azione farà parte. Quindi, sulla barra dei menu, selezionare Nuovo > Processo. In questo si verifica che il prefisso di personalizzazione associato al nome dell'azione sia coerente con altri componenti della soluzione. Dopo aver creato l'azione, non è possibile modificare il prefisso.

Analogamente ai processi di flusso di lavoro, per le azioni sono disponibili le proprietà seguenti nella casella di dialogo Crea processo.

• Nome processo
  Dopo aver messo un nome per il processo, un nome univoco verrà creato rimuovendo tutti gli spazi o i caratteri speciali dal nome del processo.

• Categorie
  Questa proprietà stabilisce che quello corrente è un processo di azione. Dopo aver salvato il processo, non è possibile modificare questa impostazione.

• Entità
  Con i processi di azione, è possibile selezionare un'entità per fornire contesto per il flusso di lavoro come per altri tipi di processi, ma è anche possibile scegliere Nessuno (globale). Utilizzare questa opzione se l'azione non richiede il contesto di un'entità specifica. Dopo aver salvato il processo, non è possibile modificare questa impostazione.

• Tipo
  È possibile utilizzare questa proprietà per scegliere se creare una nuova azione partendo da zero o da un modello esistente.

Modificare un'azione

È necessario disattivare i processi prima di modificarli.

Puoi modificare un'azione creato come parte di una soluzione non gestita o incluso in una soluzione installata nell'organizzazione. Se la soluzione è gestita, potresti non essere in grado di modificarla. L'autore di soluzioni ha la possibilità di modificare le proprietà gestite in modo che l'azione installata con una soluzione gestita non possa essere modificata.

Quando un'azione viene salvata, viene generato un nome univoco in base al nome processo. Il nome univoco ha il prefisso di personalizzazione aggiunto dall'autore della soluzione. Nome del messaggio che uno sviluppatore utilizzerà nel codice.

Importante

Dopo che l'azione viene attivata e il codice viene scritto in modo da utilizzare un nome univoco, quest'ultimo non deve essere modificato senza che venga modificato anche il codice che vi fa riferimento.

Quando si modifica un'azione sono disponibili le opzioni seguenti:

• Nome processo
  Dopo la creazione del processo e la generazione del nome univoco a partire da tale nome, è possibile modificare il nome processo. Potresti volere applicare la convenzione di denominazione per semplificare l'individuazione di processi specifici.

• Nome univoco
  Quando un'azione viene salvata, viene generato un nome univoco in base al nome processo. Il nome univoco ha il prefisso di personalizzazione aggiunto dall'autore della soluzione. Nome del messaggio che uno sviluppatore utilizzerà nel codice. Non modificare questo nome univoco se il processo è stato attivato ed esiste codice che si prevede chiami l'azione con questo nome.

• Abilita rollback
  In genere, i processi che supportano le transazioni annulleranno (o eseguiranno il rollback) l'intera operazione se una parte di essi non riesce. Sono presenti alcune eccezioni. Alcune azioni che gli sviluppatori potrebbero eseguire in codice avviato dall'azione potrebbero non supportare le transazioni, ad esempio se il codice esegue azioni in altri sistemi di fuori dall'ambito della transazione. Per tali operazioni non può essere eseguito il rollback dall'azione eseguita in Microsoft Dynamics 365. Alcuni messaggi nella piattaforma Dynamics 365 non supportano le transazioni, ma tutte le attività che è possibile eseguire nell'interfaccia utente dell'azione supporteranno le transazioni. Tutte le azioni che fanno parte di un flusso di lavoro in tempo reale vengono considerate in transazione, ma con le azioni è possibile rifiutare esplicitamente questa possibilità.

  È consigliabile consultarsi con lo sviluppatore che utilizzerà questo messaggio per stabilire se l'azione deve essere in transazione o meno. In genere, un'azione deve essere in transazione se le azioni eseguite dal processo aziendale non sono significative a meno che tutte non siano completate correttamente. L'esempio classico è il trasferimento di fondi tra due conti bancari. Se si ritirano fondi da un conto, è necessario depositarli nell'altro. Se una delle due operazioni non riesce, entrambe devono avere esito negativo.

  Nota

  L'opzione Abilita rockball non è supportata se un'azione personalizzata viene richiamata direttamente da un flusso di lavoro o una interazione. È possibile abilitare la rollback se un'azione viene attivata da un messaggio dei servizi Web di Dynamics 365.

• Attiva come
  Come per tutti i processi, è possibile attivare il processo come un modello e utilizzarlo come punto di partenza avanzato per i processi che seguono un modello simile.

• Definisci argomenti processo
  In quest'area specifichi i dati che l'azione prevede per essere avviata e quelli che restituirà.Ulteriori informazioni:Definire gli argomenti del processo

• Aggiungere fasi, condizioni e azioni
  Come per altri processi, è necessario specificare le azioni da eseguire e il momento in cui eseguirle.Ulteriori informazioni:Aggiungere fasi e passaggi

Definire gli argomenti del processo

Quando uno sviluppatore utilizza un messaggio, può iniziare con alcuni dati che possono essere passati al messaggio e utilizzati. Ad esempio, per creare un nuovo record del caso, puoi passare come argomento il valore del titolo del caso. Questo sarà un argomento di input.

Quando il messaggio è terminato, per lo sviluppatore può essere necessario passare alcuni dati modificati o generati dal messaggio a un'altra operazione nel codice. Questi devono essere definiti come argomento di output.

Sia gli argomenti di input che di output devono avere un nome, un tipo e alcune informazioni sull'obbligatorietà o meno dell'argomento. È inoltre possibile immettere una descrizione.

Il nome del messaggio e le informazioni su tutti gli argomenti del processo rappresentano la "firma" per il messaggio. Dopo che un'azione è attivata e viene utilizzata nel codice, la firma non deve cambiare. La modifica della firma provocherà l'esito negativo di qualsiasi codice che utilizzi il messaggio. L'unica eccezione a questa condizione può essere la modifica di uno dei parametri in modo che non sia sempre obbligatorio.

La modifica dell'ordine degli argomenti ordinandoli o spostandoli verso l'alto o verso il basso non è importante perché gli argomenti vengono identificati per nome e non in base all'ordine. La modifica della descrizione non interromperà il codice che utilizza il messaggio.

Tipi di argomento per i processi di azione

Nella tabella seguente vengono descritti i tipi di argomento per i processi di azione.

Tipo	Descrizione
Boolean	Valore true o false.
DateTime	Valore in cui vengono archiviate le informazioni di data e ora.
Decimal	Valore numerico con precisione decimale. Utilizzato quando la precisione è estremamente importante.
Entity	Record di Dynamics 365 per l'entità specificata. Quando si seleziona Entity, l'elenco a discesa è abilitato e consente di scegliere il tipo di entità.
EntityCollection	Raccolta di record dell'entità.
EntityReference	Oggetto che contiene il nome, l'ID e il tipo e di un record dell'entità che la identifica in modo univoco. Quando si seleziona EntityReference, l'elenco a discesa è abilitato e consente di scegliere il tipo di entità.
Float	Valore numerico con precisione decimale. Utilizzato se i dati provengono da una misurazione non completamente precisa.
Integer	Numero intero.
Money	Valore che memorizza i dati su un importo in denaro.
Picklist	Valore che rappresenta un'opzione per un attributo OptionSet.
String	Valore di testo.

Nota

I valori dell'argomento EntityCollection non possono essere impostati nell'interfaccia utente per condizioni o azioni. Sono disponibili per gli sviluppatori nel codice personalizzato.Ulteriori informazioni:Creare azioni personalizzate

Aggiungere fasi e passaggi

Le azioni sono un tipo di processo molto simile ai flussi di lavoro in tempo reale. Tutti i passaggi che possono essere utilizzati nei flussi di lavoro in tempo reale possono essere utilizzati nelle azioni. Per informazioni sui passaggi che possono essere utilizzati per i flussi di lavoro in tempo reale e per le azioni, vedere Fasi e passaggi dei flussi di lavoro.

Oltre ai passaggi che possono essere utilizzati per i flussi di lavoro in tempo reale, le azioni dispongono del passaggio Assegna valore simile a quello utilizzato per impostare le variabili o gli argomenti di input definiti nelle interazioni. Nelle azioni può essere utilizzato solo per definire gli argomenti di output. È possibile utilizzare informazioni e selezione rapida per impostare gli argomenti di output su valori specifici oppure, con maggiore probabilità, su valori del record in relazione al quale l'azione viene eseguita, di record correlati a tale record con relazioni molti-a-uno o di record creati in un passaggio precedente o su valori che fanno parte del processo stesso.

Vedere anche

Azioni
Richiamare un'azione personalizzata da un flusso di lavoro o un'interazione
Monitoraggio dei flussi di lavoro in tempo reale e delle azioni
Creare e modificare i processi
Processi di flusso di lavoro
Interazioni
Processi aziendali
Monitorare e gestire i processi
Creare azioni personalizzate

© 2016 Microsoft Corporation. Tutti i diritti sono riservati. Copyright