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.
Note |
---|
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
Tasks
How to: Process Mobile Documents in Microsoft Dynamics NAV ClassicHow to: Modify a Mobile Document before Processing in Microsoft Dynamics NAV Classic
How to: Import and Export Mobile Request Documents in Microsoft Dynamics NAV Classic
How to: Reset and Delete Mobile Request Documents in Microsoft Dynamics NAV Classic
How to: Set Up Mobile Document Types in Microsoft Dynamics NAV Classic
How to: Set Up Mobile Users in Microsoft Dynamics NAV Classic
Reference
Mobile Document Queue TableConcepts
Defining Document Handlers in Microsoft Dynamics NAVOther Resources
Integrating Microsoft Dynamics NAV Classic with Microsoft Dynamics MobileMobile Development Tools - Server Components Overview