Shared Connections and Private Connections
From Oracle Smart View for Office in Excel, Word, and PowerPoint, you can connect to various supported data sources, such as Oracle Enterprise Performance Management Cloud and Oracle Enterprise Performance Management System sources, using a shared or private connection.
Generally, you can connect to one provider data source per sheet. However, for the following providers, you can connect to multiple instances of the same data source type per sheet, slide, or document: Planning, Planning Modules, Enterprise Profitability and Cost Management, FreeForm, Financial Consolidation and Close, Tax Reporting, Oracle Essbase cloud and on-premises, Oracle Analytics Cloud, and Oracle Business Intelligence Enterprise Edition.
As a Smart View user, you may have access to shared connections, private connections, or both. Starting in release 20.200, you can access your connections using vanity URLs, also referred to as custom URLs.
This topic covers the following sections:
Shared Connections
You can create shared to connections to EPM Cloud sources and on-premises Oracle Hyperion Enterprise Performance Management Workspace sources.
For EPM Workspace connections, you can connect to multiple provider types per connection. Figure 3-3 illustrates this type of connection.
For EPM Cloud sources, there are two ways to use a shared connection:
-
One cloud provider per shared connection.
For example, shared Connection "A" connects you to your Planning business process instance; shared Connection "B" connects you to your Financial Consolidation and Close business process instance.
Figure 3-1 illustrates this type of connection.
-
Multiple EPM Cloud providers per shared connection. In this case, all supported cloud providers must reside on the same domain.
For example, your organization is hosting Planning, Financial Consolidation and Close, and Tax Reporting on the same domain. Shared Connection "C" connects you to all three business process instances.
In Smart View, this type of connection applies only to these EPM Cloud business processes:
- Planning
- Planning Modules
- FreeForm
- Financial Consolidation and Close
- Tax Reporting
- Enterprise Profitability and Cost Management
- Narrative Reporting
- Account Reconciliation
Figure 3-2 illustrates this type of connection.
EPM Cloud Service Administrators: See Administering Planning, Connecting Environments in EPM Cloud for information on setting up multiple providers on a single shared connection.
Shared connections are either:
-
Accessed from a central server or host location and available to multiple users through the Smart View Panel.
-
Stored on each Smart View client machine or on a web server in an XML file created by an administrator. The connections in the XML file are then available to the user through shared connections in the Smart View Panel.
See Accessing Shared Connections from an XML File in the Oracle Smart View for Office Installation and Configuration Guide for information on preparing and distributing this XML file.
You cannot edit or rename shared connections, but you can save them as private connections, which you can edit and rename as described in Saving Connections as Private Connections.
Private Connections
Private connections are those that you create by saving a shared connection to your local computer, by using a wizard, or by entering a URL to a provider data source. When you create a private connection, it becomes the active connection.
Figure 3-4 illustrates this type of connecting, showing connections created using a wizard and connections created using the Quick Connection method.
Note:
When working with Oracle Analytics Cloud, Oracle BI EE, Oracle Essbase, and Narrative Reporting, you must use a private connection, or add the private connection information to a shared connection XML file, as described in Accessing Shared Connections from an XML File in the Oracle Smart View for Office Installation and Configuration Guide.
Examples of Shared and Private Connections
Following are examples of the various types of connections and how they would appear in the Smart View Panel. This will give you an idea of what to expect when you're connecting to data sources in Smart View.
Shared connection to a single EPM Cloud data source.
In the example drop-down menu in Figure 3-1, the user has access to a connection to a Planning data source (this is the EPM Cloud option) and to Financial Reporting (the Reporting Settings option).
Figure 3-1 Shared Connection to a Single EPM Cloud Data Source
![Example of a shared connection to a single EPM Cloud data source. You can choose to connect to either EPM Cloud or Reporting Settings Example of a shared connection to a single EPM Cloud data source. You can choose to connect to either EPM Cloud or Reporting Settings](img/connections_shared_cloud_102xe95a8e43.jpg)
Shared connection to multiple EPM Cloud data sources on the same domain.
In the example drop-down menu in Figure 3-2, the user has access to multiple supported EPM Cloud data sources; for example, FinPlan connects to a Planning data source, FinClose connects to a Financial Consolidation and Close data source, Wrkforce connects to a Workforce data source, Recon connects to an Account Reconciliation data source, and so on.
Your service administrator specifies the data source names you will see in the drop-down menu.
Figure 3-2 Shared Connection to Multiple EPM Cloud Data Sources
![Example of a shared connection to multiple EPM Cloud data sources. The drop-down menu shows several EPM Cloud business processes, such as Narrative Reporting and Tax Reporting, to which you can connect Example of a shared connection to multiple EPM Cloud data sources. The drop-down menu shows several EPM Cloud business processes, such as Narrative Reporting and Tax Reporting, to which you can connect](img/connections_shared_cloud_multiple_friendly_names.jpg)
EPM Cloud Administrators: See Administering Planning, Connecting Environments in EPM Cloud for information on setting up multiple providers on a single shared connection.
Shared connection in EPM Workspace.
In the example drop-down menu in Figure 3-3, the user has access to five EPM System data sources, including Essbase and Oracle Hyperion Planning.
Figure 3-3 Shared Connection in EPM Workspace
![Example of a shared connection to EPM Workspace. The drop-down menu shows several EPM System applications, such as Financial Management and Strategic Planning, to which you can connect Example of a shared connection to EPM Workspace. The drop-down menu shows several EPM System applications, such as Financial Management and Strategic Planning, to which you can connect](img/connections_shared_workspace_100xe94c67f3.jpg)
Private connections
The example drop-down menu in Figure 3-4 shows two connections, for Essbase and Oracle Hyperion Financial Management, that were created using the Private Connection wizard. The remaining connections displayed were created using the Quick Connection method and include, among others, connections to Oracle Hyperion Planning and Essbase.
Figure 3-4 Various Private Connections
![Example of a list of various private connections Example of a list of various private connections](img/connections_private_108xe977c465.jpg)
Guidelines for Shared and Private Connections
-
Starting in Release 20.200, you can use custom URLs, or vanity URLs to access data source providers from Smart View. To configure your custom URL, you use a third-party link shortener, such as T.ly, Bitly, Rebrandly, TinyUrl, or is.gd, or an open source solution, such as YOURLS. Then, depending on the configuration, use the custom URL as your shared connection, private connection, or quick connection.
Note:
- When using a vanity URL, there is the possibility of transmitting sensitive data to your third-party link shortening vendor. For example, when performing a refresh or a submit, you may be transmitting password information during the transaction.
- The extension installation and update command, Check for Updates, New installs, and Uninstalls, in the Options dialog, Extensions tab is not supported when logged in using a vanity URL.
Administrators or Smart View users can create vanity URLs. For detailed information on creating vanity URLs, see the documentation from the third-party link shortener of your choice.
-
For some data sources, you can connect to only one data source per worksheet. Exceptions and other connection guidelines are noted below.
-
Planning, Planning Modules, Enterprise Profitability and Cost Management, FreeForm, Financial Consolidation and Close, and Tax Reporting: You can connect to multiple databases on a single worksheet, as described in Changing Connections in EPM Cloud Multiple-Grid Worksheets.
-
Essbase cloud and on-premises:
- When connecting to Oracle Essbase cloud, you must use a private connection.
- You can connect to multiple Essbase databases on a single worksheet, as described in Changing Connections in Multiple-Grid Worksheets.
- If external authentication is disabled, for security reasons, you must provide your user name and password each time you connect to a different application on the same server.
- Once connected to an Essbase database, users can view database notes associated with the database. To display database notes, from the Smart View Panel, right-click the name of the Essbase database, and then select Database Note. You cannot edit these database notes from Smart View. Database notes can be implemented in VBA by using the VBA function, HypGetDatabaseNote (see HypGetDatabaseNote in the Oracle Smart View for Office Developer's Guide).
-
Oracle Analytics Cloud and Oracle BI EE
- When connecting to Oracle Analytics Cloud or Oracle BI EE, you must use a private connection.
- You can connect to multiple catalogs on a single sheet, as described in Connecting to Multiple Oracle Analytics Cloud Data Sources and Connecting to Multiple Oracle BI EE Data Sources.
- When connecting to Narrative Reporting, you must use a private connection.
- If you face any issues while logging in to your data source from Smart View, see Diagnosing Login Issues.