Provisioning Reference Guide › SPML Service › SPML Service Configuration › SPML Feed › Flow of the SPML Feed Command

Flow of the SPML Feed Command

The flow of the SPML Feed command is:

1. This command is invoked with these parameters:
   • Mapping file
   • Velocity template that produces a valid SPML request.
   • Data files to watch
   • Output file or output directory
   • Length of time to sleep between polling for file data file changes.
2. When a data file changes, the running daemon begins processing the file on the next poll.
3. The data file is locked to prevent writes.
4. The daemon reads the data file one record at a time.
   • If the mapping file has an entry mapping to the special value timestamp, that field will be retrieved from the record. If the record's timestamp is earlier than the last time the file was processed, the record has not changed and is skipped.

     Note: The timestamp should be specified in GMT time zone and YYYY-MM-DD HH:MM:SS format, such as 2006-02-14 21:02:03. If the timestamp is not in this format, or is absent, the request is skipped.

   • If the record is not skipped, it is loaded into a Velocity context and merged with the template to produce an SPML request.
   • If the mapping file does not have an entry mapping to the special value timestamp, the daemon submits all requests from the data file without exception.
5. The SPML requests are submitted to the SPML Service.
6. The response from the SPML Service is classified and appended to the appropriate output files.

The SPML Feed can use the Velocity templates created for the SPML Manager and CMDRA applications if the batchSize argument is set to 1. Ideally, you should modify templates to match SPML Feed requirements, which are less strict.