Creazione, aggiornamento, eliminazione e correlazione di azioni
È possibile utilizzare le azioni del connettore Dataverse per creare nuove righe, modificare quelle esistenti e creare correlazioni tra i dati utilizzando le relazioni definite. Se necessario, si può utilizzare l'azione di eliminazione per rimuovere le righe. Le azioni Dataverse permettono inoltre di mirare uno specifico ambiente con ulteriori azioni dall'ambiente selezionato.
Creazione di nuove righe
È possibile usare l'azione Aggiungi una nuova riga per aggiungere nuove righe in una tabella Dataverse. Occorre scegliere il nome di una tabella, quindi l'azione mostra dinamicamente le principali colonne per quella tabella. Le colonne obbligatorie sono riconoscibili da un asterisco rosso accanto al nome della colonna. Non è possibile salvare il flusso senza fornire input a tutte le colonne obbligatorie. Una colonna obbligatoria è una qualsiasi colonna della tabella impostata come Obbligatorio per l'azienda. Se si contrassegnano altre colonne come Obbligatorio per l'azienda nella tabella dopo aver creato il flusso, sarà necessario aggiornare l'azione del flusso la volta successiva che si aggiorna la colonna.
Solo alcune colonne vengono visualizzate automaticamente nella scheda Parametri dell'azione. Le rimanenti colonne sono nei Parametri avanzati.
Aggiornamento delle righe
È possibile usare l'azione Aggiorna una riga per aggiornare una riga di dati esistente. Si può inoltre utilizzare l'azione per aggiornare o inserire (upsert) quando l'ID non corrisponde a una riga esistente; l'azione può invece creare una nuova riga.
L'ID riga è obbligatorio nell'azione Aggiorna una riga e occorre solo aggiornare il GUID per la riga di dati. Se si ottiene l'ID riga da un altro trigger o un'altra azione del connettore Dataverse, l'ID riga dovrebbe avere lo stesso nome della tabella e la descrizione della colonna dovrebbe essere Identificatore univoco per la tabella. Non utilizzare la colonna OData ID, che è diversa.
A differenza dell'azione Aggiungi una nuova riga che richiede colonne, l'azione Aggiorna una riga non ne richiede. Tuttavia, è consigliabile modificare i valori delle colonne solo quando cambiano i dati. Ad esempio, il passaggio della colonna Nome account quando non è modificata comporterebbe la ricerca di modifiche da parte di altre automazioni nella tabella degli account da eseguire.
Per cancellare un valore di colonna esistente, modificare la colonna nell'azione in modo da utilizzare un'espressione null.
Correlazione dei dati
È possibile utilizzare Dataverse per creare relazioni uno-a-molti (o molti-a-uno, se si considera la relazione dall'altra direzione) e molti-a-molti tra righe di tabella. Sono disponibili due opzioni per correlare le righe di dati tra loro, a seconda del tipo di relazione e della riga nella relazione con cui si sta lavorando.
Quando si utilizzano le azioni Aggiungi una nuova riga o Aggiorna una riga, è possibile aggiornare le colonne di ricerca sulla riga di dati che si sta aggiungendo o aggiornando. Ad esempio, la tabella Account dispone di una colonna di ricerca del contatto primario che rappresenta una relazione molti-a-uno con Contatto. Quando si aggiunge o si aggiorna un account, si può stabilire la relazione con il contatto anche nella stessa azione. Non è possibile stabilire questa relazione se si sta aggiungendo o aggiornando la riga Contatto perché non ha la colonna di ricerca. L'altra opzione consiste nell'utilizzare l'azione Crea correlazione righe per stabilire la relazione separatamente.
È possibile stabilire solo relazioni molti-a-molti con l'azione Crea correlazione righe. Il motivo è che nessuna delle righe nella relazione dispone di una colonna di ricerca su cui è possibile impostare il valore nell'azione Aggiungi una nuova riga o Aggiorna una riga.
Specifica dell'ID per ogni riga
Quando si crea una correlazione tra righe di dati, occorre specificare l'identificatore univoco globale (GUID) della riga o un URL della riga. È importante conoscere la differenza perché, se si specifica il GUID o l'URL errato, si genera un errore.
È possibile ottenere il GUID (ad esempio, fd140aaf-4df4-11dd-bd17-0019b9312238) per una riga dall'output di un passaggio precedente del flusso. A tal fine, selezionare il GUID dal contenuto dinamico cercando la colonna con lo stesso nome della tabella e una descrizione che indichi Identificatore univoco per tablename.
Per ottenere l'URL della riga, cercare nell'elenco dei contenuti dinamici OData ID con una descrizione dell'ID della riga OData. È possibile comporre manualmente un URL di riga combinando il nome del set di entità OData della tabella con il GUID. Il nome del set di entità è in genere il nome logico della tabella con l'aggiunta della lettera "s". Pertanto, se il nome logico della tabella Account è account, il nome del set di entità sarà accounts. Un modo rapido per trovare il nome di una tabella consiste nell'aggiungere un'azione Dataverse, impostare la tabella sul nome della tabella di cui si vuole conoscere il nome del set di entità, quindi passare alla vista del codice. Nella vista del codice, il valore EntityName è il nome del set di entità necessario per creare un URL di riga OData. L'URL di riga OData dovrebbe avere l'aspetto dell'esempio seguente:
contoso_projects(fd140aaf-4df4-11dd-bd17-0019b9312238)
Utilizzo dell'azione Aggiungi o aggiorna una riga
Quando si utilizza l'azione Aggiungi o aggiorna una riga, si deve specificare l'URL di riga per la riga verso cui si intende creare la relazione.
Lo screenshot seguente mostra come impostare il contatto primario su una riga di account utilizzando OData ID.
Lo screenshot seguente mostra come impostare il contatto primario su una riga di account utilizzando l'ID di riga.
Utilizzo dell'azione Crea correlazione righe per stabilire una relazione uno-a-molti
Quando si utilizza l'azione Crea correlazione righe per stabilire una relazione tra due righe, è necessario determinare quale tabella selezionare per l'azione. In una relazione uno-a-molti, si dovrebbe utilizzare la tabella su un lato della relazione. Si consideri, ad esempio, una situazione in cui le righe Account hanno un contatto primario. La riga Account può essere correlata a una sola riga Contatto per questa relazione, il che pone la riga Contatto a un lato della relazione.
Successivamente, si specifica l'ID riga per la tabella impostata. Questo valore è un ID riga, non un URL, quindi occorre specificare solo il GUID (ad esempio fd140aaf-4df4-11dd-bd17-0019b9312238).
Le tabelle possono avere più relazioni, quindi si dovrebbe scegliere quale relazione stabilire successivamente. Se non si ricorda il nome, è possibile trovare il nome della relazione consultando le proprietà della tabella per la relazione.
L'ultimo passaggio consiste nell'impostare la proprietà Crea correlazione con. Questa proprietà è un URL di riga, quindi è possibile utilizzare la colonna OData ID di un passaggio precedente o specificare manualmente l'URL completo, ad esempio contoso_projects(fd140aaf-4df4-11dd-bd17-0019b9312238).
Utilizzo dell'azione Crea correlazione righe per stabilire una relazione molti-a-molti
Quando si utilizza una relazione molti-a-molti, è possibile determinare quale tabella specificare nell'azione consultando le proprietà della tabella per la relazione. La tabella che si trova nella colonna Correla nell'elenco delle relazioni è il nome della tabella da scegliere quando si stabilisce una relazione molti-a-molti tra due righe.
Per l'opzione Crea correlazione con, utilizzare l'URL di riga per la riga dell'altra tabella.
