crrm.ru - outlook

winmail.dat вместо вложенного файла в письме

Vladislav Osmanov — Thu, 28 Feb 2013 13:59:18 +0000

При массовой рассылке писем с вложениями через Microsoft Dynamics CRM 2011 некоторые получатели не могли просмотреть его содержимое - они видели только текст письма, а вложение заменялось на файл "winmail.dat" (как варианты: "ATT00008.dat" или "ATT00005.eml").

Причина этого - TNEF (Transport Neutral Encapsulation Format) - формат упаковки писем от Microsoft, который не поддерживается в полном объёме производителями сторонних почтовых серверов и клиентов.

Рекомендации Microsoft для таких случаев никак не помогали. Не помогало также принудительное выставление типа контента письма в text/html в коде формирования email - Outlook упорно отправлял письма с Content-Type: application/ms-tnef; name="winmail.dat".

Судя по всему, увидев письмо из CRM клиент для Outlook автоматически добавляет в него служебную информацию для отслеживания, конвертируя письмо в TNEF. Избежать такого вмешательства помогло выставление свойства "Доступ к электронной почте - исходящие" в "Маршрутизатор электронной почты" на форме пользователя CRM:

После чего письма отправляются получателям минуя Outlook с помощью Email Router'а и приходят как Content-Type: multipart/mixed;.

Язык Русский

Метки:

field_vote:

Average: 4 (28 votes)

Ошибка при автоматическом отслеживании электронной почты в CRM

Vladislav Osmanov — Wed, 23 Jun 2010 15:30:05 +0000

При включенной опции автоматического отслеживания писем из Outlook в CRM можно натолкнуться на ограничение размера отслеживаемого сообщения. Как правило, это выливается в множественные записи в Event Log на сервере CRM следующего содержания:

Event code: 3004 
Event message: Размер переданного сообщения превысил допустимые пределы. 
Event time: 01.04.2010 11:31:41 
Event time (UTC): 01.04.2010 7:31:41 
Event ID: 3d8e6db79e3c4e62b1979042fe4f277e 
Event sequence: 1289 
Event occurrence: 5 
Event detail code: 0 
 
Application information: 
    Application domain: /LM/W3SVC/1/ROOT-1-192541787253113666 
    Trust level: Full 
    Application Virtual Path: / 
    Application Path: C:\Program Files\Microsoft Dynamics CRM\CRMWeb\ 
    Machine name: crmserver 
 
Process information: 
    Process ID: 3400 
    Process name: w3wp.exe 
    Account name: NT AUTHORITY\NETWORK SERVICE 
 
Exception information: 
    Exception type: HttpException 
    Exception message: Превышена максимальная длина запроса. 
 
Request information: 
    Request URL: 
Получаем ошибку о невозможности операции (размер превышает допустимое значение), но кнопка "Отслеживать в CRM" остаётся нажатой (так она выглядит для отслеживаемых писем).
Отжимаем кнопку "Отслеживать в CRM", повторно видим ошибку о невозможности отслеживания письма (пусть вас не пугает текст сообщения - проблема в размере вложения).
Всё, письмо остаётся в Outlook, причём Outlook Client для CRM перестаёт его "проталкивать" в CRM - ошибка на сервере пропадает.

Язык Русский

Метки:

field_vote:

Голосов пока нет

Использование механизма Smart Tag для интеграции приложений Microsoft Office с CRM

Vladislav Osmanov — Sun, 30 May 2010 14:40:19 +0000

Уникальные номера заказов, обращений и счетов очень мощный инструмент в Microsoft Dynamics CRM, которым просто необходимо пользоваться. Сейчас расскажу как с помощью небольшой разработки можно значительно улучшить взаимодействие офисных приложений с CRM, а, следовательно, повысить производительность работы с ними.

Для обработки информации и интеграции с внешними приложениями в Microsoft Office предусмотрен механизм смарт-тегов. Вы, возможно, не раз их видели, но не придавали особого значения. А ведь можно сделать так:

Объектная модель для смарт-тегов разделяет смарт-теги и действия, которые они выполняют. Это позволяет довольно гибко определять на что будет реагировать смарт-тег, и какое действие (действия) могут быть выполнены с распознанным тегом текстом.

Смарт-теги состоят из двух основных элементов:

распознаватель (recognizer) - отвечает за распознавание текстового фрагмента, ассоциированного с данным типом;
действие (action), которое будет выполнено при активизации смарт-тега (действий можно зарегистрировать несколько).

Простейший смарт-тег можно реализовать определив и распознаватель и действие в XML-файле:

<?xml version="1.0" encoding="utf-8" ?>
<FL:smarttaglist xmlns:FL="urn:schemas-microsoft-com:smarttags:list">
	<FL:name>Simple smart-tag test</FL:name> 
	<FL:lcid>1049</FL:lcid>
	<FL:description>Simple smart-tag test (all-in-one-XML)</FL:description>
	<FL:moreinfourl>C:\Program Files\Common Files\Microsoft Shared\Smart Tag\Lists" (предварительно закрыв все открытые приложения из состава Microsoft Office) можно начинать пользоваться смарт-тегом. В данном примере, распознаватель реагирует на одно из слов, перечисленных в теге "FL:termlist" через запятую. Для большей гибкости можно задать регулярное выражение - именно так мы и поступим при создании компонента смарт-тега для Micrisoft Dynamics CRM.
ВНИМАНИЕ: если вы создали и развернули компонент-смарт-тег, но в приложениях MS Office он себя никак не обозначает, скорее всего требуется влючить отображение сторонних смарт-тегов в настройках офиса. Для Outlook последовательность действий такова: в меню "Сервис" выбрать пункт "Параметры", на вкладке "Орфография" - кнопка "Орфография и автозамена":

затем в разделе "Правописание" - кнопка "Параметры автозамены", где в окне "Автозамена" на вкладке "Смарт-теги" выбрать опцию "Добавить смарт-теги к тексту" и отметить ваши смарт-теги:

Также возможно потребуется перезапустить ВСЕ активные приложения Microsoft Office (Word, Excel, Outlook...).
Итак, создаём распознаватели для нашего компонента:
CrmCaseSmartTagRecognizer.xml
<?xml version="1.0" encoding="utf-8" ?>
<FL:smarttaglist xmlns:FL="urn:schemas-microsoft-com:smarttags:list">
    <FL:name>CRM: Распознователь номеров обращений CRM</FL:name>
    <FL:description>Распознаёт номера обращений CRM, предлагает открыть соответствующую карточку обращения.</FL:description>
    <FL:lcid>1049</FL:lcid>
    <FL:smarttag type="urn:schemas-contoso-ru/crm#case">
        <FL:caption>Номер обращения CRM</FL:caption>
        <FL:re>
            <FL:exp>
                (CAS-\d{5}-\w{6})
            </FL:exp>
        </FL:re>
    </FL:smarttag>
</FL:smarttaglist>
и CrmOrderSmartTagRecognizer.xml
<?xml version="1.0" encoding="utf-8" ?>
<FL:smarttaglist xmlns:FL="urn:schemas-microsoft-com:smarttags:list">
    <FL:name>CRM: Распознователь номеров заказов CRM</FL:name>
    <FL:description>Распознаёт номера заказов CRM, предлагает открыть соответствующую карточку заказа.</FL:description>
    <FL:lcid>1049</FL:lcid>
    <FL:smarttag type="urn:schemas-contoso-ru/crm#order">
        <FL:caption>Номер заказа CRM</FL:caption>
        <FL:re>
            <FL:exp>
                (ORD-\d{5}-\w{6})
            </FL:exp>
        </FL:re>
    </FL:smarttag>
</FL:smarttaglist>
Помещаем эти файлы "C:\Program Files\Common Files\Microsoft Shared\Smart Tag\Lists\1049":

Интересно, что в данной реализации распознавателей нет описания действий - мы их реализуем в дополнительном компоненте. Также прошу обратить внимание на регулярные выражения - они соответствуют стандартным маскам номеров для Обращений и Заказов в CRM.
Теперь код компонента, реализующего действия данного смарт-тега (поиск в CRM обращений/заказов по их номерам). В данном случае, это COM-объекты:
using System;
using System.Text;
using System.Runtime.InteropServices;

namespace Contoso.Crm.OfficeSmartTags
{
    /// 
    /// Смарт-тэг для обработки номеров обращений CRM.
    /// 
    [ProgId("Contoso.Crm.Office.SmartTag.Case.Actions")]
    [ClassInterface(ClassInterfaceType.AutoDual)]
    [Guid("AEF4C5ED-C78A-438e-A420-DBEF7679BC26")]
    [ComVisible(true)]
    public class CrmCaseSmartTagAction : CrmSmartTagAction
    {
        protected override string TAG_NAME
        {
            get
            {
                return "urn:schemas-contoso-ru/crm#case";
            }
        }

        public override void InvokeVerb(int VerbID, string ApplicationName, object Target, Microsoft.Office.Interop.SmartTag.ISmartTagProperties Properties, string Text, string Xml)
        {
            string crmCaseFormUrl =
                "Базовый класс CrmSmartTagAction определён следующим образом:
using System;
using System.Text;
using Microsoft.Office.Interop.SmartTag;
using OfficeSmartTagSample;
using System.Runtime.InteropServices;

namespace Contoso.Crm.OfficeSmartTags
{
    /// 
    /// Базовый абстрактный класс для смарт-тэгов CRM.
    /// 
    [ComVisible(false)]
    public abstract class CrmSmartTagAction : ISmartTagAction
    {
        protected abstract string TAG_NAME
        {
            get;
        }

        protected CrmAdapter _crmAdapter = new CrmAdapter();

        #region ISmartTagAction Members

        public abstract void InvokeVerb(
            int VerbID, 
            string ApplicationName, 
            object Target, 
            ISmartTagProperties Properties, 
            string Text, 
            string Xml);

        public abstract string ProgId
        {
            get;
        }

        public int SmartTagCount
        {
            get
            {
                // Specify the number of smart tag types this recognizer supports.
                return 1;
            }
        }

        public abstract string get_Desc(int LocaleID);

        public abstract string get_Name(int LocaleID);

        public abstract string get_SmartTagCaption(int SmartTagID, int LocaleID);

        /// 
        /// The most important aspect of this class is the implementation of the read-only 
        /// property SmartTagName. 
        /// This property evaluates to "urn:schemas-contoso-ru/crm#order" which is identical 
        /// to the namespace definition in the XML recognizer. 
        /// It provides the link between this Action class and the regular expression recognizer.
        /// 
        /// 
        /// 
        public string get_SmartTagName(int SmartTagID)
        {
            return TAG_NAME;
        }

        public abstract string get_VerbCaptionFromID(int VerbID, string ApplicationName, int LocaleID);

        public int get_VerbCount(string SmartTagName)
        {
            return 1;
        }

        public int get_VerbID(string SmartTagName, int VerbIndex)
        {
            return 1;
        }

        public abstract string get_VerbNameFromID(int VerbID);

        #endregion
    }
}
Класс для обработки заказов аналогичен CrmCaseSmartTagAction, и отличается только возвращаемой строкой с путём к найденному заказу (см. CRM SDK: URL Addressable Forms and Views).
ВНИМАНИЕ: не забудьте подписать полученную сборку!
Теперь осталось только зарегистрировать даный компонент, а регистрация, пожалуй, самый сложный этап создания смарт-тега. Состоит из двух шагов:

Регистрация COM-объекта с реализацией действий наших смарт-тегов.
Регистрация обработчика действий в Microsoft Office - через создание соответствующих ключей в реестре.

Более подробно про регистрацию можно прочитать в материалах, ссылки на которые приведены в конце статьи.
Для себя же я решил проблему регистрации сборок смарт-тегов через создание инсталлятора. Вот три основных момента:
Регистрация COM

Копирование XML с распознавателями

Создание в реестре соответствующих ключей

 
Вот, пожалуй, и всё. После успешной регистрации и включения смарт-тегов в параметрах приложений Microsoft Office номера обращений и заказов станут распознаваться в этих приложениях:



 
Дополнительные ссылки:

Общие сведения о смарт-тегах
Архитектура смарт-тегов
Смарт-тег для расширения меню пользователя Microsoft Outlook
Практическое руководство. Разрешение смарт-тегов в Word и Excel
Developing Simple Smart Tags
Regular Expression Support in Microsoft Office System Smart Tags

Язык Русский

Метки:

field_vote:

Average: 4.8 (35 votes)

«РќРѕРІС‹...» вместо имени записи в ссылке письма

Vladislav Osmanov — Sun, 25 Apr 2010 13:15:47 +0000

В четвёртой версии Microsoft Dynamics CRM появился очень удобная функция - отправка ссылки на любую запись в элетронном письме.

Но, зачастую, название записи вставлялось в письмо некорректно (как «РќРѕРІС‹...»).

Чтобы исправить эту ситуацию необходимо в настройках Outlook включить поддержку кодировки UTF-8 для протокола mailto: (отключена по умолчанию):

Язык Русский

Метки:

field_vote:

Average: 3 (1 vote)