Document Delivery Overview Examples

About this task

The following two simple examples demonstrate how a file is delivered using the overwrite and append methods.

  • Overwrite delivery method.
  • Append delivery method.
Overwrite Delivery Method
  • Delivery Object: FTPobj
  • Method: Overwrite any existing files
  • Delivery filename: FinalDestinationFileName.txt

The content of the file to be delivered is as follows.

101 <DestinationFilename name=???FinalDestinationFileName.txt???/>
Data

Procedure

  1. This file is saved as OutputDocument1.
  2. OutputDocument1 is copied to the \Project\DocumentDelivery\FTPobj directory.
  3. The directory scanner:
    1. Finds OutputDocument1.
    2. Adds the name of this file to a preliminary list.
    3. Goes back to scanning.
  4. FTPobj:
    1. Monitors the preliminary list
    2. (When a file appears) creates a file, OutputDocument1, in the \Project\DocumentDelivery\FTPobj\Work directory.

    OutputDocument1 is the original file with the header stripped out.

    The content of the file is Data

    1. Checks the remote location to see if the file FinalDestinationFileName.txt exists in the configured remote directory.
    2. Delivers the existing OutputDocument1 document

    From the \ProjectDocumentDelivery\FTPobj\Work directory

    To the remote file DDTEMP_FinalDestinationFileName.txt.

  5. If FinalDestinationFileName.txt is found on the remote system, that file is deleted.
  6. DDTEMP_FinalDestinationFileName.txt is renamed to FinalDestinationFileName.txt. ??
  7. The delivery is complete.

    Append Delivery Method

    Delivery Object FTPobj
    Method Append existing files
    Delivery filename FinalDestinationFileName.txt

    The content of the file is as follows.

    101 <DestinationFilename name=???FinalDestinationFileName.txt???/>
    Data
  8. This file is saved as OutputDocument2.
  9. OutputDocument2 is copied to the \Project\DocumentDelivery\FTPobj directory.
  10. The directory scanner:
    1. Finds OutputDocument2.
    2. Adds the name of this file to a preliminary list.
    3. Goes back to scanning.
  11. FTPobj:
    1. Monitors the preliminary list.
    2. (When a file appears) creates a file, OutputDocument2, in the \Project\DocumentDelivery\FTPobj\Work directory.

    OutputDocument2 is the original file with the header stripped out.

    The content of the file is More Data.

    1. Checks the remote location to see if the file FinalDestinationFileName.txt exists in the configured remote directory.
    2. Finds the file that was just delivered using the Overwrite method.
    3. Retrieves the remote FinalDestinationFileName.txt from the remote system.
    4. Copies the remote file to a file DDTEMP_FinalDestinationFileName.txt in the \Project\DocumentDelivery\FTPobj\Work directory.
    5. (In the \Project\DocumentDelivery\FTPobj\Work directory) copies the contents of OutputDocument2 to the end of the DDTEMP_FinalDestinationFileName.txt file.

    The content of the file is Data More Data.

    1. Delivers the DDTEMP_FinalDestinationFileName.txt file

    From the \ProjectDocumentDelivery\FTPobj\Work directory

    To the remote file DDTEMP_FinalDestinationFileName.txt.

  12. The current FinalDestinationFileName.txt file on the remote machine is deleted.
  13. DDTEMP_FinalDestinationFileName.txt is renamed to FinalDestinationFileName.txt.
  14. he delivery is complete.