Hvordan sette opp en egendefinert fil integrasjon?
- Runar Olstad
En integrasjon kan spare deg for unødvendig tid ellers brukt på å taste inn adresser og referansefelter manuelt. Dette er en generell egendefinert integrasjon-guide som kan passe for ulike typer programmer som ikke er dekket spesifikt i andre artikler (MAMUT, VISMA Global, VISMA Business, Unimicro..). Ved å følge punktene i denne artikkelen kan hvem som helst sette opp en slik integrasjon på få minutter.
Denne integrasjonen fungerer på det vis at man definerer en mappe som ProTeria automatisk skal importere filer fra (når det kommer nye filer dit). Avhengig av hvilket program du her skal lage en integrasjon mot så vil stegene som har å gjøre med eksportering av filen fra din programvare kunne variere, men stikkordene er “innstillinger”, “fil”, “eksporter”.
Last ned den nyeste versjonen av ProTeria CloudConnect service. Legg den på serveren hvor du ønsker at filene skal overføres til (se steg 6) en trygg plass på din maskin.
Nå skal vi sørge for at ProTeria får tilgang til en spesifikk mappe på din maskin. Dette er mappen du skal eksportere filer til fra ditt program. Først går du inn i nettleseren (Chrome, Firefox, Edge) og lim inn følgende lenke: “localhost:6677”
Dersom du ikke allerede har gjort denne valideringen tidligere så lander du på denne siden som spør om din ProTeria API nøkkel (les: “Slik finner du din ProTeria API nøkkel”) og ditt kundenummer hos ProTeria (les: “Hva er mitt ProTeria kundenummer?”). Fyll inn og klikk “Validate”
Etter å ha skrevet inn API nøkkel og kundenummer, eller dersom det allerede lå inne, så lander du på en blank side hvor du kun ser en meny i toppen som ser slik ut. Klikk på “Add/remove filewatcher”
Da vil du lande på en side som ser slik ut. Velg “Customized file integration”, last opp en test-fil (template-file) for å fortelle systemet hvordan filene skal leses av / forståes. “Eksport_til_proteria” er et eksempel på en mappe. Velg en eksisterende mappe som på din maskin som du tenker kan være passende å eksportere filer til (uten at man risikerer at den flyttes på av andre brukere).
På filtere skriver du inn “*.*” som vil tilsi at alle filene i mappen skal eksporteres, velg Type: “Freight”
Trykk deretter på “Velg fil”. Merk at filen bør være i .csv format (“comma separated values”) som vist i skjermdumpen nedenfor. Fil-endelsen (i dette tilfellet en “.txt”-fil) kan i grunn være nærmest hva som helst.
Firmanavn og adresse er klusset ut i eksempelet, men du kan se ordrenummer, postnummer, poststed osv er separert med komma og gåsetegn.Når du legger inn fila vil disse feltene dukke opp, og du vil bli bedt om å velge korrekte tilhørende felter i oversikten. Først velger du informasjon som tilhører “Avsenderen” som da vil være din informasjon. Der det står f. eks poststed der velger du verdien i fila som skal være postnummer. I dette eksempelet 'Billingstad'
Alle feltene er ikke obligatoriske, og det er ikke forventet eller nødvendig å fylle inn alt. Avsender-adresse ligger for eksempel lagret inne i ProTeria Web automatisk, og pakketype kan man også lage maler for. Det aller viktigste og vanligste vil da være ordrenummer, mottakers adresse, navn, epost og telefonnummer.
Når alle feltene du ønsker er peket ut klikker du “Save”.
Dersom du da har en ordre liggende (i tilsvarende format som test-filen du la inn tidligere) som er blitt overført til den mappen du tidligere valgte (i mitt tilfelle en mappe som heter “Eksport_til_proteria”), så kan du gå inn i ProTeria Web og velge f. eks “Ny Bring”
Såfremt du har bestilt en integrasjonsmodul aktivert av ProTeria så vil du ha en boks som heter “Søk i ordresystem” tilgjengelig inne i ProTeria Web. Der kan du skrive inn et ordrenummer for å se om det dukker opp → klikk på ordren du ønsker.
Trykk deretter “Hent ordre”, og den vil dukke opp med kontakt-info, adresse og de feltene dere ellers har fylt ut.
