FieldFX eForm Setup
Introduction
In FieldFX, you can must setup a Parent eForm or a Child eForm, underneath the parent.
Complete these tasks in order. Before you begin, review the Guidelines.
Prerequisites
To setup and use FieldFX eForms, you need to:
Have these user licenses | Have these permissions | Complete these tasks and review these topics before continuing |
---|---|---|
|
Guidelines
When setting up FieldFX eForms, keep in mind these details about the Master-Detail, SyncID, and Job Share Trigger fields:
Master-Detail Field
-
The Master-Detail field controls the parent object for an FieldFX eForm. This field also determines the type of record for which you can add the FieldFX eForm.
If an FieldFX eForm has a master-detail relationship with the Ticket object, you can add the FieldFX eForm to tickets. -
Every FieldFX eForm requires a Master-Detail field.
SyncId Field
-
The SyncId field controls whether an FieldFX eForm syncs to FieldFX Mobile.
FieldFX eForms only sync if they have a unique value set in the SyncId field.
-
To prevent sync issues, you must:
-
Add a SyncId field to every FieldFX eForm.
-
Add a workflow rule to assign unique sync ids to FieldFX eForms automatically.
-
Job Share Trigger Field
Use the Job Share Trigger to download only the child records you want in FieldFX Mobile that are associated with a parent object.
If there are 5 JSA (Job Safety Analysis) records associated with one Job record in mobile, only the 5 JSA records that is associated with the Job will be downloaded to mobile, not all records in the JSA object.
You should have for the Job Share (Job_Share__c) field at least Read permission in the form object in a profile or in a permission set that is associated with a Fieldfx mobile user.
Enable Job Share Trigger Field
-
Ensure that you have the Job Share Trigger added to each of your eForm Config records.
-
Ensure that you have read permission and have the Doc Share field populated.
-
Under Setup > Object Manager > Form_Name > Field & Relationships, ensure there is a
Job_Share__c
field.Form_Name is the name of your form.
The
Job_Share__c
field must be a lookup data type field to the job. -
Under Setup > Object Manager > Form Name > Triggers, ensure there is a trigger called
<form name>Trigger_FX5Auto
.Form_Name and
<form name>
is the name of your form.If there is a
Job_Share__c
field, the trigger is automatically created.
Typical Fields in a Job Safety Analysis (JSA)
In the JSA form for the oil and gas industry, the form will typically include the following fields per the intended purpose:
All these fields aren’t necessarily needed for a JSA form. |
Category | Suggested Fields | |||
---|---|---|---|---|
General |
|
|||
Hazard |
|
|||
Control Measures |
|
|||
Equipment & Tools |
|
|||
Signatures |
|
FieldFX eForm Configurations
An FieldFX eForm configuration controls when an FieldFX eForm is available for use.
You must add an FieldFX eForm configuration for every basic FieldFX eForm.
Child RX Forms use the FieldFX eForm configuration for their parent FieldFX eForm. |
Add an FieldFX eForm Configuration
Click to expand
includes::base:eticketing:partial$BO_AddeFormConfig.adoc[]
Continue with Record Types.
Record Types
Set up record types if you need to complete FieldFX eForms differently based on a certain aspect of a job.
Add Downstream, Midstream, and Upstream record types for an FieldFX eForm you complete differently at downstream, midstream, and upstream work sites.
How Record Types Appear in FX Mobile | How Record Types Appear in the FieldFX Mobile App |
---|---|
When you add record types, add a page layout for each record type. This allows you to display different fields on each version of the FieldFX eForm.
Add Record Types for an FieldFX eForm
Click to expand
-
From Setup, enter
object
in the Quick Find box, then select Object Manager. -
Open the FX Form object.
-
Under Record Types, click New.
-
In Existing Record Type, select "--Master--".
-
In Record Type Label, enter the record type.
-
Select Active then click Next.
-
Click Save & New.
-
Repeat these steps for other record types as needed.
-
Click Save to finish and then click Back to Custom Object at the top of the page.
Continue with Add Page Layouts for Record Types.
Add Page Layouts for Record Types
Click to expand
-
From Setup, enter
object
in the Quick Find box, then select Object Manager. -
Open the FX Form object.
-
Under Record Types, click New.
-
In Existing Record Type, select "--Master--".
-
In Record Type Label, enter the record type.
-
Select Active then click Next.
-
Click Save & New.
-
Repeat these steps for other record types as needed.
-
Click Save to finish and then click Back to Custom Object at the top of the page.
Continue with Assign Page Layouts to Record Types.
Assign Page Layouts to Record Types
Click to expand
-
From Setup, enter
object
in the Quick Find box, then select Object Manager. -
Open the FX Form object.
-
Under Record Types, click New.
-
In Existing Record Type, select "--Master--".
-
In Record Type Label, enter the record type.
-
Select Active then click Next.
-
Click Save & New.
-
Repeat these steps for other record types as needed.
-
Click Save to finish and then click Back to Custom Object at the top of the page.
Continue with GrantPermsUseRecTypes[].
Recommended Reading
For more information, see:
FieldFX Documentation | Salesforce Documentation |
---|---|
|
|