FX Timecards Module Setup

Prerequisites

To set up and use FX Timecards, you need to:

Have these user licenses Have these permissions Complete these tasks
and review these topics
before continuing

Install the FieldFX Timecards Package

  1. Contact FieldFX Support to get an installation link and password for the FieldFX Timecards Package.

  2. Open your email app.

  3. Look for an email from FieldFX support.

    The email contains a customized link to install the Timecards package.

  4. Click the installation link from the email you received.

  5. Enter the password you from the email you received.

  6. Select Install for Admins Only.

  7. Click Install.

    A notification displays once the installation finishes.

  8. Click Done.

Configure FieldFX Back Office

When configuring FX Timecards in FieldFX Back Office, you can:

Create Page Layouts

Add Timecard Page Layouts

  1. From Setup, enter object in the Quick Find box, then select Objects.

  2. Click Timecard.

  3. Add an Admin layout:

    1. Under Fields & Relationships, click New.

    2. Select Formula, then click Next.

    3. In Field Label, enter Timecard Type.

    4. Under Formula Return Type, select Text, then click Next.

    5. In Timecard Type (Text), enter the following formula:

      IF (FXT2__Input_Hours__c > 0, "Daily", "Hourly")
    6. Click Next.

    7. Make the field visible to system administrators only, then click Next.

    8. Deselect Add Field, then click Save.

    9. Under Page Layouts, click New.

    10. In Existing Page Layout, select "HourlyLabor".

    11. In Page Layout Name, enter Admin, then click Save.

    12. Add the Timecard Type, Status, User, and Input Hours fields to the layout.

    13. Remove the Required property for the Start Time and End Time fields.

    14. Click Save

Configure Custom Settings

  1. From Setup, enter object in the Quick Find box, then select Objects.

  2. Click Catalog Item.

  3. Under Fields & Relationships, click Ticket Item Record Type.

  4. Under Picklist Options in Values, note the record types for which to add timecards.

    For example, Labor

  5. From Setup, enter custom settings in the Quick Find box, then select Custom Settings.

  6. Click Manage next to FX Timecard Settings.

  7. Click the New button highlighted below.

    FX Timecard Settings screen with the first *New* button highlighted
  8. In Ticket Item Record Types for Timecard, enter the record type(s) you noted in step 4 that should generate timecard records automatically.

    Enter each record type separated with a comma and space.

    For Example: Daily Labor, Hourly Labor

  9. Select Create Timecard for Ticket Item to add timecards automatically for the record types listed in Ticket Item Record Types for Timecard.

  10. (Optional) Complete the following if the org is going to use custom Apex triggers that conflict with the default Apex triggers in the Timecards package:

    • Select TicketItemTriggerOverridden to disable the Apex trigger that runs when users add and update labor ticket items.

    • Select TimecardTriggerOverridden to disable the Apex trigger that runs when users add and update timecards.

      If you don’t want to create Timecard entries from Ticket items, you need to disable these triggers.

      Not Disabling "Create Timecard for Ticket Item"

      In the FX Timecard Settings Edit screen, unselect the Create Timecard for Ticket Item checkbox.

      If not, when the user goes to create a adds or updates a timesheet or timecard, they still get this error:

      Second error in not Disabling "Create Timecard for Ticket Item"
  11. Click Save.

Configure Pay Periods

  1. From Setup, enter custom metadata in the Quick Find box, then select Custom Metadata Types.

  2. Select Manage Records next to Pay Period.

  3. Click Edit next to an existing Label to modify it.

    or

    Click New to add a Pay Period frequency.

  4. Make the following entries:

    Label:

    A name for the Pay Period.

    For example: Weekly, CycleA, BiWeekly

    Pay Period Name:

    The API name, which automatically populates based on the Label, but can be changed.

    Pay Period Type:

    Select the pay frequency, either Weekly or Bi-Weekly.

    Week Start Day:

    Select the day of the week each pay period begins.

    Effective Date:

    Enter a calendar date that is the first date of a pay period for this frequency.

    Expiration Date:

    (Optional) Enter a calendar date after which the pay period is no longer valid.

  5. Click Save.

    or

    Click Save and New to save the Metadata type and add another.

    Screenshot of the Custom Metadata Types screen for Pay Period with a example using *Weekly*

Set Up Tabs

Getting There

  1. From Setup, enter tabs in the Quick Find box, then select Tabs.

  2. Under Custom Object Tabs, click New.

  1. To add the timecard, timesheet, and time off tabs, continue with the steps below.

Timecard tab

To add the Timecard tab:

  1. In Object, select "Timecard".

  2. In Tab Style, select a tab style.

  3. Click Next.

  4. Click Next.

  5. Click Save.

Timesheet tab

To add the Timesheet tab:

  1. In Object, select "Timesheet".

  2. In Tab Style, select a tab style.

  3. Click Next.

  4. Click Next.

  5. Click Save.

Time Off tab

To add the Time Off tab:

  1. Under Custom Object Tabs, click New.

  2. In Object, select "Time Off".

  3. In Tab Style, select a tab style.

  4. Click Next.

  5. Click Next.

  6. Click Save.

Add Charge Codes

Charge Codes are the cost categories used to assign time costs for accounting purposes.

Common examples include Training, Sick, Bereavement, or Jury Duty.

  1. From Setup, select Object Manager.

  2. Click Timecard.

    You can search for the object using the Quick Find box in the top right

  3. Complete the following:

    1. Click Fields & Relationships, then click Charge Code.

    2. Scroll down to the Values section, then click New in that section.

    3. Enter the charge codes for labor, with each value on its own line.

    4. Click Save.

    5. Complete the following for every unused charge code:

      1. In the Values, click Del next to each unused item.

      2. Click OK.

        Do not define a default picklist value. If you do, you could get a validation error whenever a Charge Code and a Job code is defined for the Timecard.

        This causes the timecard to not be created.

        If you select a default picklist value, you must also disable the TimecardSubjectRequired validation rule on the Timecard object.

Set Up Users

Add Permission Set

Use Permission Set Groups to more easily manage permissions for groups of users. Lean more about Permission Set Groups at help.salesforce.com.

  1. From Setup, enter Users in the Quick Find box, then select Users.

  2. Select the Full Name of a Timecard User.

  3. From Permission Set Assignments, select Edit Assignments.

  4. Add FX Timecards from the Available Permission Sets to the Enabled Permission Sets, then click Save.

  5. Add the following additional permissions to either the user’s assigned user profile or an assigned permission set:

    Object Name Field and Permission Type

    Timecard Object

    • Read permission to Timecard Type field

    • Read permission to UID field

    Timesheets Object

    • Read permission to UID field

    • Read permission to UniqueKey field

    Custom Metadata Types

    • Read permission to FXT2.Pay Period

    These permissions will be added to the FX Timecards managed permission set in a future update.
  6. Repeat for other Users.

  7. Have users download and install the FX Timecards app from their device’s app store.

    The app is available for iOS and Android devices.

Assign FieldFX Timecards Licenses

  1. From Setup, enter Packages in the Quick Find box, then select Installed Packages.

  2. Select the Manage Licenses link for FieldFX Timecards.

  3. Click Add Users.

  4. Mark the Action checkbox for Timecards users.

    The checked users display in the Selected Users section. Users selected by mistake can be removed from the list if needed.

  5. Click Add.

Troubleshooting

Timecard not generating

  • The following fields on the Ticket Item record must be populated for a timecard to generate:

    • Ticket Item must have a Record Type valid for Timecards as defined in the custom setting setup described above

    • The Ticket Item must have a Contact selected

    • The Contact selected for the Ticket Item must have a User defined

      If any of the above are not selected or defined, a Timecard does not generate.

  • A timecard cannot have both a Charge Code and a Job code assigned. Do not assign a default picklist value for the Charge Code field. If a default is desired, disable the TicketSubjectRequired validation rule for the Timecard object.