Source Control for OAC Webcatalog Objects

The FlexDeploy OAC solution allows developers to either source the WebCatalog objects from a development OAC instance or from a source control system. To source control WebCatalog objects there are two main practices that must be followed.

First, the web catalog objects stored in source control must maintain the same directory structure as the OAC WebCatalog.  The root path in your source control repository can be anything, but the directory structure under it must exactly match that of the WebCatalog. For example, notice the WebCatalog path for the report below:


The path above must match the path in the source control system as we see below.

For the above example, FlexDeploy project source configuration will be configured with "OAC/shared/Financials" as the sparse folder when using Git. This would ensure that all objects under that folder will be discovered as WebCatalog objects and the file path starts with /shared/Financials which matches the WebCatalog path in OAC.

Secondly, the files stored in source control should be named with the following extensions corresponding to the object type.  The extensions are important to both ensure the deployment operation is handled correctly, and to make it easier to identify and search for these objects in FlexDeploy.

OAC Type NameOAC Signature / Composite Signature*Source Control Extension
ActionactionAction
Agentcoibot1Agent
Analysisqueryitem1Analysis
Columncosavedcolumn1Column
Conditioncondition1Condition
Dashboarddashboardfolder1Dashboard
Data Model.xdm *Data Model
Dashboard Promptglobalfilteritem1Dashboard Prompt
Filterfilteritem1Filter

Hyperion Financial Reporting Report

application/hyperion-reports-report

Financial Reporting Report
Groupcustomgroup1Group
KPIkpi1KPI
KPI Watchlistscorecardkpiwatchlist1KPI Watchlist
Mobile App.xmaMobile App
Report.xdo *Report
Scorecardscorecard1Scorecard
ShortcutN/AShortcut
Style Template.xss *Style Template
Visual Analyzer Projectsprojectfolder1Visual Analyzer Projects

The OAC signature can be viewed by hovering over the  icon on the OAC WebCatalog Manager's properties for a catalog object (see image above).

The manual process of ensuring folder structure and file extensions can be cumbersome when managed manually.  See Automate check-in of development OAC catalog items to SCM for details on more effectively managing this.

The following macros are not currently supported in the footer:
  • style