Start of Content Area

Background documentation Open Dialog for New Document  Locate the document in its SAP Library structure

Use

Using the Open Dialog for New Document command (OPEN_DIALOG_DLG_NEW_DOC), you can open a dialog box to create a new document for InfoProvider, master data or metadata selections.

NoteThis command is particularly useful if you do not use the Single Document Web item in your Web application. You can assign this command to a pushbutton. When you choose this pushbutton, the dialog box to create new documents for your selection is displayed.

Command Parameters

The list below shows the command parameters in the sequence in which they appear in the Command Wizard when you insert the command:

Parameter

Description

Target Web Item (TARGET_ITEM_REF)

This parameter is not relevant.

Choose Next to navigate to the parameters for the command.

Document Action (DOCUMENTACTION)

You use this parameter to specify the type of document to be created. Alternatively, you can load an existing document:

      Comments

      Formatted Text

      Upload

Data Provider (DATA_PROVIDER_REF)

You use this parameter to specify which data provider the command is to relate to.

Document Type (WWW_DOC_TYPE)

You use this parameter to classify documents by assigning a freely selectable document type to them.

Document Class (DOCUMENT_CLASS_SPECIFIC)

You use this parameter to specify for which BI object the documents are to be created:

      InfoProvider Data (DATA_CONTEXT)

      Metadata (BW_OBJECT)

      Master Data (CHARACTERSTIC_MEMBER_SPECIFIC)

Depending on the value you select for the Document Classparameter, you need to set the following additional parameters:

Parameter Value: InfoProvider Data (DATA_CONTEXT)

Parameter

Description

 

 

Data Row (DATA_ROW)

You use this parameter to specify the row number of the data cell for which the documents are to be displayed. The row number of the first data cell has the value 0. The default value is -1.

Data Column (DATA_COLUMN)

You use this parameter to specify the column number of the data cell for which the documents are to be displayed. The column number of the first data cell has the value 0. The default value is -1.

ExampleUsing the Data Row (DATA_ROW) and Data Column (DATA_COLUMN) parameters, you can specify the data cell for which you want to create a document. If you set the values for the DATA_ROW and DATA_COLUMN parameters to -1, you can create documents for the entire InfoProvider selection as it is specified by the data provider.

 

Parameter Value: Metadata (BW_OBJECT)

Parameter

Description

BI Object (BW_OBJECT)

You select the BI object for which the document is to be created:

      InfoObject (INFO_OBJECT)

      Web Template (TEMPLATE)

      Reusable Web Item (REUSABLE_WEB_ITEM)

      Query View (VIEW)

      Query (QUERY)

      Filter (SELECTOR)

      Workbook (EXCEL_WORKBOOK)

      InfoCube (INFOCUBE)

ExampleYou want to display a metadata document for a query. Select Query for the BI Object parameter and enter the name of the query.

 

Parameter Value: Master Data (CHARACTERSTIC_MEMBER_SPECIFIC)

Parameter

Description

Characteristic (CHARACTERISTIC)

You use this parameter to specify the characteristic for which the document is to be created.

Member Name (MEMBER_NAME)

You use this parameter to specify the characteristic value to which the document is to relate.

ExampleFor a specific customer in your customer list, for characteristic customer 0D_CUSTOMER, you want to create a document for customer ABC. As characteristic value, enter the name of the customer ABC.

If the data provider returns a unique value, you can leave this parameter empty.

 

Name of the Hierarchy (HIERARCHY_NAME)

You use this parameter only if you want to create a document for a hierarchy node.

Enter a hierarchy name.

Hierarchy Node Type (HIERARCHY_NODE_TYPE)

You use this parameter to specify the type of hierarchy node for which you want to create a document:

      Text node

      Characteristic value

ExampleYour customer list is structured hierarchically according to regions. You have defined a hierarchy named HIERARCHY_REGION for the characteristic customer 0D_Customer; this hierarchy does not contain its own characteristic for the region, but contains the text nodes North, South, East, and West. For the text node East, you want to create a document that contains the information for all customers in the region East, such as the delivery type, for example. Select 0HIERNODE as the value for the hierarchy node type.

ExampleYour customer list is structured hierarchically according to countries. You have defined a hierarchy named HIERARCHY_COUNTRY for the characteristic customer 0D_CUSTOMER. This contains the nodes DE and US, which are characteristic values for the characteristic country 0D_COUNTRY. You want to create a document for the characteristic value DE. For the hierarchy node type, specify the name of the characteristic to which the node relates, in this case 0D_COUNTRY.

 

Version (VERSION)

You use this parameter to specify the hierarchy version for which you want to create a document.

Key Date (yyyymmdd) (DUEDATE)

You use this parameter to specify the date for the time-dependent hierarchy for which you want to create a document.

 

 

 

End of Content Area