Microsoft Dynamics 365 Business Central
Hämta projekt- och beläggningsdata från Microsoft Dynamics 365 Business Central till MuchSkills. Era administratörer registrerar en app i Microsoft Entra och ger den läsbehörighet i Business Central. Vi mappar datan och kör synkroniseringen tillsammans med er, som en del av er MuchSkills-implementering.
- Vem
- Era administratörer för Business Central och Microsoft Entra, tillsammans med vår CTO
- Så kopplas det
- Anpassad uppsättning som ingår i er implementering
- Hämtar
- Projekt- och beläggningsdata, inklusive frånvaro
- Åtkomst
- Läsbehörigheter som ni tilldelar i Business Central
How to
Så fungerar det
MuchSkills loggar in i Business Central som en app, utan användare, med Microsofts tjänst-till-tjänst-autentisering. Appen läser de poster ni har gått med på att dela enligt ett schema. Ingenting skrivs tillbaka till Business Central, och vad appen kan se begränsas av de behörighetsuppsättningar ni tilldelar.
Innan du börjar
- En administratör för Microsoft Entra som kan registrera en app och ge administratörsmedgivande. Se rollerna i vanliga frågor nedan.
- En administratör för Business Central som kan konfigurera Microsoft Entra-applikationer och tilldela behörighetsuppsättningar.
- Ert omfång: vilken Business Central-miljö och vilka bolag, samt vilka projekt och personer som ska finnas i MuchSkills.
- Kontrollera e-postadresserna. Personer matchas mot medlemmar i MuchSkills via e-post. E-postadressen i Business Central ska vara den adress som respektive person loggar in i MuchSkills med.
Steg
I Microsoft Entra
Microsofts guide beskriver stegen i detalj: Använda tjänst-till-tjänst-autentisering med Business Central.
- Registrera en app. Logga in i administrationscentret för Microsoft Entra och gå till Entra ID › App registrations › New registration. Döp den till MuchSkills, behåll Single tenant only, lämna Redirect URI tomt och klicka på Register. Anteckna Application (client) ID och Directory (tenant) ID på sidan Overview.
- Lägg till behörigheten för Business Central. Öppna API permissions › Add a permission › Microsoft APIs och välj Dynamics 365 Business Central. Välj Application permissions, markera API.ReadWrite.All och klicka på Add permissions.
- Ge administratörsmedgivande. Klicka på Grant admin consent for er organisation på samma sida och bekräfta. Vänta tills behörigheten visas som Granted. Microsofts guide om administratörsmedgivande
- Skapa en klienthemlighet. Öppna Certificates & secrets › Client secrets › New client secret. Lägg till en beskrivning, välj giltighetstid och klicka på Add. Kopiera Value direkt. Microsoft visar det bara en gång.
I Business Central
- Lägg till appen i Business Central. Sök efter Microsoft Entra applications och öppna sidan. Välj New. Ange Application (client) ID i fältet Client ID på kortet, skriv MuchSkills i Description och sätt State till Enabled.
- Tilldela läsbehörigheter. Tilldela på samma kort behörighetsuppsättningar som låter appen läsa den data som ingår, och ingenting mer. Business Central tillåter inte behörighetsuppsättningen SUPER för appar. Vi bekräftar exakt vilka behörighetsuppsättningar som gäller tillsammans med er under den tekniska genomgången.
Tillsammans med MuchSkills
- Skicka anslutningsuppgifterna till oss. Ert tenant-ID, namnet på Business Central-miljön, bolagsnamnen, klient-ID, klienthemligheten och ert omfång, via en säker kanal som vi kommer överens om.
- Delta i den tekniska genomgången. Er administratör för Business Central och vår CTO mappar datan och testar anslutningen tillsammans.
- Kontrollera en första synk. Vi synkroniserar ett fåtal projekt eller personer. Ni kontrollerar dem i MuchSkills.
- Utöka omfånget. Vi slår på synkroniseringen för allt som ingår. Därefter körs den enligt schema.
Kontrollera att det fungerar
- Projekten som omfattas visas i Team Builder.
- Beläggningen för dem som arbetar i projekten syns i rapporterna under Team/Org › Reports.
- Frånvaro från Business Central syns i respektive persons tillgänglighet, till exempel i My Circle.
Benefits
Det här får ni
- Business Central är fortsatt källsystemet. Projekt och tid registreras en gång, i Business Central, och MuchSkills hänger med.
- Bemanning utifrån faktisk arbetsbelastning. Ni ser vem som redan är bokad innan ni lägger till någon i ett team.
- Kompetens kopplad till leveransen. Lägg till kompetenskrav på synkade projekt för att hitta kompetensgap och planera vem ni behöver rekrytera eller kompetensutveckla.
Important to know
Bra att veta
Vad som synkroniseras. Vi kommer överens om exakt vilka poster under den tekniska genomgången. Vanligtvis gäller det projekt, personerna som arbetar i dem och frånvaro.
Frånvaro hämtas bara som datum och procentandel. Orsaker importeras aldrig. Så länge frånvaron hanteras i Business Central gör ni ändringarna där, eftersom MuchSkills API inte tillåter att den skrivs över.
Endast läsning genom behörighetsuppsättningar. Behörigheten i Entra öppnar dörren till Business Centrals API:er. Behörighetsuppsättningarna på kortet i Business Central avgör vad appen kan se. Tilldela endast läsbehörigheter.
Data som MuchSkills inte tar emot. Följande blockeras när datan kommer in och lagras aldrig, även om källan innehåller det: ålder eller födelsedatum, lön eller andra ersättningsuppgifter, prestationsbedömningar samt uppgifter om politisk åskådning, religion eller hälsa.
Våra IP-adresser. MuchSkills ansluter alltid från samma två adresser: 13.51.77.53 och 16.170.107.61. Om ert system eller nätverk begränsar åtkomst utifrån IP-adress lägger ni till båda i listan över tillåtna adresser.
Håll hemligheten aktuell. Lägg in klienthemlighetens utgångsdatum i kalendern. När den går ut stoppas synkroniseringen tills ni skickar en ny till oss.
Common errors
Felsökning
| Problem | Orsak | Åtgärd |
|---|---|---|
| Anslutningstestet misslyckas direkt efter konfigurationen | Administratörsmedgivande har inte beviljats, eller så står appens State inte på Enabled i Business Central | Gör om steg 3 och kontrollera kortet Microsoft Entra applications |
| Vissa projekt eller personer saknas | Behörighetsuppsättningarna täcker inte dem, eller så ligger de utanför de bolag eller det omfång ni har kommit överens om | Kontrollera behörighetsuppsättningarna på kortet och ert omfång |
| Personer kopplas inte till sina kompetensprofiler i MuchSkills | Deras e-postadress i Business Central är inte samma som den de loggar in med | Se till att e-postadresserna stämmer överens |
| Det går inte att ändra någons frånvaro via MuchSkills API | Frånvaron i er organisation hanteras i Business Central | Ändra frånvaron i Business Central |
| Synkningen har stannat | Klienthemligheten har gått ut eller tagits bort i Microsoft Entra | Skapa en ny hemlighet och skicka den till oss på ett säkert sätt |
Vanliga frågor
Business Central visas som ”Contact us” i MuchSkills. Kan vi ändå koppla det?
Ja. Business Central sätts upp tillsammans med oss i stället för via ett formulär, eftersom varje Business Central-miljö är konfigurerad på sitt eget sätt. Mejla support@muchskills.com eller använd chatten, så bokar vi den tekniska genomgången.
Behöver vi middleware eller en integrationsplattform?
Nej. MuchSkills läser från Business Central-API:erna över HTTPS och loggar in som den app du registrerar i Microsoft Entra. Ditt team behöver bara registrera appen och ge den läsbehörighet.
Varför heter Entra-behörigheten API.ReadWrite.All?
Det är den applikationsbehörighet som Microsoft erbjuder för åtkomst till Business Central-API:erna. Vad appen faktiskt kan se och göra styrs av de behörighetsuppsättningar du tilldelar den i Business Central. Tilldela bara läsbehörigheter.
Vilka roller behöver vi?
I Microsoft Entra: någon som kan registrera appar, samt en Cloud Application Administrator, Application Administrator eller Privileged Role Administrator som kan ge administratörsmedgivande. I Business Central: en administratör som kan konfigurera Microsoft Entra-program och tilldela behörighetsuppsättningar. I MuchSkills: rollen Owner eller Admin.
Kan vi testa med några få projekt först?
Ja. Den första synkroniseringen kan begränsas till en handfull projekt eller personer. Du kontrollerar resultatet, och sedan utökar vi omfattningen.
Följer frånvaroorsakerna med i importen?
Nej. MuchSkills hämtar bara datumen och hur stor andel av tiden personen är borta. Orsaker som sjukfrånvaro importeras aldrig.
Hur skickar vi inloggningsuppgifterna på ett säkert sätt?
Via en säker kanal som vi kommer överens om i förväg, till exempel delning via en lösenordshanterare. Aldrig med vanlig e-post.
Vad händer när klienthemligheten går ut?
Synkroniseringen stoppas. Skapa en ny klienthemlighet i Microsoft Entra och skicka den till oss via den överenskomna säkra kanalen. Lägg in utgångsdatumet i kalendern när du skapar hemligheten.