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:

<?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-Metadaten Beschreibung

Source Pflichteingabe. Wenn die Quelle für Ihre Videodatei nicht angegeben wird, ist die XML-Datei ungültig. Ihr Upload wird fehlschlagen.

title Standardmäßig verwendet das System den ursprünglichen Dateinamen. (Optional)

description Geben Sie eine kurze Beschreibung für das Video ein. (Optional)

keywords Sie können mehrere Schlüsselwörter eingeben, falls gewünscht. (Optional)

reference Um 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)

customMetadata Bearbeiten 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.

groupId Geben 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)

securityPolicyId Geben 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.

download Sie können die Download-Freigabe über das Element <download/> aktivieren. (Optional)

delete Geben 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).

<?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:

Eigenschaft	Beschreibung
reference	Dies 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.
jobReference	This 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>