proALPHA

anymize læser poster fra Read-API'en i dit proALPHA-ERP, altså præcis de områder, jeres installation har givet fri til det.

5 Min

Hvad du kan gøre med det

„Hvilke dataområder giver vores proALPHA fri via grænsefladen?“
„Vis mig de første 20 poster fra endepunktet Artikler.“
„Hvad betyder feltnavnene i dette endepunkt?“
„Læs datasættet med denne identifikator fuldt op.“
„Sammenfat, hvilke felter endepunktet Kunder returnerer.“

Assistenten går altid samme vej: først liste områderne, så endepunkterne deri, så deres version, så feltbeskrivelsen, og først derefter posterne. Det lyder besværligt, men er den eneste ærlige vej, fordi hver proALPHA-installation ser anderledes ud.

Hvorfor ved anymize ikke på forhånd, hvad der står i mit ERP?

Fordi proALPHA ikke leverer en fast liste over grænseflader. Read-API'en er et byggesæt: hvilke endepunkter der er, beslutter jeres installation. En konsulent, en partner eller jeres egen IT opretter dem under Dataudveksling, Konfiguration REST-endepunkter. To proALPHA-kunder har derfor to forskellige grænseflader.

Det, der er ens overalt, er opbygningen af selve Read-API'en, og den beskriver heldigvis sig selv. Derfor spørger assistenten først jeres system, hvad det overhovedet giver, i stedet for at gætte områder, der måske slet ikke findes hos jer.

Kommer der ved forbindelsen en tom liste tilbage, er adgangen som regel rigtig, men der er endnu ikke konfigureret et læse-endepunkt. Det er så det første punkt for jeres IT, ikke et problem med adgangsdataene.

Sådan opretter du M2M-brugeren

01Åbn i proALPHA brugeradministrationen og opret en særskilt M2M-bruger. Et almindeligt ERP-login rækker ikke.
02På fanen Tilladelse skal du kun sætte hak ved REST-SERVICES.
03Giv en stærk adgangskode og notér brugernavn og adgangskode et sikkert sted.
04Sørg for, at der under Dataudveksling, konfiguration REST-endepunkter findes mindst ét læseendepunkt.

De nøjagtige menunavne kan afvige lidt efter proALPHA-version. Hvis usikker, spørg jeres IT eller partneren, der har sat Read-API'en op. Offentlige selvbetjeningsportaler til API-nøgler findes ikke hos proALPHA.

Forbind

01Åbn i anymize Apps, derefter Connectors, og vælg proALPHA.
02Indtast adressen på jeres installation, for eksempel https://erp.dit-firma.dk, plus M2M-brugeren og adgangskoden fra afsnittet ovenfor.
03Angiv, hvilke områder assistenten må bruge: endepunktskataloget og datasættene.

Kører jeres proALPHA i eget hus, skal grænsefladen kunne nås udefra. Det er en aftale med jeres IT og ikke en fejl i konnektoren. I proALPHA-skyen er den det som regel allerede.

Kan anymize oprette en ordre i proALPHA?

Nej. Her trækker selv producenten grænsen: Read-API'en er den læsende halvdel af byggesættet, skrivning kører over helt andre veje, som anymize ikke taler til. Dertil kommer vores egen regel om, at der ikke er skrivende værktøjer.

M2M-brugeren bør alligevel kun bære tilladelsen REST-SERVICES. To grænser er bedre end én.

Hvad der mangler på dette trin

Filtrering efter feltindhold går endnu ikke. proALPHA filtrerer via parametre, der er opkaldt efter jeres egne felter, og dem kender ingen på forhånd. Assistenten bladre i stedet sidevis.
En side rummer højst 50 poster. Det er med vilje: store udtræk via grænsefladen mærker jeres applikationsserver, det skriver proALPHA selv i sin egen dokumentation.
Feltbeskrivelsen hjælper med at forstå: proALPHA-feltnavne er ofte forkortede tyske kolonnenavne, og assistenten kan oversætte dem til læsbare betegnelser.

Digital suverænitet og anonymisering

proALPHA kører på jeres egen installation, i huset eller i producentens sky. anymize taler udelukkende med den adresse, I har indtastet, og adgangsdataene ligger krypteret i jeres arbejdsområde.

Det, der kommer fra ERP, er forretningsdata i ren form. Kundenavne, adresser, kontaktpersoner, kunde- og leverandørnumre samt bankforbindelser erstattes af pladsholdere, før en post går til en AI-model.