Microsoft Dynamics® Mobile - Server Components manages the interaction between mobile devices and Microsoft Dynamics NAV. Mobile devices send data and requests back to the server as XML documents, called request documents. Inside Microsoft Dynamics NAV, application objects called document handlers and document types complete the integration. For more information, see Defining Document Handlers in Microsoft Dynamics NAV and How to: Import, Export and View Document Schemas in Microsoft Dynamics NAV Classic.

All the request documents that are sent from mobile devices to Microsoft Dynamics NAV are stored in a document queue. The document queue gives you an overview of all the submitted requests and their processing status. This section gives an overview of how request documents can be processed and of the request document queue.

NoteNote

To use mobile functionality during run time, you must install and configure Microsoft Dynamics® Mobile. For more information, see Microsoft Dynamics Mobile Installation and Configuration Guide onl.

Monitoring the Request Document Queue

When a user submits a request from a mobile device, the mobile document service adds this request to the request document queue in Microsoft Dynamics NAV. The mobile application on the device can request information or it can request that data be created, updated, or deleted.

All request documents are sent to the Mobile Document Queue table before being processed. The request documents can be processed in two ways, as described in the following table.

Processing method Description

Direct processing

A request document is sent to the document queue and is processed immediately, returning a result to the mobile device.

Queued processing

A request document is sent to the document queue and is not processed until initiated by the user or by the document queue processor.

You can monitor all of the request documents in the document queue by using the Document Queue List window, which is a log that provides a status of the request documents. When request documents are processed, they remain in the document queue with the status Completed until they are manually deleted. For more information, see How to: Reset and Delete Mobile Request Documents in Microsoft Dynamics NAV Classic.

Security

When a user submits a request document to Microsoft Dynamics NAV, the mobile document dispatcher validates their access to the specific document type. If the mobile user is not a member of a mobile group that is assigned to the specific document type, the request is rejected. Queued request documents are revalidated when they are processed. A document handler can also validate the mobile user’s access to the tables before processing a request document.

If the required user right is unassigned between the time that the document is submitted and it is processed, the document queue processor does not process the document and an error is returned. The administrator must then assign the required user right or delete the request document.

Mobile Document Queue

In the Document Queue List window, you can modify a request document that has not yet processed successfully. This is useful if an error occurs when you are trying to process it the first time. You can also reset the status, delete a request document, and manually import and export request documents as XML.

For more information about the fields in the document queue, see Mobile Document Queue Table.

See Also