yospaceCDS can accept content uploaded by standard FTP. The option Create FTP Input Feed listed under Input Management allows you to set-up an FTP account and the other details associated with getting content ingested into a Content Group or Content Groups.
The following fields are required when setting up a new FTP Input Feed:
You can apply a variety of adjustments to the content on ingest. See our article describing these settings for more information.
You can define a mapping from a tag in the source FTP feed to a field in your metadata schema. In order for this to work for custom metadata fields you have defined yourself you need to have an FTP feed type using a customised XML format. Contact support if you need this.
To define a mapping:
namespace:tag.It is possible to set-up feed monitoring so that you are informed by email in the event a problem should develop with your feed. If there is a problem, yospaceCDS will send an email detailing the nature of the issue.
The yospaceCDS FTP can be accessed at ftp://cds1-ftp.yospace.com
Username and password will be case sensitive.
The FTP server supports both active and passive modes.
Upload your content and XML files to the root (/) directory of the FTP account. As soon as you log out of the FTP Account, yospaceCDS will examine the files you have left and put them in the library folder if they successfully parsed.
Any XML file that was not successfully parsed will be left in the root directory, consequently, any media files left in the root directory will not have been uploaded into yospaceCDS (thus indicates a missing or badly formed XML file).
If an XML file references a media file that has not been uploaded (or is incorrectly named), then this will cause your FTP Input Feed to appear Red in the Manage Inputs status screen.
The yospaceCDS FTP server will not allow more than 10 concurrent logins on a given FTP account. Some graphical FTP clients will open multiple FTP connections at once and in some circumstances may open more sessions than are permitted. Check the settings of your FTP client to see if this behaviour can be disabled or limited
Once content has been successfully parsed, it will be placed into the FTP library for that account. The FTP library contains a subdirectory for each category you have uploaded into, plus a special subdirectory called default for uncategorised uploads.
For each published item there is are up to three files, a video file, an XML file and an optional thumbnail image (an image supplied by the upload process). If the thumbnail file is not uploaded, then yospaceCDS will create its own thumbnail.
You do not have permission to delete any files in the library other than the XML files. Deleting an XML file will result in its corresponding video and thumbnail file to be removed. Some moments later it will also disappear from the Content Groups into which the item was fed.
The following is an example of a FTP account structure:
library
CATEGORY1
3177.mpg3177.jpg3177.xml3137.mpg3137.jpg3137.xmlCATEGORY2
3138.mpg3138.jpg3138.xmldefault
3139.mpg3139.jpg3139.xmllastBuildDate.txtUnlike RSS, the FTP protocol doesn't provide a standard means by which the content files are associated with useful metadata such as Title, Description, Publish Date, and so on. Therefore when ingesting content via FTP, it is necessary to also upload an associated XML file containing this additional information. Without it, yospaceCDS will not upload the content into the Content Group(s) you specify.
The format of the XML file depends on your choice of Feed Type. What is common across all types is the fact that you can upload an individual XML file for each video, or place multiple items in a single XML file. yospaceCDS will parse all uploaded files ending with .xml and look for XML fragments that match one of the XML Fragments described below depending on your choice of Feed Type
For every item of video you want to ingest into yospaceCDS, there must be an XML file containing the following XML fragment (encoded in UTF-8):
<?xml version="1.0" encoding="UTF-8"?>
<ftpUploadItem>
<uid>12345</uid>
<title>Bail-out anxiety weighs on dollar</title>
<description>Joe Schmo on the short-
and medium-term outlook of the dollar</description>
<text>Joe Schmo talks to us about what he sees as the short-
and medium-term outlook of the dollar</text>
<publishDate>Thu, 12 Jan 2009 09:00:00 GMT</publishDate>
<content mime-type="video/x-flv">12345_video.flv</content>
<thumb>12345_thumb.jpg</thumb>
<category>BUSINESS</category>
</ftpUploadItem>
Example syntax:
<CMSFEED>
<FEEDITEM TYPE="CLIP" MEDIA="VIDEO" ID="DV250908PG1200" SORTORDER="100">
<TITLE>Sep 25: Bail-out anxiety weighs on dollar</TITLE>
<DESCRIPTION>Peter Garnham on the dollar's short and
medium term outlook</DESCRIPTION>
<VALIDTIME TZ="ET" >Thu, 25 Sep 2008 09:57:12 GMT</VALIDTIME>
<IMAGE USE="SMALLTHUMB">DV250908PG.jpg</IMAGE>
<STREAM FORMAT="FLV" BITRATE="1200">DV250908PG_1200.flv</STREAM>
<KEYWORDS>Daniel Garrahan , DV250908PG.flv ,</KEYWORDS>
</FEEDITEM>
</CMSFEED>
It is possible to set-up more than one FTP Input Feed with the same account. This is useful if the CMS that is sending content to yospaceCDS cannot differentiate content categories by feeding into different FTP accounts. For example, you have a single FTP account setup for all news videos, say meganews-ftpfeed and you have XML metadata indicating which news category each video should be in (for example, World News, Financial News, Entertainment News, etc). FTP Input Feed category filtering allows you to feed specific Content Groups based on the XML category metadata provided.
For the example given above, it would be necessary to create multiple FTP Input Feeds all with the same FTP Username and Password but set the Category field in each FTP Input Feed set-up to the corresponding value that will appear in the XML Metadata supplied. For example, WORLD, FINANCIAL, ENTERTAINMENT, etc. Each FTP Input Feed would then be set-up to feed into its own specific Content Group. If you wanted to maintain a Content Group containing a superset of all categories, then you would need to set-up each FTP Input Feed to feed into its specific group and the superset group.
When working with categories, please bear the following in mind: