Connecting to Dynamics NAV Web Services Using PHP

By Chris Carrigee | February 28, 2020

Prerequisites

In order to make Dynamics NAV Web Services work with PHP you need to make sure that SOAP and CURL extensions are installed and enabled in php.ini.

You can check this by running the info.php and checking the following entries:

Once you have verified that the php.ini file is correct you will need to update the Service Tier to use NTLM Authentication.

Note: Be sure to stop and start the service instance to apply the NTLM Authentication change.

Extract The Attached Zip File And Transfer The Contents To The PHP Site.

You will need to update the NTLMUserID.php file to reflect your Username and Password.

After you update the Web Services Credentials you must configure the Web Service URL for PHP Examples.

First, verify that the Web Services instances is running.

Example:

http://abs-dev-nav2016.westus.cloudapp.azure.com:7047/NAV/WS/Services

Next update Examples.php variables to reflect your Web Service instance.

$baseURL = ‘http://abs-dev-nav2016.westus.cloudapp.azure.com:7047/NAV/WS/’;

Note: Be sure to include Port Number and Service Tier name in URL.

Define the company name that you will be connecting to.

$CompanyName = “CRONUS International Ltd.”;

Save changes to the examples.php file.

Run the PHP Examples page.

Read Single Record

$pageURL = $baseURL.rawurlencode($CompanyName).’/Page/Item’;

// Read Single Record

try{

$service = new NTLMSoapClient($pageURL);

$params = array(‘No’ => ‘*1*’);

$result = $service->Read($params);

$item = $result->Item;

echo “Read Single Record Result: Item Filter No = *1*:” . $item->No . “&nbsp;” . $item->Description.”<br><br>”;

}

catch (Exception $e) {

echo “<hr><b>ERROR: SoapException:</b> <hr>”;

echo “<pre>”.htmlentities(print_r($service->__getLastRequest(),1)).”</pre>”;

Read Multiple Records

try{

$params = array(‘filter’ => array( array(‘Field’ => ‘No’,

‘Criteria’ => ‘*1*’)

),

‘setSize’ => 20); //setSize =0 will return all rows – Can cause performance issue with large results set!

$result = $service->ReadMultiple($params);

$resultSet = $result->ReadMultiple_Result->Item;

echo “Read Multiple Records Result: First 20 Items that Contain *1* :<br>”;

if (is_array($resultSet)) {

foreach($resultSet as $rec) {

echo $rec->No . “&nbsp;” . $rec->Description.”<br>”;

}

}

else {

echo $resultSet->No . “&nbsp;” . $resultSet->Description.”<br>”;

}

}

catch (Exception $e) {

echo “<hr><b>ERROR: SoapException:</b> <hr>”;

echo “<pre>”.htmlentities(print_r($service->__getLastRequest(),1)).”</pre>”;

}

Create Record

try {

$create = new stdClass();

//Define The Primary Key Values

$Item_PK = new stdClass();

$Item_PK->No= “NEWITEM” . DATE(his);

//Create The Record

$create->Item = $Item_PK;

$result = $service->create($create);

//Key is the Unique Identifer that is required to perform any additional updates to the data.

$key = $result->Item->Key;

echo “Record Created: Key Value = ” . $key.”<br>Item No.=” . $result->Item->No . “<br>”;

}

catch (Exception $e) {

echo “<hr><b>ERROR: SoapException:</b> <hr>”;

echo “<pre>”.htmlentities(print_r($service->__getLastRequest(),1)).”</pre>”;

}

Update Record

//Note: Key Value is required to update data!

try {

$Update_Rec = new stdClass();

$Update_Rec->Key = $key;

$Update_Rec->No =”UPDATEDITEM” . DATE(his); //Note: We Are Changeing the Primary Key(The Primary Key value is not required, I just wanted to show the Key Value Increments when the Primary Key is changed.)

$Update_Rec->Description = ‘Created by Web Service’; //Text Field

$Update_Rec->Unit_Price = 19.99; //Decimal Field

$Update_Rec->Replenishment_System = ‘Assembly’; //Option Field

$Update_Rec->Blocked = True; //Boolean Field

$Update_Rec->Safety_Lead_Time = ’30D’; //DateFormula Field

$update->Item =$Update_Rec;

$result = $service->Update($update);

$key = $result->Item->Key;

echo “Record Updated: New Key Value = ” . $key.”<br>Item No.=” . $result->Item->No . “<br>”;

}

catch (Exception $e) {

echo “<hr><b>ERROR: SoapException:</b> <hr>”;

echo “<pre>”.htmlentities(print_r($service->__getLastRequest(),1)).”</pre>”;

}

Delete Record

//Note: Key Value is required to delete data!

try {

$Delete_Rec = new stdClass();

$Delete_Rec->Key = $key;

$result = $service->Delete($Delete_Rec);

echo “Record Deleted: Key Value = ” . $key.”<br>”;

}

catch (Exception $e) {

echo “<hr><b>ERROR: SoapException:</b> <hr>”;

echo “<pre>”.htmlentities(print_r($service->__getLastRequest(),1)).”</pre>”;

}

Execute Codeunit Function

try {

$codeunitURL = $baseURL.rawurlencode($CompanyName).’/Codeunit/LibraryRandom’;

echo “<br>Execute NAV Codeunit Call: $codeunitURL<br><br>”;

//Initialize Page Soap Client

$codeunit = new NTLMSoapClient($codeunitURL);

$functionparams = array(‘delta’ => rand(1,10)); //Set Parameters for function

$result = $codeunit->RandDate($functionparams); //Call Codeunit Function To Return Random Date Based Upon delta passed

echo “NAV Codeunit LibraryRandom Result: ” . $result->return_value.”<br>”;

}

catch (Exception $e) {

echo “<hr><b>ERROR: SoapException:</b> <hr>”;

echo “<pre>”.htmlentities(print_r($service->__getLastRequest(),1)).”</pre>”;

}

Related Posts

Recommended Reading:

Stoneridge Software Selected for 2022 Microsoft US Partner Award – Dynamics 365 Business Central

Stoneridge Software is honored to be selected as a 2022 Microsoft US (MSUS) Partner Award winner for Dynamics 365 Business […]

Read the Article
6.29.22 Dynamics CRM

Reduce Manual Data & Increase Productivity with Dynamics 365 for Sales

Dynamics 365 for Sales has a ton of great features to help automate processes for you and your team to […]

Read the Article

Dynamics 365 Business Central Boolean Field Bug Temporary Fix

If you are a Dynamics 365 Business Central cloud (SaaS) customer who is using Edge or Chrome to run the […]

Read the Article

Using Non-Sequential Numbering to Prevent Locking In Your Dynamics 365 Business Central System

Running into locks in your system? Enable non-sequential numbering on your number series to prevent number series locking issues! As […]

Read the Article
6.24.22 Dynamics GP

Uncommonly Used Features: Setting Up Account Categories in Dynamics GP

This is the final part of my current series on Uncommonly Used Features in Dynamics GP. In this post, I […]

Read the Article

Increase User Productivity in Dynamics 365 Business Central with These 10 Tips

There are constantly evolving ways for you to increase user productivity in Dynamics 365 Business Central. Here are 10 tips […]

Read the Article

Star Tribune Lists Stoneridge as a Top 200 Workplace for 2022

Stoneridge Software’s emphasis on creating a positive and flexible culture has earned recognition as a top workplace in Minnesota. The […]

Read the Article
6.14.22 Dynamics GP

Uncommonly Used Features – Reconciling Sub-ledger to GL using the Reconcile Routines in Dynamics GP

As we continue the uncommonly used features series, with this post I want to show you how to reconcile your […]

Read the Article

Organize and Prioritize Your Resources with Dynamics 365 Field Service

As a manager, Dynamics 365 Field Service lets you optimize the use of your employees, their skillsets, and other resources […]

Read the Article

Start the Conversation

It’s our mission to help clients win. We’d love to talk to you about the right business solutions to help you achieve your goals.

Subscribe To Our Blog

Sign up to get periodic updates on the latest posts.

Thank you for subscribing!

X