ServiceMax Field Service App Mobile Testing on iOS

ServiceMax Mobile Testing on iOS is a mobile application for engineers in the field. It allows them to access ServiceMax while on the go, comprising a full work order process, calendar, and directions, allowing engineers to account accurately for their work, follow the right steps for consistent service, and confidently answer customer inquiries.

ServiceMax FSA can be accessed from laptops, smartphones, and iPads. Provar supports ServiceMax mobile testing on iOS devices (from Provar version 1.9).

Some initial configuration must be completed to enable ServiceMax Mobile Testing on iOS. Before following the steps below, ensure you have read and completed the steps on the Mobile Testing with Appium page. Once you have completed the steps on that page, return here and continue to iOS Device Setup below.

iOS Device Setup

---

We’ll start by configuring the device you will be testing on.

Navigate to the Test Settings view and click the Browser Providers tab:

The Browser Provider represents the platform that hosts the FSA. Once you have configured the Browser Provider, it will appear in the Web Browser dropdown in the top-right of Provar Desktop:

To begin adding a new Browser Provider, click the Add New button on the Browser Providers tab in Test Settings:

On the Add new Browser Provider screen, specify the following:

• Enter the Provider Name (this should be the machine that is hosting the Appium server)
• Select the Appium Server radio button
• Enter the Appium Server Address (the IP address where Appium is configured, i.e., your machine’s IP), followed by the port number (the default port for Appium is 4723)
• Set a timeout duration in New Command Timeout (the Appium server will be disconnected after the number of seconds specified here)

Then add an iOS device by clicking the Add New button in the Devices section:

On the Add New Device screen, enter the device Name and set the platform (iOS):

Next, we’ll add some Appium Desired Capabilities. These are keys and values encoded in a JSON object sent by Appium clients to the server when a new automation session is requested. They give the Appium drivers some key information about how you want your test to work, helping to set properties for the WebDriver.

We will add the following four properties:

1. deviceName = iPad
2. platformName = iOS
3. platformVersion = 11.4 (or iOS version installed on iPad)
4. Udid = [your device udid]

Follow the steps below to add these properties.

Start by clicking the Add New button in the Properties section:

On the Add new Desired Capability screen, set the Name to deviceName and the Value to iPad:

Then click the OK button.

Add the second property by clicking the Add New button in the Properties section.

On the Add new Desired Capability screen, set the Name to platformName and the Value to iOS:

Then click the OK button.

Add the third property in the Properties section by clicking the Add New button.

On the Add new Desired Capability screen, set the Name to platformVersion and the Value to 11.4 (or the iOS version installed on your iPad):

Then click the OK button.

Add the fourth and final property by clicking the Add New button in the Properties section.

On the Add new Desired Capability screen, set the Name to udid and the Value to the udid of your device (the udid for your device is shown inside iTunes).

Then click the OK button.

Launching Appium Server

Now you are ready to launch Appium Server.

Use the Terminal to launch Appium Server. Launch Terminal and navigate to the Appium directory:

Enter the command:

node . -a [Appium server IP address] -p [port number]

Then press the Return key.

You should see the following message confirming that Appium Server is now running on your machine:

It would help if you always launched the Appium Server before beginning mobile testing in Provar.

You can also re-launch the server to reconnect after a timeout (based on the time you have specified in the Browser Provider’s New Command Timeout).

Creating SFA Mobile Test Cases

---

Once you have completed the setup, you can build FSA Mobile test cases.

First, select the new Web Browser from the dropdown list in the top-right of Provar Desktop:

Then check that you have added the Connection(s) required for your FSA Mobile testing. You can reuse these existing Connections if you have already been testing the ServiceMax desktop. If not, you can create a ServiceMax FSA testing Connection in the standard way. Refer to Adding a Connection for more information.

Once you have your Web Browser selected and your Connection is set up, you can start creating Test Cases in the standard way.

On the New Provar Test Case screen, make sure the correct Connection is selected for ServiceMax Mobile Testing on iOS and select ServiceMax SFA in Salesforce Application:

Make sure that you leave Launch Test Builder Session ticked, then click the Finish button:

This will launch the Test Builder and open an iPad screen for you to begin mapping test steps.

ServiceMax Field Service App Mobile Support

---

Once logged into the app, Provar will automatically recognize elements such as the Calendar, Explore options, Create New options, and Tasks:

Note that these navigational elements, such as Calendar and Explore, do not need to be mapped separately. Much like tabs in standard Salesforce, Provar will perform the navigation automatically once the inside screen element is mapped.

All Actions are also supported, as in this example for Action items under Work Orders in Explore:

Example 1: Default Search

---

Once logged into SFA, you can add test steps in the standard way: select the element to be mapped by right-clicking and selecting Add to Test Case:

Note that the page and fields have been recognized.

Then click Add & Do to execute the step. Once executed, it should show as follows:

Below is an example FSA Mobile test case is seen from Provar Desktop. The Default Search test step is highlighted:

And in Test Runner:

Example 2: Creating an Event

---

Launch the Test Builder into the ServiceMax SFA application and navigate to the Calendar view:

As mentioned above, note that a navigational element such as a calendar does not need to be mapped separately. Much like tabs in standard Salesforce, Provar will perform the navigation automatically once the inside screen element is mapped.

Add test steps in the standard way: select the element to be mapped by right-clicking and selecting Add to Test Case, for example, on the New button below:

Provar automatically recognizes the fields on the New Event screen, and you can map them in the normal way:

Once the relevant fields are mapped, the Save button is also mapped:

The draft test step above shows the page and elements being recognized automatically.

After clicking Add & Do, the test appears as below:

Here is the same test case seen from Provar Desktop:

And in Test Runner:

Example 3: Attach and Email Documents

---

This example demonstrates attaching an image file to a Work Order and then sending it by email.

Note that this example will involve emailing the file using Gmail, and currently, Provar only supports the use of Gmail on iPad, not other iOS devices. Before completing this email, we recommend ensuring that Gmail is configured to work on your device.

Before starting, prepare your image file and place the file to be uploaded under the templates folder inside your Provar project.

Start mapping the Add link under the Attached Documents header on the Edit WO screen.

Make sure the Interaction Type is set to Attach file and then enter the file path for the image in the templates folder, e.g., templates/download.jpg:

Then click the Add & Do button.

Once the image file has been uploaded, map the Select hyperlink on the Attached Images/Videos header and execute the step:

Then map a step to check the radio button next to your target image.

You can locate the target row based on image size, Name, or both, as shown:

Then click Add & Do to execute the step.

Ensure that Gmail has been configured on your device to email the file. Provar only supports using Gmail on iPad, not other iOS devices.

Next, map the envelope icon on the Attached Images/Videos to send an email:

Enter To, CC, and BCC details, then click the Add & Do button.

Finally, verify in Gmail that the email has been sent and received successfully with the image file attached.

---

Feedback

Was this article helpful for you?

We really appreciate it!

Thank you for your feedback.

Tell us how we can improve this article.

No Yes