Aufbau und Funktion

Geändert am Do, 9 Jul, 2020 um 1:36 NACHMITTAGS

Allgemeine Informationen

Für die Bereitstellung von Inhalten in Purple DS Apps oder den Purple DS HUB kann eine sogenannte CSV-Datei erstellt werden, die alle wichtigen Informationen enthält, die man importieren möchte.

Sind alle notwendigen Informationen In der CSV Datei eingetragen, kann diese in ein SFTP Verzeichnis hochgeladen werden und der Purple DS Importer prüft in regelmäßigen Abständen vollautomatisch, ob eine neue csv-Datei hochgeladen oder eine bestehende aktualisiert wurde.

Voraussetzungen

Texteditor: z.B. Brackets oder Atom, nicht Software zur Tabellenkalkulation wie Microsoft Excel. Diese können bei einem Abspeichern das Dateiformat verändern, wodurch ein Import nicht mehr funktioniert.

CSV Datei:

Die Dateiendung muss *.csv sein
Einträge/Spalten werden mit einem Semikolon (;) voneinander getrennt
Die Dateikodierung muss UTF-8 sein
Über die Spaltenangabe in der ersten Zeile der CSV können Metadaten (z.B. Ausgaben- oder Publikationsname) angegeben und die Dateien (Ausgaben, zusätzliche Cover etc.) referenziert werden.
Jede nachfolgende Zeile der csv-Datei steht für eine zu importierende Ausgabe

Anleitung

1. Aufbau

Öffnet man eine CSV Datei sieht diese in der Regel wie folgt aus:

Mit der Vorschau auf einem Mac (im Finder die CSV anwählen und dann die Leertaste drücken) sieht das ganze dann so aus. In dieser Ansicht kann man die Spalten sehr viel besser erkennen.

2. Spalteninhalt

In der CSV Datei können diverse Spalten angelegt werden, die beim automatischen Import ggf. ein Cover hinzufügen oder den Preis mittels Product-ID an die Ausgabe anheften.

Folgende Spaltenbereiche sind in der Importdatei verwendbar:

Spaltenbezeichnung	Beschreibung
folder*	Die Pfadangabe zur Inputdatei (Zip oder PDF)
publication*	Der Publikationsname in App und Purple Manager
issue name*	Der Ausgabenname, wie er dem Leser angezeigt wird
publication date*	Das Veröffentlichungsdatum
team	Name des Purple Manager Teams
issue alias	Alias für Ausgaben (ggf. relevant für Tracking)
issue number	Ausgabennummern (relevant für Entitlement)
ios product	Product-ID für iOS Einzelkäufe
android product	Product-ID für Android Einzelkäufe
cover	Pfadangabe zu einem alternative Cover

(*)erforderliche Angabe

3. Format der Inhalte

3.1 Spalte: publication

Mit dieser Spalte wird festgelegt, in welcher Publikation die Datei veröffentlicht wird. Der Eintrag muss identisch zum Namen der Publikation im Purple DS Manager sein. Achten Sie auf Groß/Kleinschreibung. Bei Abweichungen scheitert der Import.

3.2 Spalte: publication date

Die folgenden Datumsformate sind erlaubt:

JJJJ-MM-TT HH:MM:SS
JJJJ-MM-TT
TT.M.JJJJ HH:MM:SS
TT.M.JJJJ
TT/MM/JJJJ HH:MM:SS
TT/MM/JJJJ

Die Angabe der Jahreszahl kann für jede der oben aufgeführten Eingabeformate um die ersten beiden Stellen gekürzt werden, also zum Beispiel von 2018 auf 18

3.3 Spalte: Cover

Wenn in der CSV Datei ein Cover angegeben ist, wird diese immer das Cover überschreiben, die der Importer standardmäßig aus der ersten Seite der angelieferten Ausgabe erzeugt.

Das Cover muss vom Dateityp "jpg/jpeg" oder "png" sein.

Für Cover empfiehlt es sich, im Upload Ordner einen eigenen Ordner namens "cover" anzulegen, in dem die Coverbilder hinterlegt werden.

Beispiel:

Für eine Ausgabe soll ein alternatives Cover importiert werden.

Die Datei ist vom Format *.jpg , heisst Coverneu.jpg und ist im Coverordner abgelegt.

In der CSV muss nun die Angabe korrekt referenziert werden. In der Spalte Cover steht somit dann:

cover/Coverneu.jpg