Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Updated the sv-pagetree macro with the following parameter(s): []
Scroll ignore
scroll-pdftrue
scroll-officetrue
scroll-chmtrue
scroll-docbooktrue
scroll-eclipsehelptrue
scroll-epubtrue
scroll-htmltrue
#F0F0F0#F0F0F0

3

You can create SRs along with the Approval using the following API Request. 

To authenticate the below API, see API Authentication and Authorization.

Service NameHTTP Method
SR_LogServiceCatalog_Workflow 

POST


Code Block
themeDJango
titleSample Request
linenumberstrue
{
    "ServiceName": "SR_LogServiceCatalog_Workflow",
    "objCommonParameters": {
        "_ProxyDetails": {
            "AuthType": "APIKEY",
            "APIKey": "XXXXXXXXXXXXXXXXX",
            "ProxyID": 0,
            "TokenID": "",
            "OrgID": "1",
            "ReturnType": "JSON"
        },
        "objSRServiceTicket": {
            "LogSRForUserMode": false,
            "Org_ID": "1",
            "DelegationMode": false,
            "DelegateeUserID": 0,
            "ServiceCatalogID": 1009,
            "FirstLevelNotificationIDs": "",
            "WorkflowID": "1226",
            "HasCompleteApprovalFlow": "true",
            "ServiceCategoryName": "Desktop",
            "SupportFunction": "IT Tec",
            "ServiceCategoryID": 1,
            "ServiceCatalogName": "Multi approver",
            "WorkGroupID": 1,
            "Source": "web",
            "JustificationRemarks": "When adding a new user to the company",
            "strCustomAttributes": "\"[{\\\"Attribute_Type\\\":\\\"DropdownList\\\",\\\"Attribute_Value\\\":\\\"1509\\\",\\\"Attribute_ID\\\": 3889,\\\"Attribute_Name\\\":\\\"BuildingLocation\\\"},{\\\"Attribute_Type\\\":\\\"DropdownList\\\",",
            "\\\"Attribute_ID\\\":3890,\\\"Attribute_Name\\\":\\\"Project\\\",\\\"Attribute_Value\\\":\\\"12\\\"}]\"",
            "ListSRApprovals": [
                {
                    "NotificationIDs": null,
                    "CurrentApprover": false,
                    "ApproverID": "15",
                    "WorkflowActivityID": 2085,
                    "ApprovalLevel": "1",
                    "AllApprover": "15",
                    "LevelName": "Approver1ID",
                    "ApproverRole": "User Selectable"
                },
                {
                    "NotificationIDs": null,
                    "CurrentApprover": false,
                    "ApproverID": "0",
                    "WorkflowActivityID": 2086,
                    "ApprovalLevel": "2",
                    "AllApprover": "9,11",
                    "LevelName": "Approver2ID",
                    "ApproverRole": "Test User 1 Group Approval"
                },
                {
                    "NotificationIDs": "",
                    "CurrentApprover": false,
                    "ApproverID": "0",
                    "WorkflowActivityID": 2087,
                    "ApprovalLevel": "3",
                    "AllApprover": "11,8,4,15,3,1045,1120,1145,1075,9,11",
                    "LevelName": "Approver3ID",
                    "ApproverRole": "Workgroup Approval"
                }
            ],
            "NoOfApprovals": 3
        }
    }
}

Request Parameters

Parameter NameTypeDescriptionMandatory

LogSRForUserMode

Status
colourBlue
titleBOOLEAN

Is the SR logged for a user?

The value must always be true.

Status
colourGrey
titlefalse

Org_ID

Status
colourGrey
titleinteger

Unique Identification number of the Organization.

Status
colourGreen
titletrue

DelegationMode

Status
colourBlue
titleBOOLEAN

Is the delegation enabled?

Status
colourGrey
titlefalse

DelegateeUserID

Status
colourGrey
titleinteger

Unique Identification number of the user who is delegated with.

DelegateeUserID is a mandatory parameter if the DelegationMode parameter value is true.

Status
colourGrey
titlefalse

ServiceCatalogID

Status
colourGrey
titleinteger

Unique Identification number of the Service Catalog.

Note:

It is mandatory to provide either ServiceCatalogID or ServiceCatalogName value.

Status
colourGreen
titletrue

ServiceCatalogName

Status
colourGreen
titleString

Name of the Service Catalog.

Status
colourGreen
titletrue

If ServiceCatalogID value is provided then it is not mandatory.

FirstLevelNotificationIDs

Status
colourGreen
titleSTRING

Notification IDs of the first level Approvals.

Status
colourGrey
titlefalse

WorkflowID 

Status
colourGrey
titleinteger

Unique Identification number of the Workflow.

Status
colourGreen
titletrue

HasCompleteApprovalFlow

Status
colourGreen
titleString

Is the Request has complete Approval workflow?

The value must be true.

Status
colourGrey
titlefalse

SupportFunction 

Status
colourGreen
titleString

Name of the Instance.

For Example: Info

Status
colourGreen
titletrue

ServiceCategoryID

Status
colourGrey
titleinteger

Unique Identification number of the Service Category.

Note:

It is mandatory to provide either ServiceCategoryID or ServiceCategoryName value.

Status
colourGreen
titletrue

ServiceCategoryName

Status
colourGreen
titleString

Name of the Service Category.

Status
colourGreen
titletrue

If ServiceCategoryID value is provided then it is not mandatory.

WorkGroupID

Status
colourGrey
titleinteger

Unique Identification number of the Work Group.

Note:

It is mandatory to provide either WorkGroupID or WorkGroupName value.

Status
colourGreen
titletrue

WorkGroupName

Status
colourGreen
titleString

Name of the Workgroup.

Status
colourGreen
titletrue

If WorkGroupID value is provided then it is not mandatory.

Source

Status
colourGreen
titleString

Name of the Source.

Status
colourGrey
titlefalse

JustificationRemarks

Status
colourGreen
titleString

Specify the Remarks.

Note: It depends upon the Tenant level configuration. If you make it mandatory in Tenant level then it is True. 

Status
colourGreen
titletrue

strCustomAttributes

Status
colourGreen
titleString

Custom Attributes of the SR.

Status
colourGrey
titlefalse

ListSRApprovals 

Status
colourGreen
titleString

Details of the Approvals.

Status
colourGreen
titletrue

NoOfApprovals 

Status
colourGreen
titleString

Number of Approvals that are specified in the ListSRApprovals.

Status
colourGreen
titletrue

Code Block
themeDJango
titleSample Response
linenumberstrue
{
    "Errors": "",
    "Message": null,
    "Output": "",
    "TokenID": "",
    "OrgID": 0,
    "OutputObject": {
        "CatalogDet ails": {
            "Message": "Successfully saved the service request. Service Request ID: SR3489",
            "SRId": "3489",
            "UploadControlUID": []
        }
    }
}

Status and Error Codes

For more information, see Status and Error Messages.

Scroll ignore
scroll-pdftrue
scroll-officetrue
scroll-chmtrue
scroll-docbooktrue
scroll-eclipsehelptrue
scroll-epubtrue
scroll-htmltrue
1

| |