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:
- deviceName = iPad
- platformName = iOS
- platformVersion = 11.4 (or iOS version installed on iPad)
- 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.
- Provar Automation
- Installing Provar Automation
- Updating Provar Automation
- Using Provar Automation
- API Testing
- Behavior-Driven Development
- Creating and Importing Projects
- Creating Test Cases
- Custom Table Mapping
- Debugging Tests
- Defining a Namespace Prefix on a Connection
- Defining Proxy Settings
- Environment Management
- Exporting Test Cases into a PDF
- Exporting Test Projects
- Override Auto-Retry for Test Step
- Managing Test Steps
- Namespace Org Testing
- Provar Desktop
- Provar Test Builder
- Refresh and Recompile
- Reintroduction of CLI License Check
- Reload Org Cache
- Running Tests
- Searching Provar with Find Usages
- Secrets Management and Encryption
- Setup and Teardown Test Cases
- Tags and Service Level Agreements (SLAs)
- Test Cycles
- Test Plans
- Testing Browser Options
- Tooltip Testing
- Using the Test Palette
- Test Palette Introduction
- Control Test Steps
- Generate Test Case
- List Compare
- Page Object Cleaner
- Read Test Step
- String Test Steps
- UI Test Steps
- Using Custom APIs
- Callable Tests
- Data-Driven Testing
- Page Objects
- Block Locator Strategies
- Introduction to XPaths
- Creating an XPath
- Label Locator Strategies
- Maintaining Page Objects
- Mapping Non-Salesforce fields
- Page Object Operations
- Refresh and Reselect Field Locators in Test Builder
- Using Java Method Annotations for Custom Objects
- Applications Testing
- Database Testing
- Document Testing
- Email Testing
- Mobile Testing
- OrchestraCMS Testing
- Guide in Salesforce CPQ Testing in Automation
- Guide in ServiceMax Testing
- Skuid Testing
- Vlocity API Testing
- Webservices Testing
- Provar Manager
- Introduction to Test Scheduling
- Apache Ant
- Configuration for Sending Emails via the Automation Command Line Interface
- Continuous Integration
- AutoRABIT Salesforce DevOps in Provar Test
- Azure DevOps
- Running a Provar CI Task in Azure DevOps Pipelines
- Configuring the Automation secrets password in Microsoft Azure Pipelines
- Parallel Execution in Microsoft Azure Pipelines using Multiple build.xml Files
- Parallel Execution in Microsoft Azure Pipelines using Targets
- Parallel execution in Microsoft Azure Pipelines using Test Plans
- Bitbucket Pipelines
- Gearset DevOps CI/CD
- GitHub Actions
- Integrating GitHub Actions CI to Run Automation CI Task
- Remote Trigger in GitHub Actions
- Parameterization using Environment Variables in GitHub Actions
- Parallel Execution in GitHub Actions using Multiple build.xml Files
- Parallel Execution in GitHub Actions using Targets
- Parallel Execution in GitHub Actions using Test Plan
- Parallel Execution in GitHub Actions using Job Matrix
- GitLab Continuous Integration
- Travis CI
- Execution Environment Security Configuration
- Provar Jenkins Plugin
- Parallel Execution
- Running Provar on Linux
- Salesforce DX
- Team Foundation Server
- Version Control
- Salesforce Testing
- Adding a Salesforce Connection
- Assert Page Error Messages on Add/Edit Product
- Internationalization Support
- List and Table Testing
- Salesforce Console Testing
- Salesforce Lightning Testing
- Salesforce Lightning Web Component (LWC) Locator Support
- Salesforce Release Updates
- Visualforce Testing
- Best Practices
- Configurations and Permissions
- Error Messages
- Licensing, Installation and Firewalls
- Test Builder and Test Cases
- Release Notes