Download Handbuch

 

 

EN

Damit Ihr Upload erfolgreich ist, muss Ihre XML-Datei unserem internen Schema entsprechen. Formatieren Sie Ihre XML-Datei entsprechend dem Schema in der unten stehenden Beispieldatei.

Beispiel einer XML-Eingabedatei

Um sicherzustellen, dass Ihr Upload und die Validierung der Metadaten erfolgreich sind, müssen Sie Ihre XML-Datei ähnlich wie die unten stehende Datei formatieren:

Sample XML file 
<?xml version="1.0" encoding="UTF-8" ?>
<job xmlns="http://schemas.video-cdn.net/vmpro/public/v1/ingest/ftp/job.xsd" reference="abc">
    <title>FtpImportMetaData</title>
    <description>Lorem ipsum dolor sit amet, consectetur adipiscing
elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi
ut aliquip ex ea commodo consequat.</description>
    <channels>
        <id>3054</id>
    </channels>
    <keywords>
        <keyword>summer</keyword>
        <keyword>autumn</keyword>
    </keywords>
    <customMetadata>
        <field name="production company">MGM</field>
    </customMetadata>
    <source>
        <file>video001.mp4</file>
    </source>
    <actions>
        <release>
            <publish>
                <period>
                    <begin>2019-07-01T09:00:00+02:00</begin>
                    <end>2019-08-01T09:00:00+02:00</end>
                </period>
            </publish>
            <download/>
        </release>
        <delete>
            <time>2019-08-02T09:00:00+02:00</time>
        </delete>
    </actions>
    <still>
        <file>Chysathemum.jpg</file>
    </still>
    <groupId>2233</groupId>
    <securityPolicyId>950</securityPolicyId>
    <inform>
        <email>employee.name@company.com</email>
    </inform>
    <ingestActions>
        <disableAutoDelete>source</disableAutoDelete>
        <disableAutoDelete>still</disableAutoDelete>
    </ingestActions>
</job>



Verfügbare Eigenschafts-Tags

Die folgenden Tags sind in der XML-Datei zulässig.

Video-MetadatenBeschreibung
SourcePflichteingabe. Wenn die Quelle für Ihre Videodatei nicht angegeben wird, ist die XML-Datei ungültig. Ihr Upload wird fehlschlagen.
titleStandardmäßig verwendet das System den ursprünglichen Dateinamen. (Optional)
descriptionGeben Sie eine kurze Beschreibung für das Video ein. (Optional)
keywordsSie können mehrere Schlüsselwörter eingeben, falls gewünscht. (Optional)
referenceUm die Zuordnung von Importdateien zu Ergebnisdateien zu verbessern, können Sie einen benutzerdefinierten Referenzwert angeben. Dieser Wert wird dann in der Ergebnisdatei zurückgegeben. (Optional)
customMetadataBearbeiten Sie benutzerdefinierte Metadaten für ein Video. Die Felder sind dieselben, die auch in Ihrer Videoliste angezeigt werden (Hochladedatum, Kategorie usw.). (Optional)
channels

Weisen Sie Ihr Video einem Kanal zu, indem Sie eine oder mehrere Kanal-IDs angeben. (Optional)

Wenn Sie Ihr Video keinem Kanal zuordnen möchten, müssen Sie diese Markierung vollständig entfernen, sonst schlägt der Upload fehl.

groupIdGeben Sie die Kennung der Benutzergruppe an, der das Video zugewiesen werden soll. Wenn keine Kennung zugewiesen wird, wird das Video automatisch der Standardgruppe "Unternehmen" zugewiesen. (Optional)
securityPolicyIdGeben Sie die Id der Sicherheitsrichtlinie an, die auf Ihr Video angewendet werden soll. (Optional)
release

Geben Sie den Freigabestatus des Videos über das <publish>-Tag an. (Optional)

Die Zeitangaben entsprechen der Norm D ISO 8601 im Format JJJJ-MM-TDThh:mm:ssTZD:

  • JJJJ = Jahr
  • MM = Monat
  • T = Beginn des Zeitelements (erforderlich)
  • hh = Stunde
  • mm = Minute
  • ss = Sekunde
  • TZD = Kennung der Zeitzone (+hh:mm oder -hh:mm)

Beispiel: 2019-07-01T09:00:00+02:00 würde das Video bei

  • 09:00 Berlin
  • 08:00 London
  • 07:00 UTC

veröffentlichen.

Wenn ein Zeitraum angegeben wird, erfolgt die Freigabe zeitgesteuert.

Beispiel : 

<release>
    <publish>
        <period>
            <begin>2019-07-01T09:00:00+02:00</begin>
            <end>2019-08-01T09:00:00+02:00</end>
        </period>
    </publish>
</release>


Wenn ein leeres Tag angegeben wird <publish/>, wird das Video sofort und ohne Zeitlimit veröffentlicht. 

Wenn Sie ein ungültiges Datum eingegeben haben (z. B. wenn das eingegebene Veröffentlichungsdatum in der Vergangenheit liegt), wird das Video ohne Veröffentlichungsstatus importiert.

downloadSie können die Download-Freigabe über das Element <download/> aktivieren. (Optional)
deleteGeben Sie das Datum an, an dem das Video automatisch gelöscht werden soll. (Optional)
still

Geben Sie an, welche Datei als Miniaturansicht für das Video verwendet werden soll. (Optional)

Die Miniaturbilddatei darf nicht größer als 10000 KB sein.

Sie müssen ein Thumbnail-Bild verwenden, wenn Sie eines im XML-Schema definieren. Andernfalls wird der Upload fehlschlagen.

inform

Geben Sie zusätzliche Personen an, die Benachrichtigungs-E-Mails über den Status der Dateiübernahme erhalten sollen. Der Uploader erhält standardmäßig immer Benachrichtigungen. (Optional)

Bei den folgenden Fehlern werden Benachrichtigungen gesendet:

  • Videodatei ist beschädigt
  • Falsches XML-Schema verwendet
  • Falscher Dateityp
  • Das System konnte die Videodatei aufgrund eines falschen Dateityps nicht prüfen
  • Fehler im Ingest-System
disableAutoDelete

Verwenden Sie diese Markierung, um zu verhindern, dass das System Videodateien und Standbilder nach der Verarbeitung automatisch vom FTP-Server löscht. (Optional)

Alle Dateien werden unabhängig vom disableAutoDelete-Tag nach 30 Tagen automatisch gelöscht.

XML-Schema

Wenn Sie Ihre XML-Datei hochladen, überprüfen wir sie anhand unseres internen Validierungsschemas (siehe unten).

Internal XML Validation Schema 
<?xml version="1.0" encoding="UTF-8" ?>
<schema xmlns="http://www.w3.org/2001/XMLSchema"
        targetNamespace="http://schemas.video-cdn.net/vmpro/public/v1/ingest/ftp/job.xsd"
        elementFormDefault="qualified">
    <element name="job">
        <complexType>
            <all>
                <element name="source" minOccurs="1" maxOccurs="1">
                    <complexType>
                        <all minOccurs="1" maxOccurs="1">
                            <element name="file" minOccurs="1" maxOccurs="1">
                                <simpleType>
                                    <restriction base="string">
                                        <minLength value="1"/>
                                        <pattern value="[^/\\]+"/>
                                    </restriction>
                                </simpleType>
                            </element>
                        </all>
                    </complexType>
                </element>
                <element name="indexVideo" maxOccurs="1" minOccurs="0">
                    <complexType>
                        <all>
                            <element name="sourceLanguage" maxOccurs="1" minOccurs="1">
                                <simpleType>
                                    <restriction base="token">
                                        <pattern value="([a-zA-Z]{2}|[iI]-[a-zA-Z]+|[xX]-[a-zA-Z]{1,8})(-[a-zA-Z]{1,8})*"/>
                                    </restriction>
                                </simpleType>
                            </element>
                            <element name="generateSubtitle" maxOccurs="1" minOccurs="0"/>
                        </all>
                    </complexType>
                </element>
                <element name="onlineTranscoding" maxOccurs="1" minOccurs="0"/>
                <element name="title" type="string" maxOccurs="1" minOccurs="0"/>
                <element name="description" type="string" maxOccurs="1" minOccurs="0"/>
                <element name="securityPolicyId" type="int" maxOccurs="1" minOccurs="0"/>
                <element name="groupId" type="int" maxOccurs="1" minOccurs="0"/>
                <element name="keywords" maxOccurs="1" minOccurs="0">
                    <complexType>
                        <sequence minOccurs="0" maxOccurs="1">
                            <element name="keyword" type="string" minOccurs="0" maxOccurs="unbounded"/>
                        </sequence>
                    </complexType>
                </element>
                <element name="channels" minOccurs="0" maxOccurs="1">
                    <complexType>
                        <sequence minOccurs="1" maxOccurs="1">
                            <element name="id" minOccurs="1" maxOccurs="unbounded">
                                <simpleType>
                                    <restriction base="string">
                                        <minLength value="1"/>
                                        <pattern value="(([1-9])[0-9]*)"/>
                                    </restriction>
                                </simpleType>
                            </element>
                        </sequence>
                    </complexType>
                </element>
                <element name="customMetadata" minOccurs="0" maxOccurs="1">
                    <complexType>
                        <sequence minOccurs="0" maxOccurs="1">
                            <element name="field" minOccurs="0" maxOccurs="unbounded">
                                <complexType>
                                    <simpleContent>
                                        <extension base="string">
                                            <attribute name="name" type="string"/>
                                        </extension>
                                    </simpleContent>
                                </complexType>
                            </element>
                            <element name="select" minOccurs="0" maxOccurs="unbounded">
                                <complexType>
                                    <simpleContent>
                                        <extension base="string">
                                            <attribute name="name" type="string" use="required"/>
                                        </extension>
                                    </simpleContent>
                                </complexType>
                            </element>
                            <element name="multiselect" minOccurs="0" maxOccurs="unbounded">
                                <complexType>
                                    <sequence minOccurs="1" maxOccurs="unbounded">
                                        <element name="option" type="string" minOccurs="1" maxOccurs="unbounded"/>
                                    </sequence>
                                    <attribute name="name" type="string" use="required"/>
                                </complexType>
                            </element>
                        </sequence>
                    </complexType>
                </element>
                <element name="actions" minOccurs="0" maxOccurs="1">
                    <complexType>
                        <sequence minOccurs="0" maxOccurs="1">
                            <element name="release" minOccurs="1" maxOccurs="1">
                                <complexType>
                                    <sequence>
                                        <element name="publish" minOccurs="0" maxOccurs="1">
                                            <complexType>
                                                <sequence minOccurs="0" maxOccurs="1">
                                                    <element name="period" minOccurs="1" maxOccurs="1">
                                                        <complexType>
                                                            <sequence>
                                                                <element name="begin" type="dateTime" minOccurs="1"
                                                                         maxOccurs="1"/>
                                                                <element name="end" type="dateTime" minOccurs="1"
                                                                         maxOccurs="1"/>
                                                            </sequence>
                                                        </complexType>
                                                    </element>
                                                </sequence>
                                            </complexType>
                                        </element>
                                        <element name="download" minOccurs="0" maxOccurs="1" fixed=""/>
                                    </sequence>
                                </complexType>
                            </element>
                            <element name="delete" minOccurs="0" maxOccurs="1">
                                <complexType>
                                    <sequence>
                                        <element name="time" type="dateTime" minOccurs="1" maxOccurs="1"/>
                                    </sequence>
                                </complexType>
                            </element>
                        </sequence>
                    </complexType>
                </element>
                <element name="ingestActions" minOccurs="0" maxOccurs="1">
                    <complexType>
                        <sequence>
                            <element name="disableAutoDelete" minOccurs="1" maxOccurs="2">
                                <simpleType>
                                    <restriction base="string">
                                        <enumeration value="still"/>
                                        <enumeration value="video"/>
                                        <enumeration value="source"/>
                                    </restriction>
                                </simpleType>
                            </element>
                        </sequence>
                    </complexType>
                </element>
                <element name="still" minOccurs="0" maxOccurs="1">
                    <complexType>
                        <sequence>
                            <element name="file" type="string"/>
                        </sequence>
                    </complexType>
                </element>
                <element name="inform" minOccurs="0" maxOccurs="1">
                    <complexType>
                        <sequence minOccurs="1" maxOccurs="1">
                            <element name="email" type="string" minOccurs="1" maxOccurs="unbounded"/>
                        </sequence>
                    </complexType>
                </element>
            </all>
            <attribute name="reference" type="string"/>
        </complexType>
    </element>
</schema>

Beispiel einer XML-Ausgabedatei

Die Datei <video_filename.xml> enthält einige wichtige Werte:

EigenschaftBeschreibung
referenceDies ist derselbe Verweis, der in der XML-Datei der Eingabemetadaten definiert ist. Sie können dies verwenden, um Eingabe- und Ausgabedateien in Ihrer Integration abzugleichen.
jobReferenceThis is an internal reference to the processing actions taken on the video file. You must include this value when contacting movingimage Professional Services for troubleshooting.
video id
Die Video-ID, die dem hochgeladenen Video zugewiesen wurde. Wenn die Videoeinheit nicht in VideoManager Pro erstellt werden konnte, wird dieser Wert nicht angezeigt.

Die Datei <video_filename>.xml dient nur der Validierung der Metadaten. Die Videodatei selbst wird vor der Transkodierung weiter geprüft; eine Erfolgsmeldung in <video_filename>.xml garantiert nicht, dass die Videodatei selbst transkodiert werden kann.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<result fileName="myVideo.mp4" reference="MyReference" jobReference="123abc45-abcd-67ef-89ab-1234ab567890" xmlns="http://schemas.video-cdn.net/vmpro/public/v1/ingest/ftp/result.xsd">
    <success>
        <videoTitle>My Video</videoTitle>
        <video id="ABcd1234efGH5678jk90ab"/>
    </success>
</result>