NAV Widgets For IOS: NAVws:Test

 

NAV Widgets for IOS can bring Microsoft Dynamics NAV (formerly known as Navision) functionality to your IOS device!


NAVwsTest, is a free app whose purpose is to “Test” a web services connection to a NAV server.

The app provides minor functionality in that it can display the web services that are published by the server, allow the user to pick a NAV company, and retrieve customer information and display the customers postal address.


To get started with the app, you must first ensure that your NAV server is configured properly for web services and that the CustomerCard (page 21) service that NAVwsTest requires has been defined and is “published”.  For for the details on how to set up your server and publish the required web services, see the NAV Server Configuration Page.


Once the server is configured, you are now ready to test your NAV web services connection.


View NAVws:Test in the iTunes App Store!


 


Address: This is the address of the server running Microsoft Dynamics NAV Server.  If connecting from outside your companies network, it should be the fully qualified server address (example: navserver.mycompany.com.

Port: The listening TCP port for web services for the NAV server.  Normally this is 7047 unless an administrator changed the NAV configuration file.

Instance: The executable instance of NAV running on this server.  By default this is DynamicsNAV, but NAV allows for multiple instances to be running on the same server, each with its own unique name

Uses HTTPS: Indicates if NAV services are configured to use SSL.  By default this is Off

User Name: A valid windows user name authorized to access this NAV instance. Note: Do not enter the domain or work group extension in this field as NAVWidgets asks for that information separately.

Domain: The domain or work group that the user belongs to.

Password: Windows password for the user entered above.


Note: A working server will be attempted to be maintained (but not guaranteed) for testing purposes.  The settings for this test server are listed in the sample screens with a password of ILoveNAV7



Also on the NAVWidgets: ws Test Settings tab are several indicators and status messages.  Pressing the information icon will give descriptions of each setting on the phone.  The icon to the right will show whether a connection is being made via the Cellular Data Network, WIFI, or whether no internet connection is available.

In the bottom center of the heading, a status message will appear that indicates the reachability of the NAV Server that was entered into the settings application.

Server is Reachable indicates that the address can be resolved.  Note that reachable does not mean that a connection can be made, but just that DNS has resolved an IP address for the server address name.

Check NAV Server Settings indicates that the address cannot be resolved and thus is not reachable, but that the network state of the device does have a connection to a network and can route IP.

No Internet Connection indicates that the network state of the device does not have a connection to a network and can not route IP.

 



The Services Tab will show the Web Services that have been published on the NAV Server.  This list should be the same as if you were on the Web Services Page of the NAV Role Tailored Client.


Since NAV Widgets: ws Test for the iPhone can retrieve customer information from the NAV server, the web service that is necessary to do this customer function is highlighted in Green.


Upon entering the tab this list will be cleared.  Tapping the Get button will issue the web service call to the NAV Server and list the response in the table.  Tapping the clear button will clear the list.

 

The Companies Tab will show the Companies that have been set up on this NAV server in the form of a pick wheel.


Since NAV Widgets: ws Test for the iPhone can retrieve customer information from the NAV server, selecting the company that you want customers to be retrieved from is a key step in the process.


Tapping the Get button will issue the web service call to the NAV Server and assemble the companies found into the pick wheel.  Tapping the clear button will clear the list.

 


Last but certainly not least is the Customers Tab. First notice the caption about 2 thirds the way down the screen.  It should indicate which company was selected.  A company must be selected before a customer’s information can be retrieved.


Tap in the Customer No. text box and type in a customer number.


Tapping the Get button will issue the web service call to the NAV Server and retrieve the customer’s data, displaying address information on the screen.  Tapping the clear button will clear the customers address data.

 
After launching the app, you will be presented with the settings screen.  The settings contain information regarding the NAV server the widget will consume web services from.  To access the server, you must also provide authentication information in the form of a user name and password.  This user name and password must be an authorized “Windows Authenticated” user for NAV.  


These settings can be changed directly on the Setting screen, or via IOS devices “Settings Application”.  After launching the settings application, scroll down toward the bottom and look for the icon NAV Widgets icon with an application title of NAVws: Test

  

Here is the information you will need to enter into the Setting Application on the IOS device: