exportNewSnapshot

This operation utilizes Oracle EPM's migration capability to enable files to be moved across environments.  This operation generates a snapshot (containing meta information of on the files only) based on the files selected in the package being built.  That snapshot is uploaded to the EPM server and Repeat Export is called which looks at the meta information in the uploaded snapshot and generates an updated snapshot with the files from that EPM server.  That new snapshot is downloaded to FlexDeploy as the artifact and the snapshot on the EPM server is deleted.

This operation would be used for the build operation for package based projects using snapshots to deploy EPM files.

Discovery

Prior to initiating a build, the user must discover the files to be included in future builds for that project.  The discovery will use the project property Oracle EPM Discover Snapshot to determine the files to add to the catalogue.  See Discovering Project Files in the User Guide for more information. 

To create the snapshot to discover files, follow the documentation below to create a snapshot in EPM (follow the documentation on exporting selected application artifacts from an environment):

https://docs.oracle.com/en/cloud/saas/enterprise-performance-management-common/epmss/export_artifact.html

Applies to

Planning, Planning Modules, FreeForm, Financial Consolidation and Close, Tax Reporting, Enterprise Profitability and Cost Management, Oracle Strategic Workforce Planning Cloud, and Oracle Sales Planning Cloud.

Target Properties

Property Name

Property Code

Required

Description

Property Name

Property Code

Required

Description

Oracle EPM Account

FDEPM_CLOUD_ACCOUNT_CODE



Oracle EPM Account will be required on either the plugin input or Target. If a value is set on both then, the plugin input will take precedence.

See Special Considerations below for instructions on how to create Oracle EPM account.

Project Properties

Property Name

Property Code

Required

Description

Property Name

Property Code

Required

Description

Discover Snapshot

FDEPM_DISCOVER_SNAPSHOT

Yes

The Oracle EPM Snapshot that will be used to discover which files are available.

Snapshot Base Name

FDEPM_SNAPSHOT_BASE_NAME

Yes

The Snapshot prefix used when exporting a Snapshot. The prefix will be followed by the workflow execution id to form the snapshot name.

Inputs

Input Name

Input Code

Required

Description

Input Name

Input Code

Required

Description

Oracle EPM Snapshot Timeout

FDEPM_INP_SNAPSHOT_TIMEOUT

No

Time to wait in seconds for the snapshot to be imported, uploaded or downloaded.  Defaults to 300.

Artifacts

This operation produces artifacts that will be stored in the artifacts repository.

Endpoint Selection

This operation will select all available endpoints associated to the target.

Endpoint Execution

This operation will execute on any one of the selected endpoints and will be random in the determination of which one.

Special Considerations

Oracle EPM Account

Before using this plugin operation, navigate to Topology → Integrations → Cloud, then create an account with provider OracleEPM for each one of your SaaS environments. This account will store the URL and credentials to make HTTPS requests to your SaaS environment. The account will be reusable by all Oracle EPM Plugin operations. All fields shown are required.



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