Overview
You may notice that Jobs, Timesheets, Forms, or other data is not loaded via Web Services from Field Force Manager to the 3rd-party application that you are using, or jobs, locations, or users are not imported into Field Force Manager.
Diagnosis
Please follow the troubleshooting steps below to identify the reason for this issue:
- Check if the data that you want to retrieve from Field Force Manager is present on the web portal under the corresponding tab (e.g., Jobs, Shits, Forms, etc.) - the data may have not been transferred from the worker's mobile device to our servers.
If you are trying to push data to Field Force Manager (e.g., create jobs), you may want to check if the data is present in your system. - If you received an error when running web services API calls, open the link for the corresponding Web Service from the developer guide and search for the error you encountered for more explanation. For example, you were using an incorrect date and time format, didn't provide a worker name or any other required data.
-
Execute a test API call for the same service but using another request to check if Web Services are working.
If test API calls are working, check if there are any issues on your side (e.g., with the application you integrated with Field Force Manager).
If you still haven't identified what is causing issues with Web Services, please contact us, providing the following information:
-
- Data which you want to pull or push to Field Force Manager (e.g., jobs, forms, timesheets for specific workers)
- The exact name and version of the web service (WSDL) that you are using
- Full text of the API request you are running
- Error message (if available)
-
<supportagent>Agents need to perform the same troubleshooting as described above. You can create a WebService user on the customer's environment to execute APIs; the user should be removed once the issue is solved.
- If all Web Service calls that you are running are failing, there might be an outage that needs to be elevated to SaaS as a Showstopper.
Note: Check if any issues were mentioned in the StreetSmart Announcements chat and if there are existing Jira tickets related to Web Services. - If you cannot identify the issue with the customer's API call within L1/L2 (but standard API calls are running successfully), elevate the issue to SaaS.
</supportagent>
Solution
- If the required data was not loaded to the web portal from workers' mobile devices - the affected workers need to follow the steps from the Device Is Not Syncing with the Server article to get the data transmitted.
- If you received errors after running Web Services, adjust the data in the failing API request according to the developer guide.
Testing
Run the same API call manually or using your automation; the required data should be retrieved from Field Force Manager or pushed to our server without issues.