1. Administering Oracle Field Service
  2. Can I open internal pages and plug-ins with direct URLs?

Can I open internal pages and plug-ins with direct URLs?

You can directly access internal pages such as Activity details, List view, or Inventory details within the Oracle Field Service Mobile for Android or iOS apps or Core Application, using specific direct URLs.

Note: Use this feature only to launch Oracle Field Service on the browser or the app using external sources such as sms, emails, or other apps. Don't use this feature to navigate between pages within Oracle Field Service.

Based on the page that is accessed and the user type accessing the page, you can send the following parameters with the URL:

Name Type Description Constraints

screen

String

Specifies the page that you want to access.
The following labels are supported:

  • activity_list

  • activity_by_id

  • start_activity

  • end_activity

  • cancel_activity

  • notdone_activity

  • suspend_activity

  • delay_activity

  • inventory_list

  • inventory_by_id

  • install_inventory

  • deinstall_inventory

date

Date

Specifies the date for the page that you want to access.

Date format is YYYY-MM-DD.

activityId

Number

Specifies the activity for the page that you want to access.

Valid activity ID is required.

resourceInternalId

Number

Specifies the resource for the page that you want to access.

A valid resourceInternalId is required.

Mandatory, if you are navigating from the Supervisor page.

inventoryId

Number

Specifies the inventory for the page that you want to access.

Valid Inventory ID is required.

The order of the parameters is not important. Also, any unsupported parameters are ignored. The supported parameters, URLs, and accessible pages might differ based on whether the logged-in user has access to other users (such as supervisor, mobile worker). In case, there are missing or invalid params or if the user doesn't have access to the page, then an error message is displayed.

<OFS_CORE_APP_URL> is the URL to access the following Core Application pages:

Activity List

The activity_list label lets you access the Activity List page.

Supported Parameters

Name Mandatory for Mobile Worker Mandatory for Supervisor

date

No

No

resourceInternalId

No

Yes

Possible URLs

URL Description Applicable for Mobile Worker Applicable for Supervisor

https://<OFS_CORE_APP_URL>/#screen=activity_list

Displays the Activity List page for today’s date.

Yes

No

https://<OFS_CORE_APP_URL>/#screen=activity_list&date=2020-02-19

Displays the Activity List page for the date, 2020-02-19.

Yes

No

https://<OFS_CORE_APP_URL>/#screen=activity_

list&resourceInternalId=3000001

Displays the Activity List page of the mobile worker with resourceInternalId 3000001 for today’s date.

Yes

Yes

https://<OFS_CORE_APP_URL>/#screen=activity_list&date=2020-02-19&resourceInternalId=3000001

Displays the Activity List page of the mobile worker with resourceInternalId 3000001 for the date, 2020-02-19.

Yes

Yes

Activity Details

The activity_by_id label allows you to access the Activity Details page.

Supported Parameters

Name Mandatory for Mobile Worker Mandatory for Supervisor

activityId

Yes

Yes

date

Yes

Yes

resourceInternalId

No

Yes

Possible URLs

URL Description Applicable for Mobile Worker Applicable for Supervisor

https://<OFS_CORE_APP_URL>/#screen=activity_by_id&activityId=4225435&date=2020-02-20

Displays the details for activity with id 4225435.

Yes

No

https://<OFS_CORE_APP_URL>/#screen=activity_by_id&activityId=4225435&date=2020-02-20&resourceInternalId=3000001

Displays the details for activity with id 4225435.

Yes

Yes

Constraints

  • The specified date must be the route date of the specified activity.

  • For mobile workers, the activity must be assigned to the mobile worker.

  • For supervisors, the specified resourceInternalId must be assigned to the activity and the supervisor must have access to the mobile worker.

Activity Actions

Page Label Description

start_activity

Access the Start Activity page.

end_activity

Access the End Activity page.

cancel_activity

Access the Cancel Activity page.

notdone_activity

Access the Not Done Activity page.

suspend_activity

Access the Suspend Activity page.

delay_activity

Access the Delay Activity page.

Supported Parameters

Name Mandatory for Mobile Worker Mandatory for Supervisor

activityId

yes

yes

date

yes

yes

resourceInternalId

No

yes

Possible URLs

URL Description Applicable for Mobile Worker Applicable for Supervisor

https://<OFS_CORE_APP_URL>/#screen=<SCREEN_LABEL>&activityId=4225435&date=2020-02-20

Displays the specified Activity Action page for the Activity ID, 4225435.

yes

 No

https://<OFS_CORE_APP_URL>/#screen= <SCREEN_LABEL>&activityId=4225435&date=2020-02-20&resourceInternalId=3000001

Displays the specified activity action page for activity with id 4225435.

yes

yes

Constraints

  • The specified Activity Action page must be visible for the specified activity.

  • The specified date must be the route date of the specified activity.

  • For mobile workers, the activity must be assigned to the mobile worker.

  • For supervisors, the specified resourceInternalId must be assigned to the activity and the supervisor must have access to the mobile worker.

Inventory List

The inventory_list page label allows you to access the Inventory List page.

Supported Parameters

Name Mandatory for Mobile Worker Mandatory for Supervisor

activityId

No

No

date

No

No

resourceInternalId

No

yes

Possible URLs

URL Description Applicable for Mobile Worker Applicable for Supervisor

https://<OFS_CORE_APP_URL>/#screen=inventory_list

Displays the Inventory List page.

yes

No

https://<OFS_CORE_APP_URL>/#screen=inventory_list&activityId=4225435&date=2020-02-19

Displays the Inventory List page for the Activity ID, 4225435.

yes

No

https://<OFS_CORE_APP_URL>/#screen=inventory_list&resourceInternalId=3000001

Displays the Inventory List page of the mobile worker with resourceInternalId, 3000001.

No

No

https://<OFS_CORE_APP_URL>/#screen=inventory_list&activityId=4225435&date=2020-02-19&resourceInternalId=3000001

Displays the Inventory List page for the Activity ID, 4225435. resourceInternalId is required for supervisors.

yes

No
Constraints

  • Inventory list action link should be visible from the activity.

  • The specified date must be the route date of the specified activity.

  • For mobile workers, the activity should be assigned to the mobile worker.

  • For supervisors, the specified resourceInternalId must be assigned to the activity and the supervisor must have access to the mobile worker.

Inventory Details

The inventory_by_id label allows you to access the Inventory Details page with the specified Inventory ID.

Supported Parameters

Name Mandatory for Mobile Worker Mandatory for Supervisor

inventoryId

yes

yes

activityId

No

No

date

No

No

resourceInternalId

No

yes

Possible URLs

URL Description Applicable for Mobile Worker Applicable for Supervisor

https://<OFS_CORE_APP_URL>/#screen=inventory_by_id&inventoryId=21229417

Displays the inventory details for the inventory ID, 21229417.

yes

No

https://<OFS_CORE_APP_URL>/#screen=inventory_by_id&inventoryId=21229417&activityId=4225435&date=2020-02-19

Displays the inventory details for the inventory ID, 21229417 and activity ID, 4225435.

No

No
https://<OFS_CORE_APP_URL>/#screen=inventory_by_id&inventoryId=21229417&resourceInternalId=3000001

Displays the inventory details for the inventory ID, 21229417 for the mobile worker with resourceInternalId 3000001.

yes

yes

https://<OFS_CORE_APP_URL>/#screen=inventory_by_id&inventoryId=21229417&activityId=4225435

&date=2020-02-19&resourceInternalId=3000001

Displays the inventory details for the inventory ID, 21229417 and the activity ID, 4225435 for the mobile worker with resourceInternalId 3000001.

yes

yes

Constraints

  • For mobile workers, the mobile worker must have the inventory with the specified ID.

  • For supervisors, the specified resourceInternalId must belong to a mobile worker with the inventory specified by inventory ID.

  • The specified date must be the route date of the specified activity.

  • For mobile workers, the activity must be assigned to the mobile worker.

  • For supervisors, the specified resourceInternalId must be assigned to the activity and the supervisor must have access to the mobile worker.

Inventory Actions

Page Label

Description

deinstall_inventory

Accesses the Add to Deinstalled page with the selected inventory.

install_inventory

Accesses the Add to Installed page with the selected inventory.

Supported Parameters

Name Mandatory for Mobile Worker Mandatory for Supervisor

inventoryId

yes

yes

activityId

yes

yes

date

yes

yes

resourceInternalId

no

yes

Possible URLs

URL Description Applicable for Mobile Worker Applicable for Supervisor

https://<OFS_CORE_APP_URL>/#screen=<SCREEN_LABEL>&activityId=4225435&date=2020-02-19&inventoryId=21229417

Displays the specified Activity Action page for the activity ID, 4225435 and for the inventory ID, 21229417.

yes

no
https://<OFS_CORE_APP_URL>/#screen= <SCREEN_LABEL>

&activityId=4225435&date=2020-02-19&resourceInternalId=3000001&inventoryId=21229417

Displays the specified Inventory Action page for the activity ID, 4225435 and inventory ID, 21229417.

no

yes

Constraints

  • The specified Inventory Action page must be visible for the specified activity and inventory.

  • For mobile workers, the mobile worker must have the inventory with the specified ID.

  • For supervisors, the specified resourceInternalId must belong to a mobile worker with the inventory specified by inventory ID.

  • The specified date must be the route date of the specified activity.

  • For mobile workers, the activity must be assigned to the mobile worker.

  • For supervisors, the specified resourceInternalId must be assigned to the activity and the supervisor must have access to the mobile worker.