Как настроить Dynamics CRM в операции копирования

В этой статье описывается, как использовать действие копирования в конвейере для копирования данных из Dynamics CRM и обратно.

Предварительные условия

Чтобы использовать этот соединитель с аутентификацией сервисного принципала Microsoft Entra, необходимо настроить аутентификацию между серверами (S2S) в Dynamics CRM. Сначала зарегистрируйте учетную запись службы (пользователя приложения) в Microsoft Entra. Дополнительные сведения см. в статье "Создание приложения Microsoft Entra и субъекта-службы, которые могут получать доступ к ресурсам".

Во время регистрации приложения необходимо создать этого пользователя в Dynamics CRM и предоставить разрешения. Эти разрешения можно предоставить напрямую или косвенно, добавив пользователя приложения в команду, которая была предоставлена разрешения в Dynamics CRM. Дополнительные сведения о настройке пользователя приложения для проверки подлинности с помощью Dynamics CRM см. в статье "Использование однотенантной проверки подлинности между серверами и серверами".

Поддерживаемая конфигурация

Для настройки каждой вкладки в действии копирования перейдите к следующим разделам соответственно.

Общие

Для настройки вкладки "Общие" перейдите к общим параметрам.

Источник

Перейдите на вкладку "Источник" , чтобы настроить источник действия копирования. См. следующее содержимое для подробной конфигурации.

Требуются следующие свойства:

  • Подключение. Выберите существующее подключение Dynamics CRM из списка подключений. Если подключение не существует, создайте новое подключение Dynamics CRM, нажав кнопку "Создать".
  • Тип подключения: выберите Dynamics CRM.
  • Используйте запрос: укажите способ, используемый для чтения данных. Вы можете выбрать имя сущности для чтения данных с его помощью или запрос для использования запроса для чтения данных.
    • Имя сущности: выберите имя сущности из раскрывающегося списка или нажмите кнопку "Изменить ", чтобы ввести ее вручную. Это логическое имя сущности, которую нужно извлечь.

    • Запрос. Использование FetchXML для чтения данных из Dynamics CRM. FetchXML — это защищаемый язык запросов, используемый в Dynamics Online и локальной версии Dynamics. См. следующий пример. Дополнительные сведения см. в разделе Создание запросов с помощью FetchXML.

      Пример запроса FetchXML:

      <fetch>
        <entity name="account">
          <attribute name="accountid" />
          <attribute name="name" />
          <attribute name="marketingonly" />
          <attribute name="modifiedon" />
          <order attribute="modifiedon" descending="false" />
          <filter type="and">
            <condition attribute ="modifiedon" operator="between">
              <value>2017-03-10 18:40:00z</value>
              <value>2017-03-12 20:40:00z</value>
            </condition>
          </filter>
        </entity>
      </fetch>
      

В разделе "Дополнительно" можно указать следующие поля:

  • Дополнительные столбцы: добавление дополнительных столбцов данных для хранения относительного пути или статического значения исходных файлов. Выражение поддерживается для последнего.

Назначение

Перейдите на вкладку "Назначение" , чтобы настроить назначение действия копирования. См. следующее содержимое для подробной конфигурации.

Требуются следующие свойства:

  • Подключение. Выберите существующее подключение Dynamics CRM из списка подключений. Если подключение не существует, создайте новое подключение Dynamics CRM, нажав кнопку "Создать".
  • Тип подключения: выберите Dynamics CRM.
  • Имя сущности: укажите имя сущности для записи данных. Выберите имя сущности в раскрывающемся списке или нажмите кнопку "Изменить ", чтобы ввести ее вручную. Это логическое имя сущности, которую необходимо извлечь.

В разделе "Дополнительно" можно указать следующие поля:

  • Поведение записи: характер выполнения операции записи. Это свойство необходимо, и необходимо выбрать Upsert. Если вы используете добавление динамического содержимого, укажите значение Upsert.
  • Альтернативное имя ключа: укажите альтернативное имя ключа, определенное для вашей сущности, чтобы вставлять или обновлять записи.
  • Игнорировать значения NULL: указывает, следует ли игнорировать значения NULL из входных данных во время операции записи. По умолчанию он не выбирается.
    • При выборе: оставьте данные в целевом объекте без изменений при выполнении операции upsert/update и вставьте определенное значение по умолчанию при выполнении операции вставки.
    • Если он не выбран: обновите данные в целевом объекте до NULL при выполнении операции upsert/update и вставьте значение NULL при выполнении операции вставки.
  • Размер партии записи: Укажите количество строк данных, записанных в Dynamics CRM в каждой партии.
  • Максимальное число одновременных подключений: верхний предел одновременных подключений, установленных в хранилище данных во время выполнения действия. Указывайте значение только при необходимости ограничить количество одновременных подключений.

Сопоставление

Чтобы настроить вкладку "Сопоставление", перейдите на вкладку "Настройка сопоставлений".

Настройки

Для конфигурации вкладки "Параметры" перейдите к разделу "Настройка других параметров" на вкладке "Параметры".

Сводка таблицы

Дополнительную информацию и краткое описание действия копирования Dynamics CRM см. в следующей таблице.

Сведения об источнике

Имя Описание Значение Обязательное поле Свойство скрипта JSON
Соединение Подключение к исходному хранилищу данных. < ваше подключение к Dynamics CRM > Да подключение
Тип подключения Тип подключения. Dynamics CRM Да типа (под typeProperties ->source ->datasetSettings):
DynamicsCrmEntity
Использование запроса Способ чтения данных из Dynamics CRM *Таблицы
*Запрос
Да /
имя сущности Логическое имя сущности, которое требуется получить. < имя объекта > Да entityName
Запрос Используйте FetchXML для чтения данных из Dynamics CRM. FetchXML — это защищаемый язык запросов, используемый в Dynamics Online и локальной версии Dynamics. Дополнительные сведения см. в разделе Создание запросов с помощью FetchXML. < запрос > Да запрос
Дополнительные столбцы Добавьте дополнительные столбцы данных для хранения относительного пути или статического значения исходных файлов. Выражение поддерживается для последнего. *Имя
*Ценность
Нет дополнительныеКолонки:
*имя
*ценность

Сведения о назначении

Имя Описание Значение Обязательное поле Свойство скрипта JSON
Соединение Ваше подключение к назначенной системе Dynamics CRM. < подключение > Да подключение
Тип подключения Тип подключения. Dynamics CRM Да типа (под typeProperties ->sink ->datasetSettings):
DynamicsCrmEntity
Имя сущности Логическое имя сущности, которое требуется получить. < ваша сущность > Да entityName
Режим записи Характеристика операции при записи. Значение должно быть Upsert. Upsert Да writeBehavior: upsert (обновление или вставка)
Альтернативное имя ключа Альтернативное имя ключа, определенное в вашей сущности для обновления или добавления записей. < альтернативное имя ключа > Нет альтернативноеИмяКлюча
Игнорировать значения NULL Указывает, следует ли игнорировать значения NULL из входных данных во время операции записи.
— Выбрано (true): оставьте данные в целевом объекте без изменений при выполнении операции upsert/update и вставьте определенное значение по умолчанию при выполнении операции вставки.
— Unselected (false): обновите данные в целевом объекте до NULL при выполнении операции upsert/update и вставьте значение NULL при выполнении операции вставки.
выбран или не выбран (по умолчанию) Нет ignoreNullValues:
true или false (по умолчанию)
Размер пакета записи Количество строк, записанных в Dynamics CRM в каждом пакете. < размер пакета записи >
Значение по умолчанию — 10
Нет writeBatchSize
Максимальное число одновременных подключений Верхний предел одновременных подключений, устанавливаемых с хранилищем данных во время выполнения активности. Указывайте значение только при необходимости ограничить количество одновременных подключений. < максимальное число одновременных подключений > Нет МаксимальноеКоличествоОдновременныхСоединений