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