Modified File

The ModifiedFileRequest is a new request type in DAM Server version 5.0. ModifiedFileRequest is a type of request made by a vendor to obtain a list of physical files that have been modified within a certain date range. If a PDF for an Asset is updated, but no Asset metadata is updated, that Asset will not be included in an AssetMetadataRequest.

The ModifiedFileRequest has a required fileType attribute to specify what type of files to get a list for. Generally, this is the file extension -- currently only "pdf" is supported. The ModifiedFileRequest also has 2 child elements, StartDate (required) and StopDate (optional). If the StopDate is omitted, the current date and time will be used. Every file of the requested type that the vendor has permission to is filtered against the input StartDate (inclusive) and StopDate (exclusive if included in request). Files that match the criteria are added to the response which includes these elements: AssetId, FileName, and LastModified

Request / Response Examples

ModifiedFileRequest Example:

<?xml version="1.0"?>
<!DOCTYPE DAMRequest SYSTEM "https://haldms.halleonard.com/dam_dtd/DAMRequestVersion5.dtd">
<DAMRequest>
    <RequestHdr>
        <DAMVersion>5.0</DAMVersion>
        <VendorId>123</VendorId>
        <VendorKey>theKey123</VendorKey>
    </RequestHdr>
    <ModifiedFileRequest fileType="pdf">
        <StartDate>2015/11/26</StartDate>
        <StopDate>2015/12/17</StopDate> <!-- optional end date -->
    </ModifiedFileRequest>
</DAMRequest>

ModifiedFileResponse Example:

<?xml version="1.0"?>
<!DOCTYPE DAMResponse SYSTEM "https://haldms.halleonard.com/dam_dtd/DAMResponseVersion5.dtd">
<DAMResponse>
    <ResponseHdr>
        <DAMVersion>5.0</DAMVersion>
        <VendorId>123</VendorId>
    </ResponseHdr>
    <ModifiedFileResponse>
        <ModifiedFile>
            <AssetId>1234</AssetId>
            <FileName>HL_DDS_0000000000074222.pdf</FileName>
            <LastModified>2015/12/7</LastModified>
        </ModifiedFile>
        <ModifiedFile>
            <AssetId>1412</AssetId>
            <FileName>HL_DDS_0000000000078731.pdf</FileName>
            <LastModified>2015/12/7</LastModified>
        </ModifiedFile>
        <ModifiedFile>
            <AssetId>35854</AssetId>
            <FileName>HL_DDS_0000000000088858.pdf</FileName>
            <LastModified>2015/12/7</LastModified>
        </ModifiedFile>
        ...
        <StatusCode>1</StatusCode>
        <StatusDescription>OK.</StatusDescription>
    </ModifiedFileResponse>
</DAMResponse>