Before you Begin

This 10-minute tutorial shows you how to package your custom data action plug-in for deployment on an Oracle Analytics environment to enable others to use the data action.

Background

You need to create an archive file of your custom data action plug-in, upload, and register the plug-in in Oracle Analytics so that your consumers can use the data action in their analyses.

This is the second tutorial in the series Create and Deploy a Custom Data Action. Read the tutorials in the order listed.

What Do You Need?

  • Access to Oracle Analytics with Administrator privileges to upload the custom data action
  • Download sample_order_lines.xlsx to your computer

Create an Archive

In this section, you create an archive file of your data action plug-in.

  1. On your computer, locate and select the customdataaction folder and all of its contents.

    The folder location is similar to the following:

    %PLUGIN_DEV_DIR%\src\customdataaction

    For example: %PLUGIN_DEV_DIR%\src\currencylayer-currencyconversiondataaction

  2. Create an archive (zip) file using the name of your data action plug-in.

    In the Create a Custom Data Action Plug-in tutorial, the plug-in was named currencylayer-currencyconversiondataaction.

Upload the Data Action Plug-in

  1. Sign in to Oracle Analytics Cloud using your administrator credentials.
  2. On the Home page, click the Navigator Navigator icon, and then select Console.
  3. In Console, click Extensions. In Extensions, click Upload Extension, select your data action plug-in archive file, and then click Open.
  4. Click Back. In the Console, click Extensions, and then verify that your data action is listed.

Update the Safe Domains List

  1. In the Console, click Safe Domains.
  2. In Safe Domains, click add domain Add Domain icon. In the URL field, enter the apilayer.net, and then select Connect.
  3. Click Back. In the Console, click Safe Domains, and then verify that apilayer.net is listed.

Test the Data Action

In this section, you configure the currency conversion data action, anchor the data action to a column in the data set, and create a visualization project that demonstrates the data action.

  1. Sign in to Oracle Analytics Cloud as a content author.
  2. On the Home page, click Create, and then click Project.
  3. In Add Data Set, click Create Data Set. In Create Data Set, click Drop data file here or click to browse, select the sample_order_lines.xlsx file, and then wait for the file to load. In Add Data Set, click Add.
  4. In Results, click Visualize.
  5. In the project, click Menu Porject Menu icon, and then select Data Actions.
  6. In Data Actions, click Add Action. Enter Convert Currency in Name.

    The name you entered appears on the context menu of the anchored data point.

  7. From the Type list, select Currency Conversion. Click Anchor To Add icon, and select Sales.
  8. In CurrencyLayer API Key, enter your API access key. In the From Currency and To Currency lists, select USD and EUR respectively. Click OK.
  9. From Data Elements, hold down the Ctrl key, select and drag Sales and Product Sub Category to the canvas.
  10. In the view, hover over the Chairs & Chairmats data point, right-click and select Convert Currency.


    Description of currency_to_euro.png follows
    Description of the illustration currency_to_euro.png

Learn More