Newer Version Available

This content describes an older version of this product. View Latest

Configuration of Integration Meta Data

The integration meta configuration defines dimensions, export columns, filters, or conditions for CSV exports.

Before creating an integration meta configuration entry in RTR Report Configuration", the Salesforce integration dimension meta configuration must be created, saved, and synchronized to off-platform.

You can create CSV export integration metadata configuration by adding new report configuration entry to RTR Report Configurations. For CSV export reports, provide the following inputs:
Attribute Description
Information Internal Name A unique internal name of the integration metadata configuration.
Configuration Usage Integration Metadata.
Configuration of sales org The sales organization to which the product belongs.
Configuration Reporting KPI Set The KPI set connected to measure dimension.

When you trigger an inbound integration data source, ensure that you specify the calendaryear instead of businessyear in the request parameters. For more information, see Triggering CSV Exports.

Note

Examples of the supported data sources

Examples of different supported data sources are listed in this section. Such a meta JSON must be saved to off-platform in order to enable CSV export. A meta JSON consists of the following blocks:
  • datasources:
    Inbound datasources:
    • PromotionTacticDailyMeasureReal
    • PromotionTacticWeeklyMeasureReal
    • DailyRealData
    • DailyIntData
    • ProductMeasures
    • AccountMeasures
    • AccountProductMeasures
    Writeback datasources:
    • AccountAndPromotionMeasures
    • PromotionMeasures
    • AccountAndTacticMeasures

    See Triggering the CSV Export Process for more information.

    Note

  • dimensions:
    Specifies dimensions to fetch data based on the selected data source:
    • accountdimension: Retrieves Salesforce data from CGCloud__Account_Extension__c
    • promotiondimension: Retrieves Salesforce data from CGCloud__Promotion__c
    • tacticdimension: Retrieves Salesforce data from CGCloud__Tactic__c
    • productdimension: Retrieves Salesforce data from Product2
    • kpidimension: Specifies the KPIs that are exported. The KPIs that are calculated based on the KPI set defined in the report configuration are available for the export.
    • timedimension: Specifies how to define the time dimension, by default, it’s fixed to the business year.
      • includetotal: true or false (include the total value of the KPI)
      • splitweeks: true (only valid for weekly or custom period) or false
      • period: weekly or monthly or custom
  • exportsettings:
    Specifies columns to generate in CSV file and CSV separator
    • columns: Array of strings referencing dimension attributes.
      dimensionname.attribute must exist in the corresponding dimension. the allowed accessors for timedimension:
      • timedimension.label
      • timedimension.StartDate
      • timedimension.EndDate
      • timedimension.yearnumber
      The allowed accessors for kpidimension:
      • kpidimension.label
      • kpidimension.measurecode
      • kpidimension.name
      Spread operator: The last column requires spread operator on either a kpidimension or timedimension accessor.

      When spread operator is used on kpidimension as the last column, accessors of kpidimension can’t be used in columns before. When spread operator is used on timedimension as the last column, accessors of timedimension can’t be used in columns before.

      Note

    • Separator: The string specifying CSV separator. The allowed separators are:
      • ,
      • |
      • ;
      • :
  • exportfilters:
    Specifies conditions to apply when export process fetches data from Salesforce dimensions.