Using Drop & FTP Service for VMS

Drop Service

The Drop service allows for the seamless transfer of files from the internal (in-house) system to Erstream VMS. The folder structure within the drop folder follows this format:

/BasePath/CustomerAlias/TemplateAlias(ftp)/

The operation consists of multiple states, with the defined parameters from the introduction phase being utilized:

When the media file arrives:

• In this case, every file present in the drop folder is processed.
• The file name is considered a unique ID. In other cases, VMS automatically assigns a unique ID.

When XML/JSON arrives:

• In this case, a JSON or XML file is expected within the drop folder.
• Only one content can be assigned for each JSON or XML.
• The content is processed based on the data provided in the JSON file.

To enable the Drop service, the machine hosting the service must have Nginx or another web service installed. All workers should have access to this server. After the worker retrieves the content from the Drop service, it sends a delete request to remove the content.

The Drop service must be available in the FTP API service on the FTP service machines.

Example JSON format for Drop service:

{
    "Contents": [
        {
            "Name": "Default Import",
            "SourceUrl": "http://url1_without_ticket",
            "ContentType": "VIDEO_AUDIO"
        },
        {
            "Name": "Default Import",
            "UniqueId": "UniqueId. can be null",
            "ReferenceId": "like cms id. can be null",
            "Description": "Description",
            "SourceUrl": "http://url1_without_ticket",
            "ContentType": "VIDEO_AUDIO"
        }
    ]
}             

Example JSON format for Multi-audio:

{
    "Contents": [   
        {
            "Name":"test_asset_id",
            "UniqueId": null,   //if value not sent, VMS creates UniqueId  automatically.
            "ReferenceId": null,
            "ContentType": "VIDEO_AUDIO",
            "EncodedUrls":
            [
                    {
                            "FileType":"VIDEO",
                            "SourceUrl":"test_asset_video.mp4",
                    },
                    {
                            "FileType":"AUDIO",
                            "SourceUrl":"test_asset_audio_org.mp4",
                            "Default":true,
                            "Title":"org",
                            "Language":"org"
                            
                    },
                    {
                            "FileType":"AUDIO",
                            "SourceUrl":"test_asset_audio_eng.mp4",
                            "Title":"eng",
                            "Language":"eng"
                    }
            ]
        }
    ]
}

FTP Service

The FTP service follows the same logic as the Drop service. In addition to the FTP service, VMS also manages users. To set up the system, ensure that MySQL is installed locally, and provide access to the FTP machine and VMS-API.

By utilizing the Drop and FTP services, users can seamlessly transfer files from the internal system to Erstream VMS, whether through the Drop folder or FTP service, while managing parameters and accessing user management functionalities within VMS.