Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

If desired, you can pre-configure metadata by uploading an XML file along with your video file. This file must contain the video source, and can also be used to specify additional properties for the video, such as which channel to upload to, still images, ownership and many more. Either way, metadata can be configured as normal in the UI after the video has been uploaded. More information can be found in the Important Notes section.

Warning

If you use an XML file, it must comply with our schema for the upload to succeed. See how to format it properly by consulting our sample file.

Connecting to the FTP server

To upload your files, use the following credentials in the command line or your FTP client:

  • FTP Server Host: ftpingest ftpingest.video-cdn.net
  • Username : Use your movingimage username followed by a colon and the VideoManager  Pro account ID you want to upload your video to (e.g. "example@movingimageexample@movingimage.com:558")
  • Password : Use your movingimage password
Info

If you do not know your account ID number, you can check your VMPro Administration Overview page under "Account details" or contact your account manager.

FTP folder structure

You will find the following folders on the FTP server:

  • Workspace: Use this folder to upload video files with a corresponding XML file and thumbnails still images (if usingdesired). They should be uploaded in this order: video file → thumbnail file → XML file. This is because the XML file is what triggers the upload.
  • Fast_lane:  Use this folder to upload video files only, without XML files or thumbnails.  
  • Output: This is where the system stores all successful uploads and files. 

After processing, files are automatically deleted from the FTP server (but not your VideoManager Pro account). You can prevent the system from doing this by editing your XML file.

Notifications

Immediately after your files are uploaded, if you supplied an XML metadata file, it is validated against the schema. At this point, the FTP processing service will generate an result file, <video_filename>.xml in the output folder. This file tells you whether the upload to the FTP server was successful or not, and if the XML metadata file could be validated.

Info

The <video_filename>.xml file is only a validation of the metadata. The video file itself will be further checked before transcoding; a success message within <video_filename>.xml does not guarantee that the video file itself can be transcoded.

If your video file passes further checks, and is passed for transcoding, you will receive a notification email. The video will then show in your VideoManager Pro account and will shortly be available for use.

Notification emails will be sent to the original uploader. You can configure additional people to be notified in the associated XML metadata file. These emails are automatically generated by the system and will inform you about the status of your upload--see   See the XML Schema and Sample XML File section for more information.

In case of error

If your upload is successful, you will receive a success email and see your videos listed in your account. your video file does not show in your VideoManager Pro account, please contact movingimage Professional Services. To assist in tracing the error, please include the jobReference and video id values from the <video_filename>.xml in the output folder:

Code Block
languagexml
themeRDark
<?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>