» Record Save Service

METHODS

Record Save Service

This method creates a process record. The client makes a POST request providing Request body in xml format and input parameters WorkflowCode, CategoryCode, Language in the request url. The output will be an xml format. New record ID will be returned. All circumstances will be return Process Status Types and Process Message. The system will be returned operation status of web service with “ProcessStatusTypes”. The status informations is given in the following descriptions.

Name	Value
Service Type	RESTFUL / POST
Request Data Type	XML
Response Data Type	XML
Content Type	UTF-8
Authentication Types	Basic Authentication, Custom Header Authenticaton
Sample Request Endpoint	http://company.bpm.next4biz.com/RES/RecordProcessorService.svc/Save/CategoryCode/{CategoryCode}/WorkflowCode/{WorkflowCode}/language/{Language}

ProcessStatusTypes

Success
- Process finished with success
NoEntryPageForWorkflow
- Process finished with an error. The record does not occur. Workflow has no entry page (Workflow design issue).
NoWorkflow
- Process finished with an error. The record does not occur. Service workflow parameter is missing or incorrect (Workflow design issue).
NoCurrentUser
- Process finished with an error. The record does not occur. Service has no authorized user, or user has not authorized.
NoCategory
- Process finished with an error. The record does not occur. Service category parameter is missing or incorrect
NullRecord
- Process finished with an error. The record does not process. RecordID is missing or incorrect
InvalidAssignedUserForTakeownership
- Process finished with an error. The record does not process. A processed user is missing or incorrect.
InvalidAssignedUserGroupForTakeownership
- Process finished with an error. The record does not process. The processed user group is missing or incorrect.
EmptyNoteList
- Process finished with an error. The record does not process. The record has no notes.
InvalidNote
- Process finished with an error. The record does not process. Missing note/description or record notes are an invalid date range.
InvalidAssignedUserForAssignment
- Process finished with an error. The record does not assign. The processed user is missing or incorrect.
InvalidAssignedUserGroupForAssignment
- Process finished with an error. The record does not assign. The processed user group is missing or incorrect.
InvalidToState
- Process finished with an error. Record transition does not occur. Destination state is missing or incorrect
InvalidFromState
- Process finished with an error. Record transition does not occur. The initial state is missing or incorrect.
InvalidTransition
- Process finished with an error. Record transition does not occur. Transition id or code is missing or incorrect.
InvalidAssignedUserForTransition
- Process finished with an error. Record transition does not occur. User id or code is missing or incorrect.
GeneralError
- Process finished with an error. The record does not process. System returned an unexpected exception. Must be analysis by next4biz BPM technical department.
EmptyDataFields
- Process finished with an error. The record does not process. Workflow has no data fields (Workflow design issue).
InvalidCurrentUser
- Process finished with an error. The record does not process. There is no such user in the system.
InvalidBusinessChannel
- Process finished with an error. The record does not process. Service businesschannel parameter is missing or incorrect (Workflow design issue)
InvalidAssignee
- Process finished with an error. The record does not assign. Assigned user id or code is incorrect.
InvalidCategory
- Process finished with an error. The record does not occur. Service category parameter is missing or incorrect.
InvalidRecord
- Process finished with an error. The record does not process. There no record is in the system. Record ID is incorrect.
NoResUser
- Process finished with an error. The record does not process. Remote event user definition is missing or incorrect.
NoActiveResUser
- Process finished with an error. The record does not process. Remote event user definition is not active.
ClientPasswordMismatch
- Process finished with an error. The record does not process. Remote event user username or password is incorrect.
EmptyUsernameOrPassword
- Process finished with an error. The record does not process. Remote event user username or password is empty.
NoAccess
- Process finished with an error. The record does not process. A user has no auth for the specific operation. (Workflow design issue).
AuthorizedGroupsDoesNotContainUsergroup
- Process finished with an error. The record does not assign. The relevant group is not among the authorized user groups. (Workflow design issue).
UserGroupDoesNotContainUser
- Process finished with an error. The record does not assign. The relevant user is not in the user group which is required to be assigned. (Workflow design issue).
AuthorizationExpired
- Process finished with an error. The record does not process. The user has no auth for the specific record. The record may be assigned to a different user or be in a state to the user has not authorized. Please check the record history page. (Workflow design issue).
MissingMandatoryFields
- Process finished with an error. The record does not process. Please fill the all mandatory data fields in the error message. (Workflow design issue).
NoVisibleDataField
- Process finished with an error. The record does not process. The user has no auth for specific record’s fields. Please check the user record authorization. (Workflow design issue).
PageHasNoDataField
- Process finished with an error. The record does not process. The relevant page has no data field (Workflow design issue).
EmptyTransitionUserGroups
- Process finished with an error. Record transition does not occur. The list of authorized user groups for transition is empty. (Workflow design issue).
SelectedUsergroupNotAuthorizedForTransition
- Process finished with an error. Record transition does not occur. The relevant user group is not in the user groups to authorized for the transition.
UserNotMember
- Process finished with an error. Record transition does not occur. The relevant user is not a member of the user groups to authorized for the transition.
CategoryWorkflowRelation
- Process finished with an error. The record does not process. The relevant category is not related to the selected workflow. (Workflow design issue).
WorkflowHasNoRelatedCategory
- Process finished with an error. The record does not process. The relevant category list is empty for the selected workflow. (Workflow design issue).
EmptyLifeCycle
- Process finished with an error. The record does not process. The record lifecycle list is empty. Must be analysis by Opheleia technical department.

ENDPOINT DEFINITION

POST

REQUEST BODY

                                    
                                        <Fields>
  <{field_code1}>{field value}</{field_code1}>
  <{field_code1}>{field value}</{field_code1}>
  <{field_code2}>{field value}</{field_code2}>
  <{field_code3}>
    <CascadingSubField1>{Cascading Sub Field 1 Value}</CascadingSubField1>
    <CascadingSubField2>{Cascading Sub Field 2 Value}</CascadingSubField2>
    <CascadingSubField3>{Cascading Sub Field 3 Value}</CascadingSubField3>
    <CascadingSubField4>{Cascading Sub Field 4 Value}</CascadingSubField4>
  </{field_code3}>
</Fields>

RESPONSE BODY

                                    
                                        <SaveResponse xmlns="http://tempuri.org/">
    <SaveResult xmlns:a="...." >
        <a:ProcessMessage>IssueCreated Success</a:ProcessMessage>
        <a:ProcessStatus>Success</a:ProcessStatus>
        <a:RecordID>5392</a:RecordID>
    </SaveResult>
</SaveResponse>