1. Administering Oracle Fusion Field Service
  2. Create an Attachment Property to use with Fusion Attachments

Create an Attachment Property to use with Fusion Attachments

You can create an Attachment property to use with Fusion Attachments when you want mobile workers to upload multiple photos for an activity and associate those photos with the related Fusion Service or Maintenance work order. You can also use the Attachment property to let users view and download attachments that were added to the related work order in Fusion Service or Maintenance Cloud. Fusion attachments support documents and images. In Oracle Fusion Field Service, users can take photos and upload them to Fusion Attachments. Files that originate in Fusion Service or Maintenance Cloud, including non-image files, can be viewed and downloaded in Oracle Fusion Field Service when they’re associated with the related work order. Oracle Fusion Field Service supports preview for photos and PDF files; other file types are displayed with a file icon and can be downloaded.

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

  1. The integration between Fusion Service and Service Logistics in Oracle Fusion Field Service must be configured.
  2. If work orders are not synced between Fusion and Oracle Fusion Field Service, attachments will not be created on the Fusion side.
    Note: You still need an Application when working in Oracle Field Service environments or with OCI Object Storage.

Limitations

Review these limits and considerations before configuring an Attachment property for Fusion Attachments:

  • Number of attachments: Fusion Service doesn’t impose a hard limit on the number of files that can be attached to an object. The practical limit is generally governed by the purchased Content Server storage. In Oracle Fusion Field Service, there isn’t a strict count limit for attachments, but uploading many high-resolution images can affect activity performance. The Attachment form element validation range supports a maximum of 20 images for an upload requirement.

  • Fusion Service file size: The maximum attachment size for Fusion Service is controlled by the FND_FILE_UPLOAD_MAX_SIZE profile option. The default value is 2 GB at the site level. The limit can be decreased but not increased. Oracle recommends uploading smaller attachments for better performance.

  • Oracle Fusion Field Service photo resolution: Oracle Fusion Field Service controls photos by resolution rather than by an individual file-size setting. Configure the minimum and maximum photo resolution in the Attachment property. These settings help control traffic volume and upload time. If a mobile device captures a higher-resolution photo, the application compresses or downscales the image according to the configured parameters.

  • Mobile device gallery access: The out-of-the-box Attachment property supports taking photos from Oracle Fusion Field Service. Uploading images directly from the mobile device gallery isn’t currently supported.

  • Non-image attachments from Fusion: Non-image attachments that originate in Fusion Service or Maintenance Cloud can be visible in Oracle Fusion Field Service, associated with the related work order, and downloaded for use. Photos and PDF files can be previewed; other file types are displayed as files and can be downloaded.

  • Non-image attachments in Object Storage: Non-image attachments stored through Oracle Cloud Infrastructure Object Storage aren’t expected to be visible in Oracle Fusion Field Service unless they were attached from Oracle Fusion Field Service.

To perform the required configuration, you’ll need access to:

  1. Oracle Fusion Field Service
  2. Oracle Cloud Infrastructure (OCI) Identity/IDCS for the tenancy associated with your Fusion Applications

To configure the application in OCI Identity domain

  1. Go to OCI Identity > Domains > [your domain].
  2. Copy the domain URL. You'll need it when configuring Field Service.
  3. From your domain, navigate to Integrated Applications.
  4. Click Add Application and fill in the required details.
  5. Add scope: Search for Oracle Applications Cloud (Fusion).

  6. If you can’t find it, verify that you're using the correct OCI tenancy.

  7. Copy the highlighted scope value for use in Oracle Fusion Field Service later.

  8. After creating the Confidential Application, activate it and copy the Client ID and Client Secret.

To create an attachment property

  1. Sign in as an administrator.
  2. Click Configuration > Properties.
  3. Click Add New.
  4. Complete these fields:
    Field Action
    Entity Select the entity for which you want to create the Attachment property. Select Activity. Currently you can create an Attachment property only for Activity type of entity.
    Property name Enter a name for the property that you want to display to the user. Enter in English and in all the languages that are active in the application.
    Property label Enter a unique database identifier for the Oracle Field Service API.
    Property hint Enter a hint that you want to display when a user hovers over the field name. For example, Enter comments if any. Enter the text in English and in all the languages that are active in the application.
    Property Type Select Attachment and then select Fusion attachments.
    Application Select the Oracle Fusion application that you've implemented.
    Fusion Business Object Select the Fusion business object to sync the attachments. Choose either Service Work Order or Maintenance Work Order.
    Attachment Category Select the category to classify and secure attachments. These categories are added when you created the business object in Fusion.
    Note: When multiple properties share the same attachment category, all attachments in that category are visible under each property. However, you can only manage attachments uploaded through the property you are currently viewing.
    Photo Resolution Select the minimum and maximum resolution for photos that users upload. Oracle Fusion Field Service uses resolution limits for photos instead of an individual picture file-size limit. The default resolution is 1000 x 1000 pixels, and the maximum configurable resolution is 5000 x 5000 pixels. If a device captures a higher-resolution photo, the application downscales the image proportionally to fit the configured limits. Use these settings to help control traffic volume and upload time.
  5. Click Add.
    The Attachment property is added to work with Fusion attachments.
    Note: The Attachment property lets Oracle Fusion Field Service users upload photos to Fusion Attachments. It also lets users view and download attachments that originated in Fusion Service or Maintenance Cloud and are associated with the related Service or Maintenance work order. Non-image files can’t be uploaded through the Oracle Fusion Field Service UI, but supported files uploaded through Fusion Service UI or APIs can be visible in Oracle Fusion Field Service.
    Note: 'Attachments' properties aren't supported in:
    • Plug-in API framework
    • Daily Extract
    • Inbound and outbound SOAP APIs
    • Filters, message scenarios, work skill conditions, and capacity categories