Prerequisites

Procedure

1. In the Solution Explorer, do the following:

   Custom Business Object	SAP Business Object
   Right-click your business object and select Create Data Source. The Data Source Wizard opens.	Right-click your solution and select   Add   New Item  The Add New Item dialog opens. Select   SAP   Analytics   Data Source  and click Add. The Data Source Wizard opens.

2. In the Create a Data Source step, define your data source by doing the following:

   1. Select a namespace.

      By default, the namespace for your solution is selected; however, to create a data source based on an SAP business object, you can select an SAP namespace.

   2. Select a business object.

   3. Select an anchor node to link to the data source.

      If a [1,n] association is defined for a field, the field is not displayed in the business object hierarchy. Therefore, we recommend that you select the most detailed node as the anchor node. For more information about associations, see Syntax for Business Object Definitions under Association. You can also select nodes of dependent objects, for example, TextCollection.Root. >>> MISSING TARGET TEXT FOR TEXT-ID: 'XTXT_a11y_TipEnd' <<<

   4. Enter the data source name.

   5. Optional: Enter a description of the data source.

   6. Optional: To allow access restrictions for data in reports based on this data source, select Enable Access Control.

      The access restrictions of the anchor business object are inherited; therefore customers can only assign reports based on this data source to work center views with the same access control.

   7. Optional: To allow referencing by another data source and allow the fields of your data source to be used in reports based on the referencing data source, select Allow Referencing.

      • If you want to allow referencing, under Reference Details, select the key field.

      • Optional: Under Object Based Navigation, specify a target UI.

        Users will be able to navigate from the report to this floorplan.

   8. Optional: To enable read access logging for sensitive personal data, select the Log Sensitive Personal Data checkbox.

   9. Click Next.

3. In the Select Data Source Fields step, select the fields you want to include in the data source.

   You can include fields from other business objects by using associations. The studio supports read access across deployment units in data sources. You can use cross-deployment-unit associations to access the data in business objects that are not assigned to the default deployment unit of your solution. For more information, see Deployment (Business Object).

   Not all fields and associations modeled in the business object are supported. Only supported fields and associations are displayed. End of the note

   Click Next.

4. Optional: In the Define Transformation Rules step, define transformation rules for fields of data type text (such as name and description), date, or GLOBAL_DataTime by doing the following:

   1. In the Business Object Element area, select a field and on the  Transformation tab, select a transformation rule.

   2. Define a field name for the transformation field and then press ENTER.

   3. If the transformation rule allows the selection of a second parameter, next to the Parameter field, click ....

      The Select Additional Transformation Rule Parameter dialog box opens.

   4. In the Select Additional Transformation Rule Parameter dialog box, select a second parameter by selecting a row and clicking the first cell in the row.

      For information about the available transformation rules, see Transformation Rules.

   5. Click Next.

5. Optional: In the Define Referenced Data Sources step, modify the parameters by doing the following:

   1. Display and define the names for the selected fields that are characteristics.

   2. Assign an existing data source to each parameter.

      If necessary, you can change the display name for each parameter. You can assign an existing data source if the fields of an SAP business object are already included in an SAP data source. End of the note

   3. Click Next.

6. Optional: In the Define Aggregation Behavior step, define the aggregation behavior for business object elements that are key figures.

   For more information about aggregation behavior, see Aggregation.

   The default aggregation of every key figure is Summation. You can change the default or add new aggregations. End of the note

7. Optional: In the Select Sensitive Personal Data Fields step include sensitive personal data fields for read access logging by selecting the Create Log checkbox against the field. You must then include a reference for the sensitive personal data field.

   If you select a field that has transformation rules, you can include only the parent field as the reference. End of the note

8. In the Review step, check that the information you have entered is correct and then click Finish.

   If you have defined aggregations, check that the selected aggregations are displayed correctly. End of the note

   A new item with the file extension .ds () appears in the Solution Explorer.

9. In the Solution Explorer, right-click the data source you have created and select Activate.

Result