How to: Configure SOAP and OData Web Services for Microsoft Dynamics NAV on Windows Azure

  • Article

By default, the example scripts of the Microsoft Dynamics NAV Provisioning Tools for Windows Azure do not automatically configure SOAP and OData on the Microsoft Dynamics NAV environment. If you want to implement SOAP or OData web services, you must manually configure the services as described in this topic.

To enable SOAP and OData web services, you use the Set-NAVServerConfiguration of the Microsoft Dynamics NAV Administration Shell.

To configure SOAP and OData web services for Microsoft Dynamics NAV on Windows Azure

  1. Establish a Remote Desktop Connection to the virtual machine that is running Microsoft Dynamics NAV Server.

    For more information, see How to Log on to a Virtual Machine Running Windows Server.

  2. Start Microsoft Dynamics NAV Administration Shell.

  3. To enable SOAP web service, do the following:

    1. At the command prompt, type the following command to specify the TCP port to use for SOAP:

      Set-NAVServerConfiguration -ServerInstance <ServerInstance> -keyname SOAPServicesPort -keyvalue <port>

      • Replace <ServerInstance> with the name of the Microsoft Dynamics NAV Server instance on which to set up SOAP services. The default instance is DynamicsNAV70_Instance1.

      • Replace <Port> with the port number to use SOAP services.

    2. Type the following command to enable SOAP services:

      Set-NAVServerConfiguration -ServerInstance <ServerInstance> -keyname SOAPServicesEnabled -keyvalue true

      Replace <ServerInstance> with the name of the Microsoft Dynamics NAV Server instance on which to set up SOAP services. The default instance is DynamicsNAV70_Instance1.

  4. To enable OData web service, do the following:

    1. At the command prompt, type the following command to specify the TCP port to use for OData:

      Set-NAVServerConfiguration -ServerInstance <ServerInstance> -keyname ODataServicesPort -keyvalue <Port>

      • Replace <ServerInstance> with the name of the Microsoft Dynamics NAV Server instance on which to set up OData services. The default instance is DynamicsNAV70_Instance1.

      • Replace <Port> with the port number to use OData services.

    2. Type the following command to enable OData services:

      Set-NAVServerConfiguration -ServerInstance <ServerInstance> -keyname ODataServicesEnabled -keyvalue true

      Replace <ServerInstance> with the name of the Microsoft Dynamics NAV Server instance on which to set up SOAP services. The default instance is DynamicsNAV70_Instance1.

  5. (Optional) Configure the SOAP and OData web services to use Secure Sockets Layer (SSL).

    We recommend that you configure SSL to help make the data transmission and network more secure and reliable.

    For more information, see Walkthrough: Configuring Web Services to Use SSL (SOAP and OData).

  6. Add endpoints for the SOAP and OData web service ports on the Windows Azure virtual machine that is running Microsoft Dynamics NAV Server.

    For more information, see How to Set Up Communication with a Virtual Machine.

See Also

Concepts

Deploying and Managing Microsoft Dynamics NAV on Windows Azure
Deploying Microsoft Dynamics NAV on Windows Azure Using the Example Scripts
Planning and Preparing for Deploying on Windows Azure
OData Web Services
SOAP Web Services