Outlook Addin API
De Outlook Addin API biedt de mogelijkheid om een Outlook Addin te gebruiken die kan communiceren met Business Central.
De API kan verschillende data beschikbaar stellen aan de Addin. Hiertoe moet de interface CFL Outlook Addin API geimplementeerd worden.
De Interface bevat volgende methodes:
procedure CFLGetLevel1Records(var CCSAPILevel1: record "CFL Outlook Addin API Level 1");
procedure CFLGetLevel1Caption(): text
procedure CFLGetLevel2ARecords(Level1Filter: text; var CCSAPILevel2: record "CFL Outlook Addin API Level 2A");
procedure CFLGetLevel2ACaption(): text
procedure CFLGetLevel2BRecords(Level1Filter: text; var CCSAPILevel2: record "CFL Outlook Addin API Level 2B");
procedure CFLGetLevel2BCaption(): text
procedure CFLProcessPost(Level1Code: code[20]; Level2Code: Code[20]; Content: text) Response: text;
De standaard implementatie van de interface is voorzien in de codeunit CFLContact/Interaction-Contact en voorziet de mogelijkheid om contacten en interacties op te halen en te posten.
Level1Records zijn alle contacten.
Level2ARecords zijn alle interacties van een contact.
Level2BRecords zijn alle contacten gekoppeld aan het contact van level1.
Dit maakt het mogelijk om in de Addin een contact te selecteren en de interacties en gekoppelde contacten op te halen.
Via de CFLProcessPost methode kan de email naar Business Central worden gebracht. De email wordt dan in de drag&drop folder opgeslagen van de interactie of er kan ook een nieuwe interactie aangemaakt worden.
De Content parameter bevat de email in base64 formaat.
TIP
In tabasco wordt de Outlook Addin gebruikt om emails aan tickets te koppelen.
Daarvoor is een nieuwe implementatie gemaakt van de interface: Customer/Ticket-Contact.
Deze implementatie voorziet de mogelijkheid om klanten en hun tickets en contacten op te halen en te posten.
De email wordt dan in de drag&drop folder opgeslagen van het ticket of er kan ook een nieuwe ticket aangemaakt worden.
Er kunnen meerdere implementaties van de interface voorzien worden.
In de Addin kan dan een keuze gemaakt worden welke implementatie gebruikt moet worden door te filteren op het veld apiConfig met de gewenste implementatie.
Indien de filter niet is voorzien, worden alle implementaties opgehaald.
Outlook Addin
Installatie Outlook AddIn
In tenant van de klant navigeren naar https://admin.microsoft.com/#/Settings/IntegratedApps
(als Global Admin, Exchange Admins of Azure Application Admin)
Upload Custom App
Kies Office Add-in en Provide Link outlookaddin.bocount.net/manifest.xml
Kies Entire organization of voor welke gebruikers je dit wil beschikbaar maken
Na deze stap kan het wel enige tijd duren (tot enkele uren) alvorens de AddIn beschikbaar wordt bij de gebruikers in Outlook...
App-registratie
De Outlook Addin vereist enkele delegated rechten om de mails en Business Central te benaderen.
We gebruiken hiertoe een multitenant app. Je moet deze niet aanmaken in de tenant van de klant, deze moet wel admin consent worden in de tenant van de klant.
Een gebruiker die de addin gebruikt zal de eerste keer deze consent-vraag krijgen. Alternatief kan je dit reeds (laten) doen/voorbereiden via https://login.microsoftonline.com/<entra_id_klant>/adminconsent?client_id=4f215773-733d-4567-86ee-56679ddc1373
