Inleiding

Er zijn twee manieren om pdf-bestanden met binnenwerk en omslag te uploaden. Direct via het POD menu in CB Online of via de ftp-toegang bij CB. De mogelijkheid via ftp is bedoeld voor uitgevers die relatief veel pdf-bestanden moeten uploaden en dat niet per titel willen doen in CB Online. Ook is ftp een mogelijkheid wanneer een pdf-bestand groter is dan 160 MB. De geüploade pdf-bestanden worden automatisch gekoppeld aan de betreffende titel en zijn dan zichtbaar in CB Online.

In dit document wordt beschreven waaraan de bestandsnaam moet voldoen en hoe het uploaden via FTP werkt.

Naamgeving POD voor uploaden via FTP

Pdf-bestanden dienen voorzien te zijn van de juiste naamgeving, zodat de ftp-server de bestanden ook herkent als bestanden voor Print on demand.

De naam mag maximaal 40 karakters lang zijn en mag geen hoofdletters bevatten

bestand	patroon bestandsnaam	voorbeeld
Cover	<ISBN>.pcovr.pdf	9789099968439.pcovr.pdf
Binnenwerk	<ISBN>.pinn.pdf	9789099968439.pinn.pdf

FTP(S)

FTP betekent File Transfer Protocol, dit is een protocol (reeks met afspraken) dat uitwisseling van bestanden tussen vergemakkelijkt. De communicatie verloopt via de FTP server van CB, waar voor de uitgever een ftp account is ingericht. Als de uitgever al digitale berichten van CB ontvangt of instuurt dan beschikt de uitgever al over een ftp account en zijn de inloggegevens voor dat account bij de uitgever bekend. Wanneer er nog geen ftp account voor de uitgever is ingericht dient dit eerst te gebeuren, het verzoek voor een ftp account kan via Customer Service aangevraagd worden.

Connectie maken met FTP server

Om de connectie te maken met de FTP server dient de afnemer/uitgever cliënt- of serversoftware te installeren. Deze software is veelal gratis te downloaden, voorbeelden zijn FileZilla, WinSCP.

Het is niet mogelijk om via een browser connectie te maken met de ftp server.

FTP account

Het ftp account op de ftp server van CB beschikt over 2 maken heeft de volgende mappen

in de in-map waarin de uitgever de bestanden voor CB plaatst
uit de uit-map waarin CB bestanden voor de uitgever plaatst

Uploaden van bestanden via ftp account

Bij het uploaden van POD bestanden dient van commando PASV (passive mode) gebruik gemaakt te worden en bestand moet geplaatst worden in Overdrachttype/transfermodus Binair.

Klik hier voor de algemene informatie rondom de ftp connectie, poortranges, het account en uploaden van bestanden

Click here for the English version

https://userguidescb.atlassian.net/wiki/x/BQCBBQ

Bestanden worden uitgewisseld middels het FTP(S) protocol. Versleuteling van de berichten op basis van het protocol ftp(e)s (FTP over SSL) is verplicht.
CB ondersteunt op dit moment enkel TLS 1.2, data channels zijn gelimiteerd tot poortrange 41000:42000. Om gebruik te maken van versleuteld ftp, dient de gebruikte ftp cliënt software dit wel te ondersteunen.

Webservices en websites zijn secure zodra daar vertrouwelijke gegevens over gaan.

CB stelt FTPs (SSL encryptie) 'FTP over TLS' verplicht maar staat 'Plain text FTP' nog toe. Met ingang van 1 maart 2025 is 'Plain text FTP' definitief niet meer toegestaan.

Wanneer er gebruik gemaakt wordt van communicatie via FTP wordt er een ftp account op de ftp1.boekhuis.nl server van CB aangemaakt. Via dit account kunnen de bestanden voor CB geplaatst worden en zullen de gewenste bestanden door CB worden klaargezet. De inloggegevens worden toegestuurd na activeren van het account.

Kenmerken FTP account
/Relatie id/	Home directory
	in/	map voor bestanden van Klant naar CB	Geplaatste bestanden worden door CB direct na binnenkomst verplaatst voor syntactische controle en verdere verwerking. Na plaatsen van het bestand is het niet toegestaan om deze nog te bewerken . Van geplaatste bestanden wordt automatische een ontvangstbevestiging geplaatst in de out map
	out/	map voor bestanden van CB naar Klant	Bestanden die gedownload of geopend worden zullen automatisch van de ftp server verwijderd worden. Bestanden die niet worden opgehaald, zal CB na enige tijd verwijderen
Aanmaken van directories en sub-directories is niet toegestaan.

Naamgeving bestand bestaat uit 2 delen, gedeelte voor en na de 'punt'
voor de 'punt'	bestandsnaam
na de 'punt'	extensie
De bestandsnaam mag opgebouwd worden m.b.v. cijfers 0 t/m 9, de letters a t/m z (hoofdletters en/of kleine letters) en de speciale karakters “punt “ (.), dash (-) en underscore (_). Alle andere karakters zoals spatie, trema, &, <, >, {, } etc. zijn niet toegestaan. Voor de extensie is het gebruik van hoofdletters niet toegestaan.

Connectie met ftp server - Transfer mode
Frequentie voor inloggen op de ftp server is maximaal 1 keer per 10 minuten. Aan het eind van iedere sessie dient er uitgelogd te worden. Parallelle inlogsessies voor hetzelfde bestand zijn niet toegestaan.
Transfer mode	Voor de verbinding dient gebruik gemaakt te worden van commando PASV (passive mode)
Binair	alle bestanden met de extensies '.epub', '.jpg', '.pdf' en '.zip'
ASCII	alle overige extensies

Voorbeeld van de FTP client tool FileZilla waarbij Overdrachttype Binair is geselecteerd

Verwerking op FTP server geplaatste bestanden

De pdf-bestanden worden, mits de juiste naamgeving is gebruikt, automatisch verwerkt en worden na enige verwerkingstijd in CB Online gekoppeld aan de betreffende POD titel.

Berichtdefinities

POD bestanden uploaden via FTP