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:


SpaltenbezeichnungBeschreibung
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
teamName des Purple Manager Teams
issue aliasAlias für Ausgaben (ggf. relevant für Tracking)
issue numberAusgabennummern (relevant für Entitlement)
ios productProduct-ID für iOS Einzelkäufe
android productProduct-ID für Android Einzelkäufe
coverPfadangabe 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








War dieser Artikel hilfreich?

Das ist großartig!

Vielen Dank für das Feedback

Leider konnten wir nicht helfen

Vielen Dank für das Feedback

Wie können wir diesen Artikel verbessern?

Wählen Sie wenigstens einen der Gründe aus
CAPTCHA-Verifikation ist erforderlich.

Feedback gesendet

Wir wissen Ihre Bemühungen zu schätzen und werden versuchen, den Artikel zu korrigieren