Esempio: Inserire o aggiornare un record utilizzando Upsert

 

Data di pubblicazione: novembre 2016

Si applica a: Dynamics CRM 2015

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.

Questo esempio è per Aggiornamento 1 di Microsoft Dynamics CRM Online 2015. È disponibile per il download in Inserire o aggiornare un record tramite Upsert.

Prerequisiti

1. Accedi a un'organizzazione Aggiornamento 1 di Microsoft Dynamics CRM Online 2015.

2. Scarica il progetto UpsertSample di Visual Studio.

3. Apri il progetto UpsertSample di Visual Studio e installa il pacchetto NuGet Microsoft.CrmSdk.CoreAssemblies versione 7.1.0-preview. 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, fai clic con il pulsante destro del mouse sul progetto UpsertSample e scegli Gestisci pacchetti NuGet.

4. Per la versione di anteprima, assicurati di scegliere Includi versione di valutazione anziché Solo stabile nei criteri di ricerca. Quindi, cerca "Microsoft Dynamics CRM 2015 SDK core assemblies". Assicurati di selezionare la versione 7.1.0-preview.

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 CRM, devi immettere le informazioni necessarie per eseguire il codice, altrimenti immetti il numero di uno dei server CRM configurati in precedenza.

   Richiesta	Descrizione
   Immetti una porta e un nome per il server CRM [crm.dynamics.com]	Digita il nome del server Microsoft Dynamics CRM. L'impostazione predefinita è Microsoft Dynamics CRM Online (crm.dynamics.com) in Nord America. Esempio: crm5.dynamics.com
   È stato eseguito il provisioning dell'organizzazione in Microsoft Online Services? (sì/no) [n]	Digita s se si tratta di un'organizzazione sottoposta a provisioning in Microsoft Online Services. Altrimenti, digitare n.
   Immetti dominio\nomeutente	Digita il tuo account Microsoft.
   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

© 2017 Microsoft. Tutti i diritti sono riservati. Copyright