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

Потоки Dynamics 365 Intelligent Order Management Power Automate

  • Статья

В этой статье представлен список потоков, доступных в составе Microsoft Dynamics 365 Intelligent Order Management. Эти потоки можно использовать для создания собственных пользовательских поставщиков или решений.

Потоки сопоставления

Создание сопоставления счетов

Поток Создание сопоставления счетов позволяет создать сопоставление счетов клиентов, которое использует указанное имя внешнего поля и значение внешнего поля для поиска, чтобы выполнить обратное сопоставление с идентификатором счета.

Параметр Наименование Обязательное поле
ИД поставщика Идентификатор поставщика, для которого предназначено сопоставление. Истина
Идентификатор группы сопоставлений Идентификатор группы сопоставления, для которой предназначается сопоставление. Истина
Код счета Идентификатор счета для возврата при обнаружении совпадения. Истина
Имя внешнего поля Имя поля, для которого проверяется значение во внешнем источнике данных. Истина
Значение внешнего поля Значение поля для сравнения во внешнем источнике данных. Истина

Сопоставление возвращает ИД счета, независимо от того, был он только что создан или уже существует.

Примечание

Это значение является идентификатором сопоставления, а не счетом.

Создать сопоставление контактов

Поток Создать сопоставление контактов позволяет создать сопоставление контактов клиентов, которое использует указанное имя внешнего поля и значение внешнего поля для поиска, чтобы выполнить обратное сопоставление с идентификатором контакта.

Параметр Наименование Обязательное поле
ИД поставщика Идентификатор поставщика, для которого предназначено сопоставление. Истина
Идентификатор группы сопоставлений Идентификатор группы сопоставления, для которой предназначается сопоставление. Истина
Код контактного лица Идентификатор контакта для возврата при обнаружении совпадения. Истина
Имя внешнего поля Имя поля, для которого проверяется значение во внешнем источнике данных. Истина
Значение внешнего поля Значение поля для сравнения во внешнем источнике данных. Истина

Сопоставление возвращает ИД контакта, независимо от того, был он только что создан или уже существует.

Примечание

Это значение является идентификатором сопоставления, а не контактом.

Создать сопоставление заказов на выполнение

Поток Создать сопоставление заказов на выполнение позволяет создать сопоставление заказов на выполнение, которое использует указанное имя внешнего поля и значение внешнего поля для поиска, чтобы выполнить обратное сопоставление с идентификатором заказа на выполнение.

Параметр Наименование Обязательное поле
ИД поставщика Идентификатор поставщика, для которого предназначено сопоставление. Истина
Идентификатор группы сопоставлений Идентификатор группы сопоставления, для которой предназначается сопоставление. Истина
ИД заказа на выполнение Идентификатор заказа на выполнение для возврата при обнаружении совпадения. Истина
Имя внешнего поля Имя поля, для которого проверяется значение во внешнем источнике данных. Истина
Значение внешнего поля Значение поля для сравнения во внешнем источнике данных. Истина

Сопоставление возвращает ИД сопоставления заказа на выполнение, независимо от того, был он только что создан или уже существует.

Примечание

Это значение является идентификатором сопоставления, а не заказом на выполнение.

Создать сопоставление продуктов заказов на выполнение

Поток Создать сопоставление продуктов заказов на выполнение позволяет создать сопоставление продуктов заказов на выполнение, которое использует указанное имя внешнего поля и значение внешнего поля для поиска, чтобы выполнить обратное сопоставление с идентификатором продукта заказа на выполнение.

Параметр Наименование Обязательное поле
ИД поставщика Идентификатор поставщика, для которого предназначено сопоставление. Истина
Идентификатор группы сопоставлений Идентификатор группы сопоставления, для которой предназначается сопоставление. Истина
Идентификатор продукта заказа на выполнение Идентификатор продукта заказа на выполнение для возврата при обнаружении совпадения. Истина
Имя внешнего поля Имя поля, для которого проверяется значение во внешнем источнике данных. Истина
Значение внешнего поля Значение поля для сравнения во внешнем источнике данных. Истина

Сопоставление возвращает ИД сопоставления продукта заказа на выполнение, независимо от того, был он только что создан или уже существует.

Примечание

Это значение является идентификатором сопоставления, а не продуктом заказа на выполнение.

Создать сопоставление заказов

Поток Создать сопоставление заказов позволяет создать сопоставление заказов, которое использует указанное имя внешнего поля и значение внешнего поля для поиска, чтобы выполнить обратное сопоставление с заказом.

Параметр Наименование Обязательное поле
ИД поставщика Идентификатор поставщика, для которого предназначено сопоставление. Истина
Идентификатор группы сопоставлений Идентификатор группы сопоставления, для которой предназначается сопоставление. Истина
ИД заказа Идентификатор заказа для возврата при обнаружении совпадения. Истина
Имя внешнего поля Имя поля, для которого проверяется значение во внешнем источнике данных. Истина
Значение внешнего поля Значение поля для сравнения во внешнем источнике данных. Истина

Сопоставление возвращает ИД сопоставления заказа, независимо от того, был он только что создан или уже существует.

Примечание

Это значение является идентификатором сопоставления, а не заказом.

Получить внешнее сопоставление

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

Параметр Наименование Обязательное поле
Таблица сопоставления Таблица сопоставления, в которой выполняется поиск внешнего значения. Истина
ИД поставщика Идентификатор поставщика, для которого предназначено сопоставление. Истина
Идентификатор группы сопоставлений Идентификатор группы сопоставления, для которой предназначается сопоставление. Истина
Значение внутренней записи Значение, используемое в качестве внутреннего для сопоставления. Истина
Имя внешнего поля Имя поля, для которого проверяется значение во внешнем источнике данных. Истина

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

Получить внутреннее сопоставление

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

Параметр Наименование Обязательное поле
Таблица сопоставления Таблица сопоставления, в которой выполняется поиск внешнего значения. Истина
ИД поставщика Идентификатор поставщика, для которого предназначено сопоставление. Истина
Идентификатор группы сопоставлений Идентификатор группы сопоставления, для которой предназначается сопоставление. Истина
Имя внешнего поля Имя поля, для которого проверяется значение во внешнем источнике данных. Истина
Значение внешнего поля Значение, используемое в качестве внешнего для сопоставления. Истина

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

Потоки выполнения

Создать отслеживание выполнения

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

Параметр Наименование Обязательное поле
Номер отслеживания Номер отслеживания, который требуется задать для записи. Истина
CarrierRecordId Соответствующая запись из таблицы Перевозчик. Истина
CarrierServiceId Соответствующая запись из таблицы Услуга перевозчика. Истина
FulfillmentOrderRecordId Запись заказа на выполнение, для которой требуется задать номер отслеживания. Ложь
FulfillmentLineRecordId Запись строки заказа на выполнение, для которой требуется задать номер отслеживания. Ложь
ShipmentId Связанный код отгрузки, если он доступен. Ложь
ShipmentCost Связанная стоимость отгрузки, если она доступна. Ложь
InsuranceCost Связанные затраты на страхование, если они доступны. Ложь
Налог Связанный налог, если он доступен. Ложь
SurchargeFee Связанная дополнительная комиссия, если она доступна. Ложь
FulfillmentReturnOrderRecordId Запись заказа на возврат выполнения, для которой требуется задать номер отслеживания. Ложь

Примечание

Одно из значений FulfillmentOrderRecordId или FulfillmentReturnOrderRecordId является обязательным.

Поток возвращает код номера отслеживания из таблицы Отслеживания выполнения.

Строка выполнения и события агрегированных заказов

Поток Строка выполнения и события агрегированных заказов создает бизнес-событие в строке заказа на выполнение. При возникновении этого события выполняется проверка, чтобы убедиться, что все строки имеют одинаковый статус. Если они имеют одинаковый статус, указанное бизнес-событие уровня заказа на выполнение создается на уровне заголовка.

Параметр Наименование Обязательное поле
FulfillmentLineBusinessEventDefinitionId Бизнес-событие, которое должно вызываться для сущности строки. Истина
FulfillmentLineRecordId Строка заказа на выполнение, для которой создается исходное бизнес-событие. Истина
FulfillmentOrderBusinessEventDefinitionId Бизнес-событие, которое должно создаваться для заказа на выполнение, если все строки имеют одинаковый статус. Истина
FulfillmentOrderRecordId Заказ на выполнение, для которого создается бизнес-событие. Истина
Полезные данные Дополнительные полезные данные JSON, которые передаются вместе с бизнес-событием. Ложь

Поток возвращает значение IsSuccessful true, если бизнес-событие было успешно создано.

Потоки учетных записей и контактов клиентов

Создание или изменение учетной записи

Поток Создание или изменение учетной записи создает или обновляет существующую учетную запись на основе указанных полезных данных JSON.

Параметр Наименование Обязательное поле
Полезные данные Представление JSON для учетной записи. Истина
Код счета Идентификатор обновляемой учетной записи. Ложь

Примечание

Таблица Учетная запись содержит отдельные поля, необходимые в полезной нагрузке JSON. Чтобы увидеть, какие поля являются обязательными, перейдите в раздел Dataverse>Таблицы>Все, найдите вашу таблицу и выберите Столбцы. Используйте поле Обязательный для определения, что требуется.

Поток возвращает идентификатор созданной или обновленной учетной записи.

Создание или изменение контакта

Поток Создание или изменение контакта создает или обновляет существующий контакт на основе указанных полезных данных JSON.

Параметр Наименование Обязательное поле
Полезные данные Представление JSON для контакта. Истина
Код контактного лица Идентификатор обновляемой учетной записи. Ложь

Примечание

Таблица Контактное лицо содержит отдельные поля, необходимые в полезной нагрузке JSON. Чтобы увидеть, какие поля являются обязательными, перейдите в раздел Dataverse>Таблицы>Все, найдите вашу таблицу и выберите Столбцы. Используйте поле Обязательный для определения, что требуется.

Поток возвращает идентификатор созданной или обновленного контактного лица.

Потоки заказов и потоки продуктов заказов

Создание заказа на продажу

Поток Создание заказа на продажу создает заказ на продажу на основе указанных полезных данных JSON.

Параметр Наименование Обязательное поле
Полезные данные Представление JSON заказа на продажу и строк. Истина
ProviderId Идентификатор вызывающего поставщика. Ложь

Примечание

Как Таблица заказов, так и Таблица строк имеют отдельные поля, необходимые в полезных данных JSON. Чтобы увидеть, какие поля являются обязательными, перейдите в раздел Dataverse>Таблицы>Все, найдите вашу таблицу и выберите Столбцы. Используйте поле Обязательный для определения, что требуется.

Поток возвращает идентификатор созданного заказа на продажу.

Создание строк и событий агрегированных заказов

Поток Создание строк и событий агрегированных заказов создает бизнес-событие в строке заказа на продажу. При возникновении этого события выполняется проверка, чтобы убедиться, что все строки имеют одинаковый статус. Если они имеют одинаковый статус, указанное бизнес-событие уровня заказа создается на уровне заголовка.

Параметр Наименование Обязательное поле
LineBusinessEventId Бизнес-событие, которое должно вызываться для сущности строки. Истина
LineRecordId Строка заказа, для которой создается исходное бизнес-событие. Истина
OrderBusinessEventId Бизнес-событие, которое должно создаваться для заказа, если все строки имеют одинаковый статус. Истина
OrderRecordId Заказ, для которого создается бизнес-событие. Истина
Полезные данные Дополнительные полезные данные JSON, которые передаются вместе с бизнес-событием. Ложь

Поток возвращает значение IsSuccessful true, если бизнес-событие было успешно создано.

Создание бизнес-события строк заказа на продажу

Поток Создание бизнес-события строк заказа на продажу создает бизнес-событие для всех строк заказа на продажу.

Параметр Наименование Обязательное поле
SalesOrderId Запись заказа, для которой должно быть инициировано бизнес-событие для каждой строки. Истина
BusinessEventId Бизнес-событие строки заказа, которое создается для каждой строки. Истина

Поток возвращает значение IsSuccessful true, если бизнес-событие было успешно создано.

Пересчет ед. изм.

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

Параметр Наименование Обязательное поле
Количество Количество для преобразования. Истина
Из единицы Единица измерения, из которой производится пересчет. Истина
В ед. изм. Единица измерения, в которую осуществляется пересчет. Истина

Поток возвращает преобразование единиц измерения, если существует преобразование.

Разные потоки

Средство преобразования поставщиков

Поток Средство преобразования поставщиков применяет преобразование Power Query, определенное для поставщика, а затем возвращает преобразованные данные. Этот поток выполняет поиск активного экземпляра поставщика по идентификатору и проверяет преобразование с совпадающим именем объекта-источника и именем целевого объекта.

Если типом преобразования является сущность Dataverse, необходимо указать код записи. Представленный код записи ищется для сущности, которая определена для преобразования. Если запись найдена, она используется для преобразования.

Если типом преобразования является JsonPayload, для параметра Полезные данные необходимо ввести значение.

Параметр Наименование Обязательное поле
ИД поставщика Любой действительный глобально уникальный идентификатор (GUID). Истина
Имя исходного объекта Имя объекта-источника для поиска в преобразованиях поставщика. Истина
Имя объекта назначения Имя объекта-назначения для поиска в преобразованиях поставщика. Истина
Полезные данные Полезные данные JSON для преобразования, если тип преобразования JsonPayload. Ложь
ИД записи Запись для поиска сущности, которая связана с преобразованием. Ложь

Примечание

Необходимо указать либо значение Полезная нагрузка, либо ИД записи.

Значение Идентификатор поставщика — это GUID, который заменяется при активации поставщика. Можно ввести любой GUID для этого параметра.

Если поток выполнен успешно, возвращается JSON-представление преобразованной записи.

Создание бизнес-события

Поток Создание бизнес-события создает бизнес-событие для указанной записи сущности и доставляет дополнительные полезные данные.

Параметр Наименование Обязательное поле
BusinessEventDefinitionId GUID существующего бизнес-события. Истина
EntityRecordId Идентификатор записи сущности, которая связана с бизнес-событием. Истина
Полезные данные Дополнительные полезные данные для доставки вместе с бизнес-событием. Ложь

Примечание

Значением EntityRecordId может быть список идентификаторов записей с разделителями-запятыми. Если предоставляется список с разделителями, для каждой записи создается бизнес-событие.

Поток возвращает значение IsSuccessful true, если бизнес-событие было успешно создано.