Добавить новую запись контакта в Dynamics CRM через вызов REST

Question

Я не знаю ничего о том, как работает Динамика, и при этом я ничего не знаю о ее модели данных (и при этом я не понимаю ее жаргон, поэтому заранее извиняюсь, если использую неправильные термины).

Я создаю веб-сайт, и когда кто-то заполняет форму на этом сайте, необходимо создать новую запись в Dynamics CRM (я полагаю, последняя версия - 2011).

Этот веб-сайтпостроен на PHP, поэтому большая часть кода, предоставленного MS, не применяется.В идеале я ищу некоторые инструкции или ссылку на учебник, который выглядит следующим образом:

1. Сделайте запрос POST на этот URL: http://myinstallation.com/address/to/rest/endpoint
2. Передайте его этимпараметры:
   • 'пароль': пароль приложения
   • 'firstName': имя контакта
   • 'фамилия': фамилия контакта
   • 'address1':Первая строка адреса улицы и т. Д.
3. В виде строки JSON будет возвращена следующая информация:
   • 'код ошибки': 0 для успеха, в противном случае номер ошибки
   • «сообщение об ошибке»: описание ошибки (если есть)

Я знаю, что, возможно, в CRM нет простой концепции «контакта»а скорее некоторая комбинация "возможности" и "человека" и "организации".И я знаю, что, возможно, вы не просто отправляете ему пароль, но скорее используете какой-либо токен аутентификации или данные cookie.И я знаю, что для этого может потребоваться вызов SOAP вместо вызова REST (хотя кажется, что последняя версия поддерживает REST, что я бы предпочел, потому что это проще).И я знаю, что он, вероятно, не возвращает строки JSON.То, что я опубликовал выше, является лишь примером формата, на который мой идеальный ответ выглядел бы (не пытаясь быть требовательным, просто я знаю, что вещи могут «потеряться в переводе» между мирами MS и PHP, иногда, надеюсь, что это поможет объяснить, чтополезный ответ на мой слабый мозг выглядит так.)

Или, может быть, я совершенно не в себе, и делать подобные вещи невозможно без множества настроек на стороне Dynamics?

Кстати, меня сейчас не интересует "двусторонняя синхронизация", поэтому мне просто нужно сообщить CRM, что есть новый контакт (в идеале он автоматически помечает записи, которые он считает дубликатами, но это не обязательно).

Спасибо за любые рекомендации или помощь, которую вы можете предоставить.

Answer 1

У меня была точно такая же проблема, и после кучки затягиваний (в течение которых я наткнулся на ваш пост здесь) я нашел этого парня, который предлагает готовую библиотеку PHP по очень разумной цене, которая делает именно то, что вы необходимо:

http://www.zenithies.org/articles/articles/6/microsoft-dynamics-crm-4-0-php-integration-offer.html

Я нахожусь в процессе интеграции его кода с моим рабочим приложением, но вот интерфейс, с которым вы имеете дело, очень близкий к тому, что вы искали:

<code>$bridge = new CrmExt();
$bridge->liveUser = 'username@domain.com';
$bridge->livePassword = 'password';
$bridge->crmDiscoveryHost = 'domain.crm.dynamics.com';
$bridge->crmDiscoveryHostHttps = true;
$bridge->crmAddress = 'domain.crm.dynamics.com';
$bridge->crmHost = 'domain.api.crm.dynamics.com';
$bridge->crmHostHttps = true;

try {
    $bridge->connnect();

    $newContact = array(
        'firstname' => 'John',
        'lastname' => 'Doe',
        'emailaddress1' => 'example@example.com',
        'telephone1' => '+420 000 000 000 000',
        // etc ..
    );

    // This will send account into crm
    $newContactId = $bridge->pushContact( $newContact );
} catch (Exception $e) {
    printf(
        '<h1>Error:</h1><ul><li>%s</li></ul><pre>%s

», $ E-> GetMessage (), $ Мост-> свалка (правда) ); }

Answer 2

я использовал этот класс: https://github.com/Ben-Speakman/PHP-Dynamics-Online-CRM-2011-SOAP-Class

и запрос такой:

$request = '<Execute xmlns="http://schemas.microsoft.com/xrm/2011/Contracts/Services" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
                           <request i:type="a:CreateRequest" xmlns:a="http://schemas.microsoft.com/xrm/2011/Contracts">
                            <a:Parameters xmlns:b="http://schemas.datacontract.org/2004/07/System.Collections.Generic">
                           <a:KeyValuePairOfstringanyType>
                           <b:key>Target</b:key>
                            <b:value i:type="a:Entity">
                            <a:Attributes>
                          <a:KeyValuePairOfstringanyType>
                            <b:key>firstname</b:key>
                            <b:value i:type="c:string" xmlns:c="http://www.w3.org/2001/XMLSchema">name</b:value>
                           </a:KeyValuePairOfstringanyType>
                           <a:KeyValuePairOfstringanyType>
                            <b:key>lastname</b:key>
                            <b:value i:type="c:string" xmlns:c="http://www.w3.org/2001/XMLSchema">lastname</b:value>
                           </a:KeyValuePairOfstringanyType>
                          <a:KeyValuePairOfstringanyType>
                            <b:key>department</b:key>
                            <b:value i:type="c:string" xmlns:c="http://www.w3.org/2001/XMLSchema">department_name</b:value>
                           </a:KeyValuePairOfstringanyType>
                            <a:KeyValuePairOfstringanyType>
                            <b:key>emailaddress1</b:key>
                            <b:value i:type="c:string" xmlns:c="http://www.w3.org/2001/XMLSchema">email@yahoo.com</b:value>
                           </a:KeyValuePairOfstringanyType>
                            <a:KeyValuePairOfstringanyType>
                            <b:key>telephone1</b:key>
                            <b:value i:type="c:string" xmlns:c="http://www.w3.org/2001/XMLSchema">00112233</b:value>
                           </a:KeyValuePairOfstringanyType>
                         <a:KeyValuePairOfstringanyType>
                            <b:key>description</b:key>
                            <b:value i:type="c:string" xmlns:c="http://www.w3.org/2001/XMLSchema">bla bla</b:value>
                           </a:KeyValuePairOfstringanyType>
                           <a:KeyValuePairOfstringanyType>
                          <b:key>address1_country</b:key>
                          <b:value i:type="c:string" xmlns:c="http://www.w3.org/2001/XMLSchema">My country</b:value>
                           </a:KeyValuePairOfstringanyType>
                                         </a:Attributes>
                                         <a:EntityState i:nil="true" />
                                         <a:FormattedValues />
                                         <a:Id>'.$dynamicsClient->create_guid().'</a:Id>
                                         <a:LogicalName>contact</a:LogicalName>
                                         <a:RelatedEntities />
                                       </b:value>
                                     </a:KeyValuePairOfstringanyType>
                                   </a:Parameters>
                                   <a:RequestId i:nil="true" />
                                   <a:RequestName>Create</a:RequestName>
                                 </request>
                               </Execute>';

                    $dynamicsClient->sendQuery($request);