Примечание:
для учетной записи пользователя должны быть предоставлены необходимые права в SharePoint

Сам алгоритм плагина будет выглядеть так:

1. сначала я должен получить список всех url документов,
2. после чего создаю заметку в MS CRM
3. считываю документ из SharePoint в буферный файл (в моем случае c:\\bufferFile)
4. добавляю файл в аннотацию (note)
5. повторяю шаги 2-4

Ниже я предоставлю код функции для плагина

public static void CreateNote(Lookup regarding, string lookupfield, DynamicEntity entity, ICrmService crmService)

Параметры которой следующие:

Lookup regarding – связанная запись, к которой привязаны записи документов из SharePoint с полем new_self – это url к документу и new_name – название документа
string lookupfield – поле по которому связана моя сущность с сущностью, содержащую карточки документов
DynamicEntity entity – исходная сущность
ICrmService crmService – IcrmService

//функция для создания примечания в листе согласования
        public static void CreateNote(Lookup regarding, string lookupfield, DynamicEntity entity, ICrmService crmService)
        {
            //вытягиваю все Карточки файлов, привязанных к данному договору
            ColumnSet cs = new ColumnSet();
            cs.Attributes.AddRange(new string[] { "new_self", "new_name" });

            QueryByAttribute qba = new QueryByAttribute();
            qba.ColumnSet = cs;

            qba.EntityName = "new_isorgdoc";
            qba.Attributes = new string[] { lookupfield };
            qba.Values = new object[] { regarding.Value };

            RetrieveMultipleRequest rmr = new RetrieveMultipleRequest();
            rmr.Query = qba;
            rmr.ReturnDynamicEntities = true;

            //получаю ответ
            RetrieveMultipleResponse rmresponse = (RetrieveMultipleResponse)crmService.Execute(rmr);
            //создаю новые заметки в листе согласованя и загружаю файлы из Карточки файлов
            foreach (DynamicEntity _file in rmresponse.BusinessEntityCollection.BusinessEntities)
            {
//получаю полный путь(url) к файлу
                string currentPath;
                Uri url = new Uri(_file["new_self"].ToString());
                currentPath = url.ToString();
//получаю только имя файла, в формате имя_файла.расширение
                string FileName = currentPath.Substring(currentPath.LastIndexOf("/") + 1, (currentPath.Length - currentPath.LastIndexOf("/") - 1));

                // создаю заметку
                annotation note = new annotation();
                note.notetext = FileName; // тело заметки
                note.subject = FileName; //тема заметки 

                note.objectid = new Lookup();
                note.objectid.type = "new_list_soglasovaniya";

                // привязываю ее к листу согласования
                note.objectid.Value = ((Key)entity.Properties["new_list_soglasovaniyaid"]).Value;
                note.objecttypecode = new EntityNameReference();
                note.objecttypecode.Value = "new_list_soglasovaniya";
//создаю заметку
                Guid createdNoteId = crmService.Create(note); 

//отправляю запрос на чтение файла по полученному url
                HttpWebRequest myReq = (HttpWebRequest)WebRequest.Create(url.ToString());
                myReq.Timeout = 7000;
                try
                {
//авторизирую себя (пользователя)
                    myReq.Credentials = CredentialCache.DefaultCredentials;
                    HttpWebResponse MyResponse = (HttpWebResponse)myReq.GetResponse();
                    if (HttpStatusCode.OK == MyResponse.StatusCode)
                    {
                        // открываю поток
                        using (Stream MyResponseStream = MyResponse.GetResponseStream())
                        {
                            // открываю или создаю промежуточный файл
                            using (FileStream MyFileStream = new FileStream("c:\\bufferFile", FileMode.OpenOrCreate, FileAccess.Write))
                            {

                                byte[] MyBuffer = new byte[4096];
                                int BytesRead;
                                //записываю в промежуточный файл
                                while (0 < (BytesRead = MyResponseStream.Read(MyBuffer, 0, MyBuffer.Length)))
                                {

                                    MyFileStream.Write(MyBuffer, 0, BytesRead);
                                }
                            }
                        }
                    }
                }
                catch (Exception err)
                {
                    throw new Exception("Error saving file from URL:" + err.Message, err);
                }
                FileStream stream = File.OpenRead("c:\\bufferFile");
                byte[] byteData = new byte[stream.Length];
                stream.Read(byteData, 0, byteData.Length);
                stream.Close();

                string encodedData = System.Convert.ToBase64String(byteData);
                // подгружаю файл к аннотации
                annotation updateNote = new annotation();
                updateNote.annotationid = new Key();

                updateNote.annotationid.Value = createdNoteId;
                updateNote.documentbody = encodedData;
                updateNote.filename = FileName;
                //updateNote.mimetype = @"application\ms-word";
                crmService.Update(updateNote);
            }

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

CreateNote(regardingLookup, "new_dogovor", entity, crmService);

Вот вроде бы и все. Решение не претендует на единственное, есть множество способов для его улучшения, просто представлен пример, показывающий возможность реализации такой задачи. Кстати, таким способом можно приаттачивать документы не только из SharePoint, но и других веб-ресурсов, а так же с локального сервера (localhost) все будет упираться в политику безопасности. Кстати, я не проверил, но возможно если расширение запрещено для загрузки в MS CRM, то загрузить файл не получится. Так что имейте это в виду.

Спасибо Андрею Бутенко aka a33ik, который постоянно меня направляет в нужное русло Кстати, он получил статус MVP по Microsoft Dynamics CRM, так что еще раз мои поздравления!

Полезные ссылки:

• Расширяем функциональность MS CRM 4.0 с помощью Plug-in
• Услуги по программированию для Microsoft Dynamics CRM + SharePoint

Задача: необходимо реализовать автонумерацию сущности «Лист согласования», создаваемую из сущности «Договор» со следующем форматом: ГГММДД – ХХХ, где ГГММДД – Дата создания записи, а ХХХ – количество созданных листов согласования по этому договору + 1.

Основной код плагина автонумерации:

ICrmService crmService = context.CreateCrmService(true);

//Если лист согласования
if (entity.Name == "new_list_soglasovaniya")
{

//Если договор Договор (создается из договора)

if (entity.Properties.Contains("new_regardingobjectid"))

{

//получаю список листов согласования, по текущему договору

ColumnSet cs = new ColumnSet();

cs.Attributes.AddRange(new string[] { "createdon" });

ConditionExpression conditionId = new ConditionExpression();

conditionId.AttributeName = "new_regardingobjectid";

conditionId.Operator = ConditionOperator.Equal;

conditionId.Values = new string[]{ ((Lookup)entity.Properties["new_regardingobjectid"]).Value.ToString()};

FilterExpression filter = new FilterExpression();

filter.FilterOperator = LogicalOperator.And;

filter.Conditions.Add(conditionId);

QueryExpression query = new QueryExpression();

query.EntityName = "new_list_soglasovaniya";

query.ColumnSet = cs;

query.Criteria = filter;

RetrieveMultipleRequest retrieve = new RetrieveMultipleRequest();

retrieve.Query = query;

retrieve.ReturnDynamicEntities = true;

RetrieveMultipleResponse retrieved = (RetrieveMultipleResponse)crmService.Execute(retrieve);

string countLists;

//номер текущей записи

countLists = (retrieved.BusinessEntityCollection.BusinessEntities.Count + 1).ToString();

//формирую вывод

while (countLists.Length < 3)

{

countLists = "0" + countLists;

}

string new_number;

new_number = DateTime.Now.Year.ToString().Substring(2, 2) + DateTime.Now.Month.ToString() + DateTime.Now.Day.ToString() + "-" + countLists.ToString();

//присваиваю полю new_number мой полученный номер

entity.Properties.Add(new StringProperty("new_number", new_number));

}

Данные для регистрации плагина

Register New Step:

• Message: Create
• Primary Entity: new_list_soglasovaniya
• Execution order: 1
• Eventing Pipeline Stage of Execution: Pre

Полезные ссылки:

• Расширяем функциональность MS CRM 4.0 с помощью Plug-in
• Автонумератор для Microsoft Dynamics CRM 4.0. Plug-in
• Услуги по программированию для Microsoft Dynamics CRM

1. Скачайте необходимые файлы: кастомизацию сущности и сам плагин
2. Импортируем файл кастомизации. У вас создаться новая сущность Автонумератор (do_universalnumber)
3. Опубликуем данную сущность
4. Создаем новую запись нашего Автонумератора.
   

Пример: В поле Сущность выбираю «Контакт» -> Жмем «Сохранить» -> в поле «Атрибут» выбираю firstname -> Указываю необходимый префикс и в поле «Счетчик» указываю начальное значение счетчика. -> «Сохранить и закрыть»
Примечание: т.к. в поле «Атрибут» необходимо выбирать только атрибуты типа nvarchar

5. Регистрирую плагин AKAutoNumber.dll
   Message: Create
   Primary Entity: contact
   Stage: Pre

   

6. Тестируем.
   

Для того, чтобы создать автонумератор для другой сущности повторяем шаги 4-5

Вы можете скачать кастомизацию сущности и сам плагин. Улучшение кода приветствуется, сообщайте в комментариях

Использовались:

http://www.codeplex.com/crmnumbering/ – основа плагина

http://a33ik.blogspot.com/ – примеры для создания динамического пиклиста сущностей

Порядок действий для отладки plug-in

1. Нам необходим plug-in для MS CRM.

2. Выбираем свойства проекта. Properties

3. Вкладка Build – раздел Output path – необходимо выбрать папку assembly у MS CRM. В моем случае это – C:\Program Files\Microsoft Dynamics CRM\Server\bin\assembly\
Сюда будет помещаться dll плагина, а так же файл для отладки . pdb

UPD: Т.к. для отладки необходим только .pdb файл, то этот шаг можно заменить, написав сценарий в Build Events в раздел Post-build event command line вида:
COPY “$(TargetDir)\*.pdb” “C:\Program Files\Microsoft Dynamics CRM\Server\bin\assembly” /Y

(спасибо Сергею за комментарий)

4. Вкладка Build Events в Pre-build event command line указываем: iisreset /stop, в Post-build - iisreset /start. Теперь, перед компиляцией и генерацией dll плагина (build) будет останавливаться IIS-server, потом создаваться dll и pdb файлы, которые помещаются в папку, указанную в п.3, а затем запускаем IIS-server

debug-plugins

5. Делаем Build нашего проекта.

6. Запускаем PluginRegistration tool и регистрируем наш плагин. Выбираем dll из папки п3. (Program Files\Microsoft Dynamics CRM\Server\bin\assembly\)

7. Повторяем ситуацию, на которой должен сработать плагин.
Например: я зарегистрировал плагин на свою сущность, событие – Create, стадия – Pre. Чтобы повторить ситуацию мне достаточно создать записей своей сущности, заполнить необходимые поля и нажать «Сохранить». Аналогично и для других событий

8. Установите Breakpoint там, где это вам необходимо.

9. Итак, ошибку получили, осталось «прицепиться» к IIS, чтобы иметь возможность заняться дебагом.
Для этого: Debug – Attach to Process… – выбираем процесс w3wp.exe и жмем Attach.
Примечание: 1) процессов может быть несколько, цепляемся ко всем 2) если не находите этот процесс, то убедитесь, что выбрана опция «Show processes from all users».

debug-plugins

10. Повторяем п. 7 и занимаемся отладкой плагина в Visual Studio

debug-plugins

Спасибо Савран Роману за помощь

А как отладку делаете Вы? Поделитесь в комментариях.

Follow us in Twitter

Обновление dynamic entity

public void UpdateEntity(ICrmService service)
{
//инициализация переменных
//будем получать сущность для обновления
DynamicEntity entity = new DynamicEntity();

//используем для обновления сущности
TargetUpdateDynamic targetUpdate = new TargetUpdateDynamic();

//запрос на обновление сущности
UpdateRequest updateRequest = new UpdateRequest();

entity.Name = <entity name>

//обновляем необходимые поля
entity.Properties.Add(<свойство1>);
entity.Properties.Add(<свойство2>);
entity.Properties.Add(<свойство3>);

//устанавливаем запрос на обновление
targetUpdate.Entity = entity;
updateRequest.Target = targetUpdate;

//выполняем запрос на обновление
service.Execute(updateRequest);
}

Необходимо помнить, что для того чтобы создавать запись у вас должны быть соответствующие права.

Пример кода для создания записи сущности используя динамические сущности CRM (dynamic entities)

public void CreateEntity(ICrmService service)
{
//объявляем переменные

//будем получать сущность для обновления
DynamicEntity entity = new DynamicEntity();

//используется для обновления сущности
TargetCreateDynamic targetCreate = new TargetCreateDynamic();

//запрос на создание сущности
CreateRequest createRequest = new CreateRequest();

entity.Name = <entity name>

//добавляем значения для атрибутов
entity.Properties.Add(<property>);
entity.Properties.Add(<property>);

//устанавливаем запрос на создание сущности
targetCreate.Entity = entity;
createRequest.Target = targetCreate;

//выполняем запрос
service.Execute(createRequest);
}

Продолжаем изучать плагины для Microsoft Dynamics CRM дальше

Так же посмотрите пример обновления Dynamic Entity в плагине для MS CRM 4.0

В Microsoft Dynamics CRM 4.0 callout переименовали в plug-in (плагин) и добавили дополнительные возможности. Более подробно сейчас не будем останавливать на перечислении всех возможностей plug-in, а рассмотрим простой пример.

Я приведу пример обновления поля new_companyname в task при выборе определенной записи из поля «В отношении» (regardingobjectid). Например, если выбран контакт и он относится к организации, то получаем имя родительской организации (account)

Примечание: пример плагина есть в SDK, он создает объект сущности Task (Задачу) после создания нового объекта сущности Account (Организация).

Подготовка рабочего окружения

1. Установить MS Visual Studio 2008 (можно и 2005)
2. Обязательно скачать SDK для MS CRM 4.0
3. скачаем шаблон проекта для плагина.
4. качаем PluginRegistration tool – этот инструмент поможет нам легко зарегистрировать плагин

Visual Studio установили, теперь кидаем скачанный архив MSCRM Plug-in.zip по пути (у меня так)

C:\Documents and Settings\<Имя пользователя>\Мои документы\Visual Studio 2008\Templates\ProjectTemplates\Visual C#

(теперь, по умолчанию в проект будут подключены необходимые библиотеки, но очень рекомендую для начала изучить SDK)

При создании нового проекта на C# у нас появилась возможность выбрать наш шаблон

MS CRM Plug-in шаблон

- Сразу подпишем нашу сборку: Правой кнопкой в студии на проекте – Properties – Signing – Sign the assembly – Choose a strong name key file – new – указываете имя файла, галочку Protect my key file with a password – снимаете, Сохраняете.

Подключим Microsoft.Crm.Sdk.Query;

using Microsoft.Crm.Sdk.Query;

В плагинах, в отличие от колаутов, используется один основной метод Execute. Мой метод для этого примера выглядит так:

public void Execute(IPluginExecutionContext context)
{
DynamicEntity entity = null;

if (context.InputParameters.Properties.Contains(ParameterName.Target) &&
context.InputParameters.Properties[ParameterName.Target] is DynamicEntity)
{

entity = (DynamicEntity)context.InputParameters.Properties[ParameterName.Target];

if (context.MessageName != MessageName.Update.ToString()
&& context.MessageName != MessageName.Create.ToString())
{
throw new InvalidPluginExecutionException(«Smth wrong with Update stage may be»);
}

}
else
{
return;
}

try
{

ICrmService crmService = context.CreateCrmService(false);
if(entity.Properties.Contains(«regardingobjectid»))
{
String new_companyname = «»;
ColumnSet cs = new ColumnSet();
Lookup regarding = (Lookup)entity.Properties["regardingobjectid"];
// проверяю что за объект передаю в лукапе: организация/контакт/возможная сделка/интерес

// проверяю, что в лукапе выбрана Организация
if (regarding.type == EntityName.account.ToString())
{
cs.Attributes.Add(«name»);
account _account = (account)crmService.Retrieve(EntityName.account.ToString(), regarding.Value, cs);
if (_account == null || _account.name == null)
{
return;
}

else
{
new_companyname = _account.name.ToString();
}
}

// проверяю, что в лукапе выбран Контакт
if (regarding.type == EntityName.contact.ToString())
{
cs.Attributes.Add(«parentcustomerid»);
contact _contact = (contact)crmService.Retrieve(EntityName.contact.ToString(), regarding.Value, cs);

if (_contact == null ||
_contact.parentcustomerid == null ||
(_contact.parentcustomerid.IsNull &&
_contact.parentcustomerid.IsNullSpecified) ||
_contact.parentcustomerid.type != EntityName.account.ToString())
{
return;
}
else
{
new_companyname = _contact.parentcustomerid.name.ToString();
}
}

// проверяю, что в лукапе выбрана Возможная сделка
if (regarding.type == EntityName.opportunity.ToString())
{
cs.Attributes.Add(«customerid»);
opportunity _opportunity = (opportunity)crmService.Retrieve(EntityName.opportunity.ToString(),regarding.Value, cs);
if (_opportunity == null ||
_opportunity.customerid == null)
{
return;
}
else
{
new_companyname = _opportunity.customerid.name.ToString();
}
}
// проверяю, что в лукапе выбран Интерес
if (regarding.type == EntityName.lead.ToString())
{
cs.Attributes.Add(«companyname»);
lead _lead = (lead)crmService.Retrieve(EntityName.lead.ToString(), regarding.Value, cs);
if (_lead == null ||
_lead.companyname == null)
{
return;
}
else
{
new_companyname = _lead.companyname;
}
}

// обновляем наше поле
entity.Properties.Add(new StringProperty(«new_companyname», new_companyname));
}
}

Компилируем плагин и переходим к регистрации плагина.

Регистрация плагина с помощью PluginRegistration tool

Для регистрации используем ранее скачанный PluginRegistration tool, указываем параметры для соединения с CRM-сервером и регистрируем нашу сборку:

1. Register -> Register New Assembly  (Ctrl + A)
2. Указываем AKPuginActivity.dll (C:\Documents and Settings\Администратор\Мои документы\Visual Studio 2008\Projects\AKPuginActivity\AKPuginActivity\bin\Debug) и оставляем выбор сохранения в базе данных.
3. Выбираем нашу сборку и регистрируем новый Step
4. Register -> Register New Step (Ctrl+T)
5. Message: Create; Primary Entity: task; Stage of Execution: Pre Stage

Регистрируем новый Step для плагина

Повторяем шаги 4 и 5, только для события Update (Message: Update)

Проверяем работу

Создаем новую задачу и в поле «В отношении» выбираем контакт, у которого есть родительская организация. Сохраняем и в поле new_companyname появится название организации. Проверяем обновление выбрав другую запись.

Примечание:

Поле new_companyname у меня присутствует не только в сущности task, но и letter, phonecall, appointment в каждой из этих стандартных сущностей присутствует поле «В отношении» regardingobjectid поэтому достаточно зарегистрировать еще несколько step для каждой из сущностей и код будет отрабатывать корректно

Отдельное спасибо Андрею Бутенко за отзывчивость

Ознакомьтесь со статьей «Отладка plug-ins для Microsoft Dynamics CRM 4.0» для эффективной отладки ваших плагинов.