Introductie
Portbase biedt verschillende protocollen aan om berichten uit te wisselen tussen jullie interne systeem en het Port Community System (PCS). Dit artikel legt uit hoe je berichten kunt versturen en ophalen via het sFTP-protocol.
Een overzicht van de andere protocollen vind je hier
Voordat je begint
In dit artikel gaan we ervan uit dat:
- Je organisatie al een sFTP-verbinding heeft, of onze collega's van Integration Services contact met je hebben opgenomen om deze op te zetten. Nog geen verbinding? Lees dan eerst dit artikel over het aanvragen van een systeemkoppeling.
- Je als technisch beheerder verantwoordelijk bent voor het aanmaken en beheren van systeemkoppelingen, en toegang hebt tot de applicatie Systeemkoppelingen (EDIFACT/XML) in het PCS. Nog geen toegang? Bekijk dan dit artikel over hoe je toegang kan krijgen tot de applicatie.
Koppeling beheren
Beheren van je AS2 en sFTP koppelingen doe je via de PCS-service Systeemkoppelingen (EDIFACT/XML). Deze kan je vinden in het Port Community Systeem (PCS).
In het artikel sFTP systeemkoppeling beheren lees je hoe je dit doet.
Technische vereisten
- De Portbase sFTP-services accepteren alleen push/pull. Dit betekent dat jij zelf verantwoordelijk bent voor het plaatsen en ophalen van bestanden in de mappen.
- Berichten in de map cur (upload en download) worden automatisch na 7 dagen verwijderd.
- De maximale bestandsgrootte is 4 MB.
- De PCS sFTP-server is bereikbaar via sftp://messaging2.pcs.portbase.com. Je kan inloggen met de verstrekte gebruikersnaam en je SSH-sleutelpaar, via poort 22. Het beheer van je koppelingen met Portbase doe je in het System Interfaces Portal, via PCS.
Performance
Voor de beste prestaties raden we aan om meerdere parallelle uploads en downloads (ook wel channels of sessies genoemd) te gebruiken binnen één verbinding. Onze server ondersteunt maximaal 10 parallelle transfers per verbinding.
Deze methode is sneller dan het openen van meerdere aparte verbindingen zonder gebruik te maken van parallelle transfers.
Upload procedure
- Upload je bestand naar de map upload/tmp/.
- Als de upload voltooid is, verplaats je het bestand naar upload/new/.
- Na korte tijd pakt het PCS-systeem het bestand op voor distributie en verwerking en verplaatst het naar de map upload/cur/. Na 7 dagen wordt het bestand automatisch verwijderd.
Waarom deze procedure?
Eerst uploaden naar /tmp en daarna verplaatsen naar /new zodra de upload compleet is, voorkomt dat ons systeem onvolledige bestanden oppikt. Het gebruik van de map /new geeft de bevestiging dat een bestand klaarstaat om opgehaald te worden. Op dezelfde manier is het verplaatsen naar de map /cur onze bevestiging dat je bestand is opgehaald voor distributie binnen Portbase.
Download procedure
- Controleer de map download/new/ op nieuwe bestanden.
- Download deze bestanden en verplaats ze als je klaar bent naar download/cur/ of verwijder ze direct. Na 7 dagen worden de bestanden in download/cur/ automatisch verwijderd.
Waarom deze procedure?
Het gebruik van de /new directory bevestigt dat een bestand klaar is om opgehaald te worden en er is geen risico op het ophalen van een gedeeltelijke upload. Het verplaatsen van het bestand naar de /cur map is de bevestiging van jou dat het bestand is opgehaald voor distributie/verwerking. De /tmp directory wordt door Portbase gebruikt voor het uploaden van (gedeeltelijke) bestanden en is niet bedoeld voor gebruik door klanten.
Testen van de koppeling
Controleer of je vanaf je sFTP-client verbinding kan maken met de Portbase sFTP-server en neem contact op met Portbase om de verbinding van Portbase met jouw sFTP-server te controleren.
Heb je vragen over je sFTP systeemkoppeling met Portbase, neem dan contact op via integration@portbase.com
Gerelateerd aan