Uploading content to FlickRocket is quite easy using either the FlickRocket Content Tools or the web based uploader.
But what do you do if you want to upload hundreds or thousands of content items? Well, for that case the uploading process can be automated. How this works and what to consider when doing so is something I want to explain in this post.
The batch file and FlickRocket Content Tools
Batch uploading is done via a regular batch file which repeatedly (once for every product) starts the FlickRocket Content Tools with the following two parameters:
- 1st parameter: Path to the location for the XML file which defines the product and points to the actual content items to be uploaded.
- 2nd parameter: “-silent” makes sure the uploader terminates itself after the job completion to be ready to process the next upload.
A typical batch file which uploads two products would look as follows:
echo start batch > Uploadbatch.log
"%LOCALAPPDATA%\flickrocket content tools\bin\FlickRocketContenttools.exe" "%~dp0Upload.xml" -silent
echo Uploader Error code: %errorlevel% for Upload.xml >> Uploadbatch.log
"%LOCALAPPDATA%\flickrocket content tools\bin\FlickRocketContenttools.exe" "%~dp0Upload_2.xml" -silent
echo Uploader Error code: %errorlevel% for Upload_2.xml >> Uploadbatch.log
The echo lines are only there to create a log file about the upload process. You can leave them away but they are typically very helpful.
The other thing you probably notice is the “%~dp0” preceding the file name of the XML file. It is replaced with the current path of the batch file and so the lines above assume that the xml files exist in the batch of the batch file. However, it could be any other path also.
Now, the most complex part is the XML file which defines the process. Besides the actual files to be uploaded if contains virtually all the information about the related product creation.
Note: It is strongly recommended to put in all the data about the product at this time as this way you save a lot of work which otherwise you have to do manually later.
You can download a sample XML with comments about the nodes from this link and in case you use Attributes you can download the additional Attributes XML from this link. It is commented and should be fairly self-explanatory.
If an upload fails, an error code from the following list is reported:
|0||No error||Everything went well.|
|-1||Update error||Uploader cannot continue because it requires an update|
|-2||Failed||A generic error occured|
|-3||Cancelled||The process was cancelled by the user|
|-4||Account upgrade required||An account upgrade is required. Proabably the current account type has ready a limitation|
|-5||Project already exists||A product with identical name and version already exists|
|-6||Crash||The uploader crashed and no more infromation is available. If this happens repeatedly, please contact support.|
|-7||Invalid file||The file path (movie, cover, pictures) specified for upload is invalid|
|-8||Invalid XML||The XML files contains errors. It cannot be parsed or not all required information exists.|
|-9||Product not found||The (existing) product which is referenced in the XML does not exist|
|-10||Name too long||The name for the product is too long|
|-11||Description too long||The description for the product is too long|
|-12||No name / No description||No name and/or description exists in the XML|
|-13||Content type mismatch||The content to be uploaded is not of the same type as the existing content. e.g. this would happen if you upload an HD file for an SD file or a PDF for a video.|
|-14||No source file||The file to be uploaded could not be accessed.|
Note: If no error is returned and the Uploader just displays “Please wait”, this typically means that the XML file couldn’t be accessed.