New convertIdFormat function

CHANGELOG.md

@@ -1,5 +1,8 @@
 # Changelog
 
+## 0.7.6 - 2016-04-19
+ * Added a `API::convertIdFormat($itemId, $oldFormat, $destinationFormat, $mailbox)` function
+
 ## 0.7.5 - 2016-04-18
  * Removed `NTLMSoapClient\Exchange`. Folded the few lines of functionality in to `NTLMSoapClient`
  * Added `API::getServerTimezones($timezoneIDs = array(), $fullTimezoneData = false)`

examples/basic/README.md

@@ -9,3 +9,4 @@ libraries, so that you can utilize the API beyond what has been simplified.
  * [Impersonating Other Users](impersonation.php)
  * [Accessing a Primary SMTP Mailbox](primarySmtpAddress.php)
  * [Using the EWS Library with Office 365 and OAuth](authenticatingWithOAuth.php)
+ * [Converting EWS ID Formats](convertItemIdFormat.php)

examples/basic/convertItemIdFormat.php

@@ -0,0 +1,16 @@
+<?php
+
+use jamesiarmes\PEWS\API;
+use jamesiarmes\PEWS\API\Enumeration;
+use jamesiarmes\PEWS\API\Type;
+
+//Create and build the client
+$api = API::withUsernameAndPassword('server', 'username', 'password');
+
+$ews2007ItemId = new Type\ItemIdType($ews2007Id, $changeKey);
+$ews2010ItemId = $api->convertIdFormat(
+    $ews2007ItemId,
+    Enumeration\IdFormatType::EWS_LEGACY_ID,
+    Enumeration\IdFormatType::EWS_ID,
+    '[email protected]'
+);

src/API.php

@@ -565,4 +565,30 @@ public function getServerTimezones($timezoneIDs = array(), $fullTimezoneData = f
 
         return $timezones;
     }
+
+    /**
+     * @param Type\ItemIdType $itemId
+     * @param $fromType
+     * @param $destinationType
+     * @param $mailbox
+     *
+     * @return Type\ItemIdType
+     */
+    public function convertIdFormat(Type\ItemIdType $itemId, $fromType, $destinationType, $mailbox)
+    {
+        $result = $this->getClient()->ConvertId(array(
+            'DestinationFormat' => $destinationType,
+            'SourceIds' => array (
+                'AlternateId' => array(
+                    'Format' => $fromType,
+                    'Id' => $itemId->getId(),
+                    'Mailbox' => $mailbox
+                )
+            )
+        ));
+
+        $itemId->setId($result->getId());
+
+        return $itemId;
+    }
 }

src/API/NTLMSoapClient.php

@@ -84,6 +84,13 @@ class NTLMSoapClient extends SoapClient
 
     protected $auth;
 
+    protected $callsWithoutTimezone = array(
+        'DeleteItem',
+        'SyncFolderItems',
+        'GetServerTimeZones',
+        'ConvertId'
+    );
+
     /**
      * @TODO: Make this smarter. It should know and search what headers to remove on what actions
      *
@@ -104,7 +111,7 @@ public function __call($name, $args)
             $this->ewsHeaders['impersonation']
         );
 
-        if ($name != "DeleteItem" && $name != "SyncFolderItems" && $name != "GetServerTimeZones") {
+        if (!in_array($name, $this->callsWithoutTimezone)) {
             $this->__default_headers[] = $this->ewsHeaders['timezone'];
         }