Installér OpenDIMS-udvidelsen i Business Central

/

Nogle af Business Central-appens funktioner kræver OpenDIMS’ egen udvidelse inde i Business Central: det ægte lagertal, montagestyklister, rabatmatricen, trackingnumre og de varefelter, standard-API’et ikke udgiver. Her er hele opsætningen — hent filen, upload den, og tildel de rettighedssæt, funktionerne kræver. Udvidelsen er gratis og læser kun.

Business Central-appen virker uden nogen udvidelse. Nummer, navn, priser, GTIN, enheder, lagerbeholdning, ordrer og kunder kommer fra Business Centrals eget standard-API. Udvidelsen skal kun bruges til det, standard-API’et ikke kan levere.

Hvornår har du brug for den?

Installér udvidelsen, hvis du vil bruge en eller flere af disse:

  • Det ægte lagertal — bruttobehov, altså alt det en vare allerede er lovet væk til, så webshoppen ikke sælger den samme vare to gange.
  • Ekstra varefelter — de felter Business Central har på varekortet, men ikke udgiver, inklusive dem andre udvidelser har lagt på hos netop jer.
  • Montagestyklister — produkter der består af andre produkter, med antal og enheder, og styklistens kostpris.
  • Varestatistik — solgt og købt antal, omsætning, vareforbrug, reguleringer.
  • Rabatmatricen — debitorrabatgrupper, varerabatgrupper og salgsprisaftale-linjer.
  • Trackingnumre på ordre-importen.
  • Poster, købsdokumenter og ekstra felter på kunder, kreditorer og salgsdokumenter.
  • Vilkårlig Business Central-tabel.

Trin 1: Hent .app-filen

Åbn appen i OpenDIMS under Integrations apps, og klik Download OpenDIMS Business Central-udvidelsen. Gem filen — det er den, du uploader i næste trin.

Hent den altid forfra, når du opdaterer. Nye funktioner kræver tit en nyere udgave af udvidelsen.

Trin 2: Upload udvidelsen i Business Central

Det skal gøres af en Business Central-administrator.

  1. Søg efter Udvidelsesstyring i Business Central.
  2. Vælg Administrer → Upload udvidelse…
  3. Klik … ud for Vælg .app-fil, og vælg den fil, du hentede.
  4. Installer til: Aktuel version.
  5. Sprog: jeres eget.
  6. Synkroniseringstilstand for skema: Tilføj.
  7. Slå kontakten “Ved at installere denne udvidelse accepterer du…” til.
  8. Klik Installer.

Den fejl, folk oftest render ind i: knappen Installer er grå, indtil samtykke-kontakten i punkt 7 er slået til. Der står ikke hvorfor — knappen ser bare død ud.

Installationen kører i baggrunden. Du kan følge den under Administrer → Installationsstatus.

Kontrollér til sidst, at det lykkedes: søg efter OpenDIMS i Udvidelsesstyring. Er installeret skal stå til Ja, og versionsnummeret skal være det, du lige hentede.

Ser du to linjer med OpenDIMS Integration, hvor den ene står til Nej, er alt som det skal være: Business Central lader den gamle version blive liggende som udgivet, men uinstalleret, når du opdaterer.

Trin 3: Tildel rettighedssæt

Udvidelsen henter data på vegne af den bruger, der godkendte OpenDIMS’ adgang. Det er den bruger, der skal have rettighedssættene — ikke en tilfældig administrator.

  1. Søg efter Brugere i Business Central.
  2. Klik på brugeren, så brugerkortet åbner.
  3. Under Brugerrettighedssæt: klik Ny linje.
  4. Skriv navnet på rettighedssættet, fx OPENDIMS ITEMS, og tryk Enter.
  5. Lad Virksomhed stå tom. Så gælder rettigheden alle virksomheder i miljøet.
  6. Gentag for hvert rettighedssæt, I har brug for.

Har brugeren SUPER, har den allerede adgang til alt, og rettighedssættene ændrer ingenting. De findes netop for, at I ikke behøver at give integrationen SUPER: hvert sæt åbner præcis ét område, og alle er skrivebeskyttede.

Hvad de enkelte rettighedssæt giver adgang til

  • OPENDIMS ITEMS — ekstra varefelter, varens egenskaber (produktspecifikationer som effekt, vægt, mål og garanti), bruttobehov (det ægte lagertal), varestatistik og montagestyklistens kostpris. Skal bruges, når “Brug OpenDIMS BC-udvidelsen til ekstra varedata” står til Ja på produktforbindelsen.
  • OPENDIMS BOM — selve komponentlinjerne i montagestyklisten.
  • OPENDIMS DISCOUNTS — debitorrabatgrupper, varerabatgrupper og salgsprisaftale-linjer.
  • OPENDIMS TRACKING — følgesedler og fakturalinjer, som trackingnumrene kommer fra.
  • OPENDIMS CUSTOMERS — ekstra felter på debitorer.
  • OPENDIMS SALES — ekstra felter på salgsordrer og salgslinjer.
  • OPENDIMS VENDORS — ekstra felter på kreditorer.
  • OPENDIMS PURCHASES — købsordrer, købsfakturaer og købsmodtagelser.
  • OPENDIMS LEDGERS — vare-, debitor-, kreditor- og finansposter.
  • OPENDIMS TABLE DATA — adgangen til forbindelsen Vilkårlig Business Central-tabel.

Bemærk om det sidste: det åbner kun døren. Hvad forbindelsen faktisk kan læse, er præcis det, de øvrige rettighedssæt giver den. OPENDIMS TABLE DATA alene giver altså ikke adgang til flere data.

Efter en opdatering: tildel rettighedssættet igen

Når I opdaterer udvidelsen, beholder brugeren sine rettighedssæt — men de sider, den nye version tilføjer, er ikke med i det, brugeren fik tildelt. Resultatet er tilpas ubehageligt: de nye endepunkter svarer 200 med et tomt svar i stedet for en fejl, så importen henter ingenting, og loggen siger ingenting.

Efter hver opdatering: åbn brugerkortet, fjern rettighedssættet og tilføj det igen. Henter en ny funktion ingenting som helst, er det næsten altid det her — kig efter det, før I leder andre steder.

Vigtigt: for få rettigheder giver forkerte tal — ikke en fejlmeddelelse

Bruttobehovet lægges sammen af efterspørgslen fra salgslinjer, servicelinjer, projektplanlægningslinjer, produktionskomponenter, planlægningskomponenter, montagelinjer og købsreturneringer.

Mangler brugeren rettigheden til én af dem, fejler kaldet ikke. Den del af efterspørgslen tælles bare ikke med. Bruttobehovet bliver for lavt, det ledige lagertal bliver for højt — og webshoppen sælger varer, der allerede er lovet væk.

Derfor: tildel hele OPENDIMS ITEMS, ikke udvalgte tabeller fra det.

Trin 4: Slå udvidelsen til i OpenDIMS

Udvidelsen bliver ikke brugt, bare fordi den er installeret. På produktforbindelsen skal du sætte “Brug OpenDIMS BC-udvidelsen til ekstra varedata” til Ja.

Åbn derefter integrationens feltmapning. De ekstra elementer — bruttobehov, varestatistik, styklistelinjer og varekortets øvrige felter — står nu i listen over kilder, klar til at mappe.

Hvis noget ikke virker

  • Installer-knappen er grå. Samtykke-kontakten er ikke slået til. Se trin 2, punkt 7.
  • De ekstra felter dukker ikke op i feltmapningen. Tjek i denne rækkefølge: er udvidelsen installeret (Er installeret = Ja), står indstillingen i trin 4 til Ja, og har brugeren det rigtige rettighedssæt?
  • Lagertallet ser for højt ud. Det er næsten altid en manglende tabelrettighed — se afsnittet ovenfor.
  • “Authentication_InvalidCredentials” eller fejl 401. Det er ikke godkendelsen i OpenDIMS, der er gået galt — Microsoft har udstedt et gyldigt token, og Business Central afviser brugeren bagefter. Tjek at brugeren findes som bruger i Business Central-miljøet, har en licens, og ikke er spærret.