Call Category

The Call category enables you to add decision, file server, JavaScript, OCI function action, OCI object storage, process, public event, and robot flow actions to an integration.

Topics:

Add a Decision Model to an Integration with a Decision Action

You can select to include an activated decision model in your integration by adding a decision action at the appropriate point.

All information about adding a decision action is covered in a separate guide. See Add a Decision Model to an Integration in Using Decisions in Oracle Integration 3.

Interact with Files in File Server

You can obtain a list of files, write or move a file to File Server, get the reference of a file and then stage read or unzip the file, and delete a file on File Server using the File server action.

On This Page

What You Can Do with the File Server Action

The File server action lets you interact with files in the following ways.

For all of the options, you can hard code values, but most of the time, you'll pass dynamic values into the File server action using the Map action. Complete that task after you finish defining the File server action. See Next Steps.

Goal Operation to use Step-by-step instructions

Obtain a list of files in a File Server directory

List directory

  1. Start Here: Add the File Server Action to an Integration

  2. Option 1. Obtain a List of Files in File Server

Create a new file in a File Server directory

Write File

  1. Start Here: Add the File Server Action to an Integration

  2. Option 2. Write a File to File Server

Move a file from one File Server directory to another (similar to a cut and paste operation)

Move File

  1. Start Here: Add the File Server Action to an Integration

  2. Option 3. Move a File to File Server

Get a reference to a file in a File Server director, and use the reference to complete either of the following tasks:

  • Stage the file and then work with the staged file as needed in Oracle Integration

  • Write the file to another File Server directory

Get File Reference

  1. Start Here: Add the File Server Action to an Integration

  2. Option 4. Stage a File and Work with It, or Write a File to Another Location in File Server

Encrypt or decrypt a file

  • For files that must be encrypted and saved to File Server: Get File Reference, which gets a reference to a file.

    After the File server action, add a stage file action to encrypt the file, and then another File server action using the Write File operation. The File server action uploads the file to File Server by passing the encrypted file reference.

  • For encrypted files in File Server that must be decrypted: Get File Reference, which gets a reference to an encrypted file, followed by a stage file action to decrypt the file.

You can also use the capabilities of the FTP Adapter to encrypt or decrypt a file.

  1. Start Here: Add the File Server Action to an Integration

  2. Option 4. Stage a File and Work with It, or Write a File to Another Location in File Server

  3. Process Files in Schedule Integrations with a Stage File Action

  4. Option 2. Write a File to File Server

Alternatively, to use the FTP Adapter to encrypt or decrypt a file, see Create a Connection and Add the FTP Adapter Connection to an Integration in Using the FTP Adapter with Oracle Integration 3.

Sign or verify a file

You can perform signing using the private key to allow the receiver to verify that the file contents were not altered during transit. You can also perform signature verification using the public key on the incoming file to verify that the contents were not altered during transit.

  • For files that must be signed or verified and then saved to File Server: Get File Reference, which gets a reference to a file.

    After the File server action, add a stage file action to perform file signing or verification, and then another File server action using the Write File operation. The File server action uploads the file to File Server.

  • Alternatively, you can use the capabilities of the FTP Adapter to perform file signing or verification.

  1. Start Here: Add the File Server Action to an Integration

  2. Option 4. Stage a File and Work with It, or Write a File to Another Location in File Server

  3. Process Files in Schedule Integrations with a Stage File Action

  4. Option 2. Write a File to File Server

Alternatively, to use the FTP Adapter to perform file signing or verification, see Create a Connection and Add the FTP Adapter Connection to an Integration in Using the FTP Adapter with Oracle Integration 3.

Delete a file in a File Server directory

Delete File

  1. Start Here: Add the File Server Action to an Integration

  2. Option 5. Delete a File in File Server

When Not to Use the File Server Action

If you need to write a file to a temporary storage location and then perform work on the file, such as by updating the file, use a connection that is based on the FTP Adapter, or use the stage file action.

Start Here: Add the File Server Action to an Integration

No matter what you need to use the File server action to do, start here by adding the action to your integration.

  1. Add a File server action to an integration in either of the following ways:

    • On the side of the canvas, click Actions Integration actions icon and drag the File server action to the appropriate location.
    • Click Add icon at the location where you want to add the assign action, then select File server.

    Note:

    If you don't see the File server action or can't add it to an integration, then an administrator needs to enable File Server for your Oracle Integration instance. See Enable File Server in Using File Server in Oracle Integration 3.

  2. Fill in the following fields.

    Field Description
    What do you want to call your endpoint? Name of the endpoint, such as write_file_to_File_Server.
    Select resource

    Select one of the following options:

    • File: Interact with a file, such as by writing, moving, downloading, reading, or deleting it.

    • Directory: Obtain a list of files in a specific directory in File Server.

    Additional fields, which are related to the operation that you selected, appear.

  3. Continue following the steps in the appropriate section:

Option 1. Obtain a List of Files in File Server

  1. Complete the steps in Start Here: Add the File Server Action to an Integration.

  2. From the Select operation drop-down list, select List directory.

  3. Fill in the following fields.

    Field Description Can override later in the mapper?
    Input Directory

    Name of the directory that contains the files that you need to list. Oracle recommends using an absolute directory.

    For example, /HOME/USERS/.

    		Yes
    File name pattern Pattern of the files that you want to list, such as *.csv for only CSV files. Or, enter * to list files of all types. Yes
    Max Files

    Maximum number of files to return, up to 1000.

    Note: The File server action returns the files according to the last modified time. If you selected 10 as the maximum number of files and the last modified time of the eleventh file is the same as the tenth file, then the action also returns the eleventh file and any other files with the same last modified time. For example, consider a directory with 15 files, and the Max Files setting is 10. If the tenth, eleventh, twelfth, and thirteenth files have the same time stamp, then the File server action returns thirteen files.

    		No
    Minimum Age (seconds)

    Minimum age in seconds of the files to return.

    For example, if a file was last modified at 02:28:45 AM, and the minimum age is 80 seconds, the file isn't returned at 02:29:00 AM and 02:30:00 AM. The file is returned only after 02:30:05.

    		 No
    List File Recursively Whether to list files within directories recursively beneath the input directory. No

  4. Select Continue.

  5. Review the summary of the action, and select Finish.

The File server action appears on the canvas with a Map action before it.

Option 2. Write a File to File Server

  1. Complete the steps in Start Here: Add the File Server Action to an Integration.

  2. From the Select operation drop-down list, select Write File.

  3. Fill in the following fields.

    Field Description Can override later in the mapper?
    Specify an Output Directory

    Name of the directory to write the files to. Oracle recommends using an absolute directory.

    For example, /HOME/USERS/.

    		Yes
    File Name Name of the file to create. Yes

  4. Select Continue.

  5. Review the summary of the action, and select Finish.

The File server action appears on the canvas with a Map action before it.

Option 3. Move a File to File Server

  1. Complete the steps in Start Here: Add the File Server Action to an Integration.

  2. From the Select operation drop-down list, select Move File.

  3. Fill in the following fields.

    Field Description Can override later in the mapper?
    Directory path

    Name of the directory that contains the file to be moved. Oracle recommends using an absolute directory.

    For example, /HOME/USERS/.

    		Yes
    File name Name of the file to be moved. The file can be of any size. If the file is missing, an error occurs when the integration attempts to locate it. Yes
    Target directory path

    Name of the directory to move the file to. Oracle recommends using an absolute directory.

    For example, /HOME/USERS/.

    If the directory doesn't exist, File Server creates it.

    		 Yes
    Target file name Name of the file in the target directory. Yes
    Overwrite File

    When selected, the target file is overwritten if it already exists.

    If you deselect this option and the file already exists in the target directory, an error occurs when File Server attempts to move the file to the directory.

    		No

  4. Select Continue.

  5. Review the summary of the action, and select Finish.

The File server action appears on the canvas with a Map action before it.

Option 4. Stage a File and Work with It, or Write a File to Another Location in File Server

This operation gets a reference to a file in File Server. If anyone moves or deletes the file while the integration is running, an error occurs, indicating that the file doesn't exist.

  1. Complete the steps in Start Here: Add the File Server Action to an Integration.

  2. From the Select operation drop-down list, select Get File Reference.

  3. Fill in the following fields.

    Field Description Can override later in the mapper?
    Input Directory

    Name of the directory that contains the files that you need to download. Oracle recommends using an absolute directory.

    For example, /HOME/USERS/.

    		Yes
    File Name Name of the file in the input directory. Yes

  4. Select Continue.

  5. Review the summary of the action, and select Finish.

The File server action appears on the canvas with a Map action before it.

Option 5. Delete a File in File Server

  1. Complete the steps in Start Here: Add the File Server Action to an Integration.

  2. From the Select operation drop-down list, select Delete File.

  3. Fill in the following fields:

    Field Description Can override later in the mapper?
    Directory path

    Name of the directory to delete. Oracle recommends using an absolute directory.

    For example, /HOME/USERS/.

    		Yes
    File name Name of the file to delete. Yes

  4. Select Continue.

  5. Review the summary of the action, and select Finish.

The File server action appears on the canvas with a Map action before it.

Note that the activity stream doesn't detect the file size, so the file size always appears as 0 in the activity stream for deleted files.

Next Steps

Add JavaScript Functions to an Integration with a JavaScript Action

You can add JavaScript functions to the integration.

Create a JavaScript Action

Note:

Note the following restrictions when using the JavaScript action:

  • The JavaScript action has a timeout threshold of 15 seconds. Any JavaScript function that processes for more than 15 seconds fails with a timeout error.

  • JavaScript functions are not allowed to make outbound calls to external services. Any outbound calls are blocked and ultimately fail.

  • Network, disk access, or thread access functions are not supported.

  1. Add a Javascript action to an integration in either of the following ways:

    • On the side of the canvas, click Actions Integration actions icon and drag the Javascript action to the appropriate location.
    • Click Add icon at the location where you want to add the Javascript action, then select Javascript.

  2. Click Edit Edit icon under Configure Javascript to enter a name and optional description for the JavaScript action.

  3. Click the Function button.

    The Functions List appears.

  4. Select a function.

    The function and Sources tree are displayed. Function details are shown, including the input and output parameters.


    The Input Sources (which is selected) and Functions tabs are shown. Below is the Sources tree and a search icon. To the right is the Configure Javascript panel, which includes a name field, description field, Function section (add is the selected function), Input Parameters section, and a Replace button.

  5. Click the first input parameter to open a Value field.


    The Input Parameters section shows a parameter, a Value field, and another parameter.

  6. Drag a value from the Sources tree.


    The Input Sources (which is selected) and Functions tabs are shown. Below is the Sources tree and a search icon. To the right is the Configure Javascript panel, which includes a name field, description field, Function section (add is the selected function), Input Parameters section, and a Replace button. The Input Parameters section includes a parameter, a Value field with two icons, and a second parameter.

  7. Perform the same steps to add a value for the second input parameter.

  8. Click Save.

Track the Status of a Javascript Action During Runtime

During runtime, you can track the status of the JavaScript action on the Instances page through the tracking diagram and activity stream for an activated integration. This is only possible if there is a tracking instance.

  1. In the navigation pane, click Observability, then Instances.
  2. Click the business identifier value of the integration to track.
  3. The integration (including any JavaScript actions) is displayed. Any JavaScript action failures are identified by red.
    Details about processing status (including any JavaScript actions) are displayed, including any failures.
See Use Libraries to Manage Integration Functions.

Invoke Oracle Cloud Infrastructure Functions Directly from an Integration with an OCI Function Action

Oracle Integration provides native support for invoking Oracle Cloud Infrastructure functions. This support enables you to invoke Oracle Cloud Infrastructure functions with an OCI Function action in an integration.

Oracle Cloud Infrastructure functions are part of a fully managed, multi-tenant, highly scalable, on-demand, Functions-as-a-Service platform. Use Oracle Cloud Infrastructure functions to focus on writing code to meet business needs. See Overview of Functions and Functions QuickStart Guides.

Note:

Ensure that your cloud tenancy uses identity domains. The OCI Function action in the integration canvas does not work in cloud tenancies that are not enabled for identity domains.

Want to see a video demo of the OCI Function action?

Capabilities

Oracle Cloud Infrastructure functions provide serverless execution of functions within Oracle Integration to process complex logic not easily performed in Oracle Integration, such as the following:
  • Creating a digital signature based on a key against a specific payload.
  • Supporting a custom ZIP format such as GZIP or TAR.
  • Taking and parsing a PDF file for data fields that can then participate in an integration.

Oracle Integration supports whatever functions you create using Oracle Cloud Infrastructure functions. Oracle Cloud Infrastructure also provides a catalog of prebuilt functions. See Creating Functions Using Pre-Built Functions.

Prerequisites

Note:

When making cross-region calls (the function is in a different region than that of the Oracle Integration service instance), ensure you do the following:
You must perform the following prerequisites from the Oracle Cloud Infrastructure Console before you can invoke functions from an integration. Not performing these prerequisites results in the following error:
An authentication issue was encountered when invoking Function. Please 
check if the prerequisites for calling OCI services have been properly setup for 
this service instance. OCI service integration requires dynamic groups and policies 
granting access to be created in OCI Console. Please consult the documentation for 
more information.
  1. Ensure that your cloud tenancy uses identity domains. Invoking Oracle Cloud Infrastructure functions from an integration does not work in cloud tenancies that are not enabled for identity domains. If you are unsure, ask your administrator for details. Your cloud tenancy does not use identity domains if you observe either of the following:
    • In the upper right corner, you select your Profiles icon and don't see an entry for identity domain.


      The Profile menu shows entries for the oracleidentitycloudservice provider, tenancy, service user console, user settings, console settings, and sign out link.

    • From the Menu icon menu, you select Identity & Security and don't see Domains under the Identity section.


      The image shows the search field, and links for Home, Compute, Storage, Networking, Oracle Database, Databases, Analytics & AI, Developer Services, and Identity & Security (which is selected). On the right are options for Identity, Users, Groups, Dynamic Groups, Network Sources, Policies, Compartments, Federation, Authentication Settings Cloud guard, and Overview.

  2. Set up your environment to invoke Oracle Cloud Infrastructure functions from an integration. See Functions QuickStart on Cloud Shell. This section describes how to set up the following:
    • Set up your tenancy:
      • Create groups and users (if not already done so).
      • Create a compartment in which to create functions. You specify this compartment when configuring the OCI Function action in the integration canvas.
      • Create a virtual cloud network (VCN) and subnets. For example:


        The Virtual cloud networks tab is selected in the left navigation pane. At the top is the label Virtual Cloud Networks in compartment_name Compartment. Below are the Create VCN and Start VCN Wizard buttons. Below is a table with columns for Name, Status, IPv4 CIDR Block, IPv6 Block, Default Route Table, DNS Domain Name, and Created.

      • Create a policy for groups and services. This policy enables you to create functions. For example:


        The Policies tab is selected in the left navigation pane. At the top is the label Policies in compartment_name Compartment. Below are the Create Policy and Delete buttons. Below is a table with columns for Name, Description, Statements, and Created columns.

    • Create an application in which to create the functions to invoke. You specify this application when configuring the OCI Function action in the integration canvas. For example:


      The Applications tab is selected in the left navigation pane. At the top is the label Applications in compartment_name Compartment. Below is a table with columns for Name, Status, Created, and Last updated columns.

    • Set up your Cloud Shell development environment.
    • Create, deploy, and invoke your function. For example:

      Note:

      You must create your own functions in your tenancy. Oracle Cloud Infrastructure doesn't deploy or create any functions for you by default. Oracle Cloud Infrastructure does provide prebuilt functions that you can deploy to your own instance.


      The Functions tab is selected in the left navigation pane. At the top of the page is the name of the function. Below are the Move application, Add tags, and Delete buttons. Below is the Application information tab (selected) and Tags tab. The General Information section includes the OCIDs, Compartment, Logging policy, Trace name, Created, Last updated, and Signature verification values. Next to this is the Network Information section, which includes the Subnets and Network security groups values. Below is the Functions section. Below is the Create function list. Below is a table with columns for Name, Image, Image endpoint, Provisioned concurrency units, and Last updated columns.

  3. Create a dynamic group.
    1. Obtain the client ID of the OAuth application for the Oracle Integration instance.
    2. In the upper right corner, select Profile, then click the identity domain.


      The Profile icon is selected to show the Profile section, which shows Identity domain: Default.

    3. In the left navigation pane, click Oracle Cloud Services.


      The Identity domain menu shows entries Overview, Users, Groups, Dynamic groups, Applications, and Oracle Cloud Services.

      The Oracle Cloud Services page for your domain appears.

    4. In the Name column, click your service instance.
    5. Scroll down to the General Information section and copy the client ID value to use to create your dynamic group.
  4. Scroll to the breadcrumbs at the top and click Default domain.


    The Identity > Domains > Default domain > Oracle Cloud Services breadcrumbs are shown.

  5. In the left navigation pane, click Dynamic groups.
  6. Click Create Dynamic Group.
  7. Enter the following details:
    1. In the Name and Description fields, enter values. These fields are required.
    2. In the Matching Rules section, enter the required rule. The resource ID you specify must match the client ID of the OAuth application of your Oracle Integration instance. Ensure that you enclose the value in single quotes. For example:
      resource.id = 'client_ID'


      The Matching rules section shows a value of resource.id = 'FA2E'

  8. Assign a policy to the dynamic group to enable you to invoke Oracle Cloud Infrastructure functions from an integration.
  9. Scroll to the breadcrumbs at the top and click Identity.


    The Identity > Domains > Default domain breadcrumbs are shown.

  10. In the left navigation pane, click Policies.
  11. Click Create Policy.
  12. Select the compartment in which to create the policy.
  13. Enter the following details:
    1. In the Name and Description fields, enter values. These fields are required.
    2. In the Policy Builder section, build the required policy for the dynamic group. The following example allows the dynamic group to use the entire functions family, but you can set more granular policies, as needed. See Controlling Access to Invoke and Manage Functions and Policy Statements to Give OCI Functions Users Access to Function-Related Resources.
      Allow dynamic-group group_name to use functions-family in compartment compartment_name
      Where:
      • group_name: Is the dynamic group name you created.
      • compartment_name: Is the compartment where the functions to invoke are hosted.

      This enables the Oracle Integration instance associated with the dynamic group to invoke Oracle Cloud Infrastructure functions with the OCI Function action in an integration.

Invoke Oracle Cloud Infrastructure Functions

This section provides an overview of how to configure an OCI Function action in the integration canvas to invoke the Oracle Cloud Infrastructure functions available in your application.

  1. Add an OCI Function action to an integration in either of the following ways:
    • On the side of the canvas, click Actions Integration actions icon and drag the OCI Function action to the appropriate location.
    • Click Add icon at the location where you want to add the parallel action, then select OCI Function.

    Note:

    If your cloud tenancy is not using identity domains, an error message appears and the page is blank.

    The OCI Functions wizard appears.

  2. On the Basic Info page, enter the following information to identify the function to invoke, then click >. When you enter details in a field, the page refreshes to show more fields.
    Element Description
    Region Select the region where the functions are deployed.
    Compartment Select the compartment where the functions to invoke are hosted.
    Application Select the application. Oracle Cloud Infrastructure functions are organized in sets called applications. An application can contain multiple functions.
    Function Select the Oracle Cloud Infrastructure function to invoke. The functions you are entitled to invoke by your application are displayed for selection.


    The Basic Info page shows the wizard train at the top: Basic Info, Request, Response, and Summary. To the left and right of the train are < and > links, respectively. Below are the Region, Compartment, Application, and Function lists.

  3. On the Request page, select the payload type and specify the content, then click >.
    • JSON Sample: Drag and drop or select a file, or manually enter the payload.
    • XML Schema: Drag and drop or select a file.
    • XML Sample (Single or No NameSpace): Drag and drop or select a file.
    • Binary:
      • For files, simply select Binary and map the content.
      • For plain/text request/response payloads, select Binary and perform the following encoding:
        • To provide text as input, you must first encode the text as Base64, then decode that Base64 to a stream reference.
          decodeBase64ToReference(encodeBase64(Name))
        • To receive the text output, you need to encode the output stream reference to Base64, then decode that Base64 to text.
          decodeBase64(encodeReferenceToBase64(Stream Reference))
  4. On the Response page, select the response payload type and specify the content, then click >. The available response payload types are the same as the request payload types.
  5. Review your selections on the Summary page. For this example, the hello-python-json function is invoked. The request and response media is in JSON format.


    The Basic Info page shows the wizard train at the top: Basic Info, Request, Response, and Summary. To the left and right of the train are < and > links, respectively. Below are the values for the Compartment Name, Application Name, Function Name, Request Media Type, Response Media Type, and Invoke Endpoint URL.

  6. Click Done.

Invoke Oracle Cloud Infrastructure Object Storage from an Integration with an OCI Object Storage Action

You can natively invoke Oracle Cloud Infrastructure Object Storage from an integration without the need to configure an explicit REST Adapter connection.

Oracle Cloud Infrastructure Object Storage Concepts

Oracle Cloud Infrastructure Object Storage is an internet-scale, high-performance storage platform that offers reliable and cost-efficient data durability. Oracle Cloud Infrastructure Object Storage enables you to securely store any type of data in its native format. An unlimited amount of unstructured data of any content type is supported, including analytic data and rich content such as images and videos. See Object Storage and Overview of Object Storage.

Prerequisites

To natively invoke Oracle Cloud Infrastructure Object Storage, you must satisfy the following Resource Principal Session Token (RPST) prerequisites in the Oracle Cloud Infrastructure Console.

Note:

The OCI object storage action doesn’t support cross tenancy calls. To make cross tenancy calls, configure the REST Adapter with the OCI Signature Version 1 security policy to call the object storage REST APIs. See this blog.
  • Create a dynamic group
  • Create a policy to grant access to Oracle Cloud Infrastructure Object Storage.
  • Ensure that your cloud tenancy uses identity domains. Your cloud tenancy does not use identity domains if you observe either of the following:
    • In the upper right corner, you select your Profiles icon and don't see an entry for identity domain.


      The Profile menu shows entries for the oracleidentitycloudservice provider, tenancy, service user console, user settings, console settings, and sign out link.

    • From the Menu icon menu, you select Identity & Security and don't see Domains under the Identity section.


      The image shows the search field, and links for Home, Compute, Storage, Networking, Oracle Database, Databases, Analytics & AI, Developer Services, and Identity & Security (which is selected). On the right are options for Identity, Users, Groups, Dynamic Groups, Network Sources, Policies, Compartments, Federation, Authentication Settings Cloud guard, and Overview.

  • Create the required dynamic group and assign a policy to that group to allow your Oracle Integration instance to access Oracle Cloud Infrastructure Object Storage. The policy defines the permissions for the dynamic group and determines which operations the dynamic group can perform on Oracle Cloud Infrastructure Object Storage and other services such as Oracle Cloud Infrastructure Functions, Oracle Cloud Infrastructure Vision, and more
    1. Log in to the Oracle Cloud Infrastructure Console.
    2. Obtain the client ID of the OAuth application for the Oracle Integration instance.
      1. In the upper right corner, select Profile, then click the identity domain.


        The Profile icon is being selected. The Profile section includes the Identity domain: Default link.

      2. In the left navigation pane, click Oracle Cloud Services.


        The Identity domain menu shows entries Overview, Users, Groups, Dynamic groups, Applications, and Oracle Cloud Services.

        The Oracle Cloud Services page for your domain appears.

      3. In the Name column, click your service instance.
      4. Scroll down to the General Information section and copy the client ID value to use to create your dynamic group.
    3. Scroll to the breadcrumbs at the top and click Default domain.


      The Identity > Domains > Default domain > Oracle Cloud Services breadcrumbs are shown.

    4. In the left navigation pane, click Dynamic groups.
    5. Click Create Dynamic Group.
    6. Enter the following details:
      1. In the Name and Description fields, enter values. These fields are required.
      2. In the Matching Rules section, enter the required rule. The resource ID you specify must match the client ID of the OAuth application of your Oracle Integration instance. Ensure that you enclose the value in single quotes. For example:
        resource.id = 'client_ID'


        The Matching rules section shows a value of resource.id = 'FA2E'

    7. Scroll to the breadcrumbs at the top and click Identity.


      The Identity > Domains > Default domain breadcrumbs are shown.

    8. In the left navigation pane, click Policies.
    9. Click Create Policy.
    10. Select the compartment in which to create the policy.
    11. Enter the following details:
      1. In the Name and Description fields, enter values. These fields are required.
      2. In the Policy Builder section, build the required policy for the dynamic group. Examples of the minimum policy required are as follows:
        allow dynamic-group dynamic_group to manage object-family in compartment compartment_name 

        allow dynamic-group dynamic_group to inspect compartments in compartment compartment_name
        Where:
        • dynamic_group: Is the dynamic group name you specified in Step 5.
        • compartment_name: Is the compartment in which your Oracle Integration instance is located.

        This enables the Oracle Integration instance associated with the dynamic group to call Oracle Cloud Infrastructure Object Storage in this particular compartment. The RPST token is only valid for resources to which the dynamic group has been granted access using this policy.

        Details about more granular permissions for object storage are provided. See Securing Object Storage.

Invoke Oracle Cloud Infrastructure Object Storage from an Integration

Note:

Use of an OCI Object storage action in a project is not supported.
  1. Add an OCI Object storage action to an integration in either of the following ways:
    • On the side of the canvas, click Actions Integration actions icon and drag the OCI Object storage action to the appropriate location.
    • Click Add icon at the location where you want to add the action, then select OCI Object storage.

    The Configure object storage panel opens.

  2. Enter a name.
  3. Select the resource to manage.
    • Manage buckets: Buckets are logical containers for storing objects. Buckets are region- and compartment-specific. You can define policies at a bucket level to control access.
    • Manage objects: Objects are stored within buckets. Objects can be any data type and consist of the object itself and any metadata.
  4. If you select Manage buckets:
    1. From the Operations list, select the operation to perform.
      • Create bucket: Create a bucket in Oracle Cloud Infrastructure Object Storage. In the mapper, you map the bucket name to create.
        1. Select the compartment in which to create the bucket. This selection during design-time is overridden if you map anything to the compartment Id field in the request mapper for this action.
      • List buckets: Retrieve a list of objects in a bucket in Oracle Cloud Infrastructure Object Storage. In the mapper, you map the bucket name to retrieve the objects list.
        1. Select the compartment in which to list the buckets. This selection during design-time is override if you map anything to the compartment Id field in the request mapper for this action.
      • Delete bucket: Delete a bucket in Oracle Cloud Infrastructure Object Storage. In the mapper, you map the bucket name to delete.
    2. Click Continue.
  5. If you select Manage objects:
    1. From the Operations list, select the operation to perform:
      • Upload object: Upload an object into Oracle Cloud Infrastructure Object Storage. In the mapper, you map the object name to upload. This is how you update an object (it overrides an existing object with the same name). The file size limit is 1 GB. However, the API can handle objects up to 50 GB in size. See PutObject.
      • Download object: Retrieve an object from Oracle Cloud Infrastructure Object Storage. In the mapper, you map the object name to retrieve. The size limit is 1 GB. Otherwise, the download fails.
      • Delete object: Delete an object in Oracle Cloud Infrastructure Object Storage. In the mapper, you map the object name to delete.
      • List objects: List all objects in Oracle Cloud Infrastructure Object Storage. In the mapper, you map the bucket name to retrieve the objects list.
    2. Select the compartment in which to perform the operation.
    3. Select the bucket in which to perform the operation. This selection during design-time is overridden if you map anything to the Bucket Name field in the request mapper for this action.
    4. Click Continue.
  6. Review your selections on the Summary page, then click Finish.

    This creates a map action in front of the OCI Object storage action.

Several use cases that natively invoke Oracle Cloud Infrastructure Object Storage are provided. See Manage Oracle Cloud Infrastructure Buckets and Objects from an Integration.

Invoke a Process from an Integration with a Process Action

You can invoke process automation from an integration. When you drag the process action into an integration, the Process Automation call wizard is invoked and prompts you to select a process application and a process to invoke.

Prerequisites

  • You must enable an Oracle Integration - Process Automation process in the Oracle Cloud Infrastructure Console for your service instance. Otherwise, you cannot drag the process action into the integration canvas. See Enable Process Automation with Oracle Integration 3 in Administering Oracle Cloud Infrastructure Process Automation.
  • Ensure that you perform one of the following tasks to enable the integration to invoke the process that you select. Otherwise, you receive a 403 NOT AUTHORIZED error at runtime.

    To provide access to all authenticated users:

    1. Click Start event in your process.
    2. From the Who can run this activity list, select All users and external applications.

    To provide access to Oracle Integration to invoke the process:

    1. From the drop-down list for your process, select Roles.


      The process design is shown. The drop-down list at the top is selected to show tabs for All, Processes, Uis, Decisions, Connections, Types, and Roles. Roles is selected to show a search icon. The ProcessUser is selected.

    2. From the Category list, select External applications.
    3. Copy the name of your service instance. The name is visible along with the instance shape at the top of the Oracle Integration page. See Get Familiar with the Home Page in Getting Started with Oracle Integration 3.
    4. Search for and select the instance name to add.


      The Add members to this role section is shown. The Category list is selected to shown the External applications option. The qa-manual-proj entry is selected in the search field.

Add a Process Action to the Integration

  1. Add a process action to an integration in either of the following ways:
    • On the right side of the canvas, click Integration actions icon and drag the Process action to the appropriate location.
    • Click Add icon at the location where you want to add the process action, then select Process.

    The Process Automation call wizard is displayed.

  2. On the Basic Info page, enter a name and optional description, then click Continue.
  3. On the Configuration page, enter the following details, then click Continue.
    Element Description
    Process Application Select the process application. Process instances enabled as part of Oracle Integration 3 are available for selection. Process instances that are part of standalone Oracle Cloud Infrastructure Process Automation are not available for selection.
    Version Default is selected automatically and cannot be changed.
    Process Select the process name. To be visible for selection, the process must already be activated and have been started by a form or a message. Message- and form-started processes are retrieved by the process action for display.
    Operation Create Instance is selected automatically and cannot be changed.
  4. On the Summary page, confirm your selections and click Finish. A process node with a map is displayed to provide the inputs to invoke the process. The map may contain one or more schemas and one or more complex or primitive types depending on the interface defined for the process.
  5. Complete the design and save the integration.
  6. Activate and invoke the integration.

    Every time a process is invoked, a new instance of the process is created.

Publish Events in an Integration with a Publish Event Action

You can publish an event in an integration. Subscription integrations can then subscribe to this event.

  1. Add a Publish Event action to an integration in either of the following ways:
    • On the side of the canvas, click Actions Integration actions icon and drag the Publish Event action to the appropriate location.
    • Click Add icon at the location where you want to add the publish event action, then select Publish Event.

    The Choose event panel opens.

  2. Specify an event in either of two ways:
    1. Select the event, then click Choose. If you are unsure of the event contents, click View details View details icon.
    2. Click Define new event to create a new event. See Create Events to Publish and Subscribe to in Integrations.
  3. Review your selections, then click Finish.

See Publish Events in an Integration.

Call a Robot from an Integration

A robot runs only when an integration calls it. Call a robot from an integration using the robot process automation action.

All information about robots is in a separate guide. For guidance about using the robot process automation action, see Design an Integration That Calls a Robot in Using Robots in Oracle Integration 3.