OCI-Object Store for Uploaded Attachment Management

With OCI-Object Store, you can store attachments (such as those uploaded during LPN Inquiry transaction) directly in your Oracle Cloud Infrastructure (OCI) object store bucket. This approach gives your organization complete control over storage, retention, and security. After you complete the OCI-Object Store configuration, your uploaded attachments will be stored in your designated cloud object store bucket.

Note: As a pre-requisite,youmust obtain valid Oracle Cloud Infrastructure user credentials with permissions to access the required bucket.

To configure your environment to use OCI-Object Store, do the following:

1. Go to the SaaS App Configuration (SaasAppConfigView) UI.
2. Click the Create (+) icon.
3. From the App Name drop-down list, select OCI-OBJECTSTORE.
4. Enter the following mandatory fields:

   In the UI, the parameter fields are labelled as “App parm3”, “App parm4,” and so on. These field names do not indicate their purpose within the SaaS App Configuration screen. Please refer to the following table for each parameter’s meaning and the format required. You may need to obtain some of this information from your Oracle Cloud administrator.

   Field Name	Description	Sample Format
   Base URL	OCI-Object Store bucket URL	https://<namespace>.objectstorage.<region>.oraclecloud.com/n/<namespace>/b/<bucket-name>/ NOTE: The region and bucket name must match with App parm6 and App parm7
   App parm3	User OCID (must start with ocid1.user)	ocid1.user.oc1..aaaa...
   App parm4	API Key Fingerprint	12:34:56:78:90:cd:ef
   App parm5	Tenancy OCID (must start with ocid1.tenancy)	ocid1.tenancy.oc1..aaaa...
   App parm6	Region (ends with a digit, separated by hyphens)	us-phoenix-1
   App parm7	Bucket Name	test_bucket-01
   App parm8	Private Key	A valid RSA private key. NOTE: App parm8 is encrypted in the database and not displayed in the grid view (but it is editable).

   Note:

   • SaaS App configurations can be created for Facility * or Company * (one object store bucket per an environment).
   • You cannot delete an OCI-Object Store configuration once created.
   • You must continue using your designated OCI-Object Store moving forward. Uploading attachments is not allowed if OCI-Object Store is not configured. The system displays an error message “Need to configure Object Store in SaaS App Config screen.” when you upload attachments.
   Warning: Once you configure OCI-Object Store, this configuration is permanent. You cannot revert to the original object store.
5. Click Save.

Note: If validation fails, the system displays an error message.

If you are a new user (never used attachments), you must configure OCI-Object Store before uploading attachments. If you are an existing user, you can configure OCI-Object Store and migrate your existing uploaded attachments.

Migration of Existing Attachments

A one-time migration feature allows you to move attachments from the Oracle WMS object store to your newly configured OCI-Object Store bucket.

To migrate your existing uploaded attachments,

1. On the SaaS App Configuration UI, click the Migrate Attachments action button (enabled only if you have previously used Oracle WMS storage and have not migrated yet).
2. Confirm the migration.

The migration process runs in the background and you will receive status notifications.

Status	Message
In progress	Migration in progress! Please check AsyncTaskView for status.
No attachments to migrate	No attachments to migrate.
No config found	SaaS App Config not found! Cannot migrate attachments.

Note:

• Migration can only be performed once.
• After migration, attachments will be uploaded to your configured OCI Object Store.
• Attempting to migrate again after migration is not allowed.