ODI12C - How to open ODI studio from Console or terminal

This is simple. If the Odi 12c is installed on linux system, then open the terminal and navigate to odi/studio path and run ./odi.sh script.

Steps with screenshots:

OIC - Get object from OCI object storage using OIC | Oracle Integration Cloud

Usecase: Here, we will create an object storage rest connection and using that connection, we will create an app driven integration, configure rest call to object storage and get the file from object storage.

Implementation Steps:

Step1: Create Rest connection.

Oracle home >> Integrations >> Connections >> Create >> Rest 

Provide rest API base URL

Select Securtiy as OCI Signature version 1

Provide Tenancy OCID, user OCID, private ley and fingerprint.

Test and save.

Step2: Create an app driven integration 

Integration flow:

Configure Rest input as object name and output as Binary

Call the rest connection to get the file or object from object storage

URI: /n/{namespaceName}/b/{bucketName}/o/{objectName}

Verb: GET

Configure Request Payload as Binary Format

Map the bucket name, object name and namespace.

Map the object storage response file reference to rest response.

Test

How to create a OCI object storage bucket, how to get Tenancy OCID, User OCID, API private RSA key and finger print and Namespace, everything mentioned in the previous blog. Pleae check below link.

https://soalicious.blogspot.com/2022/08/oic-how-to-use-oci-object-storage-from.html

OIC How to use OCI Object storage from the Oracle Integration Cloud | Put a file to OCI Object storage from Oracle Integration Cloud

UseCase: Here, we will create a OCI object storage bucket. From OIC, read a file and put that file to bucket using Rest connection.

Step 1 : Create a bucket in OCI object storage

In the Oracle console >> Storage >> object storage & Archive storage >> select the required compartment >> create bucket

Step 2 : Create a Object storage Rest connection

To create a Rest connection , we need to collect the following information:

Connection type : REST API Base URL

Connection URL : https://objectstorage.<region>.oraclecloud.com

My case, region is: us-ashburn-1

Securtity: OCI Signature Version 1

Tenancy OCID and Object storage Namespace: get the Tenancy OCID from the OCI console on the Tenancy Details page.

Search Tenancy in the search box

Or from profile >> Tennacy

Here we also got the Object storage namespace.

User OCID : get the user's OCID in the console on the User details page.

Profile >> User Settings

Private Key & FingerPrint: 

Profile >> User settings >> API Keys >> Add API Key >> download private key >> add >> note the fingerprint.

Oracle home >> Integrations >> Connections >> Create >> Rest 

Test and save.

Step 3:  Create the Integration

Integration flow:

Read the file 

Call the rest connection to put the file to object storage

URI: /n/{namespaceName}/b/{bucketName}/o/{objectName}

Verb: PUT

Configure Request Payload as Binary Format.

Map the namespace, bucket name, object name and fileReference to stream reference.

Save, Add Tracking and activate and test

See the below file uploaded to object storage bucket.

Note: Private key downloaded from the Oracle Cloud Infrastructure Console are in PKCS8 format. The OCI Signature version 1 security policy available with the Rest adapter only supports reading of the private key in RSA format(PKCS1) format.

If you receive the following error, you must convert the private key from PKCS8 to RSA(PKC1) format:

oracle.cloud.connector.impl.rest.security.signature.signatureException: java.lang.ClassCastException: org.bouncycastle.asn1.pkcs.PrivateKeyInfo can not be cast to org.bouncycastle.openssl.PEMKeyPair.

Convert the private key with the following command:

openssl rsa -in private_key_in_pkcs8_format.pem -out new_converted_file.pem

We can also convert it using online availavle site like below:

https://8gwifi.org/pemconvert.jsp

Reference:

https://blogs.oracle.com/integration/post/how-to-use-the-oci-object-storage-from-the-oracle-integration-cloud

OIC Interview question and Answers | Oracle Integration Cloud

OIC interview Q & A:

1. FBDI approach with an example

https://soalicious.blogspot.com/2022/02/oic-erp-supplier-bulk-import-and.html

2. OIC FTP vs OIC File adapter

Answer: https://soalicious.blogspot.com/2021/05/oic-file-adapter-vs-ftp-adapter.html

3. ERP events callback or subscription.

Answer:https://soalicious.blogspot.com/2023/03/erp-register-csf-key.html?m=1

4. Gen1 vs gen2 OIC pack

https://soalicious.blogspot.com/2022/03/oic-gen-1-vs-gen-2-benefits-of-oic.html

5. OIC Agents

https://soalicious.blogspot.com/2020/10/oic-connectivity-agent.html

https://soalicious.blogspot.com/2020/11/oic-connectivity-agent-part-2.html

https://soalicious.blogspot.com/2022/05/oic-install-connectivity-agent-in.html

6. How to handle large file in OIC

https://soalicious.blogspot.com/2021/05/oic-how-to-handle-more-than-10-mb-file.html

7. OIC error handling:

https://soalicious.blogspot.com/2021/12/oic-ootb-error-handling-in-easy-steps.html

8. OIC Integration pattern/ Styles

https://soalicious.blogspot.com/2019/11/oracle-cloud-integrationoic-introduction.html

9. OIC migration from one instance to higher one.

https://soalicious.blogspot.com/2022/02/oic-migration-of-integration-from-one.html

10. What issues you observed in OIC ERP.

https://soalicious.blogspot.com/2021/03/oic-synchronous-integrations.html

11. Can file adapter and ftp adapter support high availability mode using connectivity agent?

https://soalicious.blogspot.com/2023/07/oic-can-file-server-and-ftp-server.html

12. Maximum duration for integration flows | time out time for OIC services | Service limit for Scheduled orchestration or Async or Sync service

https://soalicious.blogspot.com/2023/06/oic-maximum-duration-for-integration.html

13. Why to avoid creating too many scheduled integrations

https://soalicious.blogspot.com/2021/07/oic-why-to-avoid-creating-too-many.html

14. How many different scheduled integrations can run in parallel in Oracle Integration | Decoupled scheduler and Business Logic pattern.

https://soalicious.blogspot.com/2023/09/oic.html

OIC Tracing | How to enable and use OIC Tracing | Oracle Integration Cloud

Why we need tracing: 

• When Tracing is enabled, OIC integration prints detailed information before and after each action / activity that is executed. It also prints the message / payload of needed. 
• We should make sure that it is enabled only for debugging purposes and turned off before going into production.
• When tracing is enabled, integration activity can be viewed in Activity Stream.

Types of Tracing:

1. Integration Level : If your requirement is to enable the tracing for one or more integrations and disable tracing for the rest of the integrations, you can ise Integration level tracing.
2. Global Tracing On : It will turn tracing on for all activated flows and we can't enbale/disable it at individual level on the integration page.
3. Global Tracing Off :  It will turn tracing off for all activated flows and we can't further enbale/disable it at individual level on the integration page.

How to change the level of Tracing:

Oracle home >> Settings >> Integrations >> Tracing

If we choose the Integration level tracing, we can enbale or disable the tracing at individual integration level following below steps:

Go To Integrations Page >> select actions >> Tracing >> Enable Tracing & Include Payload >> Save

OIC to ERP : Move custom report | download custom report based on ess job id and then move to desired folder

Usecase: Here, we will create a sub integration which will take a request id and check if ESS job status, if its succceeded, it will download the report and move the file to desired mail dl or sftp directory.

HighLevel steps:

• Main flow (where import and child process runs) call to callback integration
• Archive the success file
• Execute the execution accounting report based on child request id for support help.
• Call ESS job which internally calls the BI report to execute the SQL query to get the callback report
• Call a Sub Integration like MoveCTRLReport and feed the ESS job process id
• Here, check the ESS job status using getESSJobStatus(Interesting fact is that we are looping max 55 times to check if the ESS process completes )
• If ESS process gets completed,
• Download the control report using downloadESSJobExecutionDetails operation
• Write the control report in stage
• Unzip the report
• Read the text report
• Move the report to FTP location

Request payload:

{

"RequestId":"",

"directoryAdapter":"",

"sourceFileName":"",

"targetDirectory":""

}

Implementation logic steps:

1. Configure rest request with post verb. Request json payload spacified above.
2. Assign looping variables like
1. LoopCounter = -45.0
2. ESS_Status = ""
3. MaxLoopCount = 9
3. Take a while loop with condition $Loopcounter < $MaxLoopCount and $ESS_Status != "SUCCEEDED"
1. Call Erp cloud adapter - operation: getESSJobStatus and service : erpIntegrationService and map request Id.
2. Wait 59 sec
3. Assign status like
1. LoopCounter = Loopcounter +1
2. ESS_Status = result of the getESSJobStatus
4. Take a switch and check if ESS_Status = SUCCEEDED 
1. If yes,
1. Call erp cloud adapter and download control report using service: erpIntegrationService and operation: downloadESSJobExecutionDetails. And map request id
2. Write control reports to stage location using sourceFileName, temp stage location and using opaque schema and map the content to opaque element.
3. Unzip the zipped contents using stage
4. Read text control report using stage and xsd opaque file. Specifying file name as unzipcontrolreport/properties[filetype='text']/filename
5. Call another sub integration like OIC_File_Handler to move the control report to desired sftp or s3 folder. Or send a mail attaching the report.
2. If no, throw new fault with code, reason, details.

Sceenshots:

TBD

OIC To ERP - Design steps for Import and Custom callback | Oracle Integration Cloud

Usecase: Here we will see a design how we can import to Cloud ERP and get a Custom callback. 

Implementation Steps:

Follow the below design steps:

• First source file is there in a SFTP location. So we will list files of the location using SFTP connection
• We can have multiple files, so we will iterate over the file references and take a body scope
• Download each file to stage location
• Write header field names to a header file.
• Write LineHeader names to a Line file
• Read file reference from the download response using stage File action and CSV file sample.
• For each file record, 
• Put a switch activity and check of 1st column of the field(Transaction_Identifier) = Header ,
• Then appends the header details to the header file
• If Transaction_Identifier = Line,
• You can map the line records to the Line file
• Take a debit and credit line counts, total debit and total credit line counts etc
• If your file has Trailer part  , check if Transaction_Identifier = Trailer,
• Take the all the trailer record counts like total debit line count, total credit line counts, total debit amount, total credit amount , total lines etc
• We can also map the line records outside of the for each record loop using a Stage Read in Segments so that the performance can improve, In the XSLT , we have to check if the record identifer =Line, then go for the line record mapping to line file.
• Write Metadata file like Metadata version number and Application short name etc if needed
• Zip all these 3 files - header, Line and Metadata using stage file action
• We can keep a back up of the zip file by calling a sub Integration (File_Handler) to archive the file to a FTP location
• Now we can validate the Trailer information with the record level all the counts like total debit line , total credit line, total debit amt, total credit amt , total lines etc. Once this switch checks success
• We can create OIC level control file 
• Now we call call sub integration (Encrypt_Import) to encrypt and import the zip file to Cloud ERP. We can do following 3 way of import.
• Old method - Multi step : https://soalicious.blogspot.com/2021/05/oic-erp-import-technique-1.html
• ImportBulkData operation of ERPIntegrationService: https://soalicious.blogspot.com/2021/05/oic-import-to-erp-technique-2-bulk-data.html
• New 1 step method - import Bulk Data : https://soalicious.blogspot.com/2022/02/oic-erp-supplier-bulk-import-and.html
• Check import process status using getESSJobStatus 
• Follow: https://soalicious.blogspot.com/2021/07/oic-get-ess-job-status.html
• Capture Child Process id of the import process if any
• Follow: https://soalicious.blogspot.com/2022/01/oic-erp-how-to-get-child-process-id.html
• Check the child process status again using getESSJobStatus
• Follow: https://soalicious.blogspot.com/2022/08/oic-get-ess-job-status-of-child-process.html
• Call CallBack sub Integration to get the custom call back
• Approach1: https://soalicious.blogspot.com/2022/02/oic-custom-callback-from-erp.html
• Approach2: https://soalicious.blogspot.com/2022/08/oic-to-erp-improved-custom-callback.html