Утилитки
01
Июн
0

MSCRM ToolKit

MSCRM ToolKit – довольно большой набор полезных инструментов для работы с MS CRM (почти) на все случаи жизни:

  • Reference Data Transporter – инструмент для переноса бизнес-данных между различным средами CRM;
  • N:N Associations Transporter – инструмент для переноса связей N:N между различным средами CRM;
  • Data Export Manager – инструмент для экспорта данных из CRM в различных форматах: XML, XML Spreadsheet 2003, CSV;
  • Export Entities Structure – инструмент для экспорта метаданных (объекты, атрибуты, связи и схемы) из CRM;
  • Deployment Properties (On-Premise only) – инструмент для изменения свойств развертывания сервера CRM;
  • Solutions Transporter – инструмент для переноса Решений между различным средами CRM;
  • Solutions Import Jobs Viewer – инструмент для просмотра Solutions Import jobs в CRM;
  • Workflow Execution Manager – инструмент для запуска Бизнес-процессов в CRM;
  • Records Counter – инструмент для подсчета записей в CRM;
  • Audit Export Manager – инструмент для экспорта записей аудита Контрольных из CRM.

Установка:

  • Скачайте и запустите MSCRM ToolKit. Главное окно MSCRM ToolKit – панель инструментов, с которого запустить различные приложения. Основные пункты меню главного окна:
    • Connections Manager – менеджер соединений с CRM;
    • Tools – содержит перечень всех инструментов;
    • Log – просмотр лога работы приложения.
  • Первое, что нужно сделать – создает соединение с CRM – щелкните по пункту меню Connections Manager и настройте соединение к CRM.
    Примечание: в поле с адресом сервера вводите полный URL к организации, включая завершающий слэш (http://myserver/myorg/);


Далее посмотрим на отдельные инструменты…

Reference Data Transporter

Reference Data Transporter может использоваться для переноса данных (как бизнес-данных, так и настроечных) между средами CRM (разработческой, тестовой, продуктивной). Причем как в автоматическом режим, так и полу-автоматическом.

Сначала необходимо определить Transportation Profile, который обладает следующими параметрами:

  • Имя профиля;
  • Операция:
    • Экспорт данных: выгрузка данных из исходной среды;
    • Импорт данных: загрузка ранее выгруженных данных в целевую среду;
    • Транспортировка данных: переносит (выгружает и загружает) данные из исходной среды в целевую.
  • Исходная система (из которой берем данные);
  • Целевая система (куда загружаем данные);
  • Режим импорта:
    • Создание: инструмент будет только создавать записи в целевой среду. Если запись уже будет существовать в целевой среду, то попытка создания закончится неудачей;
    • Создание или Обновление: инструмент попытается создать запись во время импорта в целевую среду. Если запись уже будет существовать, то она не создастся;
    • Обновление: инструмент будет только пытаться обновить запись во время импорта в целевую среду. Если запись не существует в целевой среде, то попытка обновления потерпит неудачу.
  • Щелкнув по кнопке Records Mapping, Вы можете сопоставить записи в исходной и целевой системах (задав GUID обоих). Например, у Вас на карточке указано головное Подразделение. При переезде в новую среду GUID у головного подразделения может быть другой (как и его название). Чтобы инструмент правильно идентифицировал целевуе подразделение, здесь и задается сопоставление между их GUID’ами;
  • Список объектов, данные по которым будут транспортироваться (подгружается по кнопке Load Source Structure):
    • Необходимо определить порядок транспортировки объектов;
    • Для каждого объекта по умолчанию будут транспортироваться все атрибуты всех записей. При этом Вы можете задать (по кнопку «…») для каждого объекта атрибут из FetchXML, чтобы отобрать только определенные записи, а также сузить набор транспортируемых атрибутов.
  • Сохраните Transportation Profile (File -> Save или Ctrl+S).

Примечание: для данного инструмента важен порядок транспортировки. Например, если в Контакте указывается Организация, то Вы должны сначала импортировать Организацию, а затем уже Контакт.

Нажмите Run Profile, чтобы запустить текущий профиль.

По окончании работы Вы можете посмотреть отчет с результатами нажав кнопку Transport Report. Если во время импорта будут ошибки, то посмотреть список всех ошибок можно нажав кнопку Failures Report.



Созданные профили хранятся в папке ReferenceDataTransporter, в которой для каждого профиля предусмотрена отдельная папка. Каждый профиль содержит две вложенные папки:

  • Data: содержит данные всех экспортируемых объектов профиля;
  • ExecutionReports: содержит отчеты о запусках профиля.

Вы можете запустить выполнение определенного Transportation Profile через командную строку с помощью утилиты MSCRMReferenceDataTransporterCMD.exe (находится в папке MSCRM ToolKit). При ее запуске будут перечислены созданные профили, среди которых Вам необходимо выбрать один для запуска. Также можете передать название профиля как параметр при запуске утилиты, чтобы сразу выполнить его.

N:N Associations Transporter

The N:N Associations Transporter это аналог Reference Data Transporter за тем исключением, что он экспортирует/импортирует/переносит связи N:N (которые Вам нужно выбрать при настройке профиля). Чтобы импорт и перенос удался GUID’ы записей в исходной и целевой системе должны совпадать. Поэтому имеет смысл использовать его после Reference Data Transporter.

Для запуска по расписанию используйте утилиту MSCRMNtoNAssociationsTransportManagerCMD.exe.

Созданные профили будут сохранены в папке NtoNAssociationsTransporter.

Data Export Manager

Data Export Manager предназначен для экспорта данных из CRM в трех возможных форматах:

  • XML
  • XML Spreadsheet 2003
  • CSV

Как и в предыдущих случаях, сначала необходимо завести профиль со следующими параметрами:

  • Имя профиля;
  • Подключение к CRM;
  • Выгружаемый формат;
  • Кодировка:
    • Default
    • UTF8
    • Unicode
    • ASCII
    • BigEndianUnicode
  • FetchXML запрос, который будет использоваться для отбора данных.

Запустите профиль. После выполнения Вы сможете ознакомиться с результатами по кнопке Data Export Report.


Инструмент запускаете из командной строки с помощью утилиты MSCRMDataExportManagerCMD.exe. Созданные профили хранятся в папке DataExportManager.

Export Entities Structure

Export Entities Structure может использоваться для экспорта метаданных CRM:

  • Матаданные объектов;
  • Матаданные атрибутов;
  • Метаданные связей;
  • Поля, выведенные на форму объектов;
  • Диаграмма связей.
    Примечание: для формирования диаграммы на машину, на которой запускается инструмент, необходимо установить Microsoft Visio 2010.

После запуска инструмента:

  • Укажите подключение к CRM;
  • Подтяните метаданные из CRM прежде, чем экспортировать структуру;
  • Далее в зависимости от того, что Вы хотите выгрузить:
    • Объекты и атрибуты:
      • Выделите необходимые объекты;
      • Отметьте метаданные, которые Вам нужны;
      • Нажмите Export Structure.
    • Связи N:N:
      • Выделите необходимые объекты (которые содержат интересующие Вас связи N:N);
      • Нажмите кнопку N*N.
    • Диаграмма связей:
      • Выделите объекты, из которых необходимо построить диаграмму;
      • Нажмите Generate Diagrams.
    • Поля, расположенные на форме:
      • Выделите необходимые объекты;
      • Нажмите Fields on Forms.
        Это сгенерирует Excel файл, в котором строки – атрибуты объекта, а столбцы – формы объекта. На пересечении строк и столбцов будет флаг (True|False), если соответствующий атрибут будет выведен на какой-либо форме.


Примечание: объекты, атрибуты и связи N:N экспортируются в виде XML, который Вы можете открыть в Excel.

Deployment Properties

Deployment Properties используется для изменения свойств развертывания CRM.

С полным списком настраиваемых параметров можно ознакомится на следующей странице: http://msdn.microsoft.com/en-us/library/gg328128


Solutions Transporter

Solutions Transporter нужен для переноса Решений между средами CRM.

Настраиваем профиль:

  • Имя;
  • Операция: экспорт, импорт, перенос (из одной среды в другую);
  • Подключение к исходной и целевой среде CRM;
  • Папка на локальной машине, куда будут экспортироваться архивы Решений;
  • В каком виде экспортировать Решения: управляемом или неуправляемом;
  • Публикация всех настроек на исходной среде перед экспортом;
  • Что дополнительно включить в решение:
    • AutoNumbering
    • Calendar
    • Customization
    • EmailTracking
    • General (общие настройки)
    • Marketing
    • OutlookSynchronization.
    • RelationshipRoles
    • IsvConfig
  • Публикация всех настроек на целевой среде после импорта Решений;
  • Активация Бизнес-процессов и плагинов после импорта Решений;
  • Переопределение неуправляемых настроек на целевой среде при импорте Решений;
  • Выделите Решение, которые необходимо экспортировать/перенести.

Запустите профиль. После того как импорт выполнен, Вы можете использовать пункт Import logs, чтобы просмотреть результат импорта.


Для запуска инструмента по расписанию используйте утилиту MSCRMSolutionsTransporterCMD.exe. Созданные профили хранятся в папке SolutionsTransporter.

Solutions Import Jobs Viewer

Solutions Import Jobs Viewer используется для:

  • Просмотр состояний заданий на импорт Решений в CRM;
  • Загрузки файлов журналов импорта завершенных заданий на импорт Решений.

Чтобы просмотреть список заданий на импорт:

  • Выберите подключение;
  • Нажмите Load Solutions Import Jobs;
  • По кнопке Download log на каждой строке Вы можете открыть файл журнала импорта и открыть его в Excel.


Примечание: скаченные файлы журналов импорта сохраняются в папке SolutionsImportJobsViewer.

Workflow Execution Manager

Как можно понять по названию, Workflow Execution Manager используется для запуска БП (разовому или по расписанию).

Профиль для Workflow Execution Manager содержит следующие свойства:

  • Имя;
  • Подключение к CRM;
  • Выберите БП для выполнения;
  • FetchXML запрос, который отберёт записи, которые, в свою очередь будут скормлены выбранному БП.

После выполнения профиля по кнопочке Log можно просмотреть результаты.


По расписанию инструмент можно запустить с помощью утилиты MSCRMWorkflowExecutionManagerCMD.exe.

Records Counter

Records Counter подсчитывает количество записи для различных объектов CRM.

Для использования:

  • Загрузите структуру данных CRM;
  • Выберите объекты, которые нужно посчитать 🙂
  • Для каждого объекта Вы можете задать фильтр (атрибут из FetchXML запроса), чтобы отобрать только подмножество записей;
  • Жмите Get Records Number – в результате сгенерируется XML-файл (можно открыть в Excel), содержащий выбранные объекты и количество записей для них.


Примечание: по умолчанию подсчет записей ограничен 5000 записей. Этот лимит можно увеличить с помощью свойства AggregrateQueryRecordLimit в таблице Deployment Properties базы данных MSCRM_CONFIG.

Audit Export Manager

Audit Export Manager предназначен для экспорта данных аудита CRM.

Перед использованием Вам необходимо настроить профиль:

  • Имя;
  • Подключение к CRM;
  • Какой аудит хотим выгрузить:
  • Сводное представление аудита;
  • История изменения записи;
  • История изменений одного атрибута записи;
  • Общая история изменений с фильтрацией по операциям.
  • Формат экспорта:
    • CSV
    • XML
    • XML Spreadsheet 2003
  • Кодировка экспортируемого файла:
    • Default
    • UTF8
    • Unicode
    • ASCII
    • BigEndianUnicode
  • Фильтр по:
    • Дате;
    • Операциям;
    • Действиям;
    • Пользователям;
    • Объектам.

После выполнения появится кнопка выгрузки результата в Excel.


Из командной строки инструмент запускается с помощью утилиты MSCRMAuditExportManagerCMD.exe.

Комментарии (0)

*

code