This topic includes additional information about adding complete BP line items.
Interface
This interface can be extended with additional data elements. In order for Unifier to recognize those elements, the data element name has to match those created in uDesigner for this business process.
YTB/AFC
If the tags YTB or AFC are present in the line items, Unifier processes these tags. If they are not present, Unifier will check the uDesigner BP setup configuration for Cost Adjustment. If this field has been set, the line item amount is treated as YTB/AFC and processed.
To add a line item to company level BP record then send null for projectNumber parameter. If you send a project number for a BP that is at Company level then you will get an error that BP name is not correct.
Attachments
Attachments can be added to line items.
Files can be sent as a single zipped file or individual files for the complete transaction record, the same file can be referenced multiple times in the same transaction. However, files contained in the zip file should still be described by separate attachment elements.
API
This API requires Integration Design to be published in uDesigner for the business process.
Attachment elements specified as part of upper form data will be ignored by this API.
Attachment file cross references is not supported. The reference sub element under attachments should always have the value ‘No’.
Adding attachments is optional. If attachment elements are not provided, then the API behaves exactly like addBPLineItem API.
Note: This API is not compatible with non Java web services client platforms.
Total attachment size per request across all files is limited to 250 MB. It is recommended that files are compressed into 1 zip file for submission to the API.
This service can be used for both Project (Standard) and Shells of cost code type CBS and Generic.
The following XML tag <_refnum> </refnum> should be added under BP line item tag <_bp_lineitem> </bp_lineitem> to support the ability to import the line items for General Spends and Payment Applications.
This service can be used to add lines to Payment Applications and General Spends type of business process. When adding lines to Payment Applications type of business process, existing lines if any will be removed and new lines will be added that are provided as part of the service call. For General spends line will be appended like any other business process.
Adding Complete BP Line Item for Document type BP with Folder Structure
You can add additional line items (including a document) into a particular folder in the Document Type BP with folder structure for an existing, or new, BP record.
- The tag <folder_path> specifies the path of the folder for the line item. This tag already exists in the current input XML for Document Type BP with folder structure.
- The folder path (<folder_path>) contains the names of the folders.
- If the folders mentioned in the folder path do not exist, then the folders are created and the line items are added to the last folder mentioned in the folder path.
- If the folder names already exist, then the line items are created under the last folder mentioned in the path.
- The Input integration XML contains the tags, as part of bp_lineitems elements.
- The syntax of the entry for the <folder_path> field is: “/<Folder Name1>/”
- If you create the line items under the root node, then the valid inputs within the tag are either “/” or blank.
- If the folder path is blank, then the line item is created at the root node “Attachments” and the folder name will be “Attachments”.
- If the line items have attachments in the <_attachment> elements, then the line items are added to the respective folder.
When the folders are being created through Web Services, the validations (in web interface of Unifier) are completed during the naming of the folders. You can enter non-ASCII characters as folder names. For example, you can enter Chinese characters as folder names in the folder path.
Behavior Specific to Summary Payment Application SOV Type BPs
Note: The information is applicable to Base Commit, Change Commit, and Payment Application Business Processes of Summary Payment Application SOV Type BPs.
For more details about XML tags, see Create and Add Methods in the Create BP Record (Additional Information) section.
Note: You can use this method to add line items to a BP record that does not have any line items. If a record already has the SOV line items that existed at the time of the record creation, then new line items cannot be added. If the call is started, then the system generates an error message.