Configure Actions for Items and Workflows
You can configure actions for items and workflows. These actions can launch analytics, reports, URLs, Application Composer object functions, global functions, or object links.
To enable this feature you must enable the profile option Enable custom actions on Product Management objects (ORA_EGP_RW_ENABLE_CUSTOM_ACTION).
You can organize actions into groups, control their visibility using expressions, reorder or disable them, and configure parameterized URLs with variable mapping and trust token support.
To create actions, navigate to Product Management > Settings > Select the Object (Item or Workflow) > Toolbar Actions > select Create. The Create Toolbar Action drawer appears.
Enter the following details in the Create Toolbar Action drawer:
- Name: name for the action. This name appears as an action in the Actions drop-down list for the item or workflow.
- Group: Select a group to organize related actions in the Actions list. Existing groups are available in the list. To create a new group, click Create. Grouping related actions helps organize the Actions list.
- Create (+): Click the plus (+) icon to create a new group. Enter a name for the group. After you create the group, it becomes available for selection in the Group list.
- Expression: Define the conditions that control the availability of an action
on an item or a workflow. Use the expression builder to select object or user
attributes, specify attribute values, and click Validate to verify the
expression.Examples
- Workflow Type is Engineering Change Order: (variable_SourceTypeCode == "ENG_CO")
- Roles: Product Manager OR Product Data Steward:: ((variable_roles == "ORA_EGP_PRODUCT_MANAGER_JOB") || (variable_roles == "ORA_EGP_PRODUCT_DATA_STEWARD_JOB"))
- Action type: You can configure the following action types:
- Analytics: Link to an Oracle Transactional Business Intelligence (OTBI) analysis.
- Application Composer Global Functions: Invoke a global function configured in Application Composer.
- Application Composer Object Functions: Invoke an object function configured in Application Composer. You can also pass parameters to the function.
- Application Composer Object Links: Invoke an object link configured in Application Composer.
- Report: Link to an Oracle Analytics Publisher report.
- URL: Link to an internal or external URL. URL actions support JSON Web Tokens (JWT) for secure authentication.
When you select Analytics, Report, or URL, the URL field is displayed, allowing you to enter the target URL using variables in the required format. In the URL field, enter the target URL using {HOST_NAME} as the relative host path and #{VARIABLE_NAME} to reference values from the object. You can map object parameters to each variable that you specify in the URL.
External links that use JSON web tokens can now reference any supported variable, such as mytoken, instead of being limited to JSON Web Token variables.
To append a trust token to the URL, use the expression #{applCoreSecuredToken.trustToken}. At runtime, the application resolves the expression to the actual trust token. No parameter mapping is required.
When you select Application Composer Global Functions, Application Composer Object Functions, or Application Composer Object Links, the list displays the functions or object links configured for the change order in Application Composer for workflows. For items, the list displays the global functions associated through item rules.
When you enter concat and open a bracket, the application displays a list of basic and object attributes that you can select to build the expression.
Examples of parameterized URLs:
-
Analytics
Parameterized URL: {HOST_NAME}/analytics/saw.dll?Go&Path=%2Fshared%2FCustom%2FSupply%20Chain%20Management%2FChangeOrderDetails&Action=Navigate&P0=1&P1=eq&P2=%22Change%20Order%20Details%22.%22Change%20Order%20Name%22&P3=#{Number}
-
Report
Parameterized URL: {HOST_NAME}/xmlpserver/Custom/Supply%20Chain%20Management/ChangeOrderDetails.xdo?_xpt=0&_xf=html&name=#{CHANGE_NAME}
-
URL
Parameterized URL: {HOST_NAME}/tickets/#{BUG_NUMBER}
Sample URL: https://support.example.com/tickets/#{BUG_NUMBER}
-
URL with concat function
Parameterized URL: {HOST_NAME}/CustomValidatorApplication/index.html#item?itemNumber=#{bindings.ItemNumber.inputValue}&abc=concat(variable_ChangeNotice,variable_ChangeName,variable_GLOBAL_DFF_biattribute26)
-
URL with JWT token
Parameterized URL: {HOST_NAME}/index.html#bulkprocess?itemNumber=#{Item Name}&jwt=#{applCoreSecuredToken.trustToken}
Sample URL: https://myapp.com/index.html#bulkprocess?itemNumber=LaptopPro&jwt=TrustTokenSample
OR
Parameterized URL: {HOST_NAME}/index.html#bulkprocess?itemNumber=#{Item Name}&CustomToken=#{applCoreSecuredToken.trustToken}
Sample URL: https://myapp.com/index.html#bulkprocess?itemNumber=LaptopPro1&CustomToken=TrustToken2
Here are some additional details on configuring actions:
- You can disable configured actions that you don't want to display in the Product Management interface. Disabled actions aren't visible to users until you enable them.
- You can reorder configured actions that appear in the Actions menu, including actions within the same group.
- You can use the concat function in the Expression Builder to combine multiple parameters and dynamically construct URLs.
- Messages returned by object functions are displayed as banner messages.
- You can configure up to 250 Application Composer global functions and object functions as actions.
- Before initiating a configured toolbar action that runs in the background on a workflow, you can set the workflow status to Hold to prevent other users from making changes while it runs.
- If you don't select Run in Background, the application displays a loading screen and blocks user interaction until the action completes. If you select Run in Background, you can continue using the application while the action runs.