Creating a contact (example request) about php-ews

[Garethp]

Oh, and just FYI, because this is probably what's going to come up at some point next and I may as well let you know now. You're going to have to perform updates manually as well. Unlike creates however, you can't just update with an object. However, you can build an update out of an array. For example, here is how I update calendar items. here is the function that takes an array of Key=>Value objects and turns them in to the fieldUri things you want. So updating a contact will probably look something like this

        $changes = array('GivenName' => 'Jane', 'CompleteName' => 'Jane Smith');

        //Create the request
        $request = array(
            'ItemChange' => array(
                'ItemId' => $itemId->toArray(),
                'Updates' => array(
                    'SetItemField' => $this->buildUpdateItemChanges('ContactItem', 'contact', $changes)
                )
            )
        );
        $items = $this->updateItems($request);

Also, take note of the $itemId->toArray(), it'll save you from having to do something like 'ItemId' => array('Id' => $itemId->getId(), 'ChangeKey' => $itemId->getChangeKey())

Also, so you have an Id and ChangeKey, and you want to turn that in to an ItemIdType, you can do so like this $itemId = new ItemIdType($id, $changeKey);

Finally, if you want to see any more examples of how to do things, take a look in Calendar and Mail API's. They interact with the base API in much the same way you'll have to with ContactAPI.

Though I do plan on improving ContactAPI in the coming weeks.

[Garethp]

Yeah, all that? That's why I wrote this instead. Rather than doing that, we can work with arrays. I haven't gotten around to making creating a contact simple yet, so you'll have to create it manually. Here's the Microsoft documentation on creating a contact. If you scroll down a bit, you can see the XML needed, so we'll try to match it with an array. It should look something like this

$result = $ews->createItems(array (
    'Contact' => array(
        'GivenName' => 'John',
        'Surname' => 'Smith',
        'Initials' => 'J S',
        'CompleteName' => 'John Smith',
        'EmailAddress' => array(
            'Entry' => array ('Key'=>'EmailAddress1', '_value' => '[email protected]')
        )
    )
));

And so on. You can pretty much just build your request directly in array's this way. Alternatively, you can create a Type\ContactItemType object and pass that in. Like this

$contact = new Type\ContactItemType();

$contact->setGivenName('John')
    ->setSurname('Smith')
    ->setInitials('J S')
    ->addEmailAddress(Type\EmailAddressDictionaryType::buildFromArray(array('key' => 'EmailAddress1', '_value' => '[email protected]')))

$result = $ews->createItems(array('Contact' => $contact));

The second should work, but it's also untested. If you go for the second, you can take a look at the file for ContactType to see what you need to pass in for each value.

Just an FYI, I won't be available tomorrow, so if I probably won't be able to answer any more questions till Monday

[Garethp]

Just an FYI, my examples were a bit off (You can't set Initials or CompleteName when creating a contact, those are set automatically. Also, updating EmailAddress is a bit of a special case), but I've now released 0.7.5 which makes it a bit easier, I've also added those examples that you were after. If you have any further issues, please feel free to either add a new issue or just respond to this one