Using Filter and Selection Parameter in ByD OData ...

knutheusermann · ‎02-08-2017

SAP Business ByDesign release 1702 comes with some major enhancements with regards to the ByD OData for Analytics API. OData filter parameter now support report selection parameter as well as personalized characteristics and master data characteristics. Overall OData API filters are now much closer to the embedded ByD reporting UI which makes it easier to understand OData for Analytics filtering capabilities and to optimize your integration scenario with regards to runtime and memory consumption.

The following OData examples illustrate existing and new possibilities to use OData for Analytics filter parameter. For general information and more details about ByD OData for Analytics please read my SAP Community blog post OData for SAP Business ByDesign Analytics.

Use Cases

Filter by Report Characteristics and Report Selection Parameter
1. Metadata using work center business analytics (entity container ana_businessanalytics_analytics.svc)
2. Metadata using work center for business user (for example entity container crm_customerinvoicing_analytics.svc)
3. OData request w/o parameter
4. OData request w/ select
5. OData request w/ select incl. a property referring to a selection parameter (negative test raising an error message)
6. Filter on selection parameter
7. Filter on characteristic
8. Filter on selection parameter and characteristic using same value
9. Filter on selection parameter and characteristic using different values

Report Fixed Value Selections
1. Metadata (negative test: characteristic with fixed value selection is not listed as selection parameter)
2. Repeat all tests of use case 1 and observe, that the fixed value selection always applies first

Report Initial Selection Default Values
1. OData request w/o parameter
2. Filter on selection parameter overwriting the Initial Selection Default Values
3. Filter on selection parameter not covered by Initial Selection Default Values
4. Filter on characteristic overwriting the Initial Selection Default Values (negative test)
5. Filter on characteristic not covered by Initial Selection Default Values

Report Default Selection Variants
1. OData request w/o parameter (negative test)

Personalized characteristics and selection parameter
1. Characteristics added in work center Business Analytics
2. Characteristics added by business users
3. Master data characteristics and selection parameter

Extension fields
1. Metadata
2. Use extension field as Fixed Value Selection, OData request w/o parameter
3. Use extension field with Initial Selection Default Value, OData request w/o parameter
4. Filter on extension field as personalized selection parameter
5. Filter on extension field as personalized characteristic

Glossary

Let me start with a little glossary of terms and definitions used in my examples to ensure a common understanding of terms and report features:

Key figure

Characteristic

OData Property - OData properties are fields exposed by the OData API incl. characteristics, key figures and selection parameter.

Selection parameter - Report characteristics used as selection criteria on the database (aka drill-down fields).

OData Filter Parameter - Report selection parameter or report characteristics used to filter report records.

Report Filter (UI) - A possibility to filter the records displayed on the UI; a pure UI feature not relevant for OData at all.

Initial View - The initial report view for all users defined in the report wizard.

Fixed Value Selection - A fixed selection criteria applied on database level and defined in the report wizard.

Initial Selection Default Values - Default values for selection parameter defined in the report wizard.

Report View - Any report view configured by a user in the report UI.

Report Default View - A report view configured as default view by a key user or business user in the report UI.

Report Default Selection Variant - A report selection variant configured as default by a key user or business user in the report UI.

Personalized characteristic (Added field) - A characteristic added by a key user or business user in the report UI.

Personalized selection parameter (Added field) - A characteristic added as selection parameter by a key user or business user in the report UI.

Personalized key figure (Added field) - A key figure added by a key user or business user in the report UI.

Master data characteristic - Master data characteristics are characteristics that can be that added to a report from a master data object using report personalization.

Extension field

Use Case 1: Filter by Report Characteristics and Report Selection Parameter

Create extension fields for customer invoices and edit some extension field values to be able to select/filter by these values later on.

Create a custom report as copy of standard report Invoice Volume with report ID CRMCIVIB_Q0001. Select some key figures and characteristics. Try to cover all dimensions, but make sure to select less than 50 key figures and characteristics in total.
For the following examples the following key figures, characteristics and selection parameter should be included:

Key Figures: Total Formatted, Counter Formatted

Characteristics: Account, Invoice Date, Sales Unit, Product Category

Characteristics marked as selection parameter: Sales Unit, Product Category

The following characteristics should not be included: Item Processing Type, Payment Method, Ship-To, because we will use them for personalization.

Assign the report to some business user work center, e.g. work center Customer Invoicing.

Custom Report ID for the following examples is Z2321FC51ED9EE5457F43EC, which is a copy of report Invoice Volume with report ID CRMCIVIB_Q0001.

Base URL using work center Business Analytics (entity container ana_businessanalytics_analytics.svc😞
https://myXXXXXX.sapbydesign.com/sap/byd/odata/ana_businessanalytics_analytics.svc/

Base URL using a work center for business users (for example entity container crm_customerinvoicing_analytics.svc😞
https://myXXXXXX.sapbydesign.com/sap/byd/odata/crm_customerinvoicing_analytics.svc/

Metadata using work center business analytics:
myXXXXXX.sapbydesign.com/sap/byd/odata/crm_customerinvoicing_analytics.svc/$metadata?entityset=RPZ2321FC51ED9EE5457F43ECQueryResults

Metadata using work center for business user:
myXXXXXX.sapbydesign.com/sap/byd/odata/crm_customerinvoicing_analytics.svc/$metadata?entityset=RPZ2321FC51ED9EE5457F43ECQueryResults

Observe:

Some report characteristics are mentioned twice in the entity metadata:

as property referring to a report characteristic (e.g. Property Name="CIP_SALES_UNIT" sap:label="Sales Unit ID")

and as property referring to a report selection parameter (e.g. Property Name="PAR_SEL_IP_SALES_UNIT" sap:label="Sales Unit").

The property referring to the selection parameter is indicated as sap:selection="true" together with the selection type sap:selection-type="multi-value" in the property attributes.

The properties referring to report characteristics correspond to the characteristics as defined in the report wizard in step "3 - Select Characteristics".
The properties referring to selection parameters correspond to the report characteristics enabled for value selection in the report wizard in step "4 - Characteristic Properties".

You can use both type of properties for filtering, but filtering using properties referring to the selection parameters is recommended for the purpose of runtime and memory consumption optimization, because the filter parameter values are applied on the database level always.

Filtering using properties referring to report characteristics might be applied on the database selection result only, depending on the overall report setup.

OData request w/o parameter:
myXXXXXX.sapbydesign.com/sap/byd/odata/crm_customerinvoicing_analytics.svc/RPZ2321FC51ED9EE5457F43ECQueryResults
Note: The response does not contain properties referring to the selection parameter, e.g. PAR_SEL_IP_SALES_UNIT.

OData request w/ select:
myXXXXXX.sapbydesign.com/sap/byd/odata/ana_businessanalytics_analytics.svc/RPZ2321FC51ED9EE5457F43ECQueryResults?$format=atom&$select=CDOC_INV_DATE,CDPY_BUYER_UUID,CIPR_REFO_CATCP,CIP_SALES_UNIT,FCITM_GR_AM_RC,FCZ0COUNT,TDPY_BUYER_UUID,TIPR_REFO_CATCP

OData request w/ select incl. a property referring to a selection parameter (negative test raising an error message):
myXXXXXX.sapbydesign.com/sap/byd/odata/ana_businessanalytics_analytics.svc/RPZ2321FC51ED9EE5457F43ECQueryResults?$format=atom&$select=CDOC_INV_DATE,CDPY_BUYER_UUID,CIPR_REFO_CATCP,CIP_SALES_UNIT,FCITM_GR_AM_RC,FCZ0COUNT,TDPY_BUYER_UUID,TIPR_REFO_CATCP,PAR_SEL_IP_SALES_UNIT
Note: The system returns error message: "Invalid Property PAR_SEL_IP_SALES_UNIT of Entity type RPZ2321FC51ED9EE5457F43EC"

Filter on selection parameter:
myXXXXXX.sapbydesign.com/sap/byd/odata/ana_businessanalytics_analytics.svc/RPZ2321FC51ED9EE5457F43ECQueryResults?$format=atom&$select=CDOC_INV_DATE,CDPY_BUYER_UUID,CIPR_REFO_CATCP,CIP_SALES_UNIT,FCITM_GR_AM_RC,FCZ0COUNT,TDPY_BUYER_UUID,TIPR_REFO_CATCP&$filter=PAR_SEL_IP_SALES_UNIT eq 'GCFR42100'&$inlinecount=allpages

Filter on characteristic:
myXXXXXX.sapbydesign.com/sap/byd/odata/ana_businessanalytics_analytics.svc/RPZ2321FC51ED9EE5457F43ECQueryResults?$format=atom&$select=CDOC_INV_DATE,CDPY_BUYER_UUID,CIPR_REFO_CATCP,CIP_SALES_UNIT,FCITM_GR_AM_RC,FCZ0COUNT,TDPY_BUYER_UUID,TIPR_REFO_CATCP&$filter=CIP_SALES_UNIT eq 'GCFR42100'&$inlinecount=allpages

Filter on selection parameter and characteristic using same value:
myXXXXXX.sapbydesign.com/sap/byd/odata/ana_businessanalytics_analytics.svc/RPZ2321FC51ED9EE5457F43ECQueryResults?$format=atom&$select=CDOC_INV_DATE,CDPY_BUYER_UUID,CIPR_REFO_CATCP,CIP_SALES_UNIT,FCITM_GR_AM_RC,FCZ0COUNT,TDPY_BUYER_UUID,TIPR_REFO_CATCP&$filter=CIP_SALES_UNIT eq 'GCFR42100' and PAR_SEL_IP_SALES_UNIT eq 'GCFR42100'

Filter on selection parameter and characteristic using different values:
myXXXXXX.sapbydesign.com/sap/byd/odata/ana_businessanalytics_analytics.svc/RPZ2321FC51ED9EE5457F43ECQueryResults?$format=atom&$select=CDOC_INV_DATE,CDPY_BUYER_UUID,CIPR_REFO_CATCP,CIP_SALES_UNIT,FCITM_GR_AM_RC,FCZ0COUNT,TDPY_BUYER_UUID,TIPR_REFO_CATCP&$filter=CIP_SALES_UNIT eq 'GCFR42100' and PAR_SEL_IP_SALES_UNIT eq 'GCZA-1200'
Note: The system returns an empty response, because the sales unit cannot have 2 different values at the same time.

Use Case 2: Report Fixed Value Selections

Open report wizard, step "4 - Characteristic Properties" and Set Fixed Value Selections for some characteristics, for example Sales Unit = 'GCFR42100'.

Note: Report Fixed Value Selections and Initial View Default Selections are not the same. The Initial View Default Selection can be overruled using OData filter parameter whereas Fixed Value Selections cannot be changed in OData requests.

Metadata (negative test: characteristic with fixed value selection is not listed as selection parameter):
myXXXXXX.sapbydesign.com/sap/byd/odata/ana_businessanalytics_analytics.svc/$metadata?entityset=RPZ2321FC51ED9EE5457F43ECQueryResults
Note: The Sales Unit is no longer listed as property referring to a report selection parameter.

Repeat all tests from use case 1 and observe, that the fixed value selection always applies first…

OData request w/o parameter and w/ select:
Observe: The OData request returns customer invoices with sales unit GCFR42100 only.

Filter on selection parameter:
Observe: The system returns error message "Property PAR_SEL_IP_SALES_UNIT not found in type RPZ2321FC51ED9EE5457F43ECQueryResult"

Filter on characteristic:
myXXXXXX.sapbydesign.com/sap/byd/odata/ana_businessanalytics_analytics.svc/RPZ2321FC51ED9EE5457F43ECQueryResults?$format=atom&$select=CDOC_INV_DATE,CDPY_BUYER_UUID,CIPR_REFO_CATCP,CIP_SALES_UNIT,FCITM_GR_AM_RC,FCZ0COUNT,TDPY_BUYER_UUID,TIPR_REFO_CATCP&$filter=CIP_SALES_UNIT eq 'GCFR42100'&$inlinecount=allpages

Note:

Filtering by the characteristic sales unit 'GCFR42100' ($filter=CIP_SALES_UNIT eq 'GCFR42100') returns customer invoices with sales unit GCFR42100

Filtering by the characteristic sales unit 'GCFR42100' ($filter=CIP_SALES_UNIT eq 'GCZA-1200') returns no customer invoices because the fixed value selection is applied first and cannot be overruled by OData filter

Conclusion:

Report Fixed Value Selections are effective possibilities to restrict access to ByD data using OData for Analytics.

Remove the report fixed value selection before you go ahead with use case 3.

Use Case 3: Report Initial Selection Default Values

Open report wizard, step "5 - Define Variables" and Maintain Default Values for some characteristics, for example Sales Unit = 'GCFR42100' and Product Category = '10-40'.

OData request w/o parameter:
Note: The system returns customer invoices according the maintained initial selection default values.

Filter on selection parameter overwriting the Initial Selection Default Values for sales unit and product category:
myXXXXXX.sapbydesign.com/sap/byd/odata/ana_businessanalytics_analytics.svc/RPZ2321FC51ED9EE5457F43ECQueryResults?$format=atom&$select=CDOC_INV_DATE,CDPY_BUYER_UUID,CIPR_REFO_CATCP,CIP_SALES_UNIT,FCITM_GR_AM_RC,FCZ0COUNT,TDPY_BUYER_UUID,TIPR_REFO_CATCP&$filter=PAR_SEL_IP_SALES_UNIT eq 'GCNL-1200' and PAR_SEL_IPR_REFO_CATCP eq '80-10'&$inlinecount=allpages
Note: Initial selection default values can be overwritten by OData selection parameter

Filter on selection parameter overwriting the Initial Selection Default Value for sales unit only:
myXXXXXX.sapbydesign.com/sap/byd/odata/ana_businessanalytics_analytics.svc/RPZ2321FC51ED9EE5457F43ECQueryResults?$format=atom&$select=CDOC_INV_DATE,CDPY_BUYER_UUID,CIPR_REFO_CATCP,CIP_SALES_UNIT,FCITM_GR_AM_RC,FCZ0COUNT,TDPY_BUYER_UUID,TIPR_REFO_CATCP&$filter=PAR_SEL_IP_SALES_UNIT eq 'MC45000'&$inlinecount=allpages
Note: Initial selection default values that are not provided in the OData request always apply

Filter on selection parameter not covered by Initial Selection Default Values:
myXXXXXX.sapbydesign.com/sap/byd/odata/ana_businessanalytics_analytics.svc/RPZ2321FC51ED9EE5457F43ECQueryResults?$format=atom&$select=CDOC_INV_DATE,CDPY_BUYER_UUID,CIPR_REFO_CATCP,CIP_SALES_UNIT,FCITM_GR_AM_RC,FCZ0COUNT,TDPY_BUYER_UUID,TIPR_REFO_CATCP&$filter=PAR_SEL_DOC_INV_DATE ge datetime'2016-12-01T00:00:00'&$inlinecount=allpages
Note: Additional selection parameter beyond the initial selection default values can be applied using OData filter to refine the result

Filter on characteristic overwriting the Initial Selection Default Values (negative test):
myXXXXXX.sapbydesign.com/sap/byd/odata/ana_businessanalytics_analytics.svc/RPZ2321FC51ED9EE5457F43ECQueryResults?$format=atom&$select=CDOC_INV_DATE,CDPY_BUYER_UUID,CIPR_REFO_CATCP,CIP_SALES_UNIT,FCITM_GR_AM_RC,FCZ0COUNT,TDPY_BUYER_UUID,TIPR_REFO_CATCP&$filter=CIP_SALES_UNIT eq 'MC45000'&$inlinecount=allpages
Note: The OData request returns an empty result, initial selection default values cannot be overwritten by OData filter properties referring to a report characteristic

Filter on characteristic not covered by Initial Selection Default Values:
myXXXXXX.sapbydesign.com/sap/byd/odata/ana_businessanalytics_analytics.svc/RPZ2321FC51ED9EE5457F43ECQueryResults?$format=atom&$select=CDOC_INV_DATE,CDPY_BUYER_UUID,CIPR_REFO_CATCP,CIP_SALES_UNIT,FCITM_GR_AM_RC,FCZ0COUNT,TDPY_BUYER_UUID,TIPR_REFO_CATCP&$filter=CDOC_INV_DATE ge datetime'2016-12-01T00:00:00'&$inlinecount=allpages

Conclusion:

Report Initial Selection Default Values can be used to tailor ByD reports for OData consumption to simplify filtering in OData requests and to optimize runtime and memory consumption.
Report Initial Selection Default Values can be overwritten or refined using OData filter parameter.

Use Case 4: Report Default Selection Variants

Login as key user and open work center Business Analytics, view Design Reports.

Open the Report Wizard, step "5 - Define Variables" and observe that the Initial Selection contains Default Values for some characteristics, for example:

Sales Unit = 'GCFR42100'

Product Category = '10-40'

Edit the report with your web browser and edit the report selection parameter incl. overwriting the Initial Selection Default Values, for example:

Sales Unit = 'MC43200'

Product Category = '20'

Click on Set As Default to save the selection variant as Default Selection Variant.

OData request w/o parameter:
myXXXXXX.sapbydesign.com/sap/byd/odata/crm_customerinvoicing_analytics.svc/RPZ2321FC51ED9EE5457F43ECQueryResults?$format=json&$inlinecount=allpages

Observe:

The Initial Selection Default Values (Sales Unit = 'GCFR42100', Product Category = '10-40') are applied by the system; the Report Default Selection Variant is not taken into account. The same applies for all non-default report selection variants.

Conclusion:

Report selection variants are not taken into account by the OData API.

Use Case 5: Personalized characteristics and selection parameter

Key user using work center Business Analytics

Login as key user and open work center Business Analytics, view Design Reports.

Select your report and click on "Edit With Web Browser".
Click on "Add Fields" and add a characteristic to the list of fields not currently shown ("Display in Report") and to the selection area ("Display in Selection Area"). In my example I added the field "Item Processing Type".
Click on "OK" and check if the fields added are available in the report.

Request OData Metadata:
Observe that the list of properties contains 2 new properties:

the characteristic Item Processing Type ID (CITM_PROC_TYP_CD) as filterable characteristic

and the corresponding text property Item Processing Type Text (TITM_PROC_TYP_CD).

Note, that the personalized characteristic Item Processing Type has not been added as property referring to the selection parameter (sap:selection="true").

OData request w/o parameter:
Observe, that the system returns the 2 new properties.

Filter on personalized characteristic:
myXXXXXX.sapbydesign.com/sap/byd/odata/ana_businessanalytics_analytics.svc/RPZ2321FC51ED9EE5457F43ECQueryResults?$format=atom&$select=CDOC_INV_DATE,CDPY_BUYER_UUID,CIPR_REFO_CATCP,CIP_SALES_UNIT,FCITM_GR_AM_RC,FCZ0COUNT,TDPY_BUYER_UUID,TIPR_REFO_CATCP,CITM_PROC_TYP_CD,TITM_PROC_TYP_CD&$inlinecount=allpages&$filter=PAR_SEL_IP_SALES_UNIT eq 'MC42162' and PAR_SEL_IPR_REFO_CATCP eq '50-10' and CITM_PROC_TYP_CD eq 'CCMI'
Note: The filter on the personalized characteristic is applied as expected; in this example credit memo items are returned only.

Request OData Metadata using some other business user:
Note: Personalized characteristics that are added as key user using work center Business Analytics are available to all users.

Conclusion:

Personalized characteristics are exposed via OData as filterable characteristic, but not as property referring to the selection parameter.
Hierarchical parameters and relative selects are also not supported as well.

Business user using a business user work center

Assume you are working with 3 ByD users:

User A with access to work center Business Analytics (acting as key user) as well as to work center Customer Invoicing (acting as business user)

User B with access to work center Customer Invoicing only (always acting as business user)

Login as user A and open work center Customer Invoicing, view Reports List, and open the report.
Click on "Add Fields" and add a characteristic to the list of fields not currently shown ("Display in Report") and to the selection area ("Display in Selection Area"). In my example I added the field "Payment Method".
Click on "OK" and check if the fields added are available in the report.

Login as user B and open work center Customer Invoicing, view Reports List, and open the report.
Click on "Add Fields" and add a characteristic to the list of fields not currently shown ("Display in Report") and to the selection area ("Display in Selection Area"). In my example I added the field "Ship-To".
Click on "OK" and check if the fields added are available in the report.

Request OData Metadata with login as user A (acting as key user) using entity set ana_businessanalytics_analytics:
myXXXXXX.sapbydesign.com/sap/byd/odata/ana_businessanalytics_analytics.svc/$metadata?entityset=RPZ2321FC51ED9EE5457F43ECQueryResults
OData request w/o parameter:
myXXXXXX.sapbydesign.com/sap/byd/odata/ana_businessanalytics_analytics.svc/RPZ2321FC51ED9EE5457F43ECQueryResults
Observe: In both OData responses the properties Payment Method and Ship-To are not included.

Request OData Metadata with login as user A (acting as business user) using entity set crm_customerinvoicing_analytics:
myXXXXXX.sapbydesign.com/sap/byd/odata/crm_customerinvoicing_analytics.svc/$metadata?entityset=RPZ2321FC51ED9EE5457F43ECQueryResults
OData request w/o parameter:
myXXXXXX.sapbydesign.com/sap/byd/odata/crm_customerinvoicing_analytics.svc/RPZ2321FC51ED9EE5457F43ECQueryResults
Observe: In both OData responses the property Payment Method is included as characteristics for ID and text, and the property Ship-To is not included.

Request OData Metadata with login as another business user B using entity set crm_customerinvoicing_analytics:
myXXXXXX.sapbydesign.com/sap/byd/odata/crm_customerinvoicing_analytics.svc/$metadata?entityset=RPZ2321FC51ED9EE5457F43ECQueryResults
OData request w/o parameter:
myXXXXXX.sapbydesign.com/sap/byd/odata/crm_customerinvoicing_analytics.svc/RPZ2321FC51ED9EE5457F43ECQueryResults
Observe: In both OData responses the property Payment Method is not included and the property Ship-To is included as characteristics for ID and text.

Conclusion:

Personalized characteristics that are added as business user (not using work center Business Analytics) can be retrieved by the same user only.

Furthermore these business user characteristics are not exposed if you are using entity set ana_businessanalytics_analytics.svc.

Master data characteristics and selection parameter

Master data characteristics are characteristics that can be that added to a report from a master data object using report personalization.

Login as key user and open work center Business Analytics, view Design Reports.
Select your report and click on "Edit With Web Browser".
Click on "Add Fields", expand some master data object (for example "Account") and add a characteristic to the list of fields not currently shown ("Display in Report") and to the selection area ("Display in Selection Area"). In my example I added the field "Industry (Account)" following the path "Dimension: Business Partner/Account/Industry".
Click on "OK" and check if the added field is available in the report as characteristic as well as selection parameter.

Request OData Metadata:
Note that the list of properties contains 2 new properties: the characteristic Industry ID as filterable characteristic and the corresponding text property Industry Text. Note furthermore that the master data characteristic has not been added as property referring to the selection parameter (sap:selection="true").

OData request w/o parameter:
Observe, that the system returns the 2 new properties.

Conclusion:

Master data characteristics can be added to ByD reports using personalization and can be used by the OData API similar to other personalized characteristics and selection parameter.

Use Case 6: Extension fields

Add a key user extension field to your business object if not done already. Edit the extension field in some business object instances to be able to test filtering later on.

Open the Report Wizard, add the extension field in step "3 - Select Characteristics" and enable the extension field for value selection in step "4 - Characteristic Properties" .

Request OData Metadata:
Note that the extension field is added as property referring to a report characteristic as well as property referring to a report selection parameter. Note as well, that the separator "-" has to be passed as "s" in lowercase, for example "Cs1ANsDBABF71A70044F3" and "PAR_SEL_s1ANsDBABF71A70044F3".

Use extension field as Fixed Value Selection:

Open the Report Wizard, step "4 - Characteristic Properties" and choose Set Fixed Value Selections for the extension field.

OData request w/o parameter:
Note, that the fixed value selection of the extension field is applied by the OData API as well.

Use extension field as Initial Selection Default Value:

Open the Report Wizard, remove the fixed value selection and maintain a Report Initial Selection Default Value for the extension field.

OData request w/o parameter:
myXXXXXX.sapbydesign.com/sap/byd/odata/ana_businessanalytics_analytics.svc/RPZ2321FC51ED9EE5457F43ECQueryResults?$format=atom&$select=CDOC_INV_DATE,CDPY_BUYER_UUID,CIPR_REFO_CATCP,CIP_SALES_UNIT,FCITM_GR_AM_RC,FCZ0COUNT,TDPY_BUYER_UUID,TIPR_REFO_CATCP,CITM_PROC_TYP_CD,TITM_PROC_TYP_CD,Cs1ANsDBABF71A70044F3&$inlinecount=allpages&$filter=PAR_SEL_s1ANsDBABF71A70044F3 eq 'KHi1'
Note: The Initial Selection Default Value for extension fields is applied on OData requests as well and can be overwritten using the corresponding property referring to the report selection parameter.