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 or files for an activity and associate those attachments with the related Fusion Service or Maintenance work order. Mobile workers can attach files from the device file system or device gallery in addition to taking photos. Supported file types include PNG, JPG, JPEG, PDF, CSV, TXT, MP4, HEIC, MOV, and XML files.

You can enable Add Watermark to Photos when Take Photos is enabled. Watermarks can be applied to photos captured through the Attachment property. 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 property configuration controls the maximum number of files that can be attached. When users select more files than the configured maximum value, Oracle Fusion Field Service rejects the attachment action and displays a message indicating how many additional files can be attached.

  • Unsupported file type: Oracle Fusion Field Service rejects files with unsupported file types and displays a corresponding message. When users select valid and unsupported files together, the application adds the valid files and rejects the unsupported files.
  • File is too large: Oracle Fusion Field Service rejects files larger than 20 MB and displays a corresponding message. When users select valid and oversized files together, the application adds the valid files and rejects the files larger than 20 MB.

  • 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 file size: Files attached through the Oracle Fusion Field Service application can be up to 20 MB. Files larger than 20 MB are rejected.

  • 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.

  • File and gallery access: The Attachment property can be configured to allow users to attach files from the device file system or images from the device gallery.

  • 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.

  • Files uploaded from Oracle Fusion Field Service: When Attach Files is enabled, users can upload supported files from the device file system or device gallery through the Attachment property.

  • 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. Configure the attachment options as required:
    • Take Photos: Allows users to take photos using the camera in the installed iOS or Android app. This setting is enabled by default for new properties.
    • Attach Files: Allows users to attach files from the device file system or images from the device gallery.
    • Add Watermark to Photos: Allows watermarks to be added to photos when Take Photos is enabled.

    If both Take Photos and Attach Files are disabled, the Attachment property switches to ReadOnly mode. Users can view files attached to the related Service or Maintenance work order, but can't add new attachments through the property.
    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:
    • When Attach Files is enabled, mobile workers can use the Attach option to select files from the device file system or images from the device gallery. When Take Photos is enabled, mobile workers can continue to take multiple photos using the embedded camera.
    • Before submitting the form, mobile workers can identify and remove newly attached files. Newly added files appear at the top of the file list and include the file name, file size, and the "Just added by me" text. Users can select the x icon to remove an incorrect file. Newly attached files can also be previewed.
    • 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. Users can upload supported image and non-image files through the Oracle Fusion Field Service UI when Attach Files is enabled for the Attachment property. Supported files uploaded through Fusion Service UI or APIs can also be visible in Oracle Fusion Field Service.
    • 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