Request_Submit_Service
Use the Request_Submit_Service function to create and submit service requests. The following tables list the values required to submit a service request through the SRM:RequestInterface_Create form.
Service requests generated from the Request_Submit_Service function are validated against On Behalf Of (OBO) rules. To use this function, an administrator must configure an OBO rule so that the Requested By user can submit a service request on behalf of the Requested For user. For information about configuring OBO rules, see Creating on-behalf-of definition rules.
Important
Service request definitions (SRDs) that have questions associated with them are not currently supported because no mechanism exists to gather the responses to questions through the web service interface.
The following table lists the required fields if you are using web services or an interface form. A record is not created if the required field values are NULL.
Web service field | Database field on interface form | Notes |
|---|---|---|
Company | Company | |
TitleInstanceID | TitleInstanceID | Instance ID of the service to be requested. An interface must be built for users to easily obtain this value from the SRD. |
Source_Keyword | Source Keyword | Enter Interface Form or something similar to describe the creation origin. |
Login_ID | Login ID | |
Add_Request_For | Add Request For: | The interface form has the following attributes for the Requested For field on the interface form:
|
Impact | Impact | The interface form has the following attributes for the Impact field on the interface form.
|
Urgency | Urgency | The interface form has the following attributes for the Urgency field on the interface form.
|
Status | Status | The interface form has the following attributes for the Status field on the interface form.
|
AppRequestSummary | AppRequestSummary | The Title of the SRD must be passed through the AppRequestSummary field of the web service. The Summary field on the service request stores this value. |
The following table lists optional input field values. These fields are not required to create an entry.
Web service field | Database field on interface form |
|---|---|
Details | Details |
Status_Reason | Status Reason |
Middle_Name | Middle Name |
Phone_Number | Phone Number |
Internet_E-Mail | Internet E-Mail |
Organization | Organization |
Department | Department |
z1D_WorkInfoDate | z1D_WorkInfoDate |
z1D_WorkInfoCommunicationSource | z1D_WorkInfoCommunicationSource |
z1D_WorkInfoSummary | z1D_WorkInfoSummary |
z1D_WorkInfoDetails | z1D_WorkInfoDetails |
The following table lists the fields set by workflow. Input fields (required and optional) trigger the workflow to generate the values in the fields. When you use web services, these fields are not exposed.
Web service field | Database field on interface form | Field value | Notes |
|---|---|---|---|
Short_Description | Short Description | "." | |
Source Keyword | Web Service | ||
Submitter | $USER$ | ||
Submitter | login_ID | ||
z1D_Action | z1D Action | CREATE | |
Summary | OfferingTitle | Filled in with "SRD Title" | |
Impact | Impact | 3-Moderate/Limited | |
Urgency | Urgency | 3-Medium | |
Status | Status | Draft | |
Requested For | Add Request For: | Individual | |
Login ID | $USER$ | ||
Categorization_Tier_1 | Categorization Tier 1 | Filled in from Navigation Categories - Category 1 field on SRD | |
| Categorization_Tier_2 | Categorization Tier 2 | Filled in from Navigation Categories - Category 2 field on SRD | |
| Categorization_Tier_3 | Categorization Tier 3 | Filled in from Navigation Categories - Category 3 field on SRD | |
Submitter | $USER$ | ||
Request Type | Standard | ||
First_Name | First Name | Filled in from Login ID | |
Last_Name | Last Name | Filled in from Login ID | |
Location_Company | Location Company | Filled in from Company | |
z1D_WorkInfoType | z1D_WorkInfoType | General Information | |
z1D_WorkInfoSecureLog | z1D_WorkInfoSecureLog | Yes | |
z1D_WorkInfoViewAccess | z1D_WorkInfoViewAccess | Public |
When a record is created successfully, the newly created record ID is returned.
Comments
Log in or register to comment.