For at etablere en sikker og løbende forbindelse mellem Kala og Microsoft Business Central skal der foretages nogle handlinger, både fra Kalas side samt inde i Business Central miljøet.
Kala’s udviklingsteam sætter integrationen op, således at Kala’s servere hos Microsoft (Azure)
automatisk løbende udveksler data med Business Central (BC).
Fra BC siden kræver det blot at en række webtjenester publiceres samt at der oprettes en Entra applikation, som Kala kan bruge til på en sikker måde at udføre handlinger i BC via OAuth.
Publicering af webtjenester
Det er følgende webtjenester, der alle tilføjes som en side:
| Objekt type | Objekt-id | Objektnavn (autoudfyldes) | Servicenavn (skal være identisk) |
|---|---|---|---|
| Side | 88 | Projektkort | JobCard |
| Side | 1002 | Projektopgavelinjer | JobTaskLines |
| Side | 21 | Debitorkort | CustomerCard |
| Side | 5200 | Medarbejderkort | EmployeeCard |
| Side | 31 | Varer | Items |
| Side | 201 | Projektkladder | JobJournal |
Oprettelse af Entra applikation
Navigér til Microsoft Entra-programmer opsætningssiden
Tryk på “Ny” og udfyld en ny applikation med følgende værdier:
| Klient-id | {b5abebb7-b000-4f90-b0f4-f6768df4b08a} |
| Beskrivelse: | KALA |
| Tilstand: | Aktiveret |
(Vigtigt at klient-id’et også har de 2 curly brackets {} inkluderet.)
Brugerrettighedssæt
Her er det oftest nok, at applikationen får rettighedssættet “D365 FINANCE”. Det afhænger af eventuelle tillægsprogrammer, I måtte have i jeres BC setup.
Obs: Der skal ikke trykkes “Giv samtykke” efter oprettelsen. Samtykket sker via et link, der trykkes på indefra Kala.
Oprettelse af forbindelse inde fra Kala
Følgende trin skal udføres efter både webtjenester og Entra-applikation er oprettet, og de skal udføres af en person, der har Admin-rettigheder i jeres 365 miljø.
1: Log ind på Kala med en bruger, der har lederrettigheder i Kala
2: Gå ned under Indstillinger > Forbindelser og services:
3: Vælg “Tilføj forbindelse…” og vælg så “Microsoft Dynamics 365 Business Central”
4: Tryk på det blå link i toppen af siden. Det fører dig ind i Business Central, hvor du vil blive spurgt om du vil tilføje / give samtykke til Kala – udfør dette og vinduet burde lukke automatisk igen. Ellers navigér tilbage til fanen med Kala åbent i.
5: Udfyldt Webservice basis url feltet med SOAP basis url’en til regnskabet. Denne kan kopieres fra én af de publicerede webtjenester i BC. Her er basis-url’en hele stykket indtil f.eks /Page/[PageNavn]. F.eks: https://api.businesscentral.dynamics.com/v2.0/322e4943-4d0c-497c-8cec-ad07cea18645/Production/WS/CRONUS%20Danmark%20A%2FS/
6: Udfyld både Brugernavn og Password med ‘abcd’ , og Login type med ‘OAUTH’
Tryk herefter “Fortsæt“.
Herefter vil den enten sige, at forbindelsen lykkedes. Ellers vil den vise den konkrete fejlårsag til en eventuel mislykket etablering af forbindelse. Oftest grundet et manglende rettighedssæt grundet eventuelle tillægsprogrammer. Her vil fejlkoden også fortælle hvilken rettighed, der stopper os. Tilføj det relevante rettighedssæt til Entra-applikationen og forsøg igen.
Ellers tag fat i Kala’s support, og vi vil hellere end gerne hjælpe dig videre.
