1. Administering Oracle Fusion Field Service
  2. Configure Oracle Fusion Field Service for Using Multiple Attachment Properties with OCI

Configure Oracle Fusion Field Service for Using Multiple Attachment Properties with OCI

Oracle Cloud Infrastructure (OCI) Object Storage is available on the application configuration page in Oracle Fusion Field Service to store the necessary parameters to connect to OCI object storage from Oracle Fusion Field Service. OCI Object Storage can be used for storing attachments, such as images, uploaded from Oracle Fusion Field Service.

Prerequisites to enable attachment creation between OCI and Oracle Fusion Field Service

  • OCI (Oracle Cloud Infrastructure): Application to gather authentication and storage details.
  • Oracle Fusion Field Service: Application where the integration settings are applied.

Generate the required API keys and identity information from OCI

  1. Open OCI and use the search bar to locate My Profile.
  2. Under your profile, navigate to API Keys > Add API Key.
  3. Click Download Private Key, then click Add.
  4. After key creation, note down the following:
    • Fingerprint
    • Tenancy OCID
    • Region
    • User OCID

Access storage information needed for configuration

  1. In OCI, search for Buckets.
  2. Open an existing bucket or create a new one.
  3. Capture the following information:
    • Bucket Name
    • Namespace

Configure the Oracle Fusion Field Service application with information from OCI

  1. Navigate to Oracle Fusion Field Service > Configuration > Applications > Add Application.
  2. Select the appropriate application type.
  3. On the configuration page:
    • Fill in fields using the data collected from OCI
    • Upload the private key
    • Click Test Connection, then click Add.
Note: When enabled, Oracle Fusion Field Service adds a visible, non-removable watermark to each captured image. The watermark can include geolocation and timestamp information for every photo captured through the Attachments element. Each image is processed independently. Oracle Fusion Field Service captures and evaluates location information separately for each image and assigns an appropriate location status before applying the watermark.

Set up required properties in Oracle Fusion Field Service

  1. Navigate to Oracle Fusion Field Service > Configuration > Properties > Add New.
  2. Enter all required fields. For more information, see the Create an Attachment Property to use with Oracle Cloud Object Storage in Administering Oracle Fusion Field Service Guide.
  3. Add the attachment property to the relevant page (for example: Activity Details).

Currently, attachments are accessible through the Oracle Fusion Field Service mobile app for iOS and Android platforms.

Consideratios for security practices

  • Create a dedicated user with restricted permissions.
  • Generate API keys under this user via: OCI > Identity > Domains > [Your Domain] > Users > [Your User].
  • The process for integrating with Oracle Fusion Field Service remains the same; only user credentials change.

Inventory Photo Attachments with OCI Object Storage

You can use OCI Object Storage to store photos captured for inventory items. When inventory photo attachments are configured, mobile workers can take multiple photos while adding or editing inventory and upload those photos to OCI Object Storage.

Inventory photo attachments support asset-management and serialized-inventory scenarios where visual documentation is required, such as:
  • Utility equipment inspections.
  • Construction asset verification.
  • Parts installation confirmation.
  • Damage documentation.
  • Inventory audits.
  • Migration scenarios from Oracle Field Service to Oracle Fusion Field Service.

To configure inventory photo attachments, create an Attachment property for the Inventory entity, associate the property with the OCI Object Storage application, add the property to an inventory form, and add a button to the Add/Edit Inventory screen to open the inventory form.

Photos captured for inventory use a structured object name and folder structure so that integrators can locate and process them in OCI Object Storage.

File Naming Convention for Inventory Photos

Photos captured for inventory are automatically named using this pattern:
{Timestamp}_{Work_Order}_2_{Inventory_Id}_{Property_Label}
Where:
Value Description
Timestamp Date and time when the photo was captured.
Work_Order Work order number associated with the inventory item.
2 Inventory entity identifier in Oracle Fusion Field Service.
Inventory_Id Identifier of the inventory item associated with the photo.
Property_Label Label of the attachment property used to capture the photo.

Object Storage Folder Structure

Inventory photo objects are organized in OCI Object Storage using this folder naming pattern:
 2_{Inventory_Id}_{Work_Order}_{Property_Label}
Where:
Value Description
2 Inventory entity identifier in Oracle Fusion Field Service.
Inventory_Id Identifier of the inventory item.
Work_Order Work order number associated with the inventory item.
Property_Label Label of the attachment property used to capture the photo.

This structure helps integrators locate photos for a specific inventory item, work order, or attachment property.

Integration flow for inventory photos

OCI Object Storage acts as an intermediate repository for inventory photos. A typical integration flow consists of:
  • Identifying the required photos in OCI Object Storage.
  • Downloading or transferring the photos to the customer system of record.
  • Associating the photos with the corresponding asset, inventory item, or business object.

Integrators can use Object Storage search functionality to locate files and Object Storage APIs to download images for downstream processing.