Launch an Enterprise Application from a Canvas

You can use data actions to launch an Oracle Utilities software-as-a-service (SaaS) enterprise application to a particular page, in the context of a selected identifier, from a canvas.

For example, say you are looking at a workbook about Cases in Oracle Utilities Analytics Visualization and want to look at the details of a specific Case ID in Customer Cloud Service. This can be done by creating a data action link that dynamically passes the selected Case ID to the URL that opens Customer Cloud Service directly in the Case page, populated with the details of the selected Case ID.

Form the URL to Launch an Enterprise Application to a Particular Page

The online help available in your enterprise applications has good guidance on the topic of deep linking. Open the online help of a given enterprise application and search for the topic 'Creating Application Links in External Applications.' The topic suggests adding the following parameters to URL deep link calls to enterprise applications:
  • initNav=false: This parameter skips launching the default home page for the user to speed up launching the intended deep linked page.
  • minDashboard=true: This parameter minimizes the right dashboard for the user to speed up launching the intended deep linked page.

Taking this guidance results in one of the following URL schemes below. There is a slight difference depending on which release version is used.

https://{Saas enterprise app URL}/cis.jsp?minDashboard=true&initNav=false&script={product specific script}&FLAG={script specific flag}&PKVALUE1=${keyValuesForColumn:your ID}

  • The {Saas enterprise app URL} section is where you insert your enterprise application environment URL.
  • The minDashboard=true&initNav=false section has extra parameters added to speed up the quick launch of the specific page.
  • The &script={product specific script}&FLAG={script specific flag}&PKVALUE1= section is where you insert the script that's specific to your entity to direct you to the appropriate page. See examples below.
  • The ${keyValuesForColumn:your ID} section will be the parameter type and name that needs to be passed in to the URL.

Deep Link Examples

Customer Solution Cloud Service

Product Specific Script Script Specific Flag ID Addition to URL: https://{Saas enterprise app URL}/cis.jsp??minDashboard=true&initNav=false
C1-GoToCCB

FLAG=C1CC

(Control Central Account)

 Account ID &script=C1-GoToCCB&FLAG=C1CC&PKVALUE1=${keyValuesForColumn:your Account ID}
C1-GoToCCB

FLAG=C1CP

(Control Central Person)

 Person ID &script=C1-GoToCCB&FLAG=C1CP&PKVALUE1=${keyValuesForColumn:your Person ID}
C1-GoToCCB

FLAG=C1CR

(Control Central Premise)

 Premise ID &script=C1-GoToCCB&FLAG=C1CP&PKVALUE1=${keyValuesForColumn:your Premise ID}

Tip:

The values above are from the C1_TARGET_PORTAL_FLG lookup in the Oracle Utilities Customer Care and Billing application. Go to that lookup if you want to review the full set of options.

Other Deep Link URL Examples for Customer Cloud Service

ID Addition to URL: https://{Saas enterprise app URL}/cis.jsp??minDashboard=true&initNav=false
Case ID &location=caseMaint&CASE_ID=${keyValuesForColumn:your Case ID}
To Do ID

&location=toDoEntryMaint&TD_ENTRY_ID={your To Do ID}

&location=toDoEntryMaint&TD_ENTRY_ID=${keyValuesForColumn:your To Do ID}

Meter Solution Cloud Service

Note:

The URL Additions below are not limited to Meter Solution Cloud Service. They can be used to launch Customer Cloud Service from meter data that is available in OUAV for the Customer Cloud Service.
Product Specific Script Script Specific Flag ID Addition to URL: https://{Saas enterprise app URL}/cis.jsp??minDashboard=true&initNav=false
D1-GotoMDM

FLAG=D1DV

(360 View for Device)

 Device ID &script=D1-GotoMDM&FLAG=D1DV&PKVALUE1=${keyValuesForColumn:your Device ID}
D1-GotoMDM FLAG=D1MC (360 View for Measuring Component) Measuring Component ID &script=D1-GotoMDM&FLAG=D1MC&PKVALUE1=${keyValuesForColumn:your Measuring Component ID}
D1-GotoMDM

FLAG=D1SP

(360 View for Service Point)

 Service Point ID &script=D1-GotoMDM&FLAG=D1SP&PKVALUE1=${keyValuesForColumn:your Service Point ID}

Tip:

The values above are from the DRILL_ENTITY_FLG lookup in the Oracle Utilities Meter Data Management application. Go to that lookup if you want to review the full set of options.

Work and Asset Cloud Service

Product Specific Script Script Specific Flag ID Addition to URL: https://{Saas enterprise app URL}/cis.jsp??minDashboard=true&initNav=false
F1-GoToPrtl mo=W1-ACT Activity ID &script=F1-GotoPrtl&mo=W1-ACT&pkValue1=${keyValuesForColumn:your Activity ID}
F1-GoToPrtl mo=W1-ASSET Asset ID &script=F1-GotoPrtl&mo=W1-ASSET& pkValue1=${keyValuesForColumn:your Asset ID}
F1-GoToPrtl mo=W1-NODE Location ID &script=F1-GotoPrtl&mo=W1-NODE& pkValue1=${keyValuesForColumn:your Location ID}
F1-GoToPrtl mo=W1-WORKORDER Work Order ID &script=F1-GotoPrtl&mo=W1-WORKORDER& pkValue1=${keyValuesForColumn:your Work Order ID}

Other Deep Link URL Examples for Batch Run Analytics

ID Addition to URL: https://{Saas enterprise app URL}/cis.jsp??minDashboard=true&initNav=false
Batch Control Code and Batch Run Number 21C and Later: &location= CI0000001053&BATCH_CD=${keyValuesForColumn:Batch Control Code}&BATCH_NBR=${keyValuesForColumn:Batch Number Code}&BATCH_RERUN_NBR=0[RR1]