Add Attachments to a Process using Visual Builder Application (VBCS)

 Add Attachments to a Process using Visual Builder Application (VBCS)

To add attachments to a process using Oracle Visual Builder Cloud Service (VBCS), you can utilize the File Upload component and leverage the Process Cloud Service (PCS) REST APIs for attachment management. Here are the general steps:

1. Set Up Process Cloud Service (PCS) Process:

• Create a process in Oracle Process Cloud Service that includes a service or user task where attachments will be associated. Ensure the process has variables or data objects to store attachment details.

2. Generate PCS REST API Definitions:

• In PCS, generate REST API definitions for managing attachments. This can be done using the REST API Explorer in the PCS Console. This will provide you with the endpoints and payloads needed for attaching files.

3. Design Visual Builder Cloud Service (VBCS) Application:

• Create a new or use an existing VBCS application where you want to manage attachments.

4. Add File Upload Component:

• Within your VBCS application, add a File Upload component to the page where you want users to upload attachments. Configure the File Upload component to capture the uploaded file.

5. Handle File Upload Event:

• Create a JavaScript function in VBCS to handle the file upload event. In this function, you will need to handle the file upload logic and call the PCS REST API to associate the uploaded file with the process instance.

6. Use Process Instance ID:

• When calling the PCS REST API to attach a file, you'll typically need the Process Instance ID to associate the file with a specific process instance. Ensure that your VBCS application captures or retrieves the relevant Process Instance ID based on your use case.

7. Invoke PCS REST API from VBCS:

• Use the JavaScript fetch API or other HTTP request methods in VBCS to invoke the PCS REST API for attaching files. Include the necessary authentication and process instance information in the request headers and payload.

8. Handle PCS REST API Response:

• Implement logic to handle the response from the PCS REST API call. Verify if the attachment was successfully added to the process instance, and update your VBCS application's UI accordingly.

9. Test the Integration:

• Test the integration by uploading files through your VBCS application and verifying that they are properly associated with the corresponding process instance in PCS.

10. Handle Security Considerations:

sql
- Ensure that your integration follows secure practices, including proper authentication and authorization mechanisms. Protect sensitive data and use secure connections (HTTPS) when interacting with REST APIs.

11. Handle Error Scenarios:

vbnet
- Implement error handling mechanisms in your VBCS application to gracefully handle scenarios where file uploads or API calls fail. Provide informative messages to users in case of errors.

12. Documentation:

arduino
- Document the integration details, including the APIs used, payload structures, and any specific configurations. This documentation is valuable for future maintenance and troubleshooting.

Note:

Always refer to the official documentation for Oracle Visual Builder Cloud Service and Oracle Process Cloud Service for the most up-to-date information on REST APIs and best practices. The specifics of implementing the integration may vary based on the versions of VBCS and PCS you are using.