SAP JCo Uploader Agent

This section provides an overview of the SAP JCo Uploader agent, which serves as a forwarding agent within batch workflow configurations. The SAP JCo Uploader transmits records to SAP Convergent Invoicing (SAP CI) using the JCo protocol.

Within the workflow, the SAP JCo Uploader agent processes CSV files containing a large number of rows (for example, 100,000 rows per file) by dividing them into sub-batches. The size of each sub-batch is specified in the SAP JCo Uploader agent configuration dialog. Once a sub-batch of records is committed, the agent proceeds to process the next sub-batch. Multiple sub-batches can also be processed simultaneously, depending on the value set for the No of Threads option in the configuration dialog.

The agent inserts states into a remote database during processing. After the entire file has been processed, this information is removed from the database. If file processing is interrupted—such as by a workflow abort or an error—the agent resumes processing from the offset where it left off. To determine this offset, the agent performs a database lookup to retrieve the list of records that have already been processed.

In the file to be sent to SAP CI, the first record specifies the RemoteFunctionCallName and FileFormat, while the remaining records contain the data. Accordingly, a HeaderUDR must be sent for the first record, and a RecordUDR must be sent for each subsequent record. For more details, see the section ‘SAP JCo Uploader Agent UDRs’, linked below.