Verwenden der FTP-Batch-Bereitstellung

Product
Video Cloud
Betrifft die Rollen
Publisher, Entwickler
Version
Brightcove 5
Edition
Pro, Enterprise
Erstellt von Jessica Nutting.
FTP Batch Provisioning

Hier erfahren Sie, wie Sie Objekte mittels FTP-Batch-Bereitstellung hinzufügen oder bearbeiten können, ohne das Medienmodul in Video Cloud Studio zu verwenden. Dieses Dokument enthält Hintergrundinformationen zu XML-Grundlagen und Erläuterungen zum Vorbereiten Ihrer Objekte für den Upload, zum Erstellen der XML-Manifestdatei sowie zum Hochladen der Dateien und der XML-Manifestdatei auf den Video Cloud-FTP-Server.

Die FTP-Batch-Bereitstellung steht nur Kunden von Video Cloud Pro und Enterprise zur Verfügung. Wenn Sie Ihr Video Cloud-Konto heraufstufen möchten, nehmen Sie Kontakt mit Brightcove auf, um weitere Informationen zu erhalten.

Dieses Dokument umfasst die folgenden Abschnitte:

Welchen Nutzen bringt die FTP-Batch-Bereitstellung?

Mithilfe der FTP-Batch-Bereitstellung können Sie mehrere Videos und Wiedergabelisten gleichzeitig hochladen, aktualisieren oder löschen, indem Sie eine XML-Manifestdatei und den FTP-Server von Video Cloud verwenden. Die meisten Aktionen an Ihren Objekten und Wiedergabelisten, die Sie über das Video Cloud Studio-Medienmodul ausführen, können auch mittels FTP-Batch-Bereitstellung realisiert werden, und umgekehrt. Durch FTP-Batch-Bereitstellung ist es möglich, Videos und Wiedergabelisten zu generieren, die in der Medienbibliothek im Medienmodul angezeigt werden, sobald der Upload abgeschlossen ist. Zudem können Sie zahlreiche Objekte hochladen oder rasch mehrere Bearbeitungen vornehmen, ohne auf das Medienmodul zuzugreifen. Wenn Sie die Aktionen an Ihren Objekten dennoch lieber mit der FTP-Batch-Bereitstellungsfunktion anstelle des Medienmoduls ausführen möchten, müssen Sie in einem XML-Dokument (der XML-Manifestdatei) eine genaue Syntax, Tags und Attribute für Ihren Upload angeben, anstatt mit einer grafischen Benutzeroberfläche zu arbeiten.

Oft ziehen Publisher die FTP-Batch-Bereitstellung dem Medienmodul vor, wenn sie eine große Anzahl an Videos oder Wiedergabelisten basierend auf den Anforderungen eines Content-Management-Systems (CMS) hochladen, Einstellungen daran ändern oder sie löschen müssen oder wenn sie erstmalig ihre vorhandene Videobibliothek in die Video Cloud-Plattform integrieren möchten.

Wichtig: Falls ein Video oder eine Wiedergabeliste mit einer bestimmten Referenz-ID in Ihrem Konto bereits vorhanden ist (hinzugefügt mittels Medienmodul, Medien-API oder vorheriger FTP-Batch-Bereitstellung über eine XML-Manifestdatei), wird das Video bzw. die Wiedergabeliste mit den Informationen in der aktuellen XML-Manifestdatei aktualisiert.

Überblick über den FTP-Batch-Bereitstellungsprozess

Das folgende Flussdiagramm erläutert den Prozess für die FTP-Batch-Bereitstellung.
 
FTP-Batch-Bereitstellung – Flussdiagramm

Vergleich zwischen der FTP-Batch-Bereitstellung und dem Medienmodul

Sie können im Medienmodul mit Videos und Wiedergabelisten arbeiten, die mittels FTP-Batch-Bereitstellung hinzugefügt wurden. Beachten Sie dabei jedoch Folgendes:

  • Wenn Sie mittels FTP-Batch-Bereitstellung Änderungen an einem Video oder einer Wiedergabeliste vornehmen, werden alle im Medienmodul angegebenen Informationen überschrieben, auch wenn Sie nicht alle Informationen geändert haben. Beispiel: Angenommen, Sie haben für ein Video in Ihrem Konto bereits alle Attribute festgelegt. Wenn Sie mittels Batch-Bereitstellung die Kurzbeschreibung des Videos ändern, jedoch keine weiteren Informationen zum Video angeben, bleiben die anderen Attribute des Videos leer. Geben Sie daher beim Ändern vorhandener Videos und Wiedergabelisten mittels Batch-Bereitstellung alle entsprechenden Informationen an, nicht nur die zu ändernden Attribute. Alternativ können Sie das overlay-update-Attribut verwenden, entsprechend der Beschreibung unter dem Thema Ändern von vorhandenen Videos mit der FTP-Batch-Bereitstellung.
  • Beim Festlegen von Planungsinformationen mittels FTP-Batch-Bereitstellung muss die Start- und Endzeit in US-Pazifikzeit (PST) angegeben werden. Beim Anzeigen von Planungsinformationen im Medienmodul werden diese Zeiten automatisch in die für Ihr Benutzerprofil festgelegte Zeitzone übersetzt.

Hauptschritte für die FTP-Batch-Bereitstellung

Führen Sie die folgenden Schritte aus, um die FTP-Batch-Bereitstellungsfunktion von Video Cloud zu verwenden. Diese Schritte werden weiter unten genauer beschrieben.

  1. Lesen Sie den Abschnitt Bevor Sie beginnen mit Informationen zu den XML-Grundlagen und der erforderlichen Software.
  2. Bereiten Sie die Objekte für den Upload vor.
  3. Erstellen Sie das XML-Manifest. Im XML-Manifest werden Video Cloud alle Informationen bereitgestellt, die der Service zum Verarbeiten der hochgeladenen Videos und Wiedergabelisten benötigt.
  4. Laden Sie Ihre Objekte auf den FTP-Server von Video Cloud hoch.
  5. Laden Sie Ihr XML-Manifest auf den FTP-Server von Video Cloud hoch.

Nach Abschluss des Uploads können Sie eine E-Mail mit der Bestätigung, dass die Dateien erfolgreich von Video Cloud erhalten wurden, oder mit der Benachrichtigung über während der Übertragung aufgetretene Probleme erhalten. Unter Fehlerbehebung finden Sie Informationen zur Bestimmung von auftretenden Problemen.

Bevor Sie beginnen

Vor dem Beginn der Verarbeitung sind bestimmte Kenntnisse und Einrichtungsschritte erforderlich. So sollten Sie z. B. über grundlegende Kenntnisse über XML und über FTP-Zugriff verfügen und einen XML-Editor/Validator sowie einen FTP-Client installieren.

Eignen Sie sich XML-Grundlagenkenntnisse an

Zur Verwendung des FTP-Batch-Bereitstellungssystems von Video Cloud sollten Sie über allgemeine Kenntnisse zu XML-Grundlagen und Erfahrungen beim Erstellen von XML-Dokumenten verfügen. In den folgenden Ressourcen finden Sie grundlegende Informationen zu XML:

FTP-Zugriff

Wenden Sie sich an den Brightcove-Support und fordern Sie Hilfe von einem Kundensupport-Mitarbeiter in Bezug auf die folgenden Berechtigungen an:

  • Einstellen Ihres Kontos für die FTP-Batch-Bereitstellung 
  • Gewähren des Zugriffs auf die FTP-Server von Video Cloud

Als Alternative können Video Cloud Enterprise-Publisher eine Verbindung mit den Aspera-Servern von Video Cloud herstellen, die sichere Uploads mit einem deutlich höheren Durchsatz ermöglichen, besonders bei Uploads über große Entfernungen. Wenden Sie sich an den Brightcove-Support oder an Ihren Kontomanager zwecks Unterstützung beim Zugriff auf FTP oder Aspera.

Diese Tools müssen installiert werden

Sie benötigen einige grundlegende Softwaretools, um das FTP-Batch-Bereitstellungssystem von Video Cloud verwenden zu können:

  • Einen XML-Editor zum Erstellen der XML-Manifestdatei, die nach den Objekten hochgeladen wird. Zwei kostenlose XML-Editoren sind XML Marker und XRay; zwei weitere beliebte XML-Editoren sind Altova XMLSpy und Stylus Studio. Sie können auch einen herkömmlichen Texteditor verwenden, ein XML-Editor minimiert allerdings das Auftreten von Fehlern in Ihrer XML.
  • Ein Dienstprogramm zum Überprüfen, ob die XML gültig ist. Die meisten XML-Editoren überprüfen die XML. Sie können auch ein Dienstprogramm wie z. B. einen webbasierten W3Cs-Validierungsservice verwenden.
  • FTP-Client-Software zum Hochladen der Dateien und des XML-Manifests auf den Video Cloud-Server. FTP-Clients, die Sie verwenden können, sind z. B. WSFTP, AceFTP und CuteFTP. Außerdem ist ein FTP-Client in Windows Explorer integriert.

Vorbereiten der Objekte

Bereiten Sie Ihre Objekte folgendermaßen für den Upload auf den FTP-Server von Video Cloud vor. 

  1. Erfassen Sie die Objekte, die Sie hochladen möchten, an einer Position oder in einem System, das optimal zum Bearbeiten und Hochladen der Objekte geeignet ist. 
  2. Überprüfen Sie, ob alle Objekte die Anforderungen von Video Cloud für Objekte dieses Typs erfüllen. 
  3. Gewährleisten Sie die Kompatibilität mit den automatischen Systemen, die hochgeladene Objekte verarbeiten.
    • Gewährleisten Sie, dass die Objekte keine ungültigen Zeichen enthalten, die die Verarbeitung Ihrer Dateien beeinträchtigen. 
    • Dateinamen dürfen nur englische alphanumerische Zeichen enthalten (1-9, A-Z, a-z). 
    • Entfernen Sie die folgenden ungültigen Zeichen aus Ihren Dateinamen:
      • Nicht-englische und/oder erweiterte ASCII-Zeichen wie: é ñ å
      • Nicht druckbare Zeichen wie Leerzeichen und Tabstopps. Ersetzen Sie alle Leerzeichen durch Unterstriche. 
      • Bestimmte Satzzeichen wie: @ ! * & #. Unterstriche und Bindestriche sind zulässig. 
  4. Ermitteln Sie für jede hochzuladende Datei folgende Informationen, die in der XML-Manifestdatei enthalten sein müssen:
    • Der Video Cloud-Dateityp.
    • Eine eindeutige Referenz-ID für die Datei. Referenz-IDs sind nicht erforderlich für Videos, die über das Medienmodul oder Medien-APIs hochgeladen werden. Sie sind allerdings erforderlich für Videos, die mit der FTP-Batch-Bereitstellung mittels XML-Manifestdatei hochgeladen oder geändert werden.
    • Erstellen Sie optional zur Unterstützung bei der Fehlerprüfung für jede Objektdatei eine MD5-Prüfsumme (Hash). Weitere Informationen erhalten Sie unter Erstellen von Prüfsummen für die FTP-Batch-Bereitstellung.
    • Optional können Sie für jede Objektdatei die Dateigröße (in Byte) angeben, um die Fehlerprüfung zu erleichtern. Möglicherweise müssen Sie die Dateigröße von Kilobyte oder Megabyte in Byte umwandeln. Unter Mac OS wählen Sie zum Abrufen der Dateigröße die Datei aus und drücken „Apple + i“, oder Sie klicken mit der rechten Maustaste und wählen „Informationen“.

Erstellen der XML-Manifestdatei

Das XML-Manifest enthält alle Informationen, die für Video Cloud zum Verarbeiten des Uploads und zur Bereitstellung auf den Video Cloud-Servern erforderlich sind. Eine einzelne XML-Manifestdatei kann mehrere Videos beschreiben. Führen Sie beim Erstellen der XML-Manifestdatei die folgenden Schritte aus:

  1. Laden Sie das Beispiel-XML-Manifest für die Batch-Bereitstellung herunter, das Ihnen beim Erstellen einer eigenen XML-Manifestdatei als Ausgangspunkt dienen kann. Diese XML-Manifestdatei behandelt den häufigsten Verwendungszweck für die FTP-Batch-Bereitstellung, d. h. das Hochladen von Videos mithilfe der XML-Manifestdatei.
  2. Öffnen Sie in Ihrem XML-Editor die Beispiel-XML-Manifestdatei oder die von Ihnen erstellte Datei und verändern Sie sie abhängig von den durchzuführenden Aktionen. Unter FTP-Batch-Bereitstellung: Referenz für das XML-Manifest sind die erforderlichen Angaben und die Syntax für die XML-Tags und -Attribute enthalten, die Ihre Datei umfassen muss. Zudem finden Sie Spezifikationen für die verschiedenen Aktionen, die Sie mit der Datei ausführen können.
  3. Überprüfen Sie die XML-Manifestdatei. Im Abschnitt FTP-Batch-Bereitstellung: Referenz für das XML-Manifest können Sie eine Dokumenttypdefinition (DTD) zum Überprüfen Ihres Dokuments herunterladen.

Wie viele Videos sollte eine Manifestdatei enthalten?

Laden Sie für optimale Ergebnisse nicht zu viele Videos oder andere Objekte in eine einzelne Manifestdatei hoch. Ein einzelner Batch-Upload und die entsprechende Manifestdatei sollten nicht mehr als 5 GB an Objekten und insgesamt nicht mehr als 100 Objekte enthalten. Wenn einzelne Objekte größer als 5 GB sind, laden Sie jedes dieser Objekte in eine eigene Manifestdatei hoch.

Letzte Überprüfungen

Nachdem Sie die Vorbereitung Ihrer XML-Manifestdatei abgeschlossen haben, führen Sie eine letzte Überprüfung aus, um sicherzustellen, dass Sie mit dem Upload Ihrer Objekte und der XML-Manifestdatei beginnen können. Verwenden Sie diese Checkliste als Anleitung:

  • Sind meine Objekte korrekt benannt, ohne Leerzeichen oder ungültige Zeichen?
  • Enthält meine XML-Manifestdatei eine gültige XML ohne ungültige Zeichen? Überprüfen Sie Ihre Manifestdatei mithilfe eines XML-Validierungsdienstprogramms.
  • Sind meine Objektdateinamen in der XML-Manifestdatei korrekt angegeben, und stimmen sie mit den Objekten überein, die hochgeladen werden sollen?
  • Stimmt die Anzahl der Objekte auf der Festplatte mit der Anzahl der Objekte in meiner XML-Manifestdatei überein?
  • Wichtig: Falls ein Video oder eine Wiedergabeliste mit einer bestimmten Referenz-ID in Ihrem Konto bereits vorhanden ist (hinzugefügt mittels Medienmodul, Medien-APIs oder vorheriger FTP-Batch-Bereitstellung über ein XML-Manifest), wird das Video bzw. die Wiedergabeliste mit den Informationen in der aktuellen XML-Manifestdatei aktualisiert.

Hochladen der Objekte und des XML-Manifests

Nach dem Vorbereiten der Objekte, dem Erstellen des XML-Manifests, das die Objekte beschreibt, und der allgemeinen Überprüfung können Sie mit dem Upload der Objekte und der XML-Manifestdatei beginnen.

  1. Melden Sie sich beim FTP-Server von Video Cloud über einen FTP-Client mit der URL, dem Benutzernamen und dem Kennwort an, die Sie von einem Brightcove-Supportmitarbeiter erhalten haben.
  2. Laden Sie alle in der XML-Manifestdatei aufgelisteten Objekte hoch.
    • Beim Fortschreiten des Uploads bemerken Sie, dass Ihre Dateien kurz nach dem Hochladen auf den FTP-Server von Video Cloud aus dem Upload-Verzeichnis des FTP-Servers verschwinden. Dies ist normal, die Dateien werden in einem Stagingbereich gesichert, bis das Manifest hochgeladen ist.
    • Laden Sie die XML-Manifestdatei erst nach erfolgreichem Transfer aller Dateien hoch.
  3. Laden Sie die XML-Manifestdatei hoch.
    • Es ist wichtig, alle Objektdateien vor dem XML-Manifest hochzuladen. Ansonsten beginnt der Video Cloud-Server mit der Verarbeitung Ihrer XML-Manifestdatei. So entstehen Fehler, wenn der Server in der XML-Manifestdatei angegebene, aber noch nicht auf den FTP-Server von Video Cloud hochgeladene Objektdateien nicht findet.
    • Sie haben 48 Stunden Zeit zum Hochladen der XML-Manifestdatei, nachdem der Upload der Objektdateien abgeschlossen wurde.
  4. Wenn die Verarbeitung Ihres Manifests in Video Cloud abgeschlossen wurde, erhalten Sie eine E-Mail, die den erfolgreichen Eingang der im Manifest aufgelisteten Dateien bei Video Cloud bestätigt oder Informationen zu den während der Übertragung aufgetretenen Problemen enthält. Darüber hinaus erhalten Sie einen Benachrichtigungsrückruf an eine in Ihrer XML-Manifestdatei angegebene URL. Hinweis: Sie erhalten eine Bestätigungs-E-Mail nur dann, wenn Sie das report-success="true"-Attribut in der XML-Manifestdatei festlegen. Informationen zu den möglichen Ursachen von Problemen oder Fehlermeldungen finden Sie unter FTP-Batch-Bereitstellung: Fehlerbehebung.
  5. Melden Sie sich beim Medienmodul von Video Cloud Studio an, und bearbeiten Sie die mithilfe der FTP-Batch-Bereitstellung hochgeladenen Videos und Wiedergabelisten.
    Wichtiger Hinweis: Objekte benötigen u. U. bis zu eine Stunde zur vollständigen Weiterleitung im Netzwerk, bevor Sie zur Vorschau zur Verfügung stehen. Warten Sie eine Stunde ab, bevor Sie Ihre Objekte im Medienmodul von Video Cloud Studio ansehen.

Verwandte Themen

Zusätzlich zu diesem Dokument stellt Video Cloud weitere Dokumentationsmaterialien für die FTP-Batch-Bereitstellung in Video Cloud zur Verfügung.

Lesen Sie die folgenden Dokumente, um grundlegende Informationen über die FTP-Batch-Bereitstellung zu erhalten:

In den folgenden Dokumenten werden unterschiedliche Anwendungsweisen der FTP-Batch-Bereitstellung erklärt:

Tags
Batch, FTP, hochladen