Esempio: Inserire o aggiornare un record utilizzando Upsert

Data di pubblicazione: gennaio 2017

Si applica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

In questo esempio di codice viene illustrato come inserire o aggiornare i record utilizzando il messaggio Upsert. Per ulteriori informazioni sulla funzionalità illustrata in questo esempio, vedi Utilizzare Upsert per inserire o aggiornare un record.

È disponibile per il download in Inserire o aggiornare un record tramite Upsert.

Prerequisiti

1. Accedi a un'organizzazione di Microsoft Dynamics 365 o Aggiornamento di CRM Online 2016.

2. Scarica il progetto UpsertSample di Visual Studio.

3. Apri il progetto UpsertSample di Visual Studio e installa Microsoft.CrmSdk.CoreAssemblies la versione 8.0.0-preview o quella successiva NuGet Package. Per istruzioni, vedi Installare i pacchetti di NuGet.

4. Dopo aver installato i pacchetti NuGet, vedi Eseguire l'esempio per le istruzioni su come eseguire l'esempio e i risultati previsti.

In questo argomento

Esempio

Installare i pacchetti di NuGet

Eseguire l'esempio

Esempio

1. Il metodo Run della classe ProductUpsertSample chiama il metodo ImportUpsertSampleSolution che per prima cosa verifica se la soluzione gestita UpsertSample è già installata. Se non lo è, viene importato il file UpsertSample_1_0_0_0_managed.zip per installare la soluzione gestita.

   La soluzione gestita contiene un'entità sample_product personalizzata che viene utilizzata in questo esempio. L'entità ha una chiave alternativa sample_productcode che crea un vincolo univoco sui valori archiviati nell'attributo.

2. Il metodo WaitForEntityAndKeysToBeActive è necessario perché le chiavi alternative richieste per questo esempio potrebbero non essere pronte subito dopo l'installazione della soluzione UpsertSample. Questo metodo esegue il polling dei metadati per l'entità sample_product al fine di ritardare l'esecuzione del resto dell'esempio finché le chiavi alternative non siano pronte.

3. La prima volta che viene chiamato il metodo ProcessUpsert, i dati vengono elaborati nel file newsampleproduct.xml per rappresentare i nuovi prodotti.UpsertRequest viene passato al metodo Execute per creare 13 nuovi record.

   La proprietà UpsertResponse.RecordCreated restituisce true per indicare che i nuovi record sono stati creati.

   Prima che il metodo ProcessUpsert venga completato, il programma chiede se desideri visualizzare i record di entità di esempio del prodotto. Se rispondi "y" il programma tenterà di aprire Internet Explorer su una visualizzazione con i record appena creati.

4. La seconda volta che viene chiamato il metodo ProcessUpsert, i dati vengono elaborati nel file updatedsampleproduct.xml per rappresentare gli aggiornamenti ai prodotti precedentemente creati. Il messaggio Upsert è utilizzato per aggiornare 6 record. La proprietà UpsertResponse.RecordCreated restituisce false per indicare che i record sono stati aggiornati.

   Di nuovo, il metodo ProcessUpsert chiederà se desideri visualizzare i record nel browser. Se la visualizzazione è già aperta, puoi semplicemente aggiornare la visualizzazione per visualizzare le modifiche.

5. Infine, DeleteUpsertSampleSolution ti chiede di eliminare la soluzione gestita di esempio Upsert.

   Se scegli "y", la soluzione gestita verrà eliminata, compresa l'entità sample_product e tutti i dati dell'entità. Per l'organizzazione non verrà eseguita alcuna aggiunta.

   Se scegli "n", puoi controllare i dettagli della soluzione inclusi i dati creati nell'esempio. Tuttavia, devi eliminare manualmente la soluzione gestita per ripristinare lo stato originale dell'organizzazione.

Installare i pacchetti di NuGet

Utilizza i passaggi seguenti per l'installazione degli assembly richiesti per questo esempio:

1. Scarica questo esempio ed estrai i file.

2. Passa alla cartella C# e apri il file UpsertSample.sln in Visual Studio.

3. In Visual Studio, fare clic con il pulsante destro del mouse sul progetto UpsertSample e fare clic su Gestisci pacchetti NuGet.

4. Per la versione di anteprima, assicurati di fare clic su Includi versione provvisoria anziché Solo stabile nei criteri di ricerca. Quindi, cerca "Microsoft Dynamics CRM 2016 SDK core assemblies". Assicurati di selezionare la versione 8.0.0-preview o quellqa successiva.

5. Fare clic su Installa. Dovrai accettare le condizioni di licenza per completare l'installazione del pacchetto.

Eseguire l'esempio

1. In Visual Studio, con la soluzione aperta e i pacchetti NuGet necessari installati, premi F5.

2. Se in precedenza non hai mai eseguito un esempio di codice gestito di Microsoft Dynamics 365, devi immettere le informazioni necessarie per eseguire il codice, altrimenti immetti il numero di uno dei server Dynamics 365 configurati in precedenza.

   Chiedi conferma	Descrizione
   Immetti una porta e un nome per il server Dynamics 365 [crm.dynamics.com]	Digitare il nome del server Microsoft Dynamics 365. Il valore predefinito per questo campo è Microsoft Dynamics 365 (online) crm.dynamics.com in Nord America. Esempio: nomeserver myprefix.myservername:5500 crm5.dynamics.com Non includere il nome dell'organizzazione o l'indirizzo IP (HTTP oppure HTTPS). Verrà richiesto in un secondo momento.
   Il server verrà configurato per SSL (Secure Sockets Layer) (HTTPS)? (sì/no) [n]	Digita y se l'URL che utilizzi per accedere a Microsoft Dynamics 365 inizia con https://; in caso contrario, digita n.
   È stato eseguito il provisioning dell'organizzazione in Microsoft Office 365? (sì/no) [n]	Digitare y se si tratta un'organizzazione Microsoft Office 365 di cui è stato eseguito il provisioning. Altrimenti, digitare n.
   Immetti dominio\nomeutente	Digita il tuo account Microsoft. Per Microsoft Dynamics 365, immetti il dominio di rete e il nome utente, separati da una barra rovesciata (\).
   Immetti password	Digitare la password. I caratteri verranno visualizzati nella finestra come "*". La password viene salvata in modo sicuro in Gestione credenziali Microsoft per il riutilizzo futuro.
   Specifica un numero di organizzazione (1-n) [1]	Nell'elenco delle organizzazioni visualizzato di cui si è membri, digitare il numero corrispondente. L'impostazione predefinita è 1 e indica la prima organizzazione dell'elenco.

3. In questo esempio vengono eseguite le operazioni descritte in Esempio e potrebbero essere richieste opzioni aggiuntive.

4. Al termine dell'esempio, premi INVIO per chiudere la finestra della console.

Vedere anche

Utilizzare Upsert per inserire o aggiornare un record

Microsoft Dynamics 365

© 2017 Microsoft. Tutti i diritti sono riservati. Copyright