Fieldcode Manual

Tip: You can use filters for better results

Users are persons with permission to use Work Place or Admin Panel suited to a particular job role (eg. dispatcher, engineer, admin).
Users have to be configured inside the system (usually done by an admin), so they get access to different parts of the system.
Typical user roles are: Engineers, dispatchers, admins, external partners (always part of a partner company), and custom user roles.

  1. Inside the Admin panel go to Access -> Users
  2. Click on the plus button to open the New User form.
  3. Fill in or edit the following tabs: Contact, Location, Working Hours & Availability, Roles, and Skills.
Adding new users is achieved via the plus button inside the Users page
  1. (Optional) – Click on the pencil button to upload a picture of your new or existing user.
  2. (Optional) – Decide if your new or existing user should be set to active in the system.
  3. Insert the business email address or Login name for your new or existing user.
  4. (Optional) – Insert the company name of your new or existing user.
  5. (Optional) – Select the salutation of your new or existing user.
  6. (Optional) –  Insert the business phone number of your new or existing user.
  7. Insert the first name of your new or existing user.
  8. (Optional) – Insert the business mobile number of your new or existing user.
  9. Insert the last name of your new or existing user.
  10. (Optional) –  Insert an alternative email address of your new or existing user.
  11. (Optional) – Check the “Is the user an engineer?” box if your new or existing user has the job role engineer/technician in your company.
    You now also have the option to set an efficiency factor for the engineer. The default efficiency factor is 1.
  12. (Optional) – The Reset FMA button allows you to reset the Fieldcode FMA app database, which may resolve workflow issues.
    Important: Please use this button only if the selected engineer is experiencing problems with the FMA application that are not easily resolved.
  13. (Optional) – Check the “Is the user an External Partner?” box if your new or existing user is under a subcontract.
  14. (Optional) – Insert an alternative phone number of your new or existing user.
  15. (Optional) – Insert a fax number of your new or existing user.
  16. (Optional) – Insert a note about your new or existing user which will be visible to other users of the system.
Filling out the basic details for a user

If engineer A has an efficiency factor of 1.2 assigned, it means this engineer needs 20% longer to perform a task. If engineer B has an efficiency factor of 0.8 assigned, it means this engineer is 20% faster than normal/default. Therefore you could say, the lower the factor, the more efficient the engineer is.

Ticket duration * Engineer efficiency factor = Updated Appointment time
The ticket duration meanwhile doesn’t update because of the factor, this is expected behavior.

  • If you drag & drop a ticket from the Ticket Pool to the Timeline. 
    You will see that the ticket length will change according to the engineer efficiency factor. The ticket duration remains the same. This is expected behavior.
  • If you schedule a ticket via the Scheduling Assistant.
    You will see that the ticket length will change according to the engineer efficiency factor. The ticket duration remains the same. This is expected behavior.
  • The Customer Portal will also take the Engineer efficiency factor into account for arranging appointments.

Yes, you do not lose control for manual re-adjustments, just because the Engineer efficiency applies before.

Yes, it is.
You can check the Engineer Efficiency tab inside the Analytics to understand more about engineer performance.

You have two types of engineers in your company. Younger engineers who are still learning and adapting fast, and older engineers who work slower, but steadily.
You want to enter this knowledge about your technicians into the system so that more or fewer tickets are distributed accordingly.
This allows the system to distribute the same number of tickets more efficiently on the Timeline without losing unnecessary time.

Partner accounts typically assist the regular account with ticket services on the field (usually under a subcontract agreement).
They can be either Fieldcode users themselves or can be account partners that use a different interface to receive tickets (Email) and provide reports (Partner Portal). They both count as Partner Accounts, they just use different interfaces.
To learn more about how partners are utilized inside the Work Place check out the Big Picture: Partners topic.

Account Partner: Connection inside the same account!
-> Account Partners can either rely on the Fieldcode system OR
-> Account Partners can alternatively rely on receiving tickets via email and doing the reporting via the Partner Portal
Cooperation Partner: Connection between different Fieldcode Accounts!
System Connection: Connection between Fieldcode system and third-party system!

Account Partners have the following characteristics:

  • They login into the same Fieldcode Account as the contractor company
  • The tickets are the same tickets as for the contractor company, the main difference is that partners have only view rights for assigned partner tickets
  • They can work on tickets in the same way a contractor company would work on the ticket

Cooperation Partners have the following characteristics:

  • They login into a different Fieldcode Account as the contractor company
  • The tickets are the same tickets as for the contractor company, the rights are self-determined, tickets get synchronized, when work on the ticket starts
  • The cooperation requestor sends a cooperation request to the potential partner via the Partner configuration menu inside Fieldcode Admin Panel
  • The cooperation partner provides the partner business key to the requestor, which can be found below the header inside the Partner configuration menu
  • The cooperation requestor receives an email with a 7-digit PIN code, that code must be entered inside the corresponding Partner configuration menu item
  • They can work on tickets in the same way a contractor company would work on the ticket
System connections have the following characteristics:
  • The system connection requestor uses a third-party accounting system
  • The Fieldcode system and Account is the contractor system
  • The third-party account system is the subcontractor system
  • The purpose of a system connection is to establish a connection from an external system and your Fieldcode Account to pass data between the two systems
  • After a system connection is created it needs to be mapped out so that data gets sent to the correct endpoint.
  • Solution engineers can easily help you with arranging the system connection, NO CODING IS REQUIRED.

Partner Account users are created in the same way as regular users. You have to go to the Fieldcode Admin Panel -> Access -> Users and create the user as usual.
While creating the partner user you just check the checkbox “Is the user an External Partner?” in addition. Select the partner company afterwards.
The Partner company has to be created first inside Fieldcode Admin Panel -> Access -> Partners

Yes, that’s possible.
Select the user you want to convert inside Fieldcode Admin Panel -> Users and check the checkbox “Is the user an external partner?”.
Select the partner company afterwards.

Inside the Fieldcode Admin Panel go to Interfaces -> Cooperations.
You can view your own business key there and share it with potential cooperation partners. The business key is located under the heading in the list view.
From there you can also request a cooperation with another partner.
You can also confirm cooperations by entering a special partner PIN, which you would receive by email.

 

Partners are a group of partner engineers or partner dispatchers that assist regular dispatch groups or engineers
in fulfilling their service (eg. sub-contractors).

  • Partners are able to use and utilize the Fieldcode software.
  • Partners have specific view rights inside Fieldcode that ensure privacy
    A partner can be part of a dispatch group, but a partner itself will only see his tickets (not the tickets of the whole group!).
  • Partners are always a part of a customer account (roof company).
  • Partners can be assigned from the Ticket Pool and Ticket Details.
  • Partner engineers can be identified in the Timeline by their names written in: italic typography.
  • A partner has to belong to a specific partner company that needs to be configured inside the Fieldcode Admin Panel
  • Partners are not able to use the Optimizer.
  • Partner users can only view partner engineers of a Dispatch group in the Timeline.
  • Unassigning a partner results in tickets being moved back to the Ticket Pool.

The partner selection is limited to matching partners who are actually inside the area of the dispatch group. 
Partner areas are configured inside the Partner configuration menu inside Fieldcode Admin Panel to make the partner selection for the dispatcher easier.
If you do not define a partner area for the partner it will remain selectable for every dispatch group.
Another reason why groups do not show up could also be related due to wrong configured filters.

Partner areas can be defined inside the Partner configuration menu when you select the Account Partner item and assign an area from there.
It is not done inside the Partners menu. The partner menu only lets you configure the general location of the partner company.

If you define partner areas inside the Partner configuration menu, only location-relevant partners will be displayed to dispatchers.
This will make the partner selection easier for dispatchers.

Partner company location = General definition of partner company, can be assigned to every engineer in the dispatch group
Partner company area (or other filters, eg. project) = Precise definition or partner operation circumstances, can be eg. assigned to overlapping dispatch group areas.

Let’s assume you have Account Partners, Account Partners without Fieldcode system, Cooperation Partners and system connections. Not only is your service network absolutely incredible in this case, but with all those types of “partners” it can be confusing to know what to configure where and how what affects what.
Therefore we would like to give you a brief summary over here:

  1. A user can be converted to a account partner user inside Access -> Users -> by switching the “External Partner” toggle to the right.
  2. Account Partners are configured under Access -> Account Partners.
  3. Account Partners that do not use the Fieldcode system are configured under Access -> Account Partners -> by switching the “Partner Portal” toggle to the right.
  4. Cooperation Partners are configured under Access -> Cooperation Partners.  
  5. Direct connections (=System connections) are configured under Interfaces -> System Connection.
  6. Partner areas are configured inside Partners -> Partners configuration.
    Important: Partner locations are not the same as Partner areas.
  7. The Partner configuration menu also has the purpose to list and edit all your different partners (which can differ by partner type) one-by-one.
Change of location for existing users

If the user's location is changed, it will take until the next day for the updated location to be visible on the map.

  1. Insert the address of your new or existing user.
  2. (Optional) – Insert the ZIP of your new or existing user.
  3. Insert the city of your new or existing user.
  4. Select a country from the drop-down for your new or existing user.
  5. (Optional) – Insert a room for your new or existing user.
  6. (Optional) – Insert a floor for your new or existing user.
  7. (Optional) – Insert a building for your new or existing user.
Filling out the location details for a user

Temporary locations are useful if your engineer works from another location than his usual location. You can temporarily configure a start and end location so the system assigns tickets for this temporary location. After the period has passed the default location will be taken into account by the system again.

Temporary locations temporary override the normal location for a selected period of time for a particular user!

If you create a temporary location inside a different time zone, you will also need to manually adjust the user's work hours to align with the new time zone!

  1. Click the plus button in the Temporary locations tab.
  2. Insert the address of the temporary location.
  3. (Optional) – Insert the ZIP of the temporary location.
  4. Insert the city name of the temporary location.
  5. (Optional) – Insert the state name of the temporary location.
  6. Select the country of the temporary location.
  7. Select the location type. You can choose between the start location, the end location, and the start and end location.
  8. Insert the start date for the time period.
  9. Insert the end date for the time period.
Use case for different start and end location

For example, the temporary start location could be different from your temporary end location because the engineer utilizes two locations.
This could be because, for example, the technician doesn't want to drive back after a long day of work because he has a place to stay at a second point.
In this case, you configure the start location and end location individually.
If both locations are the same you will select Start and end location.

Filling out a temporary location for a user. Please also ensure to set the working hours accordingly to the user's timezone.

By default, there will be working hours set from 08:00 AM to 16:00 PM from Monday to Friday. However, you are free to change the working hours for your existing or new users. On the right side, you will find a preview of the working hours you configured.

Temporary locations temporary override the normal location for a selected period of time for a particular user!

If you create a temporary location inside a different time zone, you will also need to manually adjust the user's work hours to align with the new time zone!

Adjusting engineer working hours

Your goal when defining working hours for your user is to cover all your working hours that the user needs to fulfill:

Let's assume your user works from Monday to Friday from 08:00 to 17:00 and has free on the weekends.
  1. Set the time in the from field to 08:00 and in the to field to 17:00.
  2. Click on Save.
Let's assume your user works Monday to Wednesday from 8:00 AM to 12:00 AM and from Thursday to Friday from 08:00 AM to 17:00 PM.
  1. Set the time from 08:00 to 12:00 for Monday to Friday.
  2. Remove the checkbox Thursday and Friday.
  3. Click on Add working hours.
  4. Set the time from 08:00 to 17:00.
  5. Turn on checkboxes for Thursday and Friday.
  6. Click on Save.

If your user has different working hours for different days, the way above is the proper way to configure this, so all eventualities are covered.

Let's assume your user works from Monday to Friday from 06:00 AM to 15:00 PM and on Saturday from 18:00 PM to 19:00 PM.
  1. Set the time from 06:00 to 15:00 for Monday to Friday.
  2. Click on Add working hours.
  3. Set the time from 18:00 to 19:00.
  4. Turn on the checkbox for Saturday.
  5. Click on Save.
Let's assume your user works 24 hours starting from Monday morning. He starts at 08:00 AM on Monday and ends his work at 08:00 AM on Tuesday.
  1. Click on Add working hours.
  2. Set the time from 08:00 to 08:00 on Monday.
  3. Click on Save.

This way you wouldn't have to select two checkboxes (which you could still do, though).

Let's assume your user works from Monday to Friday in night shifts from 23:00 PM to 05:00 AM.
  1. Set the time from 23:00 to 05:00 for Monday to Friday.
  2. You will get an information prompt that selected time periods to affect two working days, but that is fine, as we want it that way in our case.
  3. Click on Save.

In the absences and availability tab, you can configure planned and unplanned absences and configure on-call duty for your new or existing user. You can also import public holidays into the system (currently USA only!).

Managing availabilities is possible inside Work Place and inside the Admin Panel

You can either manage availabilities for your users from Admin Panel -> Users -> Absences & Availability tab or inside Work Place inside the Timeline.

Learn more about how to manage availabilities inside Work Place
Absences can only be configured after the user is saved in the system

The absence buttons will therefore be grayed out when creating a new user.​

  1. Click on the plus button in the Absence tab.
  2. Insert a date from where the Absence starts and insert it in the From field.
  3. Insert a time from where the Absence starts and insert it in the time field.
  4. Select a substitute who should be in charge of the work instead from the drop-down.
  5. Select a reason for the absence from the drop-down.
  6. Insert a description for the absence, where the reason you selected is described.
  7. Click Save.
  8. The absence will be displayed inside the Work place in the Timeline.
Configuring a user absence

(Optional) - How to delete absences

  1. Search for an item in the list that you want to delete.
  2. Scroll to the right to find the trash button.
  3. Click on the cancel absence (crossed calendar).
  4. Confirm the upcoming prompt with Yes, Cancel.
  5. The absence should now be removed from the list.
Deleting the absence

(Optional) - How to import public holidays

You can import local bank holidays for a user which saves you the hassle of entering those days manually. Importing bank holidays for a user is beneficial for the smartness of the system (eg. the Optimizer will not plan on bank holidays for this user if the bank holidays are imported for this user).

The "Import bank holidays" button inside the Absences & Availability tab
  1. Click on the Import public holiday button.
  2. You will be asked if you want to import the public holidays for your location for the next 12 months.
  3. Confirm the prompt.
  4. The bank holidays should now appear in the absence list.
Importing bank holidays

(Optional) - How to configure on-call duties

You can configure on-call duties for your engineers by clicking on the On-Call duty tab inside Absence & Availabilities tab.
On-call duties for your engineers will be visible inside the Timeline inside Work Place.

  1. In the On-call-duty tab click on the plus button.
  2. Insert a date in the From field from where the on-call-duty starts.
  3. Insert a time in the From field from where the on-call duty starts.
  4. Insert a date in the To field from where the on-call duty ends.
  5. Insert a time in the To field from where the on-call duty ends.
  6. (Optional) – Select a day on-call duty for a certain time span. The engineer in question will be available for on-call duty on all the selected days all-day.
  7. Important: Click Save in the bottom-left of the menu.
  8. Reload the Work place by pushing the Reload button inside the Work place header or hitting CRTL + F5 inside Work place.

In the roles tab, you can decide what users are allowed to do inside the applications. Currently, by default, we have three roles available for you. Just toggle the role you want to apply for your user to the right in order to decide, what the user can do.

Users with this role can view and edit all available data of the account and additionally can configure all system settings.

Users with this role can view tickets, and dispatch, and report them for all dispatch groups.

Users with this role can view tickets and report them.

Assigning a user role

If you have Skills enabled, you can assign them to your engineer under Users. Skills ensure tickets are solved with the best suitable engineer in mind to delight the customer. You are also flexible to decide if skills should be able to expire after a particular date has passed.
Expiration date configuration is done on a user level and not globally configured inside the Skills menu.

  1. Set the skills you want to assign to your engineer to active.
  2. Select a level of importance from the drop-down of a skill. Level 1 is the lowest, while Level 3 is the highest skill level.
  3. Click on Save.

If you cannot find the skill, feel free to use the keyword search at the top of the list to find the matching skill in the list.
If you cannot find the skill, because it wasn’t created yet, feel free to create it under Dispatch -> Skills.

You can add expiration dates to certain skills if you want specific skills to turn inactive after a certain amount of time.

  1. Make sure the skill is active as it otherwise cannot have an expiration date.
    If you do not add any expiration date, the selected skill will not expire and will remain active indefinitely.
  2. Click on the calendar inside the expiration date column of the skill item.
  3. Add the expiration date.
  4. Click Save.
Inactive skills are not considered anymore as soon as the expiration date is due

Inactive skills will not be considered for smart calculations anymore and will not be displayed as an existing skill for an engineer anymore as soon as the set expiration date is due.

Delivery tab visibility

The delivery tab is only visible when editing users, not when creating new users.

The delivery tab gives you an easy option to quickly assign users as dispatchers or engineers.
Be advised that engineer assignment only works if the toggle “Is the user an engineer?” is enabled in the Contact tab.

  1. Change the toggles according to your requirements.
Quick assign option

You are able to deactivate users by toggling the Active toggle of a user to the Off state.

  1. Inside the Admin panel go to Access -> Users.
  2. Select the user you want to deactivate from the list.
  3. In the Contact tab toggle the Active toggle to Off state.
Deactivating a user
What are the consequences of deactivating a user?
  • The user will not be able to log in anymore
  • Users will not be able to access the applications anymore
  • The user will be displayed in the user's list as inactive
  • User history input will still be available
  • The user can be reactivated in the future
Additional information regarding user deactivation
  • The deactivated user shouldn't have tickets assigned, if the user has tickets assigned you will be prompted to reschedule tickets to other engineers
  • The deactivated user will not be able to access the applications anymore (neither web and mobile)
  • Any history content/notes/comments of the deactivated user will remain accessible
  • Inactive users are still considered license holders
  • Inactive users are not displayed on the map anymore beginning from the day of activation
  • Once a deactivated user gets permitted to log back into the applications, then the account remains valid to be reset to an active state
Was this topic helpful?
0 out of 5 stars
5 Stars 0%
4 Stars 0%
3 Stars 0%
2 Stars 0%
1 Stars 0%
5
How can we further improve this topic?
Please provide the reason for your vote. This will help us improve this topic.
Navigation