- 21 Mar 2025
- Drucken
XML Beispieldatei
- Aktualisiert am 21 Mar 2025
- Drucken
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>