Creating and Using Action Links and ActionsEnabling BI Navigation

In this topic you add an inline action link to a column in an analysis which navigates to another analysis in Oracle BI. Because the action link is set as a property of the column itself, the action is available from Table, Pivot Table, Graph, and Map views. After testing the inline action link and saving the analysis, you save the action link as a named action link in the Presentation Catalog.

To automate BI navigation and create a named action link, you perform the following steps:

Log in to Oracle BI EE and create an analysis

Add an action link to the analysis

Test the action link

Save the action in the Presentation Catalog

Log in to Oracle BI EE and Create an Analysis

1.Open a browser or a new browser tab and enter the following URL to navigate to Oracle Business Intelligence:

http://:9704/analytics

In this tutorial the URL is http://localhost:9704/analytics

2.Sign in to Oracle BI. For this example, log in using the Sample Application user ID and password, which isabell/Admin123.

3.In the left navigation pane, under Create... Analysis and Interactive Reporting, selectAnalysis.

4.Select theSample Salessubject area.

5.Double-click the following column names in the Subject Areas pane to add them to the analysis:

Time.Time HierarchyOffices.D4 CompanyBase Facts.1 - RevenueBase Facts.2 - Billed QualityCalculated Facts.Simple Calculations.20 Actual Unit Price

6. Click theResultstab to view the analysis results. The analysis results are displayed in a Compound Layout, which includes a Title view and a Pivot Table view. Verify that the Pivot Table appears as follows:

7. Click theNew Viewbuttonin the toolbar and select Graph > Line-Bar > Default (Standard).

8. Click theEdit Viewbuttonfor the Graph view.

9. In the Graph editor's Layout pane, dragTime Hierarchyto the Sections drop target and selectDisplay as Slider.

10. ClickDoneto close the Graph Editor.

11. In the graph's slider, expand theTime Hierarchyto view the Years level in the slider values.

The slider should appear as follows:

12.Click theSavebuttonto save your analysis.

13.In the Save As dialog box, navigate to My Folders and click theNew Folderbutton. Note that if you already have a Revenue folder in My Folders, you do not need to recreate it.

14.In the New Folder dialog box, enterRevenueand clickOK.

15.Name the analysisRevenue by Companyand clickOK.

Add an Action Link to the Analysis

1. Click theCriteriatab.

2. ClickMore Optionsbuttonfor the D4 Company column and selectColumn Properties.

3. In the Column Properties dialog box, click theInteractiontab, then click the drop-down list in the Value section to view the available interaction settings. In the Interaction tab, you can specify interactions for column headings and values. The default interaction is to drill in any associated hierarchy. Other options are to send Master-Detail events, which allow user actions in a column in a Master analysis to reflect in child analyses, and to initiate an action using Action links.

4. SelectAction Linksfrom the drop-down list. In the Action Links list, you can view, add, edit, and delete actions associated with the column. Notice that you can have multiple action links associated with a column. By default, actions available for a column appear in a popup when a user clicks the column value or heading in an analysis. You can use the "Do not display in a popup if only one action is available at runtime" option to reset this so that in the event only one action is available for a value or heading, the action is executed upon the user interaction. Leave this option unchecked.

5. Click theAdd Action Linkbutton.

6. In the New Action Link dialog box, click theCreate New Actionbuttonand selectNavigate to BI Content. This new action is an inline action, in that it is created as part of the analysis it is saved in. Later, you will build and use named actions, which are saved in the Presentation catalog for reuse.

7. In the Select BI Content for Action dialog box, navigate to Shared Folders/2. Functional Examples/Demo, select the Order Detailsanalysis, and clickOK.

8. In the Create New Action dialog box, clickOK.

9. In the New Action dialog box, clickOK, then clickOKto close the Column Properties dialog box.

Test the Action Link

1. Click theResultstab.

2. In the Pivot Table view, click theStockplus Inc.value in the D4 Company column. In the Action link pop-up list, selectOrder Details.

3. The Order Details analysis opens, with Stockplus Inc. Company passed automatically by the inline action.

4. Close the Order Details analysis browser window or tab.

5. In the Graph view, click theStockplus Inc.value in the D4 Company column. In the Action link pop-up list, selectOrder Details. You can access action links from multiple views in an analysis once they are added in the column properties for a column in the analysis.

6. Examine the Order Details analysis and then Close the Order Details analysis browser window or tab.

Save the Action in the Presentation Catalog

1. Click theCriteriatab.

2. Open the column properties for the D4 Company column.

3. In the Column Properties dialog box, click theInteractiontab. In the Action Links list, select theOrder Details action link and click theEdit Action Linkbutton.

4. In the Edit Action Link dialog box, click theMorebuttonand selectSave Action As. Notice that the action you are saving is inline, or part of the Order Details Action link, which is currently associated with the analysis in the catalog. When you save the action as a named action in the Presentation Catalog, it can be secured independently and reused with other action links in other analyses.

Notice in the More drop-down list that you can edit the action from within the action link or remove the action from the action link as well as saving it.

5. In the Save Action As dialog box, save the action asOrder Details Actionin My Folders/Revenue. Notice you also have the option to replace the current action in the action link with a reference to the named action, so that any subsequent changes to the named action will be referenced in the action link. Leave this option unchecked, so that for the current analysis, the action remains an inline action, independent of the version you are saving in the catalog. ClickOKto save the action.

6. ClickCancelto close the Edit Action Link dialog box.

7. ClickOKto close the Column Properties dialog box.

8. Save the analysis and navigate to the Home page to verify in the Recent section that the action has been saved in the catalog.

9. Click theEditlink for theRevenue by Company analysis to open it in the Analysis Editor.

Enabling Web Navigation and Passing Parameters

In this topic you add an existing named action to a column, enabling navigation to a Web page from Oracle BI and passing contextual information from Oracle BI. Actions stored in the catalog can be secured independently and re-used across multiple analyses, dashboards, and agents. After adding the action, you set the action link it is associated with to display conditionally.

To enable Web navigation and pass parameters, you perform the following steps:

Add a named action to the analysis

Set the action link to display conditionally

Test the action link

Add a Named Action to the Analysis

1.Open the column properties for the Revenue column.

2.In the Column Properties dialog box, click theInteractiontab, selectAction Linksfrom the drop-down list for the column values, and click theAdd Action Linkbutton.

3. In the New Action Link dialog box, click theSelect Existing Actionbutton.

4. In the Select Action dialog box, navigate to Shared Folders/4. Actionable Intelligence/Actions/Actions to Navigate to a Web Page, select theNavigate to Googleaction, and clickOK.

5. In the Edit Parameter Mapping dialog box, you can specify a contextual value, passing a specified value or a session or repository variable or a column value. For this tutorial, you pass a column value from the analysis as a parameter for the navigation to the search engine. Click theChange Type of Valuedrop-down list and select Column Value.

6. Click theColumn Valuedrop-down list and select theD4 Companycolumn to map the company information from the analysis to the search string when the Navigate to Google action is executed. Also notice that you can set the Fixed and Hidden options, which control whether a user can change or view the parameter at runtime. Leave these options set to the default, which allows the most control on the part of the user.

7. ClickOK.

Set the Action Link to Display Conditionally

1.In the New Action Link dialog box, notice that since you selected a named action, the Show link options are now enabled, allowing you to determine whether the Action link is displayed whenever the interaction is performed or based on a condition. For this tutorial, you set the Action link to display for companies with revenue greater than 15,000,000. Select theConditionallyradio button.

2. Click theNew Conditionbuttonand select1- Revenuefrom the drop-down list.

3.In the New Condition dialog box, create a conditon that specifies revenue greater than 15,000,000. Check your work against the screenshot below and clickOK.

4. In the New Action Link dialog box, enterSearch Company Informationas the Link Text to specify what appears in the link when a user initiates the interaction, and then clickOK.

5. Notice in the Action Links list, the Show Link column indicates whether an Action Link is displayed always or conditionally. ClickOK.

6. ClickOKto close the Column Properties dialog box.

Test the Action Link

1. Click theResultstab.

2. In the Pivot Table view, hover over the Revenue value for the Stockplus Inc. company, which falls below 15,000,000. Notice that the no interaction is available for the value because it does not meet the condition.

3. Click the Revenue value for Genmind Corp, which exceeds 15,000,000. In the Action Link drop-down, select the conditionalSearch Company Informationaction link to execute its action.

4. Notice in the Navigate to Google dialog box that the Search Term parameter that is being passed as context for the action is displayed to the user and is editable, due to the Fixed and Hidden settings you retained when specifying the parameter mapping for the Navigate to Google action. ClickExecute.

5. Verify that the value is passed as a search term to Google.

Experiment with Revenue values in the Graph view as well to verify that the action link is pervasive through different views:

Creating a New Action

You have created an inline action as part of an analysis and added an existing named action. Now, you will create a new named action and define action options that affect its presentation to users. Once saved, this action can be referenced throughout Oracle BI.

To create a new action, you perform the following steps:

Create a new action

Execute the action

Create a New Action

1.Click the Home link to navigate to the Home page.

2.In the Create Section click theActionlink under Actionable Intelligence.

3. Actions can be of two types, either navigating to related content, be it within BI or on a web page or a transactional system, or invoking target functionality in an external system, for example a web service, Java method, or script. For this exercise, clickNavigate to a Web Pageto create another web navigation action..

4.The requirements for the New Action dialog box are dictated by the type of action you are creating. To enter the URL for the web page, open another browser tab and navigate tohttp://www.nasdaq.comand get a stock quote for Oracle (search on ORCL). Select the URL and copy it.

5. In the New Action dialog box, paste the URL for the web page.

6.Click theDefine Parametersbutton.

7.Click theDefine Parametersbutton. Notice that the parameters are extracted into two respective parameters automatically. Retain the default parameter names and settings. Notice also that the names of the parameters are populated in the syntax of the URL so that any user changes to the parameters initiated at time of action execution are automatically referenced in the URL.

In the Parameters list, the parameters are automatically populated:

Note that by default these parameters are set to be optional. Retain these settings.

8 .Click theOptionsbutton to set options for the action.

9.In the Action Options dialog box, you can set options for the action's behavior and display. Select theDialog Titleoption and set the title toGet Stock Quote. Also select theExecute Button Textoption and change the text toNavigate. ClickOKto save your changes and close the dialog box.

10. ClickSave Action.

11. In the Save Action As dialog box, save the action asGet Stock Quotein My Folders.

Execute the Action

1. On the Home page, click theExecutelink under the Get Stock Quote action in the Recent section.

2.Notice that your settings for the action options are reflected in the execute dialog box, in the title and in the Navigate button. ClickNavigate.

3. Confirm that the execution of the action has navigated to the ORCL quote in a new browser tab.

Creating a Web Service Action

You have finished building a navigation action. Next you will build an action that invokes a Web Service. Invoke actions allow you to initiate target operations, functions, processes and workflows in external systems.

To create a new action, you perform the following steps:

Create a new action

Execute the action

Create a New Action

1.Click the Home link to navigate to the Home page.

2.In the Create Section click theActionlink under Actionable Intelligence.

3.ClickInvoke a Web Service.

4 .In the Select Web Service dialog box, expand as shown in the screenshot below to navigate to and select theprocessRatingoperation in the CreditRatingServicethat is already registered with the Action Framework. Notice that you can also specify a URL to a WSDL document that describes a web service to make it available to the framework. ClickOK.

5.In the New Action dialog box, notice that by default, the expected prompt value required by the web service is populated in the parameters. ClickOptions.

6.In the action options, reset the Dialog Title toGet Credit Rating.

7.Click theAction Resultstab. For actions that invoke web services, there are additional options to provide feedback to the user based on the result from the web service. When a web service is invoked, it responds with an XML message. Using the options in the Action Results tab, you can customize what information from this response is presented to the user. In the case of this web service, the response includes the customer credit rating. To reference this, in the Dialog Text field, enterCredit Rating of this Customer is: @{1}

The 1 in the syntax above represents a named expression that is extracted from the message response from the web service. You still need to build a value to map these results so that they will appear in the results dialog box to the user.

8.In the XPath Results list, use the default value, 1, and in its XPath Expression field, enterBody//*.

9.Change the Dialog Title toCustomer Credit Rating.

10. ClickShow Previewto validate the results your users will see.

11. The preview should appear as follows. There is no value as yet from the web service.

12. ClickOKto close the preview dialog box.

13. ClickOKto save the options and close the Action Options dialog box.

14. In the New Action dialog box, clickSave Action.

15. Save the action asGet Customer Credit Ratingin the Revenue folder and clickOK.

Execute the Action

1.On the Home page, click theExecutelink under the Get Customer Credit Rating action in the Recent section.

2.Enter1234as the customer number and clickExecute.

The web service is invoked by the action:

3.The information from the web service response appears in the response dialog box with your settings. ClickOK.

Consuming Actions

In the first topic, you added action links to an analysis. In this topic you explore other ways to reference and consume actions and action links within Oracle BI, including dashboards and agents. Where you can add an action depends on its type. For example, you can add invoke actions to agents, to automate a business process, with the exception of Invoke Browser Scripts actions. You can add navigate actions to dashboard pages, scorecards, and Key Performance Indicators.

To explore where you can add and use actions, you perform the following steps

Add an action to a dashboard

Call an action from an agent

Add an Action to a Dashboard

1.In the Global Header, clickDashboardsand selectMy Dashboard.

2.Click thePage Optionsbuttonand selectEdit Dashboard.

3.Drag anAction Linkfrom the Dashboard Objects pane and drop it in the Dashboard Builder workspace. Notice that you can also add an Action Link Menu object if you wish to include a drop-down menu including multiple action links to the dashboard.

4.Hover on the Action Link and click thePropertiesbutton.

5.In the Action Link Properties dialog box, enterGet Customer Credit Ratingas the Link Text, andCredit Rating by Customer ID:as the Caption.

6.Click theSelect Actionbutton to add a named action to the link. Notice the other options in the dialog box, which allow you to specify that the link opens in another window and to specify a condition to determine whether the action link is shown on the dashboard.

7.In the Select Action dialog box, select theGet Customer Ratingaction you just created and clickOK.

8.In the Edit Parameter Mapping dialog box, accept the defaults and clickOK. The user will be prompted for the Customer ID required as a parameter for the web service.

9.Notice the other options in the dialog box, which allow you to specify that the link opens in another window and to specify a condition to determine whether the action link is shown on the dashboard. ClickOKto save your Action Link Properties

10. In the Dashboard Builder, verify that the Get Customer Credit Rating action link appeards.

11.Click theSavebuttonto save the dashboard, then clickRun.

12. Verify the link appears on the dashboard. Click the action link.

13. Enter1234as the customer number and clickExecute.

The web service is invoked by the action:

14. The information from the web service response appears in the response dialog box with your settings. ClickOK.

Call an Action from an Agent

1. In the Global Header, clickNewand selectAgent.

2. Click theActionstab. Notice that there are two sections that can be used to specify actions to be called when an agent completes. By adding actions to the first section, you specify that the action runs in the case that no condition exists on the agent and in the case that a condition exists and is evaluated to true. In the second section, you can set an action to run if the condition evaluates to false for the agent.

3. Click the Add Existing Action button in the first section. Notice that the buttons for adding actions are unavailable in the second section. This is because there are no conditions specified for the agent in the Condition tab. The Invoke per Row option is available for actions that are based on a condition, and is used to execute the action for each row returned by the condition.

You now can specify available actions, depending on their type, using the same steps as above. For the purposes of this tutorial, you will not run the agent.

Summary

In this tutorial you learned how to use Oracle BI actions to provide guided analysis, navigate to external applications and content, and invoke Web Services.

In this tutorial, you have learned how to:

Enable BI navigation using actions and action links

Enable web navigation and pass parameters

Create a new navigation action

Create a new invoke action

Consume actions in analyses, dashboards, and agents