Policy Modeling Files and Folders

When you create a new Policy Modeling project, a main project file with an '.xprj' extension is created (for example, KnowYourCustomer.xprj). This is located at the root level of the project folder in Windows Explorer.

Image of the files and folders installed in the root directory of a Policy Modeling project, as viewed in Windows Explorer

Tip: To locate a project in Windows Explorer from within Policy Modeling, on the Project tab, select the Summary subtab. Then select the Open project folder button. A new Windows Explorer window will be opened showing the root folder for the project.

A project will also contain some or all of the following folders:

  • assets - contains the style-related images used by the interview. The files are managed by Policy Modeling and should not be manually modified.
  • bin - contains the generated rule files. This folder is added when you create a new project. Note that this folder should not be placed under version control.
  • .cache - contains cached results of decision service reference invocations. This folder is added when you run test cases that depend on decision services. Note that this only applies to deployment-based decision service references. Project-based decision service references aren't cached.
  • FormTemplates - contains the RTF and PDF form template files and the sample.xml file used to generate forms. This folder is added when you create a new project.
  • Inclusions - contains the project inclusions. This folder is created when you add an inclusion to a project.
  • InterviewFileAssets - contains any images you have added to interview screens. This folder is added when you create a new project.
  • interview-theme - contains the files you can use to change the appearance of an interview. This folder is created when you click the Custom Files button in the Styles dialog box on the Interview tab.
    • The interview-theme/resources folder contains any text based custom files, such as css, js, json and html files.
    • The interview-theme/resources/images folder contains any custom image files referenced on interview screens.
    • The interview-theme/resources/commentary folder contains any html help files from a v10.4 migrated project.
  • Other - contains the ignored files from a v10.4 migrated project. This includes non-rule Word files, help files, data model files and data model diagram files.
  • output - contains the project *.ZIP file. This folder is created when you debug the rules or upload a project. Note that this folder should only be version controlled if the project is not being built using an automated build process.
  • Rules - contains the Word and Excel rule files, as well as any reference files. This folder is added when you create a new project.
  • TestLogs - contains the test case log files. This folder is added when you run the test cases in a project.
  • Tests - contains the testing documents. This folder is added when you create a new project.
  • Translations - contains the translation documents. This folder is created when you add a translation document to a project.

In addition to the main *.xprj file, there are numerous other files that are part of the Policy Modeling project. These are listed in the following table.

Table 1. The files used in Policy Modeling
File Description Location in project directory
*.xprj The main project file that records the file and folder structure of the project. /
compatibilityOptions.json The file used to provide compatibility settings to preserve legacy behavior. /
hubMappingSettings.xml The mapping between the project data model and the Intelligent Advisor Hub data model. Note that this file is only created after setting data mappings. /
hubModel.xml The local cache of the Intelligent Advisor Hub data model. This cache will be automatically updated at regular intervals before deploying the project, or manually updated through the Mapping Settings dialog. Note that this file is only created after connecting to Intelligent Advisor Hub. /
hub-project.bin The binary file containing a copy of the project at the time you last downloaded changes from the project repository in Intelligent Advisor Hub. Note that this file is only created after adding the project to a repository. It is used by Intelligent Advisor to determine what has changed in the project for the purpose of uploading changes to the repository. /
hub-project.xml The Intelligent Advisor Hub URL and deployment settings last used for the project. For security reasons, this file is excluded from project versions. /
Interview.xint The file that contains the screen definitions. /
projectDataModel.xml The data model file for the project. This defines entities and relationships used in the policy model, as well as any attributes that require a name. /
projectEnumerations.xml The enumerations (value lists) file for the project. This file is only created when you add a value list to the project. /
TestConnectorData.xls The file that contains the sample data used for offline testing of interviews that dynamically load data from a connected application. /
testPerformance.csv The file that contains a detailed breakdown of the total time spent executing the test cases, including time spent in each rule and in other parts of the think cycle. /
testResults.xml The file that contains the summary results when the test cases are run. /
verbs.xml The custom verbs file. This file is only created when you add a custom verbs list to the project. /
*.xgen The files containing the generated rule format for each rule document. These files are used to build policy model files for use in interviews. Each time a Word or Excel rule file is saved, the .xgen file corresponding to that file is overwritten with a new one containing the updated set of rules. /bin
*.rtf The Microsoft Word template files used with Analytics Publisher to generate forms. These are binary files. /FormTemplates/<locale>
Sample.xml The sample data file required by the Oracle Analytics Publisher Template Builder to author templates containing project data. /FormTemplates/<locale>
*.ttf The TrueType fonts used in font substitutions. /FormTemplates/fonts
font-substitution.xml The file that defines the source and target fonts to use when a form template substitutes one font with another TrueType font in the generated PDF form. /FormTemplates/fonts
*.bin The binary files containing the project inclusions. /Inclusions
appearance.properties The file that contains some of the settings controlling the appearance of Intelligent Advisor August 2016 interviews. This file is created when you click the Custom Files button in the Styles dialog (accessed on the Interview tab in Policy Modeling). Including custom files in your project may result in your project having to be manually upgraded for later versions of the product. /interview-theme/resources
*.zip The package of all of the individual output components of a policy model. These are binary files. /output
*.docx The Microsoft Word files containing rules. These are binary files. /Rules
*.xlsx The Microsoft Excel files containing rules. These are binary files. /Rules
*.ref The files that define the decision service references. /Rules
*.csv The Microsoft Excel comma separated values files containing the total execution times of all the test cases that were run at that point in time. /TestLogs
*.xlsx The Microsoft Excel files containing the test cases. /Tests
*.xlsx The Microsoft Excel files containing the translations for the project. /Translations

Note: Other files and folders not listed here do not affect the user-created content of a Policy Modeling project and so have been omitted.