Generisk REST / JSON-konnektor
Hent poster fra et hvilket som helst REST-endpoint, map felterne, og kontrollér dem mod et eksempel.
Hvem kan gøre detWorkspace-administrator
Konnektoren Generic REST / JSON henter poster fra et hvilket som helst REST-endpoint, der svarer med JSON, og skriver dem ind i en Juvaro-app: aktiver i AMS eller varer i WMS. Du mapper selv hvert målfelt, og du kan kontrollere mappingen mod et live eller indsat eksempel, før du gemmer. Brug den til et system, der ikke har sin egen konnektor.
Integrationshub findes kun på engelsk. Knapper, felter og beskeder står derfor på engelsk her, præcis som du ser dem i appen.
Opret forbindelsen
- Åbn Marketplace, find Generic REST / JSON (kategorien Generic, virker med Any app), og klik på Add. Mapping-editoren åbner.
- Under Basics skriver du et Name.
- Under Source angiver du endpointet (se nedenfor) og klikker på Fetch live sample.
- Under Target vælger du Module og, for aktiver, Asset model.
- Under Field mappings mapper du hvert målfelt.
- Kontrollér resultatet under Sample & preview.
- Under Schedule & status vælger du udløser og slår Enabled til.
- Klik på Save.
Kilde
- Type: REST / JSON endpoint.
- URL: den adresse, Hub kalder, for eksempel https://api.example.com/assets.
- Auth secret name (optional): navnet på en hemmelighed, der ligger i Juvaros hemmelighedsboks til dette endpoint, for eksempel my-api-key. Du skriver navnet her, ikke selve hemmeligheden. Lad feltet stå tomt for et offentligt endpoint. Navne på hemmeligheder, som Juvaro har oprettet til andre forbindelser, afvises.
Fetch live sample kalder URL'en én gang og læser svaret. Den viser "Live sample fetched" og " - showing the first 64 KB", hvis svaret var længere. De feltnavne, den finder, bliver valgmuligheder i mappingen. Fejler den, ser du "could not fetch the sample" eller "timed out waiting for the sample".
Mål
Module er AMS · Asset eller WMS · Item. Til AMS · Asset skal du også vælge en Asset model. Hver post bliver til et aktiv af den model. Uden den fejler gem med "choose an asset model for the AMS · Asset target".
Feltmapping
Hver række er ét målfelt med dets mapping. En rød stjerne markerer et påkrævet felt.
| Modul | Målfelter |
|---|---|
| AMS · Asset | Asset tag (påkrævet), Serial number, Purchase cost, Status |
| WMS · Item | SKU (påkrævet), Name (påkrævet), Quantity |
For hvert felt vælger du en Mapping:
- Copy from field: tag værdien fra et felt i kilden. Efter et live eksempel vælger du feltet fra en liste. Ellers skriver du feltnavnet.
- Constant value: brug samme værdi for alle poster, for eksempel en fast status.
Eksempel og forhåndsvisning
Under Sample & preview indsætter du et eksempel i Paste a sample (JSON object or array), for eksempel en eller to poster fra systemets dokumentation. Hub kører din mapping på eksemplet og viser resultatet som en tabel med fem rækker pr. side. Problemer som "sample is not valid JSON" står over tabellen. Forhåndsvisningen skriver intet til AMS eller WMS.
Kontrollér forhåndsvisningen med et eksempel, der indeholder en tom eller mærkelig post. Det er billigere at finde et mappingproblem her end efter en kørsel, der har skrevet hundrede aktiver.
Kørselsplan, webhook og pris
- En ny forbindelse starter med Trigger på Manual (Run now only) og Enabled slået fra. Skifter du til On a schedule, starter den som dagligt kl. 02.00 UTC. Det hurtigste valg er hvert 15. minut. Alle tider er UTC. Se Kørselsplaner og Run now.
- Afsnittet Webhook trigger lader et eksternt system starte en kørsel. Før første gem står der "Save the connection first, then a webhook URL + secret appear here." Se Webhook-udløsere.
- Der er ingen Test connection. Brug i stedet Fetch live sample og en første Run now.
- Hver kørsel koster 1 credit plus 5 pr. MB, også når den ikke finder nogen poster. Selve posterne er gratis. En hentning er begrænset til 5 MB, og en forbindelse, der rammer grænsen, vises som Truncated på siden Usage. Se Forbrug og credits.
- Efter 3 planlagte fejl i træk sætter forbindelsen sig selv på pause. Se En forbindelses side: tal, Pause og Resume.