Что же из этого вышло…

Когда мы вызываем методы веб-служб из JavaScript мы пишем код, который содержит XML-строки и в ручном режиме формируем HTTP запрос для CRM. Пример из SDK как может выглядеть такой код

Традиционный вызов веб-службы. Web Service Soap Request

var xml = "<?xml version='1.0' encoding='utf-8'?>"+
"<soap:Envelope xmlns:soap='http://schemas.xmlsoap.org/soap/envelope/'"+
" xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance'"+
" xmlns:xsd='http://www.w3.org/2001/XMLSchema'>"+
authenticationHeader+
"<soap:Body>"+
"<RetrieveMultiple xmlns='http://schemas.microsoft.com/crm/2007/WebServices'>"+
"<query xmlns:q1='http://schemas.microsoft.com/crm/2006/Query'"+
" xsi:type='q1:QueryExpression'>"+
"<q1:EntityName>contact</q1:EntityName>"+
"<q1:ColumnSet xsi:type='q1:ColumnSet'>"+
"<q1:Attributes>"+
"<q1:Attribute>fullname</q1:Attribute>"+
"<q1:Attribute>contactid</q1:Attribute>"+
"</q1:Attributes>"+
"</q1:ColumnSet>"+
"<q1:Distinct>false</q1:Distinct>"+
"<q1:Criteria>"+
"<q1:FilterOperator>And</q1:FilterOperator>"+
"<q1:Conditions>"+
"<q1:Condition>"+
"<q1:AttributeName>address1_city</q1:AttributeName>"+
"<q1:Operator>Like</q1:Operator>"+
"<q1:Values>"+
"<q1:Value xsi:type='xsd:string'>"+searchCity+"</q1:Value>"+
"</q1:Values>"+
"</q1:Condition>"+
"</q1:Conditions>"+
"</q1:Criteria>"+
"</query>"+
"</RetrieveMultiple>"+
"</soap:Body>"+
"</soap:Envelope>";

Этот код формирует тело SOAP запроса. Он не содержит HTTP-запроса или вывод данных.

Helper Objects

Andrew Zimmer написал пару вспомогательных классов, которые действительно делают жизнь разработчика легче. Они не поддерживают все возможные методы (например условия фильтрации или группировки), однако, большую часть повседневных задач решают замечательно.

Примечание: т.к. движок блога иногда интерпретирует код по-своему, то вы можете скачать исходники здесь или здесь

Пример запроса для одной сущности

        var LOGICAL_OPERATOR_OR = "Or";

        var CONDITION_OPERATOR_EQUAL = "Equal";

        // Создаем объект и передаем параметры

        var crmService = new CrmService("contact", LOGICAL_OPERATOR_OR);

        crmService.AddColumn("jobtitle"); //хочу получить должность

        crmService.AddColumn("telephone1"); // и рабочий телефон

        // Задаю условия выборки

        crmService.AddFilterCondition("contactid", crmForm.all.do_contactid.DataValue[0].id, CONDITION_OPERATOR_EQUAL);

        // Возвращаю результат

        var result = crmService.RetrieveMultiple();

        // Пробегаю по строкам и получаю результат

        for (rowsNumber in result.Rows) {

            var row = result.Rows[rowsNumber];

            // Получаю столбец по имени

         crmForm.all.do_jobtitle.value = row.GetValue("jobtitle");

        crmForm.all.do_workphone.value = row.GetValue("telephone1");

        }

Загрузить код вспомогательных классов

Пример функции вызова Retrieve

function GetAttributeValueFromID(sEntityName, GUID, sAttributeName)
{
var authenticationHeader = GenerateAuthenticationHeader();
// Prepare the SOAP message.
var xml = «»;
xml = xml+»<?xml version=’1.0′ encoding=’utf-8′?>»+
«<soap:Envelope xmlns:soap=’http://schemas.xmlsoap.org/soap/envelope/’»+
» xmlns:xsi=’http://www.w3.org/2001/XMLSchema-instance’»+
» xmlns:xsd=’http://www.w3.org/2001/XMLSchema’>»+
authenticationHeader+
«<soap:Body>»+
«<Retrieve xmlns=’http://schemas.microsoft.com/crm/2007/WebServices’>»+
«<entityName>»+sEntityName+»</entityName>»+
«<id>»+GUID+»</id>»+
«<columnSet xmlns:q1=’http://schemas.microsoft.com/crm/2006/Query’ xsi:type=’q1:ColumnSet’>»+
«<q1:Attributes>»+
«<q1:Attribute>»+sAttributeName+»</q1:Attribute>»+
«</q1:Attributes>»+
«</columnSet>»+
«</Retrieve>»+
«</soap:Body>»+
«</soap:Envelope>»;
// Prepare the xmlHttpObject and send the request.
var xHReq = new ActiveXObject(«Msxml2.XMLHTTP»);
xHReq.Open(«POST», «/mscrmservices/2007/CrmService.asmx», false);
xHReq.setRequestHeader(«SOAPAction»,»http://schemas.microsoft.com/crm/2007/WebServices/Retrieve»);
xHReq.setRequestHeader(«Content-Type», «text/xml; charset=utf-8″);
xHReq.setRequestHeader(«Content-Length», xml.length);
xHReq.send(xml);
// Capture the result.
var resultXml = xHReq.responseXML;

// Check for errors.
var errorCount = resultXml.selectNodes(‘//error’).length;

var result = resultXml.selectSingleNode(«//q1:» + sAttributeName).nodeTypedValue;
if (errorCount != 0)
{
var msg = resultXml.selectSingleNode(‘//description’).nodeTypedValue;
result = » «;
alert(msg);
}
// Display the retrieved value.
else
{
return result;
}
}

Пример вызова:

crmForm.all.new_field.value = GetAttributeValueFromID(«account»,»{GUID_RECORD}»,»name»);

Остальные методы описаны в SDK достаточно подробно, возможно, мы к ним вернемся.

Этот код помещается в OnLoad() формы. Позволяет выбрать любой атрибут практически из любой сущности (не работает с системными сущностями: Product, Systemuser…).

Для этого необходимо передавать имя сущности, ее гуид и имя атрибута, который необходимо получить. Под гуидом сущности понимается guid записи.

Исходный код:

function GetAttributeValueByEntityId(entityName, entytiId, attributeName)
{
var xml = » +
‘[?xml version=`1.0` encoding=`utf-8`?]‘ + ‘\r\n’ +
‘[soap:Envelope xmlns:soap=`http://schemas.xmlsoap.org/soap/envelope/` xmlns:xsi=`http://www.w3.org/2001/XMLSchema-instance` xmlns:xsd=`http://www.w3.org/2001/XMLSchema`]‘ + ‘\r\n’ +
‘ [soap:Body]‘ + ‘\r\n’ +
‘ [entityName xmlns=`http://schemas.microsoft.com/crm/2006/WebServices`]‘ + entityName + ‘[/entityName]‘ + ‘\r\n’ +
‘ [id xmlns=`http://schemas.microsoft.com/crm/2006/WebServices`]‘ + entytiId + ‘[/id]‘ + ‘\r\n’ +
‘ [columnSet xmlns=`http://schemas.microsoft.com/crm/2006/WebServices` xmlns:q=`http://schemas.microsoft.com/crm/2006/Query` xsi:type=`q:ColumnSet`]‘ + ‘\r\n’ +
‘ [q:Attributes]‘ + ‘\r\n’ +
‘ [q:Attribute]‘ + attributeName + ‘[/q:Attribute]‘ + ‘\r\n’ +
‘ [/q:Attributes]‘ + ‘\r\n’ +
‘ [/columnSet]‘ + ‘\r\n’ +
‘ [/soap:Body]‘ + ‘\r\n’ +
‘[/soap:Envelope]‘ +
»;
xml = xml.replace(/\[/gi, String.fromCharCode(60));
xml = xml.replace(/\]/gi, String.fromCharCode(62));
xml = xml.replace(/\`/gi, String.fromCharCode(34));
var xmlHttpRequest = new ActiveXObject(‘Msxml2.XMLHTTP’);
xmlHttpRequest.Open(‘POST’, ‘/mscrmservices/2006/CrmService.asmx’, false);
xmlHttpRequest.setRequestHeader(‘SOAPAction’,'http://schemas.microsoft.com/crm/2006/WebServices/Retrieve’);
xmlHttpRequest.setRequestHeader(‘Content-Type’, ‘text/xml; charset=utf-8′);
xmlHttpRequest.setRequestHeader(‘Content-Length’, xml.length);
xmlHttpRequest.send(xml);
var doc = xmlHttpRequest.responseXML;
// alert(xmlHttpRequest.responseText);
var retValue = »;
if (doc.selectSingleNode(‘//RetrieveResult/’ + attributeName) != null) retValue = doc.selectSingleNode(‘//RetrieveResult/’ + attributeName).text;
return retValue;
}

Пример вызова :
brandGuid = GetAttributeValueByEntityId(‘new_productconsumption’, crmForm.all.new_productconsumption.DataValue[0].id, ‘new_brand’);

• new_productconsumption – моя сущность
• crmForm.all.new_productconsumption.DataValue[0].id – на форме есть лукап, следовательно получаю гуид записи
• new_brand – получаю необходимый мне аттрибут

UPD: Метод Retrieve на javascript для получения атрибута сущности в MS CRM 4.0