XML Beispieldatei
  • 21 Mar 2025

XML Beispieldatei


Artikel-Zusammenfassung

XML Beispieldatei

Beispiel

Stellen Sie sicher, dass Ihre XML-Datei dem Schema in der unten stehenden Beispieldatei entspricht.

<?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 Property-Tags

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

Video-Metadaten

Beschreibung

source

Obligatorisch. 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 entsprechen denen, die in Ihrer Videoliste angezeigt werden (Hochladedatum, Kategorie usw.). (Optional)

channels

Weisen Sie Ihr Video einem Channel zu, indem Sie eine oder mehrere Channel-IDs angeben. (Optional) Wenn Sie Ihr Video keinem Channel zuordnen möchten, müssen Sie diesen Tag vollständig entfernen, da sonst der Upload fehlschlägt.

groupId

Geben Sie die ID der Benutzergruppe an, der das Video zugewiesen werden soll. Wenn keine Kennung zugewiesen wird, wird das Video automatisch der Standardgruppe zugewiesen. (Optional)

securityPolicyId

Geben Sie die Kennung der Sicherheitsrichtlinie an, die auf Ihr Video angewendet werden soll. (Optional)

release

Geben Sie den Freigabestatus des Videos über diesen Tag an. (Optional) Für weitere Informationen siehe unten

download

Sie können die Download-Freigabe über diesen Tag aktivieren. (Optional)

delete

Sie können die Download-Freigabe über diesen Tag aktivieren. (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 des Datei-Ingests erhalten sollen. Der Uploader erhält standardmäßig immer Benachrichtigungen. (Optional) Bei folgenden Fehlern werden Benachrichtigungen versendet: Videodatei 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 diesen Tag, um zu verhindern, dass das System Videodateien und Standbilder nach der Verarbeitung automatisch vom FTP-Server löscht. (Optional) Beachten Sie, dass alle Dateien unabhängig vom disableAutoDelete-Tag nach 30 Tagen automatisch gelöscht werden.

XML Schema

Wir überprüfen alle hochgeladenen XML-Dateien 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:

Property

Beschreibung

reference

Dies ist derselbe Verweis wie in der XML-Datei der Eingabemetadaten definiert. Sie können dies verwenden, um Eingabe- und Ausgabedateien in Ihrer Integration abzugleichen.ur integration.

jobReference

Dies ist ein interner Verweis auf die Verarbeitungsaktionen, die an der Videodatei vorgenommen wurden. Sie müssen diesen Wert angeben, wenn Sie sich zur Fehlerbehebung an movingimage Professional Services wenden.oting.

video id

Die Video-ID, die dem hochgeladenen Video zugewiesen wurde. Wenn das Video nicht im VideoManager Pro erstellt werden konnte, wird dieser Wert nicht angezeigt.

Hinweis

Erfolgs- oder Fehlermeldung

Die Datei <video_filename>.xml ist nur eine Überprüfung der Metadaten. Die Videodatei selbst wird vor der Transcodierung weiter geprüft; eine Erfolgsmeldung in <video_filename>.xml garantiert nicht, dass die Videodatei selbst transcodiert 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>


War dieser Artikel hilfreich?