Voorbeeld: Gegevens synchroniseren met externe systemen via het bijhouden van wijzigingen

 

Gepubliceerd: november 2016

Is van toepassing op: Dynamics CRM 2015

Deze voorbeeldcode toont hoe u wijzigingen kunt ophalen uit een entiteit en gegevens kunt synchroniseren met externe systemen door gebruik te maken van het RetrieveEntityChangesRequest-bericht. Zie Tracering gebruiken om gegevens te synchroniseren met externe systemen voor meer informatie over de functie die in dit voorbeeld wordt gedemonstreerd.

Dit voorbeeld is voor Update 1 voor Microsoft Dynamics CRM Online 2015. Dit voorbeeld kan worden gedownload van Gegevens synchroniseren met externe systemen via het bijhouden van wijzigingen.

Vereisten

1. Toegang hebben tot een Update 1 voor Microsoft Dynamics CRM Online 2015-organisatie.

2. Het Visual Studio-project ChangeTrackingSample downloaden.

3. Open het Visual Studio-project ChangeTrackingSample en installeer Microsoft.CrmSdk.CoreAssemblies versie 7.1.0-preview NuGet-pakket. Zie NuGet-pakketten installeren voor instructies.

4. Nadat u de NuGet-pakket hebt geïnstalleerd, raadpleegt u Het voorbeeld uitvoeren voor instructies voor het uitvoeren van het voorbeeld en wat u kunt verwachten.

In dit onderwerp

Wat dit voorbeeld doet

NuGet-pakketten installeren

Het voorbeeld uitvoeren

Wat dit voorbeeld doet

1. De methode Run van de klasse ChangeTrackingSample roept de methode ImportChangeTrackingSolution aan die eerst detecteert of de beheerde oplossing ChangeTrackingSample al is geïnstalleerd. Als dit niet het geval is, wordt het bestand ChangeTrackingSample_1_0_0_0_managed.zip geïmporteerd om deze beheerde oplossing te installeren.

   Deze beheerde oplossing bevat een aangepast entiteit sample_book die wordt gebruikt door dit voorbeeld. Deze entiteit heeft een alternatieve sleutel sample_bookcode waarmee een unieke beperking wordt gecreëerd voor de waarde die zijn opgeslagen in dat kenmerk.

2. De methode WaitForEntityAndKeysToBeActive is noodzakelijk omdat de alternatieve sleutels die zijn vereist voor dit voorbeeld mogelijk niet onmiddellijk na de installatie van de oplossing ChangeTrackingSample beschikbaar zijn. Met deze methode worden de metagegevens voor de entiteit sample_book geraadpleegd om de uitvoering van de rest van het voorbeeld te vertragen totdat de alternatieve sleutels gereed zijn.

3. De methode CreateRequiredRecords genereert 10 records in de entiteit sample_book.

4. De eerste keer dat de RetrieveEntityChangesRequest wordt aangeroepen wordt een initiële synchronisatie uitgevoerd en worden alle records in de entiteit samen met het versienummer opgehaald en worden de opgehaalde records in de cache opgeslagen.

5. Nadat de initiële records in de cache zijn opgeslagen, vraagt het programma of u de records voor de entiteit sample_book wilt bekijken. Als u 'y' antwoordt, probeert het programma Internet Explorer te openen met een weergave van de nieuw gemaakte records.

6. De methode UpdateRecords voegt tien nieuwe records toe, werkt een bestaande record bij en verwijdert een record in de entiteit sample_book.

7. Nadat de records zijn bijgewerkt, wordt de pagineringsinformatie opnieuw ingesteld in het programma en worden de cacheobjecten geïnstantieerd.

8. Als RetrieveEntityChangesRequest opnieuw wordt aangeroepen, worden alleen de record opgehaald die zijn bijgewerkt sinds de laatste synchronisatie.

9. Nadat de wijzigingen zijn opgehaald, vraagt het programma of u de records voor de entiteit sample_book wilt bekijken. Als u 'y' antwoordt, probeert het programma Internet Explorer te openen met een weergave van de nieuw gemaakte records.

10. Tot slot wordt u gevraagd door DeleteChangeTrackingSampleSolution om de beheerde oplossing ChangeTrackingSample te verwijderen.

    Als u 'y' kiest, wordt de beheerde oplossing verwijderd, met inbegrip van de entiteit sample_book en alle gegevens in die entiteit. Er is niets meer toegevoegd aan uw organisatie.

    Als u 'n' kiest, kunt u de details van de oplossing inspecteren, met inbegrip van de gegevens die zijn gemaakt door het voorbeeld. Maar u moet de beheerde oplossing handmatig verwijderen om uw organisatie terug te zetten in de oorspronkelijk toestand.

NuGet-pakketten installeren

Voer de volgende stappen uit om de vereisten assembly's voor dit voorbeeld te installeren:

1. Download dit voorbeeld en extraheer de bestanden.

2. Navigeer naar de C#-map en open het bestand ChangeTrackingSample.sln in Visual Studio.

3. Klik in Visual Studio met de rechtermuisknop op het project ChangeTrackingSample en kies NuGet-pakketten beheren.

4. Kies voor de preview-versie de optie Inclusief proefversie in plaats van Alleen stabiel in de zoekcriteria. Zoek vervolgens naar "Microsoft Dynamics CRM 2015 SDK core assemblies". Zorg ervoor dat u de versie 7.1.0-preview selecteert.

5. Klik op Installeren. U moet de licentievoorwaarden accepteren om de installatie van dit pakket te kunnen voltooien.

Het voorbeeld uitvoeren

1. Druk in Visual Studio, terwijl de oplossing is geopend en de benodigde NuGet-pakketten zijn geïnstalleerd, op F5.

2. Als u niet eerder een van de beheerde codevoorbeelden van Microsoft Dynamics CRM hebt uitgevoerd, moet u informatie invoeren om de code te kunnen uitvoeren. Voer anders het nummer an een van de CRM-servers in die u eerder hebt opgezet.

   Vraag	Beschrijving
   Een CRM-servernaam en -poort invoeren [crm.dynamics.com]	Typ de naam van uw Microsoft Dynamics CRM-server. De standaardserver is Microsoft Dynamics CRM Online (crm.dynamics.com) in Noord-Amerika. Voorbeeld: crm5.dynamics.com
   Is deze organisatie ingericht in Microsoft online-services (j/n) [n]	Typ y als deze organisatie is ingericht in Microsoft online-services. Typ anders n.
   Domein\gebruikersnaam invoeren	Typ uw Microsoft-account.
   Wachtwoord invoeren	Typ uw wachtwoord. De tekens worden als "*" in het venster weergegeven. Uw wachtwoord wordt veilig opgeslagen in Referentiebeheer van Microsoft voor later hergebruik.
   Geef een organisatienummer op (1-n) [1]	Typ uit de lijst met organisaties waartoe u behoort, typt het bijbehorende nummer. De standaardinstelling is 1, waarmee de eerste organisatie in de lijst wordt aangegeven.

3. Het voorbeeld voert de bewerkingen uit die worden beschreven in Wat dit voorbeeld doet en vraagt u mogelijk om aanvullende opties.

4. Als het voorbeeld is voltooid, drukt u op ENTER om het consolevenster te sluiten.

Zie ook

Tracering gebruiken om gegevens te synchroniseren met externe systemen

© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht