*
Concepts
*
Tasks
*
Settings

Manually Processing Uploaded Activities

This topic explains how to manually process mobile computing activities for the site and individual devices. It also explains how to view upload transactions for which an error occurred during processing. You can open an upload transaction to review the messages and then either accept the error or fix the problem and process the transaction.
Tip: You can set up the Upload Transaction Broker to process upload transactions automatically at regular intervals. See “Setting up APM Mobile Apps” in APM Installation Guide.
This topic explains how:
•
To Manually Process Uploaded Activities for a Site
•
To Manually Process Uploaded Activities for a Device
•
To View Upload Transactions in Error

To Manually Process Uploaded Activities for a Site

1.
On the Site window, click the Tools menu, select Mobile Computing, and then Process Upload Transactions.
2.
A confirmation message appears. To process the activities, click Yes.
Tip: You can also select the site’s Mobile Computing view, Activities (iOS or Android) tab, and the Upload Transactions tab. By default, this tab displays the “Upload transactions that are waiting to be processed” configuration. You can either select transactions and click Process Selected or click Process All.
3.
The system processes the upload transactions and then closes them. However, if a transaction cannot be processed (for example, because a reading references an indicator state that has since been deleted), the Synchronization Error dialog appears with an explanation of the problem. Your options are:
•
Retry – The system tries to process the transaction again. For example, you might select this option if the error message indicates that another user has the object locked. You can retry a transaction as many times as you want, but until the problem has been fixed, the transaction will continue to fail.
•
Accept – The transaction is marked as “Failed” and the next transaction is processed. You might use this response, for example, for a transaction that failed because it was trying to update an object that has since been deleted. Accepting failed transactions can lead to other failures, if following transactions depend on the failed transaction. This option should be used with caution.
•
Skip – The transaction is marked as “In error” and the next transaction is processed. You can later review the transaction, fix the problem, and process the transaction.
•
Cancel – The transaction is marked as “In error” and processing stops. Transactions that have been processed up to this point are not affected. The status of all remaining transactions is left as “Waiting to be Processed”.

To Manually Process Uploaded Activities for a Device

1.
Select the site’s Mobile Computing view and the Mobile Devices tab.
2.
Double-click the device to open the Mobile Computer window.
3.
Select the Activities view and then the Open Activities tab.
4.
Select one or more uploaded activities, right-click, and click Process. A confirmation message appears. To process the activities, click Yes.
5.
The system processes the upload transactions and then closes them. However, if a transaction cannot be processed (for example, because a reading references an indicator state that has since been deleted), the Synchronization Error dialog appears with an explanation of the problem. Your options are:
•
Retry – The system tries to process the transaction again. For example, you might select this option if the error message indicates that another user has the object locked. You can retry a transaction as many times as you want, but until the problem has been fixed, the transaction will continue to fail.
•
Accept – The transaction is marked as “Failed” and the next transaction is processed. You might use this response, for example, for a transaction that failed because it was trying to update an object that has since been deleted. Accepting failed transactions can lead to other failures, if following transactions depend on the failed transaction. This option should be used with caution.
•
Skip – The transaction is marked as “In error” and the next transaction is processed. You can later review the transaction, fix the problem, and process the transaction.
•
Cancel – The transaction is marked as “In error” and processing stops. Transactions that have been processed up to this point are not affected. The status of all remaining transactions is left as “Waiting to be Processed”.

To View Upload Transactions in Error

1.
From either the site’s Mobile Computing view, Activities (iOS or Android) tab or the Mobile Computer window’s Synchronization view, select the Upload Transactions tab.
2.
Select “Upload transactions in error” from the list of configurations.
3.
Open a transaction to view information about the processing error.
4.
Do one of the following:
•
Troubleshoot the error and resolve the problem, which could involve changing the indicator reading, uploading the activity from the device, and processing the transaction.
•
Click Process Now and then Accept to accept the error and remove the transaction from the list of those in error.