How to: Install Microsoft Dynamics Mobile - Device Components
Microsoft Dynamics® Mobile – Device Components includes components for extending Microsoft Dynamics AX and Microsoft Dynamics NAV to mobile devices as illustrate in the following figure:
The Microsoft Dynamics Mobile - Device Components installation includes the following:
| Component | Description |
|---|---|
|
Mobile Device SDK |
A software development kit that provides a design-time experience in Visual Studio to create or customize Microsoft Dynamics Mobile applications using Microsoft Visual Studio 2008. Mobile Device SDK includes a toolbox of components that you can configure into a mobile client solution without writing any .NET code. Mobile Device SDK also includes the source code of a sample application that illustrating some of the basic features in Mobile Device SDK. |
|
Mobile Sales |
A preconfigured Microsoft Dynamics Mobile application based on the component tool box plus application objects that extend Microsoft Dynamics AX and Microsoft Dynamics NAV for a mobile sales scenario. |
Depending on your network scenario, you can choose to install the all the components on a single computer or select specific components on separate computers. For example, if you are only developing a mobile application, you can install only Mobile Device SDK. For integrating Mobile Sales with Microsoft Dynamics AX and Microsoft Dynamics NAV, you can install Mobile Sales on your Microsoft Dynamics AX or Microsoft Dynamics NAV computer.
To install the Microsoft Dynamics Mobile - Device Components on a computer
-
Check the Installation Requirements page and ensure that all of the required components are available.
-
Download the most recent version of the software available from PartnerSource.
-
Run Microsoft Dynamics Mobile - Device Components.msi.
-
On the Welcome page, click Next.
-
Read the license terms. If you agree with the conditions, click I accept the terms in the license agreement.
-
Click Next.
-
On the Destination Folder page, accept the default folder or click Change to choose a different destination.
Note If you install Microsoft Dynamics Mobile - Device Components to a folder other than the default folder, shortcuts to any previously installed Microsoft Dynamics Mobile components are removed from the Start menu.
-
Click Next.
-
On the Installation Type page, select one of the following:
-
Complete to install all Microsoft Dynamics Mobile - Device Components, including Mobile Sales for the supported versions of Microsoft Dynamics AX and Microsoft Dynamics NAV, and Mobile Device SDK.
-
Custom to install Mobile Sales for specific versions of Microsoft Dynamics AX and Microsoft Dynamics NAV, and to choose whether to install Mobile Device SDK.
-
-
Click Next.
-
If you chose the Complete installation, then click Install and go to step 14. If you chose Custom installation, go the next step.
-
On the Custom Setup page, do the following:
-
To install Mobile Device SDK, select Device SDK.
-
To install Mobile Sales, under Mobile Sales Components, select the business solutions that you will integrate with.
-
-
Click Next, and then click Install.
-
When the installation is complete, click Finish to exit the installer. Then, you can view the installed files.
To verify the Microsoft Dynamics Mobile - Device Components installation on your computer
-
Click the Start button, point to All Programs, point to Microsoft Dynamics Mobile, and then click Folder Overview.
This opens the folder in which you installed the Microsoft Dynamics Mobile - Server Components files. The default location is C:\Program Files\Microsoft Dynamics Mobile. Depending on the section you made in the Choose Components page, the following subfolders appear.
Subfolder Description Bin
Contains the common .NET assemblies and tools that can be used to build mobile applications. The tools include:
-
A desktop command line tool called labeltool.exe that you can use to change mobile application text strings found in the UserRole.xml and App.config files.
-
A desktop command line tool called userolegen.exe that you can use to compile the UserRole.xml file into an assembly for increasing the performance and security of the mobile application on the mobile device. For more information, see How to: Compile UserRole.xml.
SDK\Device
Available if you installed the Mobile Device SDK. This folder contains the framework for developing your own mobile applications. The folder includes the following subfolders.
-
Graphics
This folder contains graphic files that are used by any Microsoft Dynamics Mobile application at runtime and those that are used by Mobile Sales. Graphics are available as VGA and QVGA types.
-
Runtime
Contains the RolePad.exe file and assemblies that are needed by any Microsoft Dynamics Mobile application at run time. It also includes services and tasklet assemblies that you can use to in your mobile application.
Note For more information about services, see Microsoft Dynamics Mobile Services Configuration. For more information about the tasklets, see Microsoft Dynamics Mobile Tasklet Reference in Microsoft Dynamics Mobile Orchestration Guide online. -
Samples
Contains the C# source code of a sample application that allows you to manage customer information found in your business solution from a mobile device.
-
Schemas
Contains schemas to validate the XML file that are used by a mobile application, including the app.config file, the UserRole.xml file, and tasklet configurations. For more information, see Mobile Orchestration online
Note Do not deploy the tasklet schemas to mobile devices. The files are provided as support for when you configure the UserRole.xml and app.config files. To view the schemas, use Microsoft Visual Studio 2005, Microsoft Visual Studio 2008, or an XML editor of your choice. For more information, see Microsoft Dynamics Mobile Tasklet Reference in Microsoft Dynamics Mobile Orchestration Guide online.
Solutions
Available if you chose to install Mobile Sales Components. This folder contains components that extend Microsoft Dynamics with Mobile Sales. There is a subfolder for each Microsoft Dynamics solution that you chose to install.
Solutions\Microsoft Dynamics\Mobile Deployment
-
The Application VGA and Application QVGA folders contain files and assemblies that must be installed on a mobile device to run a basic application that can contact the deployment service for receiving a full Microsoft Dynamics Mobile application. Use the files from the appropriate folder depending on the resolution (VGA or QVGA) on the device.
-
Localization folder contains localized versions of the mobile application's app.config file and UserRole.xml file.
For information, see Deploying a Mobile Application to Mobile Devices.
Solutions\Microsoft Dynamics\Mobile Sales\Device
Contains files that must be installed on mobile devices to run Mobile Sales.
-
Application VGA and Application QVGA folders contain the files that must be deployed to mobile devices in VGA and QVGA version. Use the files from the appropriate folder depending on the resolution (VGA or QVGA) on the device.
-
Localization folder contains localized versions of the Mobile Sales app.config file and UserRole.xml file.
For information, see Deploying a Mobile Application to Mobile Devices.
Solutions\Microsoft Dynamics\Mobile Sales\Server
Contains the files for the mobile staging database and Microsoft Dynamics AX or Microsoft Dynamics NAV. The Server folder contains the following sub folders:
-
Application Components folder contains files to import into Microsoft Dynamics AX or Microsoft Dynamics NAV that add Mobile Sales functionality. For more information, see Integrating with Integrating with Microsoft Dynamics Business Applications.
-
Schemas folder contains XML schema files for validating request documents from mobile devices on the server side. For more information, see Validating Request Documents Against XML Schemas in Microsoft Dynamics Mobile - Server Components Administration online.
-
Staging Database folder contains Microsoft SQL Server Integration Services (SSIS) packages and SQL scripts for creating the mobile staging database that replicates data from the business solution to the mobile device. For more information, see Configuring the Mobile Staging Database and SQL Server Replication.
-
To complete the installation
-
Import the integration objects for Microsoft Dynamics AX 4.0 or Microsoft Dynamics NAV 4.0. For more information, see Integrating with Microsoft Dynamics Business Applications.
Note If you are connecting to Microsoft Dynamics NAV 5.0 or Microsoft Dynamics NAV 2009 using NAV Application server, then you do not need to perform this procedure because the integration objects are already installed.
-
Set up document handlers, document types, and request document schemas in the appropriate application. For more information, see Microsoft Dynamics Mobile - Server Components Administration online.
-
Create the staging database. For more information, see Configuring the Mobile Staging Database and SQL Server Replication.
-
Run the SQL Server Integration Services package. For more information, see How to: Run the SSIS Package to Update the Mobile Staging Database.
For more information about Mobile Sales, see Mobile Sales in Microsoft Dynamics Business Applications online.
For information about using the Mobile Device SDK to develop mobile applications, see Microsoft Dynamics Mobile Device SDK.
See Also
Tasks
How to: Run the SSIS Package to Update the Mobile Staging DatabaseConcepts
Microsoft Dynamics Mobile - Device Components PrerequisitesDeploying a Mobile Application to Mobile Devices
Deployment Scenarios
Configuring the Mobile Staging Database and SQL Server Replication