Exports scenarios identified by configurable build criteria from an ODI development repository.

@since5.7.0.7 This operation supports full deployment projects and partial deployment projects of type Oracle Data Integrator, only if the scenarios are sourced from SCM (GIT, Subversion, etc..). Alternatively, you could use a partial shell operation to source from SCM.

Environment/Instance Properties

Property Name	Property Code	Required	Description
ODI Home	`FDODI_ODI_HOME`	Yes	Fully qualified path to the ODI installation directory which contains the odi folder.
ODI JDBC Driver Path	`FDODI_JDBC_DRIVER_PATH`	Yes	Classpath for locating the JDBC Driver. This is the complete path to the jar file which contains the JDBC driver.
ODI JDBC URL	`FDODI_JDBC_URL`	Yes	JDBC Connect String for the ODI Master/Work repositories.
ODI JDBC Driver	`FDODI_JDBC_DRIVER`	Yes	JDBC Driver to use for connecting to the ODI Master/Work repositories. (e.g. oracle.jdbc.driver.OracleDriver)
ODI Master User	`FDODI_MASTER_USER`	Yes	Database schema owner of the ODI Master repository.
ODI Master Password	`FDODI_MASTER_PASSWORD`	Yes	Database password for ODI Master User.
ODI User	`FDODI_ODI_USER`	Yes	User to connect to ODI instance with (must have `SUPERVISOR` privileges). (e.g. SUPERVISOR)
ODI Password	`FDODI_ODI_PASSWORD`	Yes	Password for ODI User.
ODI Work Repository	`FDODI_WORK_REPOSITORY`	Yes	The name of the target ODI work repository.
ODI Thread Count	`FDODI_THREAD_COUNT`	Yes	Thread pool size used for exporting and importing scenarios (default is 5, max is 20).
ODI Marker Group Code	`FDODI_MARKER_GROUP_CODE`	No	The code of the ODI Marker Group used for selecting scenarios within a build (default is `FLEXDEPLOY`).

Project Properties

Property Name	Property Code	Required	Description
ODI Project Code	`FDODI_PROJECT_CODE`	Yes	The code of the target ODI project.
ODI Marker Code	`FDODI_MARKER_CODE`	No	The code of the Marker within the defined Marker Group for this build.
ODI Include Pattern	`FDODI_INCLUDE_PATTERN`	No	Regular expression which identifies scenario name patterns to include in the build (e.g. ._Order.).
ODI Exclude Pattern	`FDODI_EXCLUDE_PATTERN`	No	Regular expression which identifies scenario name patterns to exclude from the build (e.g. ._Old.).
ODI Versions	`FDODI_VERSIONS`	No	List of scenario version numbers (comma-separated) to include in the build.

Inputs

Input Name	Input Code	Required	Description

Outputs

Output Name	Required	Description

Artifacts

This operation produces artifacts that will be stored in the artifacts repository. The artifacts consist of one XML file per scenario that was exported during the build operation.

Endpoint Selection

This operation will select all available endpoints associated to the environment/instance.

Endpoint Execution

This operation will randomly execute on one of the endpoints identified during selection.

Special Considerations

In addition to the required ODI project code (FDODI_PROJECT_CODE) there are several options to further filter the scenarios that are included in the build:

ODI Markers – Folders or objects (interfaces, mappings, packages, procedures, and variables) can be identified by tagging them with the ODI Marker (ODI Marker Code) within the ODI Marker Group (ODI Marker Group Code). Marking a folder will result in all scenarios within that folder being included in the build. See Oracle Data Integrator documentation for instructions on creating and using Markers and Marker Groups.
Include/Exclude Patterns – Java regular expressions can be used within the ODI Include Pattern and ODI Exclude Pattern to identify which scenarios should be included or excluded in the build. In both cases the expressions are matched against the scenario name (not the owning object's name).
Scenario Version – You have the option to identify the specify version numbers of the scenarios to include in the build by using the FDODI_VERSION property. Multiple version numbers can be specified by comma separating them. If no versions are specified, all versions of selected scenarios will be included. Specify -1 to only export the latest version.

If scenarios identified during build are linked to scenario folders, those folders are automatically exported (without children) and stored as part of the build artifacts. During deployment, any scenario folders in the build artifacts are imported (insert only) into the target folder. In order for scenarios to be linked correctly in the target repository, any existing scenario folders in the target must have the same global id as the the same folder on the source. If the folder was created manually on the target, but with the same name as the source, the deployment will not create the scenario folder and the scenario will be imported without being linked. This feature is only available for ODI 12.2+.