Поделиться через

Настройка Dynamics CRM в действии копирования

  • Статья

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

Необходимые компоненты

Чтобы использовать этот соединитель с проверкой подлинности участника-службы Entra ID, необходимо настроить проверку подлинности "сервер — сервер" (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.
  • Альтернативное имя ключа: укажите альтернативное имя ключа, определенное для сущности, для записей upsert.
  • Игнорировать значения NULL: указывает, следует ли игнорировать значения NULL из входных данных во время операции записи. По умолчанию он не выбирается.
    • При выборе: оставьте данные в целевом объекте без изменений при выполнении операции upsert/update и вставьте определенное значение по умолчанию при выполнении операции вставки.
    • Если он не выбран: обновите данные в целевом объекте до NULL при выполнении операции upsert/update и вставьте значение NULL при выполнении операции вставки.
  • Размер пакета записи: укажите количество строк, записанных в Dynamics CRM в каждом пакете.
  • Максимальное число одновременных подключений: верхний предел одновременных подключений, установленных в хранилище данных во время выполнения действия. Указывайте значение только при необходимости ограничить количество одновременных подключений.

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

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

Настройки

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

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

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

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

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

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

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

Связанный контент