DokumentasjonIntegrationer

proALPHA

anymize leser poster fra Read-API-en i proALPHA-ERP-et ditt, altså akkurat områdene installasjonen deres har frigitt til det.

5 Min

Hva du kan gjøre med det

  • «Hvilke dataområder åpner proALPHA-et vårt via grensesnittet?»
  • «Vis meg de første 20 postene fra endepunktet Artikler.»
  • «Hva betyr feltnavnene i dette endepunktet?»
  • «Les datasettet med denne identifikatoren i sin helhet.»
  • «Oppsummer hvilke felt endepunktet Kunder returnerer.»

Assistenten går alltid samme vei: først liste områdene, så endepunktene der, så versjonen deres, så feltbeskrivelsen, og først deretter postene. Det høres omstendelig ut, men er den eneste ærlige veien, fordi hver proALPHA-installasjon ser annerledes ut.

Hvorfor vet ikke anymize på forhånd hva som står i ERP-et mitt?

Fordi proALPHA ikke leverer en fast liste over grensesnitt. Read-API-et er et byggesett: hvilke endepunkter som finnes, bestemmer installasjonen deres. En konsulent, en partner eller deres egen IT oppretter dem under Datautveksling, Konfigurasjon REST-endepunkter. To proALPHA-kunder har derfor to forskjellige grensesnitt.

Det som er likt overalt, er oppbygningen av selve Read-API-et, og den beskriver heldigvis seg selv. Derfor spør assistenten først systemet deres hva det i det hele tatt gir, i stedet for å gjette områder som kanskje slett ikke finnes hos dere.

Kommer det ved tilkoblingen en tom liste tilbake, er tilgangen som regel riktig, men det er ennå ikke konfigurert et lese-endepunkt. Det er da det første punktet for IT-en deres, ikke et problem med tilgangsdataene.

Slik oppretter du M2M-brukeren

  1. 01I proALPHA åpner du brukeradministrasjonen og oppretter en egen M2M-bruker. En vanlig ERP-innlogging rekker ikke.
  2. 02På fanen Tillatelse huker du bare av REST-SERVICES.
  3. 03Sett et sterkt passord og noter brukernavn og passord på et trygt sted.
  4. 04Sørg for at det under Datautveksling, konfigurasjon REST-endepunkter finnes minst ett leseendepunkt.

De nøyaktige menynavnene kan avvike litt etter proALPHA-versjon. Hvis usikker, spør IT-en deres eller partneren som satte opp Read-API-et. Offentlige selvbetjeningsportaler for API-nøkler finnes ikke hos proALPHA.

Koble til

  1. 01I anymize åpner du Apper, deretter Koblinger, og velger proALPHA.
  2. 02Skriv inn adressen til installasjonen deres, for eksempel https://erp.firmaet-ditt.no, pluss M2M-brukeren og passordet fra avsnittet over.
  3. 03Bestem hvilke områder assistenten kan bruke: endepunktkatalogen og datasettene.

Kjører proALPHA-en deres i eget hus, må grensesnittet være nåbart utenfra. Det er en avtale med IT-en deres og ikke en feil i koblingen. I proALPHA-skyen er det det som regel allerede.

Kan anymize opprette en ordre i proALPHA?

Nei. Her trekker selv produsenten grensen: Read-API-et er den lesende halvdelen av byggesettet, skriving går over helt andre veier som anymize ikke tar opp. I tillegg kommer vår egen regel om at det ikke finnes skrivende verktøy.

M2M-brukeren bør likevel bare bære tillatelsen REST-SERVICES. To grenser er bedre enn én.

Hva som mangler på dette trinnet

  • Filtrering etter feltinnhold går ennå ikke. proALPHA filtrerer via parametere som er oppkalt etter deres egne felt, og dem kjenner ingen på forhånd. Assistenten blar i stedet sidevis.
  • En side rommer høyst 50 poster. Det er med vilje: store uttrekk via grensesnittet merker applikasjonsserveren deres, det skriver proALPHA selv i sin egen dokumentasjon.
  • Feltbeskrivelsen hjelper med å forstå: proALPHA-feltnavn er ofte forkortede tyske kolonnenavn, og assistenten kan oversette dem til lesbare betegnelser.

Digital suverenitet og anonymisering

proALPHA kjører på deres egen installasjon, i huset eller i produsentens sky. anymize snakker utelukkende med adressen dere har skrevet inn, og tilgangsdataene ligger kryptert i arbeidsområdet deres.

Det som kommer fra ERP, er forretningsdata i ren form. Kundenavn, adresser, kontaktpersoner, kunde- og leverandørnummer samt bankforbindelser erstattes av plassholdere før en post går til en KI-modell.