You are on page 1of 203

SAP BusinessObjects Access Control 10.

0
Webservices

WebServices
Webservices: Unit Overview 1/2

Unit: Inbound Webservice


Lesson 1: Select Application Webservice
Lesson 2: Firefighter Object Webservice
Lesson 3: Lookup Webservice
Lesson 4: Search Role Webservice
Lesson 5: User’s Existing Assignment Webservice
Lesson 6: Role Details Webservice
Lesson 7: Submit User Access Request Webservice
Lesson 8: Organization Assignment Request Webservice
Lesson 9: Request Status Webservice
Lesson 10: Request Details Webservice

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 2


Webservices: Unit Overview 2/2

Unit: Inbound Webservice


Lesson 11: Provision Log Webservice
Lesson 12: Audit Log Webservice
Lesson 13: Exit Webservice
Lesson 14: Risk Analysis with Request Number Webservice
Lesson 15: Risk Analysis without Request Number Webservice
Lesson 16: Audit Log Integration Webservice
Lesson 17: Exit Log Webservice

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 3


Select Application Webservice: Lesson
Objectives

After completing this lesson, you will be able to:


 Identify the input parameters
 Discuss the validation and support for input parameters
 Indentify the output parameters
 Able to execute the webservise successfully

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 4


Select Application Webservice: Input
Parameters
Serial No. Field Name Mandatory/ Description Comments
Optional
1 ConnectorCategory Optional Category of System
2 ConnectorId Optional System Id
3 ConnectorType Optional System Type
4 Language Optional Language

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 5


Input Parameters: Validations And Support 1/2

1.Web Service name: GRAC_SELECT_APPL_WS.

2. All inputs are OPTIONAL.


3. If no value is passed in any of the input field, all the systems irrespective of all
System Id and Type.
4. Language field is optional. User need to provide the queering language. In case of
no or wrong entry, the language will be set as login language.

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 6


Input Parameters: Validations And Support 2/2

 On successful data retrieval , the following SUCCESS message of statement ‘Data


populated successfully’ will be displayed having Message No 0 and Message type
‘SUCCESS’.

 For wrong entry or not availability of data the output will be an ERROR Message
of statement ‘No system found for input value’ having Message No 4 and Message
type ‘ERROR’ .

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 7


Output Parameters: Select Application
Webservice (Connector List (Table))

Serial No. Name Nature of Output Description


1 ConnectorType Single value Type of connector used
2 ConnectorId Single value Application category
3 ConnectorCategory Single value Connector category
4 ConnectorDesc Single value Connector Description

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 8


Return Messages: Structure Message Return

Serial No. Name Description Comment


1 MsgNo Message number 0 For Success,4 For Error
2 MsgType Message type Success ,Error
3 MsgStatement Message text Text for message return

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 9


Select Application Webservice: Lesson
Summary

You should now be able to:


 Identify the input parameters
 Discuss the validation and support for input parameters
 Indentify the output parameters
 Able to execute the webservise successfully

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 10


Webservices: Unit Overview 1/2

Unit: Inbound Webservice


Lesson 1: Select Application Webservice
Lesson 2: Firefighter Object Webservice
Lesson 3: Lookup Webservice
Lesson 4: Search Role Webservice
Lesson 5: User’s Existing Assignment Webservice
Lesson 6: Role Details Webservice
Lesson 7: Submit User Access Request Webservice
Lesson 8: Organization Assignment Request Webservice
Lesson 9: Request Status Webservice
Lesson 10: Request Details Webservice

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 11


Webservices: Unit Overview 2/2

Unit: Inbound Webservice


Lesson 11: Provision Log Webservice
Lesson 12: Audit Log Webservice
Lesson 13: Exit Webservice
Lesson 14: Risk Analysis with Request Number Webservice
Lesson 15: Risk Analysis without Request Number Webservice
Lesson 16: Audit Log Integration Webservice
Lesson 17: Exit Log Webservice

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 12


Firefighter Object Webservice: Lesson
Objectives

After completing this lesson, you will be able to:


 Identify the input parameters
 Learn all the validation and support for input parameters
 Indentify the output parameters
 Able to execute the webservise successfully

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 13


Input Parameters: Firefighter Object
Webservice
Serial No. Field Name Mandatory/ Description Comments
Optional
1 FfObject Optional Fire Fighter object id
2 System Optional System Id
4 Language Optional Language

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 14


Input Parameters: Validations And Support 1/3

 Web Service name: GRAC_FIRE_FIGHTER_WS.


 All the inputs are OPTIONAL.
 If no value is pass in any of the input field, list of all the Fire Fighter Object will be
displayed.
 The reference table for value source in various input field .

Serial Input Field Ref. Source Input Field Input Output Field name
No. Name service Name Val
1 System Select Connetorid Null ConnectorId
Application

 Language field is optional. User need to provide the queering language. In case of
no or wrong entry, the language will be set as login language.

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 15


Input Parameters: Validations And Support 2/3

 FfObject If valid value of Fire Fighter Object is passed into the Ffobject field, the
details of the corresponding FFobject will be displayed .
 System Similarly, for valid value of System passed into the System field, the
details of all the Firefighter in the System will be displayed.
 Language field is optional. User need to provide the queering language. In case
of no or wrong entry, the language will be set as login language.

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 16


Input Parameters: Validations And Support 3/3

On successful data retrieval , the following SUCCESS message of statement ‘Data


populated successfully’ will be displayed having Message No 0 and Message type
‘SUCCESS’.

For wrong entry or not availability of data the output will be an ERROR Message
of statement ‘No system found for input value’ having Message No 4 and Message
type ‘ERROR’ .

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 17


Output Parameters: Firefighter Object
Webservice (FFOwnerList (Table))

Serial No. Name Nature of Output Description


1 FFid Single value Fire Fighter Id
2 FfidName Single value Fire Fighter Name
3 Connector Single value System
4 OwnerId Single value Fire Fighter owner Id

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 18


Output Parameters: Firefighter Object
Webservice (FFAplicationInfo)

Serial No. Name Nature of Description


Output
1 Application Type Single value Application Type
2 Application Type Desc Single value Application Type Desc

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 19


Return Messages: Structure Message Return

Serial No. Name Description Comment


1 MsgNo Message number 0 For Success,4 For Error
2 MsgType Message type Success ,Error
3 MsgStatement Message text Text for message return

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 20


Firefighter Object Webservice: Lesson
Summary

You should now be able to:


 Identify the input parameters
 Learn all the validation and support for input parameters
 Indentify the output parameters
 Able to execute the webservise successfully

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 21


Webservices: Unit Overview 1/2

Unit: Inbound Webservice


Lesson 1: Select Application Webservice
Lesson 2: Firefighter Object Webservice
Lesson 3: Lookup Webservice
Lesson 4: Search Role Webservice
Lesson 5: User’s Existing Assignment Webservice
Lesson 6: Role Details Webservice
Lesson 7: Submit User Access Request Webservice
Lesson 8: Organization Assignment Request Webservice
Lesson 9: Request Status Webservice
Lesson 10: Request Details Webservice

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 22


Webservices: Unit Overview 2/2

Unit: Inbound Webservice


Lesson 11: Provision Log Webservice
Lesson 12: Audit Log Webservice
Lesson 13: Exit Webservice
Lesson 14: Risk Analysis with Request Number Webservice
Lesson 15: Risk Analysis without Request Number Webservice
Lesson 16: Audit Log Integration Webservice
Lesson 17: Exit Log Webservice

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 23


Lookup Webservice: Lesson Objectives

After completing this lesson, you will be able to:


 Identify the input parameters
 Learn all the validation and support for input parameters
 Indentify the output parameters
 Able to execute the webservise successfully

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 24


Input Parameters: Lookup Webservice 1/2

Serial Field Name Mandatory/ Description Comments


No. Optional
1 RequestType Optional Request Type Boolean input (T/t)
2 EmployeeType Optional Employee type Boolean input (T/t)
3 PriorityType Optional Priority type Boolean input (T/t)
4 BusProc Optional Business Process Boolean input (T/t)
5 BusSubProc Optional Business Sub Process Boolean input (T/t)
6 Phase Optional Phase Boolean input (T/t)
7 Landscape Optional Landscape Boolean input (T/t)
8 CriticalLevel Optional Critical Level Boolean input (T/t)
9 FunctionArea Optional Functional Area Boolean input (T/t)
10 ProjectRelease Optional Project Release Boolean input (T/t)
11 RoleStatus Optional Role Status Boolean input (T/t)
12 RoleType Optional Role Type Boolean input (T/t)
Contd……………………

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 25


Input Parameters: Lookup Webservice 2/2

Serial No. Field Name Mandatory Description Comments


/Optional
13 RoleSensitivity Optional Role Sensitivity Boolean input (T/t)
14 ItemProvType Optional Item Provision Type Boolean input (T/t)
15 ItemProvActionType Optional Item Provision Action Value Input
Type
16 RequestCustomFields Optional Request Custom Field Boolean input (T/t)
17 RoleCustomFields Optional Role Custom Field Boolean input (T/t)
18 CustomFieldsValues Optional List of Custom Field Value Input
19 Communication Type Optional Communication Type Boolean input (T/t)
20 OmObjectType Optional OM Object Type Boolean input (T/t)
21 OmObjectValue Optional OM Object Value Value Input
22 Language Optional Language Language code

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 26


Input Parameters: Validations And Support 1/6

 Web Service name: GRAC_LOOKUP_WS.


 All the inputs are OPTIONAL.
 If no value is pass in any of the input field, all the systems irrespective of all System Id and
Type.
 Language field is optional. User need to provide the queering language. In case of no or
wrong entry, the language will be set as login language.

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 27


Input Parameters: Validations And Support 2/6

All the Boolean type input variables are optional. Each of input has a corresponding
output.
If we put T or t in any of these input, corresponding output table will be filled with all
possible value of the variable.
The input and corresponding output table are referred bellow:

Serial Input Field Output Table


No
1 REQUESTTYPE REQUESTTYPELIST
2 EMPLOYEETYPE EMPLOYEETYPELIST
3 PRIORITYTYPE PRIORITYTYPELIST
4 BUSPROC BUSPROCLIST
5 BUSSUBPROC BUSSUBPROCLIST
6 PHASE PHASELIST
Contd……………………………………….

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 28


Input Parameters: Validations And Support 3/6

Serial No Input Field Output Table


7 LANDSCAPE LANDSCAPELIST
8 CRITICALLEVEL CRITICALLEVELLIST
9 FUNCTIONAREA FUNCTIONAREALIST
10 PROJECTRELEASE PROJECTRELEASELIST
11 ROLESTATUS ROLESTATUSLIST
12 ROLETYPE ROLETYPELIST
13 ROLESENSITIVITY ROLESENSITIVITYLIST
14 ITEMPROVTYPE ITEMPROVTYPELIST
15 REQUESTCUSTOMFIELDS REQUESTCUSTOMFIELDSLIST

16 ROLECUSTOMFIELDS ROLECUSTOMFIELDSLIST
17 COMMUNICATIONTYPE COMMUNICATIONTYPELIST
18 OMOBJECTTYPE OMOBJECTTYPELIST

If SPACE or any alphanumeric value other than T or t is passed to any of the above input field, corresponding output
table will be empty and there will be no output message.

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 29


Input Parameters: Validations And Support 4/6

 There are 2 variables namely ItemProvActionType and CustomFieldsValues for


which we need to input specific value. The valid values for the corresponding fields
will be taken from other lookup services. The process is as follows,

 Input in ItemProvActionType field: First pass T/t value to ITEMPROVTYPE field


and a list of all possible values. Then from that list we may select any one value to
pass to the ItemProvActionType field to get the list of all Provision Actions in the
output table ITEMPROVTYPELIST.

 Input in CustomFieldsValues field: We have 2 kinds of custom fields namely


Request Custom Fields and Role Custom Field. We may pass the name of any of
the Custom Field, if it has fived values or range configured in its domain, the values
will be listed in the output. So get the field name by passing T/t into the input field
REQUESTCUSTOMFIELDS (for Request Custom field) and
ROLECUSTOMFIELDS (for Role Custom field) and get the output in
REQUESTCUSTOMFIELDSLIST or ROLECUSTOMFIELDSLIST respectively. The
fieldname obtained thus may be passed to CustomFieldsValues to get the list of
all the possible value of the input field in CUSTOMFIELDDETAILS table.

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 30


Input Parameters: Validations And Support 5/6

 Input in OmObjectValue field: This structure contains 2 fields viz, SYSTEM and
OmObjType . The value for System can be obtained from Select Application
webservice and OmObjType is obtained from lookup service by passing t/T to
OmObjectType and get the list of OM Object List from OmObjectTypeList in the
output.

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 31


Input Parameters: Validations And Support 6/6

 Each of the out has their own return message, for success data retrieval ,the
following success message will be displayed having Message No 0 and Message
type ‘SUCCESS’.

 For unsuccessful data retrieval, no message will be displayed..

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 32


Output Parameters: Lookup Webservice 1/10

Request Type

Serial No. Name Nature of Output Description


1 Reqtype Single value Request Type Id
2 Reqtypename Single value Request type Description

EmployeeType
Serial No. Name Nature of Output Description
1 Emptypeid Single value Employee Type
2 Emptypename Single value Employee type Description

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 33


Output Parameters: Lookup Webservice 2/10

Business Process

Serial No. Name Nature of Output Description


1 Bproc Single value Business Process id
2 Descn Single value Business Process Description

Business Subprocess

Serial No. Name Nature of Output Description


1 Bproc Single value Business Process Id
2 Bsubproc Single value Business Sub Process Id
3 Descn Single value Business Sub Process Description

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 34


Output Parameters: Lookup Webservice 3/10

Critical level
Serial No. Name Nature of Output Description
1 Critlvl Single value Critical Level
2 Descn Single value Critical Level Description

Function Area
Serial No. Name Nature of Output Description
1 Funarea Single value Function Area Id
2 Descn Single value Function Area Description
3 Abbrv Single value Function Area Abbreviation

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 35


Output Parameters: Lookup Webservice 4/10

Landscape
Serial No. Name Nature of Output Description
1 ConnectorGrp Single value Connector Group
2 ConnectorGrpT Single value Connector Group Type
3 ConnectorType Single value Connection type

Phase list
Serial No. Name Nature of Output Description
1 MthAction Single value Method Action
2 Descn Single value Method Action Description

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 36


Output Parameters: Lookup Webservice 5/10

Priority Type
Serial No. Name Nature of Output Description
1 Prioritype Single value Priority Type Id
2 Priorityname Single value Priority Type Description

Project Release
Serial No. Name Nature of Output Description
1 Prjrel Single value Project Release Id
2 Descn Single value Project Release Description

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 37


Output Parameters: Lookup Webservice 6/10

Request Item Type


Serial No. Name Nature of Output Description
1 Val Single value Request Item Id
2 Text Single value Request Item Description

RoleSensitivity
Serial No. Name Nature of Output Description
1 Sensitivity Single value Sensitivity
2 Descn Single value Descn

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 38


Output Parameters: Lookup Webservice 7/10

RoleStatus
Serial No. Name Nature of Output Description
1 RoleStatus Single value Role Status Id
2 Descn Single value Role Status Description

RoleType

Serial No. Name Nature of Output Description


1 RoleType Single value Role Type Id
2 Descn Single value Role Type Description

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 39


Output Parameters: Lookup Webservice 8/10

RequestCustomField
Serial No. Name Nature of Output Description
1 FieldName Single value Request Field Name
2 Fieldtext Single value Request Field text

RoleCustom Field
Serial No. Name Nature of Output Description
1 FieldName Single value Role Field Name
2 Fieldtext Single value Role Field Text

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 40


Output Parameters: Lookup Webservice 9/10

Custom Field Details


Serial No. Name Nature of Output Description
1 CustomFieldName Single value Custom Field Name
2 CustomFieldValue Single value Custom Field Value
3 CustomFieldText Single value Custom Field Text

Item Provision Type List


Serial No. Name Nature of Output Description
1 Val Single value Provision Type Value
2 Txt Single value Provision Type Value text

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 41


Output Parameters: Lookup Webservice 10/10

OM Object Type
Serial No. Name Nature of Output Description
1 Value Single value OM Object Type
2 Text Single value OM Object Type text

OM Object id
Serial No. Name Nature of Output Description
1 OM Object Id Single value OM Object Id
2 OM Object Text Single value OM Object Text

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 42


Return Messages: Structure Message Return

Return Message (Applicable for all return Parameters separtely )

Serial No. Name Description Comment


1 MsgNo Message number 0 For Success,4 For Error
2 MsgType Message type Success ,Error
3 MsgStatement Message text Text for message return

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 43


Lookup Webservice: Lesson Summary

You should now be able to:


 Identify the input parameters
 Learn all the validation and support for input parameters
 Indentify the output parameters
 Able to execute the webservise successfully

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 44


Webservices: Unit Overview 1/2

Unit: Inbound Webservice


Lesson 1: Select Application Webservice
Lesson 2: Firefighter Object Webservice
Lesson 3: Lookup Webservice
Lesson 4: Search Role Webservice
Lesson 5: User’s Existing Assignment Webservice
Lesson 6: Role Details Webservice
Lesson 7: Submit User Access Request Webservice
Lesson 8: Organization Assignment Request Webservice
Lesson 9: Request Status Webservice
Lesson 10: Request Details Webservice

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 45


Webservices: Unit Overview 2/2

Unit: Inbound Webservice


Lesson 11: Provision Log Webservice
Lesson 12: Audit Log Webservice
Lesson 13: Exit Webservice
Lesson 14: Risk Analysis with Request Number Webservice
Lesson 15: Risk Analysis without Request Number Webservice
Lesson 16: Audit Log Integration Webservice
Lesson 17: Exit Log Webservice

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 46


Search Role Webservice: Lesson Objectives

After completing this lesson, you will be able to:


 Identify the input parameters
 Learn all the validation and support for input parameters
 Indentify the output parameters
 Able to execute the webservise successfully

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 47


Input Parameters: Search Role Webservice 1/3

Serial No. Field Name Mandatory/ Description Comments


Optional
1 Action Optional Action
2 ApplicationType Optional Application type
3 Approver Optional Approver
4 AssociatedRole Optional Associated Role
5 BusinessProcess Optional Business Process
6 SubProcess Optional Sub Process
7 ConnectorGroup Optional Connector Group
8 Landscape Optional Landscape
9 CriticalLevel Optional Critical Level
10 RoleDesc Optional Role Description

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 48


Input Parameters: Search Role Webservice 2/3

Serial No. Field Name Mandatory/ Description Comments


Optional
11 OrgVal Optional Organisation Value
12 FunctionalArea Optional Functional Area
13 LastReaffirmDT Optional Last Reaffirm Date
14 OrgLvl Optional Organization Level
15 RoleOwner Optional Role Owner
16 Permission Optional Permission
17 Profile Optional Profile
18 ReaffirmPeriod Optional Reaffirm period
19 RoleName Optional Role Name
20 RoleStatus Optional Role Status

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 49


Input Parameters: Search Role Webservice 3/3

Serial No. Field Name Mandatory/ Description Comments


Optional
21 RoleType Optional Role type
22 RoleSensitivity Optional Role Sensitivity
23 System Optional System
24 Language Optional Language

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 50


Input Parameters: Validations And Support

 Web Service name: GRAC_SEARCH_ROLES_WS.


 All the inputs are OPTIONAL.
 If no value is pass in any of the input field, list of all default Roles will be displayed.
 Language field is optional. User need to provide the queering language. In case of
no or wrong entry, the language will be set as login language.
 All input field supports * as wild card for possible entries.
 It also support
A. Begin with of form *<string-val>
B. Contains any of form <string-val1> *<string-val2>

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 51


Output Parameters: Search Role Webservice
(SearchRole (Table))

Serial No. Name Nature of Output Description


1 RoleName Single value Role Name
2 RoleDesc Single value Role Description
3 System Single value System
4 RoleType Single value Role type
5 RoleTypeDesc Single value Role type description
6 RoleOwner Single value Role Owner

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 52


Return Messages: Structure Message Return

Return Message

Serial No. Name Description Comment


1 MsgNo Message number 0 For Success,4 For Error
2 MsgType Message type Success ,Error
3 MsgStatement Message text Text for message return

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 53


Search Role Webservice: Lesson Summary

You should now be able to:


 Identify the input parameters
 Learn all the validation and support for input parameters
 Indentify the output parameters
 Able to execute the webservise successfully

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 54


Webservices: Unit Overview 1/2

Unit: Inbound Webservice


Lesson 1: Select Application Webservice
Lesson 2: Firefighter Object Webservice
Lesson 3: Lookup Webservice
Lesson 4: Search Role Webservice
Lesson 5: User’s Existing Assignment Webservice
Lesson 6: Role Details Webservice
Lesson 7: Submit User Access Request Webservice
Lesson 8: Organization Assignment Request Webservice
Lesson 9: Request Status Webservice
Lesson 10: Request Details Webservice

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 55


Webservices: Unit Overview 2/2

Unit: Inbound Webservice


Lesson 11: Provision Log Webservice
Lesson 12: Audit Log Webservice
Lesson 13: Exit Webservice
Lesson 14: Risk Analysis with Request Number Webservice
Lesson 15: Risk Analysis without Request Number Webservice
Lesson 16: Audit Log Integration Webservice
Lesson 17: Exit Log Webservice

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 56


User’s Existing Assignment Webservice:
Lesson Objectives

After completing this lesson, you will be able to:


 Identify the input parameters
 Learn all the validation and support for input parameters
 Indentify the output parameters
 Able to execute the webservise successfully

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 57


Input Parameters: User’s Existing Assignment
Webservice
Serial No. Field Name Mandatory/ Description Comments
Optional
1 UserId Mandatory Userid
2 System Optional System
3 Language Optional Language

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 58


Input Parameters: Validations And Support 1/2

 Web Service name: GRAC_USER_EXISTING_ASSGN_WS.


 The UserId is mandatory and System is optional input parameter. If we pass only
valid UserId, all his existing assignments irrespective of System will be displayed in
the output along with the success message having Message No 0 and Message
type ‘SUCCESS’ and Message statement as Data populated Successfully.

 This Userid or system may be entered in uppercase, lowercase or any combination


of Both. Also one or multiple space to left of these entries is allowed.

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 59


Input Parameters: Validations And Support 2/2

 If the webservice is executed without passing UserId, following ERROR message


will be displayed having Message No 4 and Message type ‘ERROR’ and Message
Statement ‘User ID is mandatory’ .

 For invalid UserId, System or any combination of them for which the input userid
does have any assignment in the input system, no data will be fetched and
webservice will display following message having Message No 4 and Message type
‘ERROR’ and Message Statement ‘No assignment data found’.

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 60


Output Parameters: User’s Existing
Assignment Webservice (Table)

Serial No. Name Nature of Output Description


1 Item Single value Item
2 Type Single value Role Type
3 TypeTxt Single value Role Text
4 SystemId Single value System Id
5 Descn Single value Description
6 ValidFrom Single value Valid from
7 ValidTo Single value Valid to
8 Status Single value status

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 61


Return Messages: Structure Message Return

Return Message

Serial No. Name Description Comment


1 MsgNo Message number 0 For Success,4 For Error
2 MsgType Message type Success ,Error
3 MsgStatement Message text Text for message return

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 62


User’s Existing Assignment Webservice:
Lesson Summary

You should now be able to:


 Identify the input parameters
 Learn all the validation and support for input parameters
 Indentify the output parameters
 Able to execute the webservise successfully

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 63


Webservices: Unit Overview 1/2

Unit: Inbound Webservice


Lesson 1: Select Application Webservice
Lesson 2: Firefighter Object Webservice
Lesson 3: Lookup Webservice
Lesson 4: Search Role Webservice
Lesson 5: User’s Existing Assignment Webservice
Lesson 6: Role Details Webservice
Lesson 7: Submit User Access Request Webservice
Lesson 8: Organization Assignment Request Webservice
Lesson 9: Request Status Webservice
Lesson 10: Request Details Webservice

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 64


Webservices: Unit Overview 2/2

Unit: Inbound Webservice


Lesson 11: Provision Log Webservice
Lesson 12: Audit Log Webservice
Lesson 13: Exit Webservice
Lesson 14: Risk Analysis with Request Number Webservice
Lesson 15: Risk Analysis without Request Number Webservice
Lesson 16: Audit Log Integration Webservice
Lesson 17: Exit Log Webservice

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 65


Role Details Webservice: Lesson Objectives

After completing this lesson, you will be able to:


 Identify the input parameters
 Learn all the validation and support for input parameters
 Indentify the output parameters
 Able to execute the webservise successfully

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 66


Input Parameters: Role Details Webservice

Serial Field Name Mandatory Description Comments


No. /
Optional
1 ObjectName Required Role Name
2 ObjectType Optional Role Object Type
3 Landscape Required Connector ID
4 Language Optional Language

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 67


Input Parameters: Validations And Support

 Web Service Name: GRAC_ROLE_DETAILS_WS


 From interface point of view Object Name and Landscape is mandatory

Validations and Input format for input fields:


 Object Name should be entered in full , no wildcards supported
 Landscape should be entered in full , no wildcards supported

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 68


Output Parameters: Role Details Webservice
1/5

Object Attributes

Serial No. Name Type Description


1 ObjectName Single value Object Name
2 Description Single value Object Description
3 Landscape Single value Connector Id
4 Landscape_Desc Single value Connector description
5 ObjectType Single value Object Type
6 ObjectTypeDesc Single value Object description
7 BusinessProcess Single value Business process
8 BusinessProcess Desc Single value Business process description
9 SubProcess Single value Business Subprocess
10 SubProcess Desc Single value Business Subprocess description
11 ObjectStatus Single value Object Status
12 ObjectStatus DESC Single value Object Status description
Cont…

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 69


Output Parameters: Role Details Webservice
2/5

Object Attributes (continued)


Serial No. Name Type Description
13 ReaffimPeriod String Reaffirm Period
14 LastReaffirDate String Last Reaffirm date
15 LastReaffirBy String Last reaffirm changed by

Table Company

Serial No. Name Type Description


1 CompanyName String Company Name
2 CompanyDesc String Company Description

Table Functional Area


Serial No. Name Type Description
1 FunctioalArea String Functional area
2 FunctioalDesc String Functional area name description

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 70


Output Parameters: Role Details Webservice
3/5

Table Role Approvers


Serial No. Name Type Description
1 Approver Single value Approver
2 AltApprover Single value Alternate Approver
3 Apprvp Single value
4 Owner Single value
5 Lead Single value
6 ValidFrom Single value Valid from
7 ValidTo Single value Valid to
Table System data
Serial No. Name Type Description
1 Connector Single value Connector Id
2 Environment Single value Environment
3 RoleExists Single value Role Exists
4 SystemValidityPeriod Single value System Validity Period
5 Status Single value Status

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 71


Output Parameters: Role Details Webservice
4/5

Table Role Actions


Serial No. Name Type Description
1 Roleid Single value Role Id
2 ActionId Single value Action Id
3 Funcid Single value Function Id
4 IsActive Single value Active
5 Action Single value Action
Table Violations
Serial No. Name Type Description
1 ReportType Single value Report Type
2 ObjeectId Single value Object Id
3 RiskId Single value Risk id
4 Connector Single value Connector ID
5 Role Single value Role
6 CompositeRole Single value Composite Role
7 SodcontrolId Single value SOD Control ID
8 Monitor Single value Monitor
9 Orgruleid Single value Org ruler ID
© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 72
Output Parameters: Role Details Webservice
5/5

Table Customer Fields


Serial No. Name Type Description
1 Fieldname Single value Field name
2 Value Single value Field value

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 73


Return Messages: Structure Message Return

Serial No. Name Description Comment


1 MsgNo Message number 0 For Success,4 For Error
2 MsgType Message type Success ,Error
3 MsgStatement Message Text for message return

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 74


Role Details Webservice: Lesson Summary

You should now be able to:


 Identify the input parameters
 Learn all the validation and support for input parameters
 Indentify the output parameters
 Able to execute the webservise successfully

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 75


Webservices: Unit Overview 1/2

Unit: Inbound Webservice


Lesson 1: Select Application Webservice
Lesson 2: Firefighter Object Webservice
Lesson 3: Lookup Webservice
Lesson 4: Search Role Webservice
Lesson 5: User’s Existing Assignment Webservice
Lesson 6: Role Details Webservice
Lesson 7: Submit User Access Request Webservice
Lesson 8: Organization Assignment Request Webservice
Lesson 9: Request Status Webservice
Lesson 10: Request Details Webservice

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 76


Webservices: Unit Overview 2/2

Unit: Inbound Webservice


Lesson 11: Provision Log Webservice
Lesson 12: Audit Log Webservice
Lesson 13: Exit Webservice
Lesson 14: Risk Analysis with Request Number Webservice
Lesson 15: Risk Analysis without Request Number Webservice
Lesson 16: Audit Log Integration Webservice
Lesson 17: Exit Log Webservice

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 77


Submit User Access Request Webservice:
Lesson Objectives

After completing this lesson, you will be able to:


 Identify the input parameters
 Learn all the validation and support for input parameters
 Indentify the output parameters
 Able to execute the webservise successfully

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 78


Input Parameters: Submit User Access
Request Webservice 1/8

Header Data
Serial No. Field Name Mandatory/ Description Comment
Optional s
1 REQTYPE Request Type
2 PRIORITY Priority
3 REQ_DUE_DATE Request Due Date
4 REQ_INIT_SYSTEM Mandatory Request initiation system
5 REQUESTORID Requestor Id

6 EMAIL Requestor’s Email


7 REQUEST_REASON Reason of Request
8 FUNCAREA Functional Area
9 BPROC Business Process

Fields other than REQ_INIT_SYSTEM will be Mandatory/ Optional as per the End User
Personalization Screen Configuration

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 79


Input Parameters: Submit User Access
Request Webservice 2/8

User Info
Serial No. Field Name Mandatory/ Description Comments
Optional
1 USERID User id
2 TITLE Accademic/Personal title
(MR/MS/MRS/DOC)
3 FNAME User’s First name
4 LNAME User’s Last name
5 SNC_NAME SNC Name

6 UNSEC_SNC User’s SNC Name


7 ACCNO User’s account no
8 USER_GROUP User Group
9 VALID_FROM Valid From

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 80


Input Parameters: Submit User Access
Request Webservice 3/8

User Info (continued)


Serial No. Field Name Mandatory/ Description Comments
Optional
10 VALID_TO Valid To
11 EMPPOSITION Position of Employee
12 EMPJOB Job of Employee
13 PERSONNELNO Personal No
14 PERSONNELAREA Personal Area

15 COMM_METHOD Communication Method


16 FAX FAX
17 EMAIL Email
18 TELNUMBER Telephone No

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 81


Input Parameters: Submit User Access
Request Webservice 4/8

User Info (continued)


Serial No. Field Name Mandatory/ Description Comments
Optional
19 DEPARTMENT Department
20 COMPANY Company
21 LOCATION Location
22 COSTCENTER Cost Center
23 PRINTER Printer
24 ORGUNIT Organization Unit
25 EMPTYPE Employee Type
26 MANAGER Manager
27 MANAGER_EMAIL Manager’s Email

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 82


Input Parameters: Submit User Access
Request Webservice 5/8

User Info (continued)


Serial Field Name Mandatory/ Description Comments
No. Optional
28 MANAGER_FIRSTNAME Manager’s First
name
29 MANAGER_LASTNAME Manager’s Last
name
30 START_MENU Start Menu
31 LOGON_LANG Logon language
32 DEC_NOTATION Decimal Notation
33 DATE_FORMAT Date Format
34 ALIAS Alias
35 USER_TYPE User’s Type

The Fields will be Mandatory/ Optional as per the End User Personalization Screen Configuration

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 83


Input Parameters: Submit User Access
Request Webservice 6/8

Requested Line Item


Serial No. Field Name Mandatory/ Description Comments
Optional
1 ITEM_NAME Item Name
2 CONNECTOR System Id
3 PROV_ITEM_TYPE Provision Item Type
4 PROV_TYPE Provision Type
5 ASSIGNMENT_TYPE Assignment Type
6 PROV_STATUS Provision Status
7 VALID_FROM Valid From
8 VALID_TO Valid To
9 FF_OWNER Fire Fighter Owner

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 84


Input Parameters: Submit User Access
Request Webservice 7/8

Requested Line Item (continued)


Serial No. Fild Name Mandatory/ Description Comments
Optional
10 COMMENTS Comments
11 PROV_ACTION Provision Action
12 ROLE_TYPE Role Type

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 85


Input Parameters: Submit User Access
Request Webservice 8/8

Parameter
Serial No. Fild Name Mandatory/ Description Comments
Optional
1 PARAMETER Parameter Name
2 PARAMETER_VALUE Parameter Value
3 PARAMETER_DESC Parameter Description

User Group

Serial No. Fild Name Mandatory/ Description Comments


Optional
1 USER_GROUP User Group
2 USER_GROUP_DESC User Group description

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 86


Input Parameters: Validations And Support 1/3

• Web Service name: GRAC_USER_ACCES_WS

• Mandatory fields and default values in the Header Data and User Info are
determined based on the End User’s Personalization Screen Configuration.

• Field REQ_INIT_SYSTEM (Request Initiating SYSTEM )of Header Data is


always mandatory.

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 87


Input Parameters: Validations And Support 2/3

Validation for Request Line item:

1. In Request Line Item, ItemName , System, Provision Item Type and Provision
Item Action are mandatory.

2. If Provision Item type is ROLE (value ‘ROL’), Role Type is Mandatory.

3. If Line Item type is System , Item name and connector will have same value.

4. If Line Item is FFid, Item Name and connector should be in sync as per FF
Object Web service.

5. If Line Item is FFid, FFowner field is mandatory and input value of FFowner is in
sync as per FF Object Web service.

6. Always Provision Item Type is in sync with Provision Item Action.

7. For each line item valid from date must be previous or same with Valid to date.

8. If the request contains lock unlock and delete action then one system should
always be present.

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 88


Input Parameters: Validations And Support 3/3

Custom field validation:

For the custom field with fixed values, the values are defined either as a set of fixed
values or as a range. The value enter in the corresponding field of Custom field Value
must satisfy the fixed value or within the range wherever applicable.

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 89


Output Parameters: Submit User Access
Request Webservice (Table)

Serial No. Name Nature of Output Description


1 RequestNumber Single value Request Number
2 RequestId Single value Request Id

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 90


Return Messages: Structure Message Return

Return Message

Serial No. Name Description Comment


1 MsgNo Message number 0 For Success,4 For Error
2 MsgType Message type Success ,Error
3 MsgStatement Message text Text for message return

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 91


Submit User Access Request Webservice:
Lesson Summary

You should now be able to:


 Identify the input parameters
 Learn all the validation and support for input parameters
 Indentify the output parameters
 Able to execute the webservise successfully

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 92


Webservices: Unit Overview 1/2

Unit: Inbound Webservice


Lesson 1: Select Application Webservice
Lesson 2: Firefighter Object Webservice
Lesson 3: Lookup Webservice
Lesson 4: Search Role Webservice
Lesson 5: User’s Existing Assignment Webservice
Lesson 6: Role Details Webservice
Lesson 7: Submit User Access Request Webservice
Lesson 8: Organization Assignment Request Webservice
Lesson 9: Request Status Webservice
Lesson 10: Request Details Webservice

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 93


Webservices: Unit Overview 2/2

Unit: Inbound Webservice


Lesson 11: Provision Log Webservice
Lesson 12: Audit Log Webservice
Lesson 13: Exit Webservice
Lesson 14: Risk Analysis with Request Number Webservice
Lesson 15: Risk Analysis without Request Number Webservice
Lesson 16: Audit Log Integration Webservice
Lesson 17: Exit Log Webservice

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 94


Organization Assignment Request Webservice:
Lesson Objectives

After completing this lesson, you will be able to:


 Identify the input parameters
 Learn all the validation and support for input parameters
 Indentify the output parameters
 Able to execute the webservise successfully

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 95


Input Parameters: Organization Assignment
Request Webservice 1/2

Request Header Details


Serial No. Field Name Mandatory/ Description Comments
Optional
1 ReqReason Mandatory Request reason
2 Priority Optional Priority
3 Bproc Mandatory Business Process
4 FuncArea Optional Functional Area
5 DueDt Optional Approval Due Date

Language

Serial No. Field Name Mandatory/ Description Comments


Optional
1 Language Optional Language

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 96


Input Parameters: Organization Assignment
Request Webservice 2/2

Request Details
Serial No. Field Name Mandatory/ Description Comments
Optional
1 System Mandatory
2 OmObjTyp Mandatory
3 OmObjId Mandatory
4 RoleId Mandatory
5 ValidFrom Mandatory
6 ValidTo Mandatory
7 Comment Optional
8 ProvAction Mandatory

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 97


Input Parameters: Validations And Support 1/2

 Web Service name: GRAC_ORG_ASSGN_REQUEST_WS.

 Validations And Support in Header data :


 Request reason and Business process fields are mandatory.
 The reference table for value source in various input field .

Seria Input Field Ref. Source Input Field Input Output Field name
l No. Name service Name Val
1 Priority Lookup PriorityType T/t PriorityTypeList
2 Bproc Lookup BusProc T/t BusProcList
3 FuncArea Lookup FunctionArea T/t FunctionAreaList

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 98


Input Parameters: Validations And Support 2/2

 Validation and Support in request Assignment:

Serial Input Field Ref. Input Field Input Val Output Field name
No. Name Source Name
service
1 System Select ConnectorId No Val ConnectorListhmm
Application
2 OmObjTyp Lookup OmObjTyp t/T OmObjectTypeList
3 OmObjId Lookup OmObjValue System and OmObjectTypeList
OmObjTyp
4 RoleId SearchRole No val
5 ProvAction Lookup ItemProvActi ROL ItemProvActionList
onType

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 99


Output Parameters: Organization Assignment
Request Webservice

Submit User Access Request (Table)


Serial No. Name Nature of Output Description
1 RequestNumber Single value Request Number
2 RequestId Single value Request Id

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 100


Return Messages: Structure Message Return

Return Message

Serial No. Name Description Comment


1 MsgNo Message number 0 For Success,4 For Error
2 MsgType Message type Success ,Error
3 MsgStatement Message text Text for message return

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 101


Organization Assignment Request Webservice:
Lesson Summary

You should now be able to:


 Identify the input parameters
 Learn all the validation and support for input parameters
 Indentify the output parameters
 Able to execute the webservise successfully

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 102


Webservices: Unit Overview 1/2

Unit: Inbound Webservice


Lesson 1: Select Application Webservice
Lesson 2: Firefighter Object Webservice
Lesson 3: Lookup Webservice
Lesson 4: Search Role Webservice
Lesson 5: User’s Existing Assignment Webservice
Lesson 6: Role Details Webservice
Lesson 7: Submit User Access Request Webservice
Lesson 8: Organization Assignment Request Webservice
Lesson 9: Request Status Webservice
Lesson 10: Request Details Webservice

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 103


Webservices: Unit Overview 2/2

Unit: Inbound Webservice


Lesson 11: Provision Log Webservice
Lesson 12: Audit Log Webservice
Lesson 13: Exit Webservice
Lesson 14: Risk Analysis with Request Number Webservice
Lesson 15: Risk Analysis without Request Number Webservice
Lesson 16: Audit Log Integration Webservice
Lesson 17: Exit Log Webservice

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 104


Request Status Webservice: Lesson
Objectives

After completing this lesson, you will be able to:


 Identify the input parameters
 Learn all the validation and support for input parameters
 Indentify the output parameters
 Able to execute the webservise successfully

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 105


Input Parameters: Request Status Webservice

Serial No. Field Name Mandatory/ Description Comments


Optional
1 Request Number Mandatory Request Number
2 Language Optional Language

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 106


Input Parameters: Validations And Support 1/2

1. Web Service name: GRAC_REQUEST_STATUS_WS

2. Request Number
A. This field is mandatory. If no value is input in this field and web service is been
executed, the following error message will appear having Message No 4 , Message type
‘ERROR’ and Message Statement ‘Request No is mandatory’ .

B. If space in given left to the request no at the time of input, it will accept the request no
and proper output will come.

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 107


Input Parameters: Validations And Support 2/2

C. If space is given within the request number , it will show the following error message
having Message No 4 , Message type ‘ERROR’ and Message Statement ‘Invalid Request
No’.

D. Input of any alphabet or special character in the INPUT field for along or without
the request number will be treated as ‘INVALID REQUEST NO’ and above message will be
displayed.

2. Language field is optional. User need to provide the queering language. In case of no or wrong
entry, the language will be set as login language.

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 108


Output Parameters: Request Status
Webservice

Serial No. Name Nature of Output Description


1 Request No Single value Request No
2 ReqCreated Single value Request Creation Date
3 Priority Single value HIGH/MEDIUM/LOW
4 RequestorId Single value Requestor’s Id
5 DueDate Single value Request due date
6 UserList List List of Users
7 Reqstatus Single value Current status of Request
8 ReqstatusTxt Single value Description of Current status of Request
9 Approver List List of Approver

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 109


Return Messages: Structure Message Return

Return Message

Serial No. Name Description Comment


1 MsgNo Message number 0 For Success,4 For Error
2 MsgType Message type Success ,Error
3 MsgStatement Message text Text for message return

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 110


Request Status Webservice: Lesson Summary

You should now be able to:


 Identify the input parameters
 Learn all the validation and support for input parameters
 Indentify the output parameters
 Able to execute the webservise successfully

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 111


Webservices: Unit Overview 1/2

Unit: Inbound Webservice


Lesson 1: Select Application Webservice
Lesson 2: Firefighter Object Webservice
Lesson 3: Lookup Webservice
Lesson 4: Search Role Webservice
Lesson 5: User’s Existing Assignment Webservice
Lesson 6: Role Details Webservice
Lesson 7: Submit User Access Request Webservice
Lesson 8: Organization Assignment Request Webservice
Lesson 9: Request Status Webservice
Lesson 10: Request Details Webservice

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 112


Webservices: Unit Overview 2/2

Unit: Inbound Webservice


Lesson 11: Provision Log Webservice
Lesson 12: Audit Log Webservice
Lesson 13: Exit Webservice
Lesson 14: Risk Analysis with Request Number Webservice
Lesson 15: Risk Analysis without Request Number Webservice
Lesson 16: Audit Log Integration Webservice
Lesson 17: Exit Log Webservice

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 113


Request Details Webservice: Lesson
Objectives

After completing this lesson, you will be able to:


 Identify the input parameters
 Learn all the validation and support for input parameters
 Indentify the output parameters
 Able to execute the webservise successfully

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 114


Input Parameters: Request Details Webservice

Serial No. Field Name Mandatory/ Description Comments


Optional
1 Request Number Mandatory Request Number
2 Language Optional Language

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 115


Input Parameters: Validations And Support 1/2

1. Web Service name: GRAC_REQUEST_DETAILS_WS


2. Request Number
A. This field is mandatory. If no value is input in this field and web service is been
executed, the following error message will appear having Message No 4 , Message type
‘ERROR’ and Message Statement ‘Request No is mandatory’ .

B. If space in given left to the request no at the time of input, it will accept the request no
and proper output will come.

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 116


Input Parameters: Validations And Support 2/2

C. If space is given within the request number , it will show the following error message
having Message No 4 ,Message type ‘ERROR’ and Message Statement ‘Invalid Request
No’.

D. Input of any alphabet or special character in the INPUT field for along or without
the request number will be treated as ‘INVALID REQUEST NO’ and above message will be
displayed.

2. Language field is optional. User need to provide the queering language. In case of no or wrong
entry, the language will be set as login language.

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 117


Output Parameters: Request Details
Webservice 1/16

Request details

Serial No. Name Nature of Description


Output
1 Request ID Single value Request ID
2 Request Type Single value Type of requests
CREATE_USER, CHANGE_USER, LOCK_USER, UNLOCK_USER,
DELETE_USER, ASSIGN_ROLES etc
3 Request Type Desc Single value Request Type description
4 Request Status Single value APPROVED/REJECTED/PENDING
5 Request Status Desc Single value Request Status description
6 Priority Single value HIGH/MEDIUM/LOW
7 Priority Desc Single value Priority Description
8 Approval due date Single value Approval due date
9 Requestor Single value Requestor’s Id
10 Requestor First Name Single value Requestor’s First Name

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 118


Output Parameters: Request Details
Webservice 2/16

Request details (continued)

Serial No. Name Nature of Description


Output
11 Requestor Last Name Single value Requestor’s Last Name
12 Requestor Email Single value Email address of the requestor
13 User Info Table User Information
14 RequestedItems Table Requested Items
15 RequestPaths Table Request Paths
16 RiskViolationData Table Risk Violation data
17 Parameter Table Parameter
18 User Group Table User Group

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 119


Output Parameters: Request Details
Webservice 3/16

User Info
Serial No. Name Nature of Description
Output
1 USERID Single value User id
2 TITLE Single value Accademic/Personal title
(MR/MS/MRS/DOC)
3 FNAME Single value User’s First name
4 LNAME Single value User’s Last name
5 SNC_NAME Single value SNC Name

6 UNSEC_SNC Single value User’s SNC Name


7 ACCNO Single value User’s account no
8 USER_GROUP Single value User Group
9 VALID_FROM Single value Valid From

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 120


Output Parameters: Request Details
Webservice 4/16

User Info (continued)


Serial No. Name Nature of Description
Output
10 VALID_TO Single value Valid To
11 EMPPOSITION Single value Position of Employee
12 EMPJOB Single value Job of Employee
13 PERSONNELNO Single value Personal No
14 PERSONNELAREA Single value Personal Area

15 COMM_METHOD Single value Communication Method


16 FAX Single value FAX
17 EMAIL Single value Email
18 TELNUMBER Single value Telephone No

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 121


Output Parameters: Request Details
Webservice 5/16

User Info (continued)


Serial No. Name Nature of Description
Output
19 DEPARTMENT Single value Department
20 COMPANY Single value Company
21 LOCATION Single value Location
22 COSTCENTER Single value Cost Center
23 PRINTER Single value Printer
24 ORGUNIT Single value Organization Unit
25 EMPTYPE Single value Employee Type
26 MANAGER Single value Manager
27 MANAGER_EMAIL Single value Manager’s Email

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 122


Output Parameters: Request Details
Webservice 6/16

User Info (continued)


Serial No. Name Nature of Description
Output
28 MANAGER_FIRSTNAME Single value Manager’s First name
29 MANAGER_LASTNAME Single value Manager’s Last name
30 START_MENU Single value Start Menu
31 LOGON_LANG Single value Logon language
32 DEC_NOTATION Single value Decimal Notation
33 DATE_FORMAT Single value Date Format
34 ALIAS Single value Alias
35 USER_TYPE Single value User’s Type

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 123


Output Parameters: Request Details
Webservice 7/16

Requested Item
Serial No. Name Nature of Description
Output
1 Item Name Single value Item Name
2 Item Desc Single value Item Description
3 Connector Single value System
4 Prov Item Type Single value Provision Item Type
5 Prov Item Type Desc Single value Provision Type Description
6 Prov Type Single value Provision Type
7 Prov Type Decs Single value Provision Type Description
8 Assignment Type Single value Assignment Type
9 Assignment type Desc Single value Assignment Type Description
10 Prov Status Single value Provision Status

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 124


Output Parameters: Request Details
Webservice 8/16

Requested Item (continued)


Serial No. Name Nature of Description
Output
11 Prov Status Desc Single value Provision Status Description
12 Valid From Single value Valid From
13 Valid To Single value Valid To
14 Owners Single value Owners
15 Comments Single value Comment
16 Prov Action Single value Provision Action
17 Prov Action Desc Single value Provision Action Description
18 Approval Status Single value Approval Status
19 Approval Status Desc Single value Approval Status description
20 ReqItemApprover Table List of Approvers
21 ReqItemDetails Single value Request Item Details

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 125


Output Parameters: Request Details
Webservice 9/16
ReqItemApprover

Serial No. Name Nature of Description


Output
1 UserID Single value User Id
2 UserFirstName Single value User First Name
3 UserLastName Single value User Last Name

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 126


Output Parameters: Request Details
Webservice 10/16
RequestPaths
Serial No. Name Nature of Description
Output
1 Path Name Single value Path Name
2 Path Desc Single value Path Description
3 Current Stage Name Single value Current Stage Name
4 Current Stage Desc Single value Current Stage Description
5 Current Stage Status Single value Current Stage Status
6 Current Stage Status Desc Single value Current Stage Status Description
7 CurstageApprovers Table List of Currentstage Approver
Current Stage Approvers
Serial No. Name Nature of Description
Output
1 UserID Single value User Id
2 UserFirstName Single value User First Name
3 UserLastName Single value User Last Name

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 127


Output Parameters: Request Details
Webservice 11/16
RiskViolationData
Serial No. Name Nature of Description
Output
1 UserId Single value User Id
2 RiskId Single value Risk id
3 RiskDesc Single value Risk Description
4 RiskLevel Single value Risk Level
5 RiskLevelDesc Single value Risk Level Description
6 RuleId Single value Rule Id
7 Role List Table List of Roles
8 System Single value System
9 SystemType Single value System Type
10 Mitigation Details Table Mitigation Details

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 128


Output Parameters: Request Details
Webservice 12/16
RiskViolationData (continued)
Serial No. Name Nature of Description
Output
11 Action Table Action
12 OrgRule Table Organisation Rule
13 RiskStatus Single value Risk Status
14 ViolationCount Single value Violation Count
15 LastExecutedOn Single value Last Executed On
16 Execution Count Single value No of Execution
17 RiskOwner Table List of Risk Owner
18 Tcode Table List Of Tcode

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 129


Output Parameters: Request Details
Webservice 13/16
Role List
Serial No. Name Nature of Description
Output
1 Role Single value Role
2 CompositRole Single value Composit Role
Mitigation Details
Serial No. Name Nature of Description
Output
1 MitigationCtrl Single value Mitigation Control
2 MitigationStatus Single value Mitigation Status
3 Monitor Table List Monitor
Monitor
Serial No. Name Nature of Description
Output
1 MitigationCtrl Single value Mitigation Control

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 130


Output Parameters: Request Details
Webservice 14/16
Action
Serial No. Name Nature of Description
Output
1 Action Single value Action
OrgRule
Serial No. Name Nature of Description
Output
1 OrgRule Single value Organisation Rule
RiskOwner
Serial No. Name Nature of Description
Output
1 OwnerId Single value Id of Risk Owner
2 FullName Single value Full name of Risk Owner

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 131


Output Parameters: Request Details
Webservice 15/16
TCode
Serial No. Name Nature of Description
Output
1 RoleID Single value Role Id
2 RoleDesc Single value Role Description
3 System Single value System
4 Tcode Single value Tcode
5 TcodeDesc Single value Tcode Description
Parameter
Serial No. Name Nature of Description
Output
1 PARAMETER Single value Parameter Name
2 PARAMETER_VALUE Single value Parameter Value
3 PARAMETER_DESC Single value Parameter Description

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 132


Output Parameters: Request Details
Webservice 16/16

User Group

Serial No. Name Nature of Description


Output
1 USER_GROUP Single value User Group
2 USER_GROUP_DESC Single value User Group description

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 133


Return Messages: Structure Message Return

Return Message

Serial No. Name Description Comment


1 MsgNo Message number 0 For Success,4 For Error
2 MsgType Message type Success ,Error
3 MsgStatement Message text Text for message return

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 134


Request Details Webservice: Lesson Summary

You should now be able to:


 Identify the input parameters
 Learn all the validation and support for input parameters
 Indentify the output parameters
 Able to execute the webservise successfully

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 135


Webservices: Unit Overview 1/2

Unit: Inbound Webservice


Lesson 1: Select Application Webservice
Lesson 2: Firefighter Object Webservice
Lesson 3: Lookup Webservice
Lesson 4: Search Role Webservice
Lesson 5: User’s Existing Assignment Webservice
Lesson 6: Role Details Webservice
Lesson 7: Submit User Access Request Webservice
Lesson 8: Organization Assignment Request Webservice
Lesson 9: Request Status Webservice
Lesson 10: Request Details Webservice

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 136


Webservices: Unit Overview 2/2

Unit: Inbound Webservice


Lesson 11: Provision Log Webservice
Lesson 12: Audit Log Webservice
Lesson 13: Exit Webservice
Lesson 14: Risk Analysis with Request Number Webservice
Lesson 15: Risk Analysis without Request Number Webservice
Lesson 16: Audit Log Integration Webservice
Lesson 17: Exit Log Webservice

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 137


Provision Log Webservice: Lesson Objectives

After completing this lesson, you will be able to:


 Identify the input parameters
 Learn all the validation and support for input parameters
 Indentify the output parameters
 Able to execute the webservise successfully

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 138


Input Parameters: Provision Log Webservice

Serial No. Field Name Mandatory/ Description Comments


Optional
1 ConnectorId Optional Connector ID
2 DateFrom Optional Date from YYYYMMDD
3 Language Optional Language
4 ProvAction Optional Provision Action

5 ProvItem Optional Provision Item


6 ProvItemType Optional Provision Item type

7 ReqNumber Optional Request Number

8 ReqStatus Optional Request Status


9 DateTo Optional Date to YYYYMMDD
10 UpdateBy Optional Update By
11 UserId Optional User ID User Id to be
Provisioned

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 139


Input Parameters: Validations And Support

 Web Service name: GRAC_PROV_LOGS_WS


 All parameters are optional from interface point of view, but request number is to
kept mandatory at Webservice consuming end, rest parameters are to restrict the
provision logs for that request number.

Validations and Input format for input fields:


 Connector Id : Wild card * supported.
 Date From : Format supported YYYYMMDD
 Date To : Format supported YYYYMMDD
 Provision item : Wild card * supported.
 Provision item type: Wild card * supported.
 Provision Action : Wild card * supported.

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 140


Output Parameters: Provision Log Webservice
(Table PROVISION_LOGS)

Serial No. Name Description


1 RequestNumber Request Number
2 User ID User ID
3 ConnectorId Target Connector
4 ProvItem Provisioning Item Name
5 ProvItemType Provisioning Item Type
6 ProvItemTypeDesc Provisioning item type Description
7 ProvAction Provisioning Action
8 ProvActionDesc Provisioning Action Description
9 Updated By Updated By
10 Last Updated Last Updated
11 ReqItemStatus Status
12 ReqItemStatusDesc Status Description
13 ReqShortText Short Description

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 141


Return Messages: Structure Message Return

Serial No. Name Description Comment


1 MsgNo Message number 0 For Success,4 For Error
2 MsgType Message type Success ,Error
3 MsgStatement Message Text for message return

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 142


Provision Log Webservice: Lesson Summary

You should now be able to:


 Identify the input parameters
 Learn all the validation and support for input parameters
 Indentify the output parameters
 Able to execute the webservise successfully

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 143


Webservices: Unit Overview 1/2

Unit: Inbound Webservice


Lesson 1: Select Application Webservice
Lesson 2: Firefighter Object Webservice
Lesson 3: Lookup Webservice
Lesson 4: Search Role Webservice
Lesson 5: User’s Existing Assignment Webservice
Lesson 6: Role Details Webservice
Lesson 7: Submit User Access Request Webservice
Lesson 8: Organization Assignment Request Webservice
Lesson 9: Request Status Webservice
Lesson 10: Request Details Webservice

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 144


Webservices: Unit Overview 2/2

Unit: Inbound Webservice


Lesson 11: Provision Log Webservice
Lesson 12: Audit Log Webservice
Lesson 13: Exit Webservice
Lesson 14: Risk Analysis with Request Number Webservice
Lesson 15: Risk Analysis without Request Number Webservice
Lesson 16: Audit Log Integration Webservice
Lesson 17: Exit Log Webservice

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 145


Audit Log Webservice: Lesson Objectives

After completing this lesson, you will be able to:


 Identify the input parameters
 Learn all the validation and support for input parameters
 Indentify the output parameters
 Able to execute the webservise successfully

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 146


Input Parameters: Audit Log Webservice

Serial No. Field Name Mandatory/ Description Comments


Optional
1 RequestNumber Optional Request Number
2 UserId Optional User id Request Created by
User ID
3 MaxHits Optional Maximum Limited to 100
number request number
4 DateFrom Optional From date

5 DateTo Optional To date


6 Language Optional Language

7 Action Optional Action Currently Not


supported

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 147


Input Parameters: Validations And Support

Web service name: GRAC_AUDIT_LOGS_WS


 All input are mandatory from interface point of view, but if user executes the
service without passing anything user will be asked to pass Request Number or User
ID or Date.

Validations and Input format for input fields:


 Maximum Hits : If user does not enter anything in this parameter , hits are
maximized to first 100 Log entries . These 100 entries are validated on
number of request not on audit log entries , result will be
displayed irrespectively how many audit log is generated for a request
number .
Eg:- If user has entered only user id in input fields .
Now If Data that exists for him is more than 100 requests than he would
only be able to see first 100 request ,rest requests will not be shown
 Date From : Format supported YYYYMMDD
 Date To : Format supported YYYYMMDD
 Action : Currently not supported included in interface to sync with old version

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 148


Output Parameters: Audit Log Webservice 1/3

Output information is structured in nested format. At header level data related to Request
number is displayed ,at second level of the structure all provision item are displayed and at the
third level audit logs for every provision item is displayed

Audit Logs Main Header Table


Serial No. Name Description
1 RequestNumber Single value Request No
2 Requested_by Single value Requested by
3 Submitted_by Single value
4 Status Single value Status of Request
5 CreateDate Single value Date of creation of Request
6 Priority Single value Priority for request
7 ItAuditData List Request history in detail

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 149


Output Parameters: Audit Log Webservice 2/3

Request ItAuditData Structure


Serial No. Name Type Description

1 ActionDate Single value Date on which action was performed


2 ActionValue Single value Currently not supported
3 DependantId Single value Id on which request is created,
4 Description Single value Audit log text
5 DisplayString Single value Audit log text
6 Id Single value Unique id for this action
7 Path Single value Path
8 Stage Single value Request stage
9 UserId Single value UserId
10 ItAuditDataChild List Mother request id of this tree

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 150


Output Parameters: Audit Log Webservice 3/3

Request ItAuditDataChild Structure

Serial No. Name Type Description

1 ActionDate Single value Date on which action was performed


2 ActionValue Single value Currently not supported
3 DependantId Single value Id on which request is created,
4 Description Single value Audit log text
5 DisplayString Single value Audit log text
6 Id Single value Unique id for this action
7 Path Single value Path
8 Stage Single value Request stage
9 UserId Single value UserId

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 151


Return Messages: Structure Message Return

Serial No. Name Description Comment


1 MsgNo Message number 0 For Success,4 For Error
2 MsgType Message type Success ,Error
3 MsgStatement Message Text for message return

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 152


Audit Log: Lesson Summary

You should now be able to:


 Identify the input parameters
 Learn all the validation and support for input parameters
 Indentify the output parameters
 Able to execute the webservise successfully

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 153


Webservices: Unit Overview 1/2

Unit: Inbound Webservice


Lesson 1: Select Application Webservice
Lesson 2: Firefighter Object Webservice
Lesson 3: Lookup Webservice
Lesson 4: Search Role Webservice
Lesson 5: User’s Existing Assignment Webservice
Lesson 6: Role Details Webservice
Lesson 7: Submit User Access Request Webservice
Lesson 8: Organization Assignment Request Webservice
Lesson 9: Request Status Webservice
Lesson 10: Request Details Webservice

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 154


Webservices: Unit Overview 2/2

Unit: Inbound Webservice


Lesson 11: Provision Log Webservice
Lesson 12: Audit Log Webservice
Lesson 13: Exit Webservice
Lesson 14: Risk Analysis with Request Number Webservice
Lesson 15: Risk Analysis without Request Number Webservice
Lesson 16: Audit Log Integration Webservice
Lesson 17: Exit Log Webservice

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 155


Exit Webservice: Lesson Objectives

After completing this lesson, you will be able to:


 Identify the input parameters
 Learn all the validation and support for input parameters
 Indentify the output parameters
 Able to execute the webservise successfully

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 156


Input Parameters: Exit Webservice

Serial Field Name Mandatory Description Comments


No. /
Optional
1 Optional Request Number <Request
Number>$<Connec
RequestNumber torid>
2 Optional Sequence Number
EntrySeq of task
3 OperResponse Optional Response Code
4 Optional Response
OperResponseDesc description

•Web service Name: GRAC_EXIT_FROM_IDM_WS

•Inputfor exit Webservice supports multiple sequence update for a single request number ,
handshaking between IDM and GRC for update in request number is
<RequestNumber>$<ConnectorID> for parameter RequestNumber however no extra efforts
have to be done by IDM’s to maintain this formatting as same way information will be provide
by GRC while provisioning.
© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 157
Input Parameters: Validations And Support

From interface point of view nothing is mandatory but user needs to enter RequestNumber and
EntrySeq for a successful execution of Webservice

Validations and Input format for input fields:


 Combination of Request Number and Entry Sequence should exist in GRC box for updating
or else the following Error message will be displayed having Message No 4, Message type
ERROR and Message Statement Seq <seqno> of Request <request no> not found.

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 158


Return Messages: Structure Message Return

Serial No. Name Description Comment


1 MsgNo Message number 0 For Success,4 For Error
2 MsgType Message type Success ,Error
3 MsgStatement Message Text for message return

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 159


Exit Webservice: Lesson Summary

You should now be able to:


 Identify the input parameters
 Learn all the validation and support for input parameters
 Indentify the output parameters
 Able to execute the webservise successfully

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 160


Webservices: Unit Overview 1/2

Unit: Inbound Webservice


Lesson 1: Select Application Webservice
Lesson 2: Firefighter Object Webservice
Lesson 3: Lookup Webservice
Lesson 4: Search Role Webservice
Lesson 5: User’s Existing Assignment Webservice
Lesson 6: Role Details Webservice
Lesson 7: Submit User Access Request Webservice
Lesson 8: Organization Assignment Request Webservice
Lesson 9: Request Status Webservice
Lesson 10: Request Details Webservice

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 161


Webservices: Unit Overview 2/2

Unit: Inbound Webservice


Lesson 11: Provision Log Webservice
Lesson 12: Audit Log Webservice
Lesson 13: Exit Webservice
Lesson 14: Risk Analysis with Request Number Webservice
Lesson 15: Risk Analysis without Request Number Webservice
Lesson 16: Audit Log Integration Webservice
Lesson 17: Exit Log Webservice

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 162


Risk Analysis with Request Number
Webservice: Lesson Objectives

After completing this lesson, you will be able to:


 Identify the input parameters
 Learn all the validation and support for input parameters
 Indentify the output parameters
 Able to execute the webservise successfully

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 163


Input Parameters: Risk Analysis with Request
Number Webservice

Serial No. Field Name Mandatory/ Description Comments


Optional
1 RequestNo Mandatory Request No
2 HitCounts Optional No of records
3 Language Optional Language

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 164


Input Parameters: Validations And Support 1/2

1 Web Service name: GRAC_RISK_ANALYSIS_WITH_NO_WS.

2 Request No is mandatory. If we do not pass any value to this field, the following
ERROR message will be displayed having Message No 4 , Message type
‘ERROR’ and Message statement ‘Request No is mandatory’ .

3 If we pass invalid request no , we will get the following ERROR message having
Message No 4 , Message type ‘ERROR’ and Message statement ‘Invalid
Request No’.

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 165


Input Parameters: Validations And Support 2/2

4. Hit count is only number, the interface is attached with a calculator to avoid any
alphabetic entry.

5. On successful data retrieval, the following success message will be displayed


having Message No 0 and Message type ‘SUCCESS’ and Message statement
‘Data populated successfully’.

6. Language field is optional. User need to provide the queering language. In case
of no or wrong entry, the language will be set as login language.

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 166


Output Parameters: Risk Analysis with
Request Number Webservice 1/6
RiskViolationData

Serial No. Name Nature of Description


Output
1 UserId Single value User Id
2 RiskId Single value Risk id
3 RiskDesc Single value Risk Description
4 RiskLevel Single value Risk Level
5 RiskLevelDesc Single value Risk Level Description
6 RuleId Single value Rule Id
7 Role List Table List of Roles
8 System Single value System
9 SystemType Single value System Type
10 Mitigation Details Table Mitigation Details
Contd………………………….

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 167


Output Parameters: Risk Analysis with
Request Number Webservice 2/6
RiskViolationData

Serial No. Name Nature of Description


Output
11 Action Table Action
12 OrgRule Table Organisation Rule
13 RiskStatus Single value Risk Status
14 ViolationCount Single value Violation Count
15 LastExecutedOn Single value Last Executed On
16 Execution Count Single value No of Execution
17 RiskOwner Table List of Risk Owner
18 Tcode Table List Of Tcode

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 168


Output Parameters: Risk Analysis with
Request Number Webservice 3/6
RiskViolationData
Serial No. Name Nature of Description
Output
11 Action Table Action
12 OrgRule Table Organisation Rule
13 RiskStatus Single value Risk Status
14 ViolationCount Single value Violation Count
15 LastExecutedOn Single value Last Executed On
16 Execution Count Single value No of Execution
17 RiskOwner Table List of Risk Owner
18 Tcode Table List Of Tcode

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 169


Output Parameters: Risk Analysis with
Request Number Webservice 4/6
Role List
Serial No. Name Nature of Description
Output
1 Role Single value Role
2 CompositRole Single value Composit Role
Mitigation Details
Serial No. Name Nature of Description
Output
1 MitigationCtrl Single value Mitigation Control
2 MitigationStatus Single value Mitigation Status
3 Monitor Table List Monitor
Monitor
Serial No. Name Nature of Description
Output
1 MitigationCtrl Single value Mitigation Control

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 170


Output Parameters: Risk Analysis with
Request Number Webservice 5/6
Action
Serial No. Name Nature of Description
Output
1 Action Single value Action
OrgRule
Serial No. Name Nature of Description
Output
1 OrgRule Single value Organisation Rule
RiskOwner
Serial No. Name Nature of Description
Output
1 OwnerId Single value Id of Risk Owner
2 FullName Single value Full name of Risk Owner

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 171


Output Parameters: Risk Analysis with
Request Number Webservice 6/6
TCode
Serial No. Name Nature of Description
Output
1 RoleID Single value Role Id
2 RoleDesc Single value Role Description
3 System Single value System
4 Tcode Single value Tcode
5 TcodeDesc Single value Tcode Description
Parameter
Serial No. Name Nature of Description
Output
1 PARAMETER Single value Parameter Name
2 PARAMETER_VALUE Single value Parameter Value
3 PARAMETER_DESC Single value Parameter Description

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 172


Return Messages: Structure Message Return

Serial No. Name Description Comment


1 MsgNo Message number 0 For Success,4 For Error
2 MsgType Message type Success ,Error
3 MsgStatement Message Text for message return

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 173


Risk Analysis with Request Number
Webservice: Lesson Summary

You should now be able to:


 Identify the input parameters
 Learn all the validation and support for input parameters
 Indentify the output parameters
 Able to execute the webservise successfully

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 174


Webservices: Unit Overview 1/2

Unit: Inbound Webservice


Lesson 1: Select Application Webservice
Lesson 2: Firefighter Object Webservice
Lesson 3: Lookup Webservice
Lesson 4: Search Role Webservice
Lesson 5: User’s Existing Assignment Webservice
Lesson 6: Role Details Webservice
Lesson 7: Submit User Access Request Webservice
Lesson 8: Organization Assignment Request Webservice
Lesson 9: Request Status Webservice
Lesson 10: Request Details Webservice

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 175


Webservices: Unit Overview 2/2

Unit: Inbound Webservice


Lesson 11: Provision Log Webservice
Lesson 12: Audit Log Webservice
Lesson 13: Exit Webservice
Lesson 14: Risk Analysis with Request Number Webservice
Lesson 15: Risk Analysis without Request Number Webservice
Lesson 16: Audit Log Integration Webservice
Lesson 17: Exit Log Webservice

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 176


Risk Analysis without Request Number
Webservice: Lesson Objectives

After completing this lesson, you will be able to:


 Identify the input parameters
 Learn all the validation and support for input parameters
 Indentify the output parameters
 Able to execute the webservise successfully

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 177


Input Parameters: Risk Analysis without
Request Number Webservice 1/3

Serial No. Field Name Mandatory/ Description Comments


Optional
1 RoleType Mandatory if ObjectType Role Type
is ‘ROL’
2 ConnectorId Mandatory Connector Id -
System
3 ObjectId Mandatory Object Id
4 UserGroup Optional User group
5 ObjectType Mandatory ObjectType
6 OrgRule Optional Org Rule
7 OrgLevel Optional Org level
8 BusinessProc Optional Bus Procedure
9 RiskId Optional Risk Id
10 RuleId Optional Rule Id
Contd ………..

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 178


Input Parameters: Risk Analysis without
Request Number Webservice 2/3

Serial Field Name Mandatory/ Description Comments


No. Optional
11 RiskLevel Optional Risk Level
12 RuleSetId Optional Rule Set ID
13 ReportType Optional Report Type
14 ReportFormat Optional Report Format
15 Language Optional Language
16 UserType Optional User Type
17 Simulation Optional Simulation
18 SimuRiskOnly Optional Simulation Risk Only
19 ApplicationType Optional Application type
20 AddlAttrib Optional Additional Attributes
Contd ………

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 179


Input Parameters: Risk Analysis without
Request Number Webservice 3/3

Serial Field Name Mandatory/ Description Comments


No. Optional
21 HitCounts Optional If no value is supplied then By
default 100 records will be
displayed

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 180


Input Parameters: Validations And Support 1/2

1 Web Service name: GRAC_RISK_ANALYSIS_WOUT_NO_WS.

2 ConnectorId field is mandatory, failing to pass any value in this field, the
following ERROR message will be displayed having Message No 4 and
Message type ‘ERROR’ and Message Statement ‘Connector id is mandatory’.

3 ObjectId field is mandatory, failing to pass any value in this field,the following
ERROR message will be displayed having Message No 4 and Message type
‘ERROR’ and Message Statement ‘Object Field is Mandatory’,

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 181


Input Parameters: Validations And Support 2/2

4. Object type is mandatory, failing to pass any value in this field, the following
ERROR message will be displayed having Message No 4 and Message type
‘ERROR’ and Message Statement ‘Object type is mandatory’.

5. Object type will be either ‘ROL’ (for Role )or ‘USR’ (for User). For any other Object
Type, the following ERROR message will be displayed having Message No 4 and
Message type ‘ERROR’ and Message Statement ‘Invalid object type’.

6. Rest of the inputs are used for filtration.

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 182


Output Parameters: Risk Analysis without
Request Number Webservice
TCode
Serial No. Name Nature of Description
Output
1 UserId Single value User Id
2 RiskId Single value Risk id
3 RiskDesc Single value Risk Description
4 RiskLevel Single value Risk Level
5 RiskLevelDesc Single value Risk Level Description
6 RuleId Single value Rule Id
7 System Single value System
8 Action Single value Action
9 Lastexecutedon Single value Last Executed ON
10 Executioncount Single value Execution Count
11 Control Single value Control
12 Monitor Single value Monitor

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 183


Risk Analysis without Request Number
Webservice: Lesson Summary

You should now be able to:


 Identify the input parameters
 Learn all the validation and support for input parameters
 Indentify the output parameters
 Able to execute the webservise successfully

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 184


Webservices: Unit Overview 1/2

Unit: Inbound Webservice


Lesson 1: Select Application Webservice
Lesson 2: Firefighter Object Webservice
Lesson 3: Lookup Webservice
Lesson 4: Search Role Webservice
Lesson 5: User’s Existing Assignment Webservice
Lesson 6: Role Details Webservice
Lesson 7: Submit User Access Request Webservice
Lesson 8: Organization Assignment Request Webservice
Lesson 9: Request Status Webservice
Lesson 10: Request Details Webservice

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 185


Webservices: Unit Overview 2/2

Unit: Inbound Webservice


Lesson 11: Provision Log Webservice
Lesson 12: Audit Log Webservice
Lesson 13: Exit Webservice
Lesson 14: Risk Analysis with Request Number Webservice
Lesson 15: Risk Analysis without Request Number Webservice
Lesson 16: Audit Log Integration Webservice
Lesson 17: Exit Log Webservice

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 186


Audit Logs from GRC: Lesson Objectives

After completing this lesson, you will be able to:


 Identify the input parameters
 Learn all the validation and support for input parameters
 Indentify the output parameters
 Able to execute the webservise successfully

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 187


Audit Logs Scenarios

There are two scenarios supported:

AuditLogs from GRC: Incase of IDM Driven Provisioning, IDM can get the auditlogs
from GRC by using GRAC_AUDIT_LOGS_WS webservice .

Auditlogs from IDM:


Currently IDMs are notexposing the enough audit information. So only Request status
of is shown in the GRC Auditlogs.

Synchronous requests, the result from IDM is captured and the result is shown in
Auditlogs in GRC

Asynchronous requests,
For All Open requests: real time call is sent to IDM to fetch Request status
for the requests that are still open in IDM.
For All Closed requests: If the requests are processed and closed in IDM, then
IDM is expected to post the status of the request to GRC by using
GRAC_EXIT_FROM_IDM_WS webservice.

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 188


Input Parameters: Audit Log Integration
Webservice

Serial No. Field Name Mandatory/ Description Comments


Optional
1 RequestNumber Optional Request Number
2 UserId Optional User id Request Created by
User ID
3 MaxHits Optional Maximum Limited to 100
number request number
4 DateFrom Optional From date

5 DateTo Optional To date


6 Language Optional Language

7 Action Optional Action Currently Not


supported

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 189


Input Parameters: Validations And Support

Web service name: GRAC_AUDIT_LOGS_WS


 All input are mandatory from interface point of view, but if user executes the
service without passing anything user will be asked to pass Request Number or User
ID or Date.

Validations and Input format for input fields:


 Maximum Hits: If user does not enter anything in this parameter , hits are maximized to
first 100 Log entries . These 100 entries are validated on number of
request not on audit log entries , result will be displayed irrespectively
how many audit log is generated for a request number .
Ex:- If user has entered only user id in input fields .
Now If Data that exists for him is more than 100 requests than he would
only be able to see first 100 request ,rest requests will not be shown
 Date From : Format supported YYYYMMDD
 Date To : Format supported YYYYMMDD
 Action : Currently not supported included in interface to sync with old version

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 190


Output Parameters: Audit Log Integration
Webservice 1/2

Output information is structured in nested format. At header level data related to Request
number is displayed ,at second level of the structure all provision item are displayed and at the
third level audit logs for every provision item is displayed

Audit Logs Main Header Table

Serial No. Name Description


1 RequestNumber Single value Request No
2 Requested_by Single value Requested by
3 Submitted_by Single value
4 Status Single value Status of Request
5 CreateDate Single value Date of creation of Request
6 Priority Single value Priority for request
7 ItAuditData List Request history in detail

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 191


Output Parameters: Audit Log Integration
Webservice 2/2

Request ItAuditData Structure


Serial No. Name Type Description

1 ActionDate Single value Date on which action was performed


2 ActionValue Single value Currently not supported
3 DependantId Single value Id on which request is created,
4 Description Single value Audit log text
5 DisplayString Single value Audit log text
6 Id Single value Unique id for this action
7 Path Single value Path
8 Stage Single value Request stage
9 UserId Single value UserId
10 ItAuditDataChild List Mother request id of this tree

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 192


Return Messages: Structure Message Return

Serial No. Name Description Comment


1 MsgNo Message number 0 For Success,4 For Error
2 MsgType Message type Success ,Error
3 MsgStatement Message Text for message return

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 193


Audit Log: Lesson Summary

You should now be able to:


 Identify the input parameters
 Learn all the validation and support for input parameters
 Indentify the output parameters
 Able to execute the webservise successfully

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 194


Webservices: Unit Overview 1/2

Unit: Inbound Webservice


Lesson 1: Select Application Webservice
Lesson 2: Firefighter Object Webservice
Lesson 3: Lookup Webservice
Lesson 4: Search Role Webservice
Lesson 5: User’s Existing Assignment Webservice
Lesson 6: Role Details Webservice
Lesson 7: Submit User Access Request Webservice
Lesson 8: Organization Assignment Request Webservice
Lesson 9: Request Status Webservice
Lesson 10: Request Details Webservice

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 195


Webservices: Unit Overview 2/2

Unit: Inbound Webservice


Lesson 11: Provision Log Webservice
Lesson 12: Audit Log Webservice
Lesson 13: Exit Webservice
Lesson 14: Risk Analysis with Request Number Webservice
Lesson 15: Risk Analysis without Request Number Webservice
Lesson 16: Audit Log Integration Webservice
Lesson 17: Exit Log Webservice

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 196


Exit Log Webservice: Lesson Objectives

After completing this lesson, you will be able to:


 Identify the input parameters
 Learn all the validation and support for input parameters
 Indentify the output parameters
 Able to execute the webservise successfully

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 197


Input Parameters: Exit Log Webservice

Serial Field Name Mandatory Description Comments


No. /
Optional
1 Optional Request Number <Request
Number>$<Connec
RequestNumber torid>
2 Optional Sequence Number
EntrySeq of task
3 OperResponse Optional Response Code
4 Optional Response
OperResponseDesc description

•Web service Name: GRAC_EXIT_FROM_IDM_WS

•Inputfor exit Webservice supports multiple sequence update for a single request number ,
handshaking between IDM and GRC for update in request number is
<RequestNumber>$<ConnectorID> for parameter RequestNumber however no extra efforts
have to be done by IDM’s to maintain this formatting as same way information will be provide
by GRC while provisioning.
© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 198
Input Parameters: Validations And Support

From interface point of view nothing is mandatory but user needs to enter RequestNumber and
EntrySeq for a successful execution of Webservice

Validations and Input format for input fields:


 Combination of Request Number and Entry Sequence should exist in GRC box for updating
or else Error message having Message No 4 , Message type ‘ERROR’ and Message
Statement ‘Seq <seqno> of req <request no> not found’ .

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 199


Return Messages: Structure Message Return

Serial No. Name Description Comment


1 MsgNo Message number 0 For Success,4 For Error
2 MsgType Message type Success ,Error
3 MsgStatement Message Text for message return

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 200


Audit Logs from IdM for Synchronous
Requests:

Request Submission from GRC to Assign a role

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 201


Audit Logs from IdM for Synchronous
Requests:

Audit Log from IDM is displayed in GRC

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 202


Exit Log Webservice: Lesson Summary

You should now be able to:


 Identify the input parameters
 Learn all the validation and support for input parameters
 Indentify the output parameters
 Able to execute the webservise successfully

© SAP AG 20010 SAP BusinessObjects <Product Name> 10 / Page 203