1. It invokes the Object Storage - List Objects REST API to get the list of files found in the Oracle Utilities Digital Asset Cloud Service Object Storage bucket, set in the properties dacs.os.dvcScore.bucketname and dacs.os.namespace. It will retrieve files matching the prefix set in property dacs.dvcScore.extract.filename.prefix.
Note: The value dacs.dvcScore.extract.filename.prefix should match the beginning of the parameter filename in Oracle Utilities Digital Asset Cloud Service Batch X1-SDCSE.
• If no file is found and notification.email.process.nofile.flag is true (by default it is false), it will send a no file found email notification to to.process.notification recipients defined in lookup OUTL-BRT-DACS_DRMS_EMAIL_ID and the process will stop.
• If files are found, proceed to the next step.
2. For each file, do the following:
a. Invoke the Object Storage: Gets Object REST API to get the actual file to process.
b. Invoke DERMS Device Score REST API and sends the file as a binary attachment.
• If Oracle Utilities Grid Edge Distributed Energy Resources Management System returns an HTTP 200 or 202, it invokes the REST API RenameObject to rename the source file obtained from the server by adding the prefix set in property dacs.prefixtag.fileuploaded and the next file in the list is processed.
3. After the successful transfer of all files, if the notification.email.process.complete.flag is true, a Process Complete email notification is sent to to.process.notification recipients defined in lookup OUTL-BRT-DACS_DRMS_Email_ID.
4. Error Handling.
For any errors encountered in this process:
• Invoke the REST API RenameObject to rename the source file obtained from the server by adding the prefix set in property dacs.prefixtag.filenotuploaded.
• An error email notification with error details is sent via the common error handler Oracle Integration Cloud process to the users defined in to recipients in lookup OUTL-BRT-DACS_DRMS_Email_ID.
• If the error happens while processing the list of files, the Process Complete email notification is also sent out containing the summary of files transferred and not transferred.
Technical Details
The following table describes the integration processes and the respective Oracle Cloud Infrastructure Object Storage and Oracle Utilities Grid Edge Distributed Energy Resources Management System artifacts used in this integration process.
Artifacts
Value
Integration Process Name
OU DACS DERMS Device Score OS Transfer
Integration Process Identifier
OUTL-BA-DRMS_DACS_SEND_DVCSCOREC
Integration Project Name
OU DACS DERMS
Source Connection (REST Adapter)
OU REST DACS Object Storage for DACS
Target Connection (Oracle Utilities Adapter)
OU REST DRMS for DACS-DERMS
invoke
• DERMS Service Name: NMS-DACSInbound
• openAPIUrl: https://{host}:{port} /nms-drms/ rest/v1/openapi.json
• OperationId: deviceScore
• Method: POST
• URI: /device-score/{file-name}
Local Integrations
OU DACS DERMS Common Error Handler
Lookup
• OUTL-BRT-DACS_DRMS_ConfigProps
• OUTL-BRT-DACS_DRMS_Email_ID
Solution Architecture
This chapter provides an overview of the application architecture used by the integration, including: