Fonction SAP BAPI_LAWCONSUTY_GETLIST - LAW: Consolidated User Types

Paramètre Reférence Type Long. Valeur par déf. Facultatif Description
MAX_ROWS BAPILAWMISC-BAPIMAXROW I 4 0 X Maximum Number of Lines of Hits
PRETTY_PRINT BAPILAWMISC-BAPILAWPTPRINT C 1 ' ' X Formatting of an XML Document (Line Breaks)
WITH_TEXT BAPILAWMISC-BAPILAWTXFL C 1 ' ' X Add Texts to Engines / User Types

Paramètre Reférence Type Long. Description
ROWS BAPILAWMISC-BAPIROWS I 4 Number of Selected User Types
SIZE BAPILAWMISC-BAPILAWXMLSIZE I 4 Size of an XML Document

Paramètre Reférence Long. Facultatif Description
CONSUTYPELIST BAPILAWCONSUTYPE 86 X BAPI Structure: Consolidated User Types in the License Administration Workbench
CONSUTYPELIST_XML BAPILAWXMLDOC 128 X License Administration Workbench: Structure for Output as XML Document
RETURN BAPIRET2 548 X Return Parameter

Functionality
This BAPI allows the output of consolidated user types that are storedin the License Audit Workbench (LAW). The transfer of user types isperformed using the table ConsUtypeList. Selection is not supported.The result can be created as tables with the structure ConsUtypeListor as an XML document.
During the consolidation, there are usually combinations of user types(including special version and country surcharge). For each of thesecombinations, there is a number of users that has this combinationof user types.
A combination has a number (field GROUP_ID). All rows with the sameGROUP_ID form a combination of this type. In the ConsUtypeList table,the number is always in the first row of the combination, in the NUMBERfield. (The following rows for the same combination always contain 0.)

Example
GROUP_ID LIC_TYP SPEC_VERS SURCHARGE UPGRADE_IND NUMBER ...
000021 ,,51 ,,,,00 ,,000 ,,S ,, ,,
0000000037 ...
000119 ,,01 ,,,,00 ,,000 ,,S ,,0000000023...
000119 ,,53 ,,,,00 ,,000 ,,S ,,0000000000...

Row 1: Simple case, the combination consists of only one user type, 5151 without a special version or country surcharge. There were 37 usersof this type, and the (trivial) combination receives the GROUP_ID000021.
Rows 2 and 3: The combination consists of user types 01 (withoutspecial version or country surcharge) and 53 (also without specialversion or country surcharge). There are 23 users, and the combinationreceives the GROUP_ID 000119.
Report RSLAW_TEST_BAPI

Description
Returns the number of selected user types.

Description
If an XML document was requested, the size of this document isspecified in this field.

Description
You can use this parameter to specify the maximum number of rows forthe set of hits. In this way, you can limit the size of the resulttable.

Value range
0 - 2 **32 -1

Default
0 , No limit

Description
Formatting of the XML document in accordance with the documentstructure. Very helpful in test cases.

Description
You can use this table to request the extension of the output list toinclude the user types and special versions.

Value range
' ',,Output without text
'X',,Output with text

Default
' ',,Output without text

Description
List of the selected consolidated user types.

Description
Table for the result of the selection in the form of an XML document.If you have restricted the number of rows, the result set may havebeen prematurely closed.

Description
Standard BAPI return table. Contains all error messages thatoccurred during processing.

Value range
The following error messages are possible:

  • You are not authorized to display LAW data

  • Selection criterion does not contain any parameters

  • Selection criterion <(>&<)>1-&2 is not supported

  • Internal error at &1, &2