Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Next »

Momenteel (februari 2022) is het enkel mogelijk om in bulk documenten te uploaden in HUMBLE via Postman. In een later stadium wordt het ook mogelijk om bulk documenten uploads te doen via de user interface van HUMBLE. Op dat moment is deze tijdelijke oplossing niet langer noodzakelijk.

Stap 1 - Voorbereiden Postman

  • Druk linksboven naast 'My Workspace’ op de knop

  • Maak een nieuwe ‘Collection'. Noem deze collection 'HUMBLE Exchange’. Ga op de collectie staan. Het scherm ziet er uit zoals in onderstaande schermafdruk.

Collection

  • Kies in de tab ‘Authorization' van de collection bij ‘Type’ voor 'Bearer Token’.

  • Vul in het zichtbaar geworden veld 'Token' het volgende in; {{bearer}}

  • Ga naar de tab 'Variables'. Maak de volgende variabelen aan met de volgende waarden (let op hoofdletters);

  • De url is; https://prd-api.humble-online.com/apiv4/.

  • Je vervangt de waarde <your email> door je mailadres waarmee je in HUMBLE bekend bent.

  • Je vervangt de waarde <your password> door het bij het mailadres behorende wachtwoord in HUMBLE. Het wachtwoord blijft leesbaar.

  • De userpool_client_id is; 77fddt7dfsi2ir9d16jpu07ori.

  • Je vervangt de waarde <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'.

Login steps

  • Maak binnen de collection een nieuwe map middels de optie ‘Add folder'. Noem deze map 'Login steps’. De standaardinstellingen voor de folder voldoen.

AWS Authentication

  • Rechtermuisklik op de map ‘Login steps' en kies voor ‘Add request’. Hernoem ‘New Request’ naar 'AWS Authentication’.

  • Verander ‘GET' in 'POST’.

  • Vul bij 'Request URL' het volgende in; https://cognito-idp.eu-central-1.amazonaws.com/.

  • Ga naar tab ‘Authorization' van de request. Verander ‘Type’ naar 'No Auth’.

  • Ga naar tab ‘Body' van de request. Klik de optie 'raw’ aan.

  • Verander de tevoorschijn gekomen optie ‘Text' in 'JSON’.

  • Plak de volgende code in de body.

{
   "AuthParameters" : {
      "USERNAME" : "{{username}}",
      "PASSWORD" : "{{password}}"
   },
   "AuthFlow" : "USER_PASSWORD_AUTH",
   "ClientId" : "{{userpool_client_id}}"
}

  • Ga naar de tab ‘Headers' van de request. Voeg de key 'Content-Type’ toe met waarde; application/x-amz-json-1.1

  • Voeg de key 'X-Amz-Target' toe met waarde; AWSCognitoIdentityProviderService.InitiateAuth

  • Ga naar de tab 'Tests' en vul deze met het volgende; 

pm.collectionVariables.set('cognitoSession', pm.response.json().Session);

  • Druk rechtsboven op 'Save'.

  • Zorg dat je toegang hebt tot de Postman HUMBLE collectie

  • Dupliceer de collectie Humble Exchange [2022-01-11] en verplaats deze vervolgens naar je eigen Postman Workspace

Configuratie

De collectie bestaat uit 2 delen: inloggen op Humble omgeving en Uitvoeren van requests naar HUMBLE Exchange.

  • Vul de ontbrekende gegevens in bij de variabelen van de collectie

  • De default instellingen wijzen naar de HUMBLE productie omgeving (Environments). Deze moet aangemaakt worden.

  • Maak een environment aan met twee variabelen : cognitoIdToken en beare

Inloggen

  • Ga op de folder ‘Login steps’ staan en druk op de Run knop.

  • De Inlog wordt uitgevoerd en alle drie de request komen met reponse 200

Upload en Import

  • Na correct inloggen kan je aan de slag.

  • Pas in de call Upload ZIP Naar Exchange de parameter importfile in de Body aan en kies hier het ZIP bestand wat geïmporteerd moet worden.

  • Open nu request Document Import via Exchange en pas de body aan

  • Vul bij import → source → filename de naam van het net geüploade bestand in

  • Vul bij export → organisationId het ID van de organisatie in waar de bestanden moeten worden geïmporteerd. let op: jij moet wel toegang hebben tot deze organisatie

  • Vul bij export->options->notify_to_user_id je eigen user ID binnen HUMBLE

Wil je weten hie het importeren werkt ? Kijk hier Document import

Gebruik je geen description maar wil je een aantal bestanden direct bij een gegeven binnen HUMBLE toevoegen ?

  • Vul bij export->options->resource de resource aanduiding waar de documenten aan gekoppeld moeten worden

  • Vul bij export->options->reference_id het ID van het record waar de documenten aan gekoppeld moeten worden

  • No labels