Description
This method can be used to:
- Create new business process records in Unifier based on Integration design that has been defined in uDesigner. For more information refer to uDesigner Administrator Guide.
- Create group line items together. You can assign a group name to provide the context of the line items.
If you want to create a BP record with line item information, then you must use this service. If this is a cost related BP, line items will be rolled up to the cost sheet.
Note: When you a create record through a web service, and you want to send the newly created record with a record number (record_no) value to Unifier, to avoid duplicating record numbers, do not include a value for the next record number because the value has already been configured in the BP setup. You can only enter a value in the record number (record_no) field, if you are getting the value from an external system, or you are self-generating a value, and the value does not fall into the same sequence number pattern as set in the BP setup. In this scenario, when you are sending the record number (record_no) value to Unifier, it is important to know that providing a unique record number (record_no) value is your responsibility.
Support
This process supports all type of BPs
Installation: ASP and Self host
Level | Yes or No |
|---|---|
Company Level | Yes |
Project and Shell Level | Yes |
Prototype
public XMLObject createBPRecord(String shortname, String authcode, string projectNumber, String BPName, String BPXML );
Parameters
Parameter | Description |
|---|---|
shortname | identifier of the company, company’s short name |
authcode | authentication key for the company, in text string |
projectNumber | Identifier of the project or shell in Unifier. If you want to create a BP record at Company level then pass null for this parameter. |
BPName | Identifier of the business process in Unifier, for example: Invoice. This is case sensitive, and should be the name as given in uDesigner |
BPXML | identifier for BP content in XML format |
BPXML Elements
The elements that include as part of BPXML parameters is dependent on the Integration interface design of your BP in uDesigner. XML format can be exported (downloaded) from uDesigner. Elements with direction marked as "Input" or "Both" will be part of XML format.
Note that elements lists should be send based on the type of BP and your design in uDesigner.
Following a list of elements that can be included as part of integration design in uDesigner and behavior when you include them. Note that elements lists should be sent based on the type of BP for which you are creating a record.
Tag Name | BP Type | Description |
|---|---|---|
<amount> | Cost | Amount is a required field if you are sending line item information under _bp_lineitems. You will see same value on Unifier. |
<CBS_code> | Cost | CBS Code is a required field if you are sending line information under _bp_lineitems. |
<status> | Any | a) If BP uses a status field then you can send status tag. b) If the BP is a workflow based then the record will be created and will stay in the initial status that is valid. User has to go through remaining workflow process. c) If it is non-workflow based then the message can send a valid status and the record will take that status. If there is only one status defined for the BP then by default that status will be picked even if user sends a wrong status value. |
<record_no> | Any | You can send record number by using this tag. If you do not specify a record_no tag as part of message then a new record will be created. Unifier will assign a record number. If you specify a record_no then system will create a record with the given record number. If the record number is a duplicate number then an error message will be send back as response. If the record_no is specified and if it does not exists then a new record will be created. |
<_comment> | Text BP | Enter the responses (comments) associated with the BP record. |
<li_group_name> | All BPs that support Summary line items other than Summary Payment Application BPs of Base Commit, Change Commit and Payment Applications. | Use to specify group name. |
Return Value
See Return Values. This is dependent on which WSDL you are going to use.
If you use WSDL –1 then you should expect XMLObject as return value.
If you use WSDL – 2 then you should expect XMLFileObject as return value.