Graph API-ondersteuning instellen voor Dynamics 365 Mail-app

In dit artikel leest u hoe u Graph API-ondersteuning voor de Dynamics 365 Mail-app configureert door een oplossing voor aangepaste instellingen te maken. U maakt een nieuwe oplossing, voegt een entiteit Instellingen toe en configureert de benodigde velden om uw Graph API-referenties op te slaan. Met deze instelling kan de Mail-app worden geverifieerd en gecommuniceerd met Microsoft Graph-services.

Vereiste voorwaarden

Zorg ervoor dat u het volgende hebt voordat u begint:

  • Beheerderstoegang tot uw Dynamics 365-omgeving
  • Een Azure AD-app-registratie met de app-id
  • Uw Azure-tenant-id
  • De juiste beveiligingsmachtigingen voor het maken van oplossingen en entiteiten.

Maak een registratie voor een app van derden in de Azure-tenant

  1. Meld u aan bij Azure Portal.

  2. Ga naar App-registraties en selecteer + Nieuwe registratie om nieuwe app-registratie te maken.

  3. Vul de vereiste velden in, zoals:

    • App-naam
    • Ondersteunde accounts - Alleen accounts in deze organisatiedirectory (alleen Mystery Incorporated - één tenant)
    • Omleidings-URL - Vervangen crm_org_domain: SPA - https://<crm_org_domain>/crmmailapp/msalAuth.html

    App-registratie

  4. Nadat u de app-registratie hebt gemaakt, gaat u naar de sectie API-machtigingen en voegt u de bijbehorende machtigingen voor Graph toe. U moet beheerderstoestemming verlenen voor deze machtigingen.

    API-machtigingen

  5. Noteer AppId en TenantId voor de volgende stap.

Oplossing voor D365 Mail-app-instellingen importeren

Volg deze stappen om handmatig een instellingen-entiteit te maken:

Maak de Dynamics 365 Mail App-instellingen oplossing

Maak een nieuwe oplossing in uw Dynamics 365-omgeving om de configuratie-instellingen voor de Mail-app te huiseren.

  1. Ga naar uw Dynamics 365-omgeving.
  2. Maak een nieuwe oplossing met de volgende details:
    • Display name: Dynamics 365 Mail App-instellingen
    • Naam: D365MailAppsettings
    • Voeg een nieuwe uitgever toe waarmee de klant entiteiten kan maken met het voorvoegsel mailapp.
    • Versie: 1.0.0.0

De entiteit Instellingen toevoegen

Voeg een aangepaste entiteit toe om de mail-app-configuratiewaarden op te slaan.

  1. Voeg in de oplossing D365MailAppsettings een nieuwe entiteit toe.
  2. Stel de naam van de entiteit in op mailapp_setting, weergavenaam op MailApp-instellingen en meervoudsnaam op Instellingen.
  3. Publiceer uw wijzigingen in Dynamics 365.

Entiteitsvelden configureren

Voeg nieuwe velden toe in de entiteit mailapp_setting.

  • mailapp_name: slaat de naam van elke configuratie-instelling op.
  • mailapp_settingvalue: slaat de bijbehorende waarde voor elke instelling op.

De Graph API-app-id toevoegen aan de instellingen van de Dynamics 365 Mail-app

  1. Als u toegang wilt krijgen tot de entiteit met de instelling, gaat u naar https://<org_domain>/main.aspx?pagetype=entitylist&etn=mailapp_setting.
  2. Maak een nieuwe record in de entiteit mailapp_setting met de volgende waarden:
    • Naam: graph_appid
    • Instellingswaarde: Voer de app-id in vanuit uw Azure AD-app-registratie.

De AAD-tenant-id toevoegen aan de Dynamics 365 Mail-app-instellingen

  1. Als u toegang wilt krijgen tot de entiteit met de instelling, gaat u naar https://<org_domain>/main.aspx?pagetype=entitylist&etn=mailapp_setting.
  2. Maak een nieuwe record in de entiteit mailapp_setting met de volgende waarden:
    • Naam: azure_tenantid
    • Instellingswaarde: Voer de Azure-tenant-id in

Leesmachtiging toevoegen voor instellingen voor alle gebruikers

Verken leesmachtigingen voor de entiteit Instellingen, zodat gebruikers toegang hebben tot de configuratie van de Mail-app.

  1. Ga naar Instellingen>Beveiliging>Beveiligingsrollen.
  2. Zoek naar de beveiligingsrol Dynamics 365 App for Outlook-gebruiker.
  3. Schakel over naar de weergave van instellingen voor aangepaste entiteiten en zoek naar de entiteit MailApp Settings.
  4. Stel leesmachtiging in op organisatieniveau.
  5. Wijzigingen opslaan.

Volgende stappen

Nadat u deze installatie hebt voltooid, kan de Dynamics 365 Mail-app worden geverifieerd met behulp van Graph API en toegang krijgen tot Microsoft Graph-services namens uw gebruikers.

  • Laatst bijgewerkt om