OPrognose upload and import via Postman

Dit artikel beschrijft de methode van het importeren van een OPrognose ZIP.

Voordeel is dat er grotere bestanden kunnen worden geïmporteerd via deze methode

Stap 1 - Voorbereiden Postman

Druk linksboven naast ‘My Workspace’ op de knop ‘Import’. Upload hier het Postman collectie bestand van de vorige stap.

Wanneer dit gedaan is, ga dan op de collectie staan (HUMBLE Exchange [2022-01-11]).
Open de tab 'Variables', het scherm ziet er nu als volgt uit;

Je vervangt de waardes <your email> door je mailadres waarmee je in HUMBLE bekend bent.
Je vervangt de waardes <your password> door het bij het mailadres behorende wachtwoord in HUMBLE. Het wachtwoord blijft leesbaar.
Je vervangt de waardes <otp_secret_key> door je eigen TOTP secret key. Deze lange aaneengesloten reeks hoofdletters en cijfers werd getoond bij het instellen van twee factor authenticatie in HUMBLE. Zie de eerste afbeelding in het volgende Confluence artikel; Instellen Twee-factor-authenticatie voor HUMBLE; bestaande klanten. In het voorbeeld op Confluence begint de secret key met '72ARTSL'.
Druk rechtsboven op 'Save'.

Klik links in het menulint op 'Environments'.
Klik op de knop ‘New' en kies voor 'Environment’.
Hernoem de environment naar 'HUMBLE productie'.
Voeg twee variabelen zonder waarden toe; ‘cognitoIdToken', 'bearer’. Type; default.
Druk rechtsboven op 'Save'.
De environment zou nu rechtsboven moeten staan (zie rode pijl in onderstaande schermafdruk).

Elke keer wanneer je documenten in bulk wenst te importeren dient stap 2 opnieuw uitgevoerd te worden.

Druk in het scherm wat geopend wordt op de brede blauwe knop rechts 'Run HUMBLE Exchange…'.
Wanneer in het volgende scherm voor de drie requests ('AWS Authentication', ‘AWS TOTP' en ‘HUMBLE Api Login') rechts als respons '200 OK’ hebben, ben je succesvol ingelogd.

Het account waarmee je de import wil doen dient wel toegang te hebben tot de organisatie waar je in wil importeren.

Open de request ‘Upload ZIP naar Exchange' in de folder 'Document Import’ in de collectie.
Open de tab ‘Body'. Verwijder het vorige importbestand door middel van het kruisje rechts van de bestandsnaam.

Zoek vervolgens het juiste .ZIP bestand op je lokale pc. Deze wordt nu als ‘waarde bij ‘importfile’ getoond.
Druk rechtsboven op ‘Send'. De .ZIP wordt nu geupload naar HUMBLE. Als het goed is gegaan verschijnt er onderaan als respons; 'jaaaa’.

Let op. De ZIP file moet aan een aantal voorwaarden voldoen:

Alle bestanden moeten in de ZIP in de hoofddirectory staan. Dus geen sub-directories
De naam van het ZIP bestand moet identiek zijn aan de naam van de XML. Dit is hoofdlettergevoelig.

Open nu de request ‘OPrognose import via Exchange in de folder 'Oprognose Import’ in de collectie.
Open de tab 'Body'.
Vul bij import → source → filename de naam van het net geüploade bestand in (inclusief .ZIP).
Vul bij import → options → checkBeforeImport standaard FALSE in. Door deze op TRUE te zetten heb je de mogelijkheid om proef te draaien. Het resultaat bevat de missende NL-SfB en Units. Die je kan gebruiken in de mapping sectie
Vul bij export → organisationId het ID van de organisatie in waar de bestanden moeten worden geïmporteerd.
Vul bij export->options->withPictures de waarde TRUE in. Bij FALSE worden de afbeeldingen niet meegenomen.
Vul bij export->options->GenerateLocationShortLabel de waarde TRUE in. Automatisch wordt een G-xxxxx nummer gegenereerd. Bij FALSE wordt de code uit OPrognose gebruikt. Zie Mapping Building record <OPO>
Druk vervolgens op ‘Send'. Wanneer het bij HUMBLE is aangeboden en begint de import. Deze duurt vermoedelijk heel lang. De verbinding tussen Postman en Exchange valt weg. Bekijk HUMBLE om te zien of de import klaar is.

Wanneer je upload en import acties zijn uitgevoerd is het tijd om te controleren of het goed gegaan is.

Je bent klaar, relax!