DP Archiver – Installationsguide

DP Archiver forbinder Microsoft Dynamics 365 Business Central med SharePoint, så dokumenter er tilgængelige i et SharePoint-dokumentbibliotek inde fra Business Central. Formålet med integrationen er at oprette og vedligeholde en dokumentstruktur i SharePoint, der svarer til stamdata hierarkiet i Dynamics Property. Denne artikel gennemgår hele opsætningen: oprettelse af SharePoint-site og metadatakolonne, installation af udvidelsen i Business Central, app-registrering i Microsoft Entra ID (Azure) samt indsamling af de ID'er og URL'er, som opsætningen kræver.

Anvendes forretningsstyring, er stamdata arrangeret i en kontekst, dvs. et SharePoint Site. Anvender du ikke forretningsstyring i Business Central og er stamdata derfor arrangeret per regnskab i Business Central, får du brug for et SharePoint Site pr. regnskab. Rettigheder administreres i Business Central på regnskabs niveau og i SharePoint på Site niveau, hvilket har været bestemmende for fastlæggelsen af strukturen med et Site pr. regnskab.

Det skal du bruge (indsamles undervejs)

Undervejs i vejledningen indsamler du følgende værdier. Alle viste ID'er og nøgler er fiktive eksempelværdier og skal erstattes med kundens egne værdier.

Trin 1: Opret et SharePoint-site

1. Log på din Microsoft 365-konto, åbn "Alle apps" og vælg SharePoint.

   

2. Vælg "Opret websted" og vælg typen Gruppewebsted (Teamwebsted).

   

3. Vælg skabelonen Standardteam, og klik på "Brug skabelon".

   

   

4. Giv webstedet et navn – i eksemplet DEMOEXE. Notér navnet; det skal bruges i opsætningen i Business Central.

   

5. Under "Angiv sprog og andre indstillinger" skal sproget sættes til engelsk. Sproget kan ikke ændres efterfølgende. Engelsk sikrer, at standardbiblioteket får stien "Shared Documents", som DP Archiver forventer. 

   

6. Tilføj medlemmer, og afslut guiden.

   

7. Sitet oprettes. Kontrollér, at dokumentbiblioteket hedder "Shared Documents".

   

Opret rodbiblioteket

Opret i dokumentbiblioteket en mappe, der udgør roden af arkivet – i eksemplet Ejendomsarkiv. Notér navnet.

Trin 2: Opret kolonnen "DP Beskrivelse"

Vigtigt: Kolonnen skal oprettes fra bibliotekets indstillinger (Library settings) – ikke via "Tilføj kolonne" i listevisningen. Det interne metadatanavn afhænger nemlig af, hvor kolonnen oprettes: Fra listevisningen bliver det interne navn DPBeskrivelse, men DP Archiver kræver DP_x0020_Beskrivelse – mellemrummet kodes som _x0020_.

Opret derfor IKKE kolonnen fra denne visning:

1. Stå i roden af sitet, fx https://dpdemo.sharepoint.com/sites/DEMOEXE.

   

2. Åbn dokumentbiblioteket, og gå til Indstillinger (tandhjulet) → Biblioteksindstillinger.

   

   

   

3. Under "Kolonner" vælges "Opret kolonne".

   

4. Navngiv kolonnen "DP Beskrivelse" (én tekstlinje), og gem.

   

5. Verificér, at metadata er oprettet korrekt: Klik på kolonnen "DP Beskrivelse", og kontrollér, at det interne navn i URL'en er DP_x0020_Beskrivelse. For brugeren vises kolonnen fortsat som "DP Beskrivelse".

   

   

   

Trin 3: Installér udvidelsen i Business Central

1. Søg efter "Udvidelsesstyring" i Business Central, og vælg at uploade/installere udvidelsen.

   

2. Følg installationsguiden.

   

   

3. Verificér i installationsstatus, at processen blev afsluttet korrekt.

   

   

Notér lejer-id (Tenant ID): Det kan fx aflæses i Business Centrals URL, https://businesscentral.dynamics.com/{tenant-id}/… – i eksemplet 7f3a9c2e-4b81-4d6a-9e57-c2d84f1b6a03.

Trin 4: Registrér appen i Microsoft Entra ID (Azure)

1. Log på Azure-portalen (https://portal.azure.com), og gå til Microsoft Entra ID.

   

   

2. Vælg "App registrations" → "New registration".

   

   

3. Angiv et navn (i eksemplet DEMOEXE), og vælg kontotypen "Accounts in this organizational directory only".

4. Angiv en Redirect URI af typen Web. I eksemplet er der anvendt URL'en til opsætningssiden i Business Central (side 50580): https://businesscentral.dynamics.com/{tenant-id}/{miljø}?company={firma}&page=50580

   

5. Efter registreringen: Notér Application (client) ID og Directory (tenant) ID fra appens oversigtsside (Essentials). I eksemplet er klient-id d94b7e12-83f5-4a2c-b6d1-5f0a92c47e88.

   

   

Trin 5: Tildel API-rettigheder til Microsoft Graph

1. Gå til "API permissions" → "Add a permission" → Microsoft Graph.

   

   

   

2. Vælg Application permissions, og tilføj rettigheden Sites.ReadWrite.All.

   

3. Klik på "Grant admin consent for …", og bekræft med Yes. Kontrollér, at status for rettigheden bliver "Granted".

   

Trin 6: Opret en klienthemmelighed (Client Secret)

1. Gå til "Certificates & secrets" → "New client secret". Angiv en beskrivelse og en udløbsperiode.

   

   

2. Kopiér hemmelighedens Value med det samme – værdien vises kun ved oprettelsen og kan ikke hentes frem igen. Opbevar den sikkert, og indsæt den senere i opsætningen i Business Central.

Trin 7: Find URL'er og ID'er

Token-URL (Auth-URL)

Åbn appens oversigtsside i Entra ID, og klik på "Endpoints".

Bemærk: Det er OAuth 2.0 token endpoint (v2), der skal anvendes:

https://login.microsoftonline.com/7f3a9c2e-4b81-4d6a-9e57-c2d84f1b6a03/oauth2/v2.0/token

SharePoint Site ID

Du skal være administrator og være logget på SharePoint-sitet. Åbn i browseren:

https://dpdemo.sharepoint.com/sites/DEMOEXE/_api/site/id

Sitets id (GUID) fremgår af XML-svaret – fx a25c8e91-7d43-4f6b-b0e8-3d59c1a74f26.

SharePoint Drive ID

Du skal være administrator og være logget på SharePoint-sitet. Åbn i browseren:

https://dpdemo.sharepoint.com/sites/DEMOEXE/_api/v2.1/drives

Notér id'et for dokumentbiblioteket – fx:

b!kQx3fY9rTUOwLp2ZcVd8mAnE5R7sBhJNqK4tXi6-uD1PzoGWyM0eScFvH_a8bTjw

Alternativt kan Drive ID findes via Graph Explorer med kaldet:

GET https://graph.microsoft.com/v1.0/sites/{siteId}/drives

Trin 8: Opsætning i Business Central

Åbn DP Archiver-opsætningen i Business Central (siden 50580), og indtast de indsamlede værdier:

• SharePoint-sitenavn og rodbibliotek (Trin 1)
• Lejer-id / Tenant ID (Trin 3)
• Klient-id / Client ID (Trin 4)
• Klienthemmelighed / Client Secret (Trin 6)
• Token-URL, Site ID og Drive ID (Trin 7)

Test forbindelsen efter opsætningen ved at arkivere et testdokument og kontrollere, at det lander i rodbiblioteket i SharePoint med feltet "DP Beskrivelse" udfyldt.