Delen via

Gebruik het XRM-aanmeldingsbesturingselement in uw clienttoepassingen

  • Artikel

 

Gepubliceerd: januari 2017

Is van toepassing op: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

De Microsoft Dynamics 365 SDK biedt u een sjabloon voor Microsoft Visual Studio dat u toestaat om het gemeenschappelijke aanmeldingsbesturingselement in uw clienttoepassingen te gebruiken. De code voor Dynamics 365 verificatie, opslag van aanmeldingsgegevens en ophalen en diagnostische gegevens is ingebouwe in het sjabloon zodat u deze mogelijkheden snel kunt gebruiken in uw Windows-clienttoepassingen voor Dynamics 365. Het algemene aanmeldingsbesturingselement is een implementatie van de Microsoft.Xrm.Tooling.CrmConnectControl, en het besturingselement wordt op de volgende afbeelding weergegeven.

XRM Tooling: besturingselement voor algemene aanmelding

In dit onderwerp

Vereisten

Maak een WPF-toepassing met het sjabloon voor het algemene aanmeldingbesturingselement

Voeg het sjabloon voor het algemene aanmeldingbesturingselement toe aan uw huidige WPF-toepassing

Vereisten

  • .NET Framework 4.5.2

  • Microsoft Visual Studio 2012, Visual Studio 2013 of Visual Studio 2015

  • Nuget-pakketbeheer voor Visual Studio 2012, Visual Studio 2013 of Visual Studio 2015

  • Verbonden met internet, zodat u de vereiste Nuget-pakketten kunt downloaden/herstellen terwijl u de projectsjabloon gebruikt.

  • Microsoft Dynamics 365 SDK sjablonen voor Visual Studio dat het sjabloon voor het algemene aanmeldingsbesturingselement bevat. U kunt het via een van de volgende opties krijgen:

    • Download de CRM SDK-sjabloon vanaf de Visual Studio-galerie en dubbelklik op het bestand CRMSDKTemplates.vsix om de sjabloon te installeren in Visual Studio.

    • Download en pak het Dynamics 365 SDK-pakket uit. Het sjabloonsbestand, CRMSDKTemplates.vsix, staat in de map SDK\Templates. Dubbelklik op het CRMSDKTemplates.vsix bestand om het sjabloon te installeren in Visual Studio.

Maak een WPF-toepassing met het sjabloon voor het algemene aanmeldingbesturingselement

Hier is een snelle manier om een Windows Presentation Foundation (WPF)-toepassing te maken die gebruikmaakt van het gemeenschappelijke aanmeldingsbesturingselement en de onderliggende code voor verificatie, referentieopslag en hergebruik, en standaardtracering of -vastlegging.

  1. Start Microsoft Visual Studio, en maak een nieuw project.

  2. In het dialoogvenster Nieuw project:

    1. Vouw in de lijst met geïnstalleerde sjablonen Visual C# uit en selecteer Dynamics 365 SDK-sjablonen.

    2. Controleer of .NET Framework 4.5.2 is geselecteerd.

    3. Selecteer WPF-toepassing voor Dynamics 365.

    4. Geef de locatie en de naam van het bestand op, en klik op OK.

    WPF-toepassing voor CRM-sjabloon

  3. Het project testen:

    1. Sla het project op en druk op F5 of klik op Foutopsporing > Start foutopsporing om te controleren of het project correct compileert. Na een succesvolle compilatie ziet u een MainWindow met de knop Aanmelden bij Dynamics 365. Klik op de knop om het algemene aanmeldingsbesturingselement weer te geven.

    2. Test de verificatie door uw aanmeldgegevens op te geven om verbinding te maken met Dynamics 365, en klik vervolgens op Aanmelden. Er wordt een bericht weergegeven in uw Dynamics 365 verbindingstatus.

Voor een voorbeeld dat gebruikmaakt van het sjabloon van het algemene aanmeldingsbesturingselement om verbinding te maken met Dynamics 365 en om verschillende bewerkingen uit te voeren, raadpleegt u Voorbeeld: Snel aan de slag voor de XRM Tooling API.

Voeg het sjabloon voor het algemene aanmeldingbesturingselement toe aan uw huidige WPF-toepassing

Als u al een WPF-clienttoepassing hebt, kunt u de sjabloon van het algemene aanmeldingsnaambesturingselement eenvoudig eraan toevoegen om gebruik te maken van een uniforme aanmeldervaring en de onderliggende code voor Dynamics 365 verificatie, opslag van aanmeldgegevens en standaardtracering of vastleggen. In dit geval, moet u een besturingselement in de gebruikersinterface van uw bestaande clienttoepassing maken om het algemene aanmeldingsbesturingselement aan te roepen, een exemplaar van het Dynamics 365 verbindingsobject te instaniëren, en vervolgens het verbindingsobject gebruiken om verschillende bewerkingen uit te voeren in Dynamics 365.

  1. Open een bestaand WPF-toepassingproject in Visual Studio. In dit voorbeeld wordt ervan uitgegaan dat de naam van uw WPF-toepassingproject SampleWPFApp is.

  2. Voeg het sjabloon voor het algemene aanmeldingbesturingselement toe aan uw project.

    1. In het venster Oplossingenverkenner rechtsklikt u op de projectnaam en vervolgens op Toevoegen > Nieuw artikel.

    2. In het dialoogvenster Nieuw artikel toevoegen vouwt u in de lijst met geïnstalleerde sjablonen Visual C# uit en selecteert u Dynamics 365 SDK-sjablonen. Klik op Dynamics 365-aanmeldingsformulier voor WPF-toepassingen en klik op OK.

      De sjabloon voor het besturingselement van algemene aanmelding toevoegen

  3. Het nieuw toegevoegde CrmLoginForm1.xaml-aanmeldingsbesturingselement wordt weergegeven in het XAML-designergebied. Als het niet wordt weergegeven, dubbelklikt u op het bestand CrmLoginForm1.xaml in het deelvenster Oplossingenverkenner.

    Controleren of het aanmeldingsbesturingselement correct wordt weergegeven

  4. U moet het zojuist toegevoegde aanmeldingsbesturingselement nu aanroepen vanuit uw toepassing. Om dit te doen, voegt u een besturingselement Knop toe aan uw MainWindow.xaml bestand. Stel de naam en inhoud in op respectievelijk btnSignIn en Aanmelden bij Dynamics 365.

    Een besturingselement toevoegen om het aanmeldformulier aan te roepen

  5. Dubbelklik op de knop voor het toevoegen van de code van de klikgebeurtenis voor de knop btnSignIn in het MainWindow.xaml.cs bestand.

  6. Voeg de volgende voorbeeldcode toe aan de klikgebeurtenis van de knop btnSignIn om het besturingselement CrmLoginForm1 aan te roepen, en maak een exemplaar van het Dynamics 365 verbindingsobject.

    // Establish the Login control.
CRMLoginForm1 ctrl = new CRMLoginForm1();

// Wire event to login response. 
ctrl.ConnectionToCrmCompleted += ctrl_ConnectionToCrmCompleted;

// Show the login control. 
ctrl.ShowDialog();

// Handle the returned CRM connection object.
// On successful connection, display the CRM version and connected org name 
if (ctrl.CrmConnectionMgr != null && ctrl.CrmConnectionMgr.CrmSvc != null && ctrl.CrmConnectionMgr.CrmSvc.IsReady)
{
    MessageBox.Show("Connected to CRM! Version: " + ctrl.CrmConnectionMgr.CrmSvc.ConnectedOrgVersion.ToString() + 
    " Org: " + ctrl.CrmConnectionMgr.CrmSvc.ConnectedOrgUniqueName, "Connection Status");

    // Perform your actions here
}
else
{
    MessageBox.Show("Cannot connect; try again!", "Connection Status");
}

  7. Voeg de definitie van de ctrl_ConnectionToCrmCompleted gebeurtenis toe onder de klikgebeurtenis van de knop:

    private void ctrl_ConnectionToCrmCompleted(object sender, EventArgs e)
{
    if (sender is CRMLoginForm1)
    {
        this.Dispatcher.Invoke(() =>
        {
            ((CRMLoginForm1)sender).Close();
        });
    }
}

  8. Zo wordt het MainWindow.xaml.cs bestand weergegeven na het toevoegen van code van de vorige twee stappen:

    Voorbeeldcode

  9. Het project testen:

    1. Sla het project op en druk op F5 of klik op Foutopsporing > Start foutopsporing om te controleren of het project correct compileert. Na succesvolle compilatie ziet u een MainWindow met de nieuwe knop Aanmelden bij Dynamics 365. Klik erop om het algemene aanmeldingsbesturingselement weer te geven.

    2. Test de verificatie door uw aanmeldgegevens op te geven om verbinding te maken met Dynamics 365, en klik vervolgens op Aanmelden. Indien geslaagd, wordt een bericht weergegeven waarin de versie en de naam van de organisatie waarmee u bent verbonden worden weergegeven. Klik op OK om het bericht te sluiten.

      Projecttestresultaten

    3. Als u opnieuw op Aanmelden bij Dynamics 365 klikt, wordt u gevraagd om te kiezen voor de laatstgebruikte aanmeldgegevens of nieuwe aanmeldgegevens in te voeren.

      Opgeslagen referenties

Zie ook

Voorbeeld: Snel aan de slag voor de XRM Tooling API
Windows clienttoepassingen maken met de XRM-hulpprogramma's

Microsoft Dynamics 365

© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht