ソリューションを使用してチャネルの構成を移行する

注意

機能の可用性情報は次のとおりです。

Dynamics 365 Contact Center - 埋め込み Dynamics 365 Contact Center - スタンドアロン Dynamics 365 Customer Service

ソリューションと構成移行ツールを使用して、チャネルの構成をソース環境からターゲット環境に移行します。

ソリューションまたは構成移行ツールの使用方法については、ALM に使用されるツールとアプリの概要 Power Platform を参照してください。

前提条件

次の前提要件を満たす必要があります。

  • チャネル構成の移行を実行するユーザーに次の権限があることを確認してください。
    • ソース環境からソリューションをエクスポートする方法
    • インストール先の環境にソリューションをインポートする方法
    • 構成移行ツールを使用して移行元環境から移行されたすべてのテーブルの読み取り権限。
    • 構成移行ツールを使用して移行先環境に移行されたすべてのテーブルのフル権限。
  • 移行元環境で、以下のようなテーブルや列が参照されている場合、移行を進める前に移行先環境にそれらが存在することを確認してください:
    • カスタム テーブル (エンティティ)
    • 列 (属性)
    • 顧客間関係
    • 選択肢 (オプション セット)
    • 検索値

重要

取引先企業、チャネル プロバイダー、ボット構成、AI およびアナリティクス設定の移行は対象外です。

チャネル構成の移行手順

構成データを正常に移行するためには、記載されている順番に手順を実行する必要があります:

  1. セッション テンプレートと通知テンプレートの構成の移行
  2. スキルベースのルーティング ルールセットの構成の移行
  3. 新しいキャパシティ プロファイルの構成の移行
  4. キューの構成の移行
  5. チャネル ワークストリームとチャネル設定の構成の移行
  6. 移行を検証する

セッション テンプレートと通知テンプレートの構成の移行

チャネル ルーティング設定でカスタム セッション テンプレートと通知を使用する場合は、セッション テンプレートと通知テンプレートの構成を移行するで説明されている手順を実行します。

スキルベースのルーティング ルールセットの構成の移行

チャネル ルーティングの設定でスキルベース ルーティングのルールセットを使用している場合は、スキルベースのルーティング ルールセットの構成を移行する で説明した手順を実行してください。 移行するチャンネルに対して、フィルター FetchXML を適切に調整してください。

新しいキャパシティ プロファイルの構成の移行

チャネル ルーティングのセットアップで新しいキャパシティプロファイルを構成している場合は、キャパシティプロファイルのデータのエクスポートとインポートに記載されている手順を実行してください。 移行するすべてのチャンネルに対して、フィルター FetchXML を適切に調整してください。

チップ

構成移行ツールを使用して新しい容量プロファイルを移行した後、ソリューションを使用して更新を移行できます。

キューの構成の移行

チャネル キューを移行するには、キューの構成の移行 で説明されている手順を実行します。 移行するすべてのチャンネルに対して、フィルター FetchXML を適切に調整してください。

チャネル ワークストリームとチャネル設定の構成の移行

  1. ソリューションを介して移行できるすべてのワークストリームとチャネルの構成をソース環境からエクスポートするソリューションを作成します。

  2. コマンド バーの 既存の追加 ボタンを使用して、次のようにエクスポートする必要がある各チャネルの開始テーブルを選択し、必要なレコードをソリューションに追加します。

    Channel スターティング テーブル
    ライブ チャット チャット ウィジェット (msdyn_livechatconfig)
    音声 音声チャネル設定 (msdyn_ocvoicechannelsetting)
    SMS SMS番号設定 (msdyn_ocsmschannelsetting)
    WhatsApp WhatsApp 番号 (msdyn_ocwhatsappchannelnumber)
    WeChat WeChat アカウント (msdyn_ocwechatchannelconfig)
    Apple Messages for Business Apple Messages for Business アカウント (msdyn_ocapplebusinessaccount)
    Facebook 作業ストリーム (msdyn_liveworkstream)
    Google Business Messages 作業ストリーム (msdyn_liveworkstream)
    LINE 作業ストリーム (msdyn_liveworkstream)
    Microsoft Teams 作業ストリーム (msdyn_liveworkstream)
    カスタム チャネル 作業ストリーム (msdyn_liveworkstream)
  3. 各チャネルのチャネル定義テーブルからレコードを選択し、ソリューションに追加します。 次のテーブルからの関連レコードがソリューションに自動的に追加されます:

    Channel ソリューションに自動的に追加されたテーブル
    すべてのチャネル 作業ストリーム (msdyn_liveworkstream)
    キャパシティ プロファイル (msdyn_capacityprofile) – 新しいレコードは、構成移行ツールを使用して移行する必要があります
    作業ストリーム キャパシティ プロファイル (msdyn_liveworkstreamcapacityprofile)
    コンテキスト変数 (msdyn_ocliveworkstreamcontextvariable)
    意思決定契約 (msdyn_decisioncontract)
    決定ルールセット (msdyn_decisionruleset)
    ルーティング構成 (msdyn_routingconfiguration)
    ルーティング構成ステップ (msdyn_routingconfigurationstep)
    言語 (msdyn_oclanguage) – 音声とカスタム チャネルを除く
    ライブ チャット チャット ウィジェット (msdyn_livechatconfig)
    認証設定 (msdyn_authenticationsettings)
    アンケート回答オプション (msdyn_chatansweroption)
    アンケートの質問 (msdyn_surveyquestion)
    アンケートの質問順序 (msdyn_questionsequence)
    位置情報プロバイダー (msdyn_oc_geolocationprovider)
    営業時間 (msdyn_operatinghour)
    音声 音声チャネル設定 (msdyn_ocvoicechannelsetting)
    認証設定 (msdyn_authenticationsettings)
    音声 (msdyn_ocvoice)
    音声チャネル言語設定 (msdyn_ocvoicechannellanguagesetting)
    電話番号 (msdyn_ocphonenumber)
    コミュニケーション プロバイダーの設定 (msdyn_occommunicationprovidersetting)
    通信事業者 (msdyn_occarrier)
    電話の音楽 (msdyn_ocphonemusic)
    営業時間 (msdyn_operatinghour)
    SMS SMS番号設定 (msdyn_ocsmschannelsetting)
    電話番号 (msdyn_ocphonenumber)
    コミュニケーション プロバイダーの設定 (msdyn_occommunicationprovidersetting)
    通信事業者 (msdyn_occarrier)
    営業時間 (msdyn_operatinghour)
    WhatsApp WhatsApp のアカウント (msdyn_ocwhatsappchannelaccount)
    WhatsApp 番号 (msdyn_ocwhatsappchannelnumber)
    WeChat WeChat アカウント (msdyn_ocwechatchannelconfig)
    Apple Messages for Business Apple Messages for Business アカウント (msdyn_ocapplebusinessaccount)

    重要

    • ソリューションをエクスポートする前に、ソリューション コンポーネントを慎重に確認してください。 Azure Communication Services、サードパーティ チャンネル、または Copilot Studio コパイロット や Customer Voice Survey などの他の Microsoft コンポーネントに関する情報を含むレコードをメモして、宛先環境で必要な構成を作成できるようにします。
    • 1 つまたは複数のワークス トリームが同じキャパシティ プロファイルを共有している場合、1 つのチャネルまたはワークストリームからテーブルを追加すると、同じキャパシティ プロファイルを共有している他のチャネルまたはワークストリームのレコードとテーブルもソリューションに追加されます。
  4. 構成移行ツールを使用してスキーマを作成し、ワークストリームとチャネルの残りの構成データを移行元環境 (組織) から移行します。

    • エンティティ表示名: スキーマを作成するときは、次の表に示す順序でリストからテーブル (エンティティ) を選択します。
    • 属性表示名: テーブルに定義されている列 (属性) を選択することをお勧めします。 作成者作成日変更者変更日所有者 のような既成のシステム定義の列を選択する必要はありません。 必要に応じて、カスタム列を選択できます。
    • FetchXML を使用してレコードをフィルターする: 選択した各テーブルについて、次の表に示す適切な FetchXML クエリを使用して、要件に基づいて単一、複数、またはすべてのレコードを取得します。 単一行または複数行の場合、ソース環境を使用して uiname に正しい名前を、値に GUID を取得する必要があります。 必要に応じて、高度な検索 メニューの品目を使用して、適切な FetchXML クエリを作成することができます。
    • インポート設定を構成する: ワークストリーム テーブルでは、キー列のみを追加し、既存のレコードを更新しない チェックボックスを選択して、ソリューションによって移行されたテーブルのレコードが更新されないようにします。

    重要

    FacebookページGoogle's Business Messages のエージェントアカウントLINE アカウントカスタム メッセージング チャネルMicrosoft Teams アカウント テーブルについては、Survey (msdyn_postconversationsurvey) と Survey (msdyn_postconversationsurveyseparatebotsurvey) 列を含めないでください。この場合、Survey レコードは各環境で Dynamics 365 Customer Voice と同期されるため、環境間で移行できなくなります。

    Channels エンティティ表示名 (論理名) 属性表示名 (論理名) FetchXML を使用してレコードをフィルターする
    すべてのチャネル 作業ストリーム (msdyn_liveworkstream)
    • チャネル (msdyn_streamsource)
    • モード (msdyn_mode)
    • 名前 (msdyn_name)
    • 作業ストリーム (msdyn_liveworkstreamid)
    サンプル 1: チャネルのすべてのワークストリーム

    サンプル 2: 単体のワークストリーム

    サンプル 3: 複数のワークストリーム
    すべてのメッセージング チャネル クイック返信 (msdyn_cannedmessage)
    • ロケール (msdyn_locale_field)
    • メッセージ (msdyn_message)
    • クイック返信 (msdyn_cannedmessageid)
    • TagsControlField (msdyn_tagscontrolfield)
    • タイトル (msdyn_title)
    サンプル 1: チャネルのすべてのワークストリーム

    サンプル 2: 単体のワークストリーム

    サンプル 3: 複数のワークストリーム
    すべてのメッセージング チャネル タグ (msdyn_octag)
    • 名前 (msdyn_name)
    • タグ (msdyn_octagid)
    サンプル 1: チャネルのすべてのワークストリーム

    サンプル 2: 単体のワークストリーム

    サンプル 3: 複数のワークストリーム
    すべてのチャネル メッセージ (msdyn_ocsystemmessage)
    • チャネル (msdyn_streamsource)
    • 既定の言語 (msdyn_defaultlanguage)
    • インスタンス ID (msdyn_instanceid)
    • メッセージ (msdyn_ocsystemmessageid)
    • メッセージの説明 (msdyn_messagedescription)
    • メッセージ受信者 (msdyn_messagereceiver)
    • メッセージ テンプレート トリガー (msdyn_messagetemplatetrigger)
    • メッセージ テキスト(msdyn_messagetext)
    • メッセージ トリガー (msdyn_systemmessageeventtype)
    • メッセージ の種類 (msdyn_messagetype)
    • 名前 (msdyn_name)
    • ウィジェット (msdyn_widgetid)
    すべてのチャネル ローカライズ (msdyn_oclocalizationdata)
    • 自動メッセージ (msdyn_systemmessageid)
    • 既定のローカライズされたテキスト (msdyn_defaultlocalizedtext)
    • エンティティの列名 (msdyn_entitycolumnname)
    • エンティティ名 (msdyn_entityname)
    • エンティティ レコード ID (msdyn_entityrecordid)
    • は規定である (msdyn_isdefault)
    • 言語コード (msdyn_customerlanguageid)
    • 言語コード (msdyn_languagecode)
    • ローカライズ (msdyn_oclocalizationdataid)
    • ローカライズされたテキスト (msdyn_localizedtext)
    FetchXML でチャネルのローカライズのためにレコードをフィルターする
    Facebook Facebook アプリケーション (msdyn_ocfbapplication)
    • アプリケーション Id (msdyn_fbapplicationid)
    • アプリケーション シークレット (msdyn_fbapplicationsecret)
    • コールバック URI (msdyn_fbcallbackuri)
    • Facebook アプリケーション (msdyn_ocfbapplicationid)
    • 名前 (msdyn_name)
    • トークンの検証 (msdyn_fbverifytoken)
    FetchXML レコードをフィルターする Facebook アプリケーション
    Facebook Facebook ページ (msdyn_ocfbpage)
    • ボット アンケート (msdyn_postconversationsurveybotsurvey)
    • 有効にする (msdyn_postconversationsurveyenable)
    • エージェントへの添付ファイルを有効にする (msdyn_enablefileattachmentforagents)
    • 顧客への添付ファイルを有効にする (msdyn_enablefileattachmentforcustomers)
    • Facebook アプリケーション (msdyn_ocfbapplicationid)
    • Facebook ページ (msdyn_ocfbpageid)
    • Facebook ページの言語 (msdyn_ocwidgetlanguage)
    • メッセージ (msdyn_postconversationsurveybotsurveymessagetext)
    • メッセージ (msdyn_postconversationsurveymessagetext)
    • 名称 (msdyn_fbpagename)
    • ページ アクセス トークン (msdyn_fbpageaccesstoken)
    • ページ Id (msdyn_ocfbpageid)
    • アンケート モード (msdyn_postconversationsurveybotsurveymode)
    • アンケート モード (msdyn_postconversationsurveymode)
    • Facebook のヒューマン エイジェント メッセージタグを有効にします (msdyn_enablehumanagenttag)
    • 作業ストリーム (msdyn_liveworkstreamid)
    FetchXML レコードをフィルターする Facebook ページ
    Google Business Messages Google's Business Messages パートナー アカウント(msdyn_ocgooglebusinessmessagespartneraccount)
    • Base64 認証ファイル文字列 (msdyn_base64credentialfilestring)
    • Base64 認証ファイル文字列 - 続 (msdyn_base64credentialfilestringcontd)
    • 資格情報ファイル名 (msdyn_credentialfilename)
    • Google's Business Messages コールバックURL (msdyn_googlebusinessmessagescallbackurl)
    • Google’s Business Messages パートナー アカウント ID (msdyn_ocgooglebusinessmessagespartneraccountid)
    • 名前 (msdyn_name)
    • パートナー アカウントのクライアント トークン (msdyn_partneraccountclienttoken)
    • パートナー アカウント ID (msdyn_partneraccountid)
    FetchXML で Google's Business Messages のパートナー アカウントのレコードをフィルターする
    Google Business Messages Google's Business Messages エージェント アカウント (msdyn_ocgooglebusinessmessagesagentaccount)
    • エージェント アカウントのクライアント トークン (msdyn_agentaccountclienttoken)
    • エージェント ID (msdyn_agentid)
    • ボット アンケート (msdyn_postconversationsurveybotsurvey)
    • ブランド ID (msdyn_brandid)
    • エージェントの上書きを有効にする (msdyn_enableagentoverride)
    • エージェントへの添付ファイルを有効にする (msdyn_enablefileattachmentforagents)
    • 顧客への添付ファイルを有効にする (msdyn_enablefileattachmentforcustomers)
    • Google’s Business Messages エージェント アカウント (msdyn_googlebusinessmessagesagentaccountid)
    • Google's Business Messages コールバックURL (msdyn_googlebusinessmessagescallbackurl)
    • Google’s Business Messages パートナー アカウント ID (msdyn_ocgbmpartneraccount)
    • ライブ ワークストリーム ID (msdyn_liveworkstreamid)
    • メッセージ (msdyn_postconversationsurveybotsurveymessagetext)
    • 名前 (msdyn_name)
    • 会話後のアンケートの有効化 (msdyn_postconversationsurveyenable)
    • 投稿会話概要メッセージ テキスト (msdyn_postconversationsurveymessagetext)
    • 会話後のアンケートのモード (msdyn_postconversationsurveymode)
    • アンケート モード (msdyn_postconversationsurveybotsurveymode)
    • ウィジェットの言語 (msdyn_ocwidgetlanguage)
    FetchXML で Google's Business Messages のエージェント アカウントのレコードをフィルターする
    LINE LINE アカウント (msdyn_oclinechannelconfig)
    • ボット アンケート (msdyn_postconversationsurveybotsurvey)
    • チャネル アクセス トークン (msdyn_channelaccesstoken)
    • チャネル ID (msdyn_channelid)
    • チャネル シークレット (msdyn_channelsecret)
    • 有効にする (msdyn_postconversationsurveyenable)
    • エージェントへの添付ファイルを有効にする (msdyn_enablefileattachmentforagents)
    • 顧客への添付ファイルを有効にする (msdyn_enablefileattachmentforcustomers)
    • LINE アカウントの言語 (msdyn_ocwidgetlanguage)
    • LINE チャネルの LINE チャネルの識別 (msdyn_oclinechannelconfigid)
    • メッセージ (msdyn_postconversationsurveybotsurveymessagetext)
    • メッセージ (msdyn_postconversationsurveymessagetext)
    • 名前 (msdyn_name)
    • アンケート モード (msdyn_postconversationsurveybotsurveymode)
    • アンケート モード (msdyn_postconversationsurveymode)
    • Webhook URL (msdyn_webhookurl)
    • 作業ストリーム (msdyn_liveworkstreamid)
    LINE アカウントのレコードをフィルターする FetchXML
    カスタム チャネル カスタム メッセージング チャネル (msdyn_occustommessagingchannel)
    • ボット アンケート (msdyn_postconversationsurveybotsurvey)
    • チャネル ID (msdyn_occustomchannelid)
    • カスタム メッセージング アカウント (msdyn_custombotchannelregistration)
    • カスタム メッセージング チャネル (msdyn_occustommessagingchannelid)
    • カスタム メッセージング チャネルの言語 (msdyn_ocwidgetlanguage)
    • 有効にする (msdyn_postconversationsurveyenable)
    • エージェントへの添付ファイルを有効にする (msdyn_enablefileattachmentforagents)
    • 顧客への添付ファイルを有効にする (msdyn_enablefileattachmentforcustomers)
    • メッセージ (msdyn_postconversationsurveybotsurveymessagetext)
    • メッセージ (msdyn_postconversationsurveymessagetext)
    • 名前 (msdyn_name)
    • アンケート モード (msdyn_postconversationsurveybotsurveymode)
    • アンケート モード (msdyn_postconversationsurveymode)
    • 作業ストリーム (msdyn_liveworkstreamid)
    FetchXML でカスタム メッセージング チャネルのレコードをフィルタリングする
    Microsoft Teams Microsoft Teams アカウント (msdyn_octeamschannelconfig)
    • ボット ID (msdyn_botid)
    • ボット アンケート (msdyn_postconversationsurveybotsurvey)
    • 呼び出しオプション (msdyn_callingoptions)
    • 有効にする (msdyn_postconversationsurveyenable)
    • エージェントへの添付ファイルを有効にする (msdyn_enablefileattachmentforagents)
    • 顧客への添付ファイルを有効にする (msdyn_enablefileattachmentforcustomers)
    • メッセージ (msdyn_postconversationsurveybotsurveymessagetext)
    • メッセージ (msdyn_postconversationsurveymessagetext)
    • 名前 (msdyn_name)
    • アンケート モード (msdyn_postconversationsurveybotsurveymode)
    • アンケート モード (msdyn_postconversationsurveymode)
    • Teams アカウントの言語 (msdyn_ocwidgetlanguage)
    • Teams アプリ名 (msdyn_octeamsappname)
    • Teams チャネル (msdyn_octeamschannelconfigid)
    • 作業ストリーム (msdyn_liveworkstreamid)
    FetchXML で Microsoft Teams アカウントのレコードをフィルターする
    Facebook Google's Business Messages、 LINE、カスタム チャネル、Microsoft Teams カスタム メッセージング アカウント (msdyn_ocbotchannelregistration)
    • ボット チャネル登録 (msdyn_ocbotchannelregistrationid)
    • クライアント シークレット (msdyn_msappsecret)
    • Facebook アプリケーション (msdyn_ocfbapplicationid)
    • Google’s Business Messages エージェント アカウント id (msdyn_ocgbmagentaccount)
    • Google’s Business Messages パートナー アカウント id (msdyn_ocgbmpartneraccount)
    • カスタム メッセージングBCR (msdyn_iscustommessagingbcr)
    • 最終検証日 (msdyn_lastvalidateddate)
    • LINE チャネル (msdyn_oclinechannelconfigid)
    • MS アプリケーション Id (msdyn_msappid)
    • 名前 (msdyn_name)
    • セキュア クライアント シークレット (msdyn_securemsappsecret)
    • Teams チャネル (msdyn_octeamschannelconfigid)
    • 検証ステータス (msdyn_validationstatus)
    FetchXML でカスタム メッセージング アカウントのレコードをフィルタリングする
  5. スキーマを生成して保存します。

  6. データをエクスポートし、圧縮 (zip) ファイルを生成します。

  7. 構成移行ツール を使用し、データをインポートするオプションを選択し、圧縮ファイルを選択します。

作業ストリーム用 FetchXML

サンプル 1: チャネルのすべてのワークストリーム

<fetch>
	<entity name="msdyn_liveworkstream">
		<filter type="and">
			<condition attribute="msdyn_mode" operator="eq" value="717210001" />
			<condition attribute="msdyn_streamsource" operator="eq" value="<CHANNEL_ID>" />
		</filter>
	</entity>
</fetch> 

チップ

ワークストリームを移行する各チャンネルの <CHANNEL_ID> 値を見つけるには、Power Apps Maker Portalにアクセスし、ソース環境を選択し、選択 に進み、Stream Source (msdyn_streamsource) 選択肢を開きます。 たとえば、音声チャネルの値は 192440000 です。

サンプル 2: ひとつのワークストリーム

<fetch>
	<entity name="msdyn_liveworkstream">
		<filter type="and">
			<condition attribute="msdyn_liveworkstreamid" operator="eq" uiname="Test workstream 1" uitype="msdyn_liveworkstream" value="{759255C7-7AC8-98E0-7E3E-59A7F0312ABC}" />
		</filter>
	</entity>
</fetch> 

サンプル 3: 複数のワークストリーム

<fetch>
	<entity name="msdyn_liveworkstream">
		<filter type="and">
			<condition attribute="msdyn_liveworkstreamid" operator="in">
				<value uiname="Test workstream 1" uitype="msdyn_liveworkstream">{759255C7-7AC8-98E0-7E3E-59A7F0312ABC}</value>
				<value uiname="Test workstream 2" uitype="msdyn_liveworkstream">{E6246229-33AC-5A9E-2FFE-51668AD44098}</value>
			</condition>
		</filter>
	</entity>
</fetch> 

クイック返信対応 FetchXML

サンプル 1: チャネルのすべてのワークストリームに対するクイック返信

<fetch>
	<entity name="msdyn_cannedmessage">
		<link-entity name="msdyn_msdyn_cannedmessage_liveworkstream" from="msdyn_cannedmessageid" to="msdyn_cannedmessageid" visible="false" intersect="true">
			<link-entity name="msdyn_liveworkstream" from="msdyn_liveworkstreamid" to="msdyn_liveworkstreamid" link-type="inner" alias="aa">
				<filter type="and">
					<condition attribute="msdyn_mode" operator="eq" value="717210001" />
					<condition attribute="msdyn_streamsource" operator="eq" value="<CHANNEL_ID>" />
				</filter>
			</link-entity>
		</link-entity>
	</entity>
</fetch> 

サンプル2: 単一のワークストリームに対するクイック返信

<fetch>
	<entity name="msdyn_cannedmessage">
		<link-entity name="msdyn_msdyn_cannedmessage_liveworkstream" from="msdyn_cannedmessageid" to="msdyn_cannedmessageid" visible="false" intersect="true">
			<link-entity name="msdyn_liveworkstream" from="msdyn_liveworkstreamid" to="msdyn_liveworkstreamid" link-type="inner" alias="aa">
				<filter type="and">
					<condition attribute="msdyn_liveworkstreamid" operator="eq" uiname=" workstream 1" uitype="msdyn_liveworkstream" value="{759255C7-7AC8-98E0-7E3E-59A7F0312ABC}" />
/>
				</filter>
			</link-entity>
		</link-entity>
	</entity>
</fetch> 

サンプル 3: 複数のワークストリームに対するクイック返信

<fetch>
	<entity name="msdyn_cannedmessage">
		<link-entity name="msdyn_msdyn_cannedmessage_liveworkstream" from="msdyn_cannedmessageid" to="msdyn_cannedmessageid" visible="false" intersect="true">
			<link-entity name="msdyn_liveworkstream" from="msdyn_liveworkstreamid" to="msdyn_liveworkstreamid" link-type="inner" alias="aa">
				<filter type="and">
					<condition attribute="msdyn_liveworkstreamid" operator="in">
						<value uiname="Test Workstream 1" uitype="msdyn_liveworkstream">{759255C7-7AC8-98E0-7E3E-59A7F0312ABC}</value>
						<value uiname="Test Workstream 2" uitype="msdyn_liveworkstream">{E6246229-33AC-5A9E-2FFE-51668AD44098}</value>
					</condition>
				</filter>
			</link-entity>
		</link-entity>
	</entity>
</fetch> 

タグ用 FetchXML

サンプル 1: チャネルのすべてのワークストリームに対するクイック返信のタグ

<fetch>
	<entity name="msdyn_octag">
		<link-entity name="msdyn_msdyn_cannedmessage_msdyn_octag" from="msdyn_octagid" to="msdyn_octagid" visible="false" intersect="true">
			<link-entity name="msdyn_msdyn_cannedmessage_liveworkstream" from="msdyn_cannedmessageid" to="msdyn_cannedmessageid" visible="false" intersect="true">
				<link-entity name="msdyn_liveworkstream" from="msdyn_liveworkstreamid" to="msdyn_liveworkstreamid" link-type="inner" alias="aa">
					<filter type="and">
						<condition attribute="msdyn_mode" operator="eq" value="717210001" />
						<condition attribute="msdyn_streamsource" operator="eq" value="<CHANNEL_ID>" />
					</filter>
				</link-entity>
			</link-entity>
		</link-entity>
	</entity>
</fetch> 

サンプル 2: 単一のワークストリームに対するクイック返信のタグ

<fetch>
	<entity name="msdyn_octag">
		<link-entity name="msdyn_msdyn_cannedmessage_msdyn_octag" from="msdyn_octagid" to="msdyn_octagid" visible="false" intersect="true">
			<link-entity name="msdyn_msdyn_cannedmessage_liveworkstream" from="msdyn_cannedmessageid" to="msdyn_cannedmessageid" visible="false" intersect="true">
				<link-entity name="msdyn_liveworkstream" from="msdyn_liveworkstreamid" to="msdyn_liveworkstreamid" link-type="inner" alias="aa">
					<filter type="and">
						<condition attribute="msdyn_liveworkstreamid" operator="eq" uiname=" workstream 1" uitype="msdyn_liveworkstream" value="{759255C7-7AC8-98E0-7E3E-59A7F0312ABC}" />
					</filter>
				</link-entity>
			</link-entity>
		</link-entity>
	</entity>
</fetch> 

サンプル 3: 複数のワークストリームに対するクイック返信のタグ

<fetch>
	<entity name="msdyn_octag">
		<link-entity name="msdyn_msdyn_cannedmessage_msdyn_octag" from="msdyn_octagid" to="msdyn_octagid" visible="false" intersect="true">
			<link-entity name="msdyn_msdyn_cannedmessage_liveworkstream" from="msdyn_cannedmessageid" to="msdyn_cannedmessageid" visible="false" intersect="true">
				<link-entity name="msdyn_liveworkstream" from="msdyn_liveworkstreamid" to="msdyn_liveworkstreamid" link-type="inner" alias="aa">
					<filter type="and">
						<condition attribute="msdyn_liveworkstreamid" operator="in">
							<value uiname="Test Workstream 1" uitype="msdyn_liveworkstream">{759255C7-7AC8-98E0-7E3E-59A7F0312ABC}</value>
							<value uiname="Test Workstream 2" uitype="msdyn_liveworkstream">{E6246229-33AC-5A9E-2FFE-51668AD44098}</value>
						</condition>
					</filter>
				</link-entity>
			</link-entity>
		</link-entity>
	</entity>
</fetch> 

チャンネルローカリゼーション用 FetchXML

<fetch>
	<entity name="msdyn_oclocalizationdata">
		<link-entity name="msdyn_ocsystemmessage" from="msdyn_ocsystemmessageid" to="msdyn_systemmessageid" link-type="inner" alias="ab">
			<filter type="and">
				<condition attribute="msdyn_streamsource" operator="eq" value="<CHANNEL_ID>" />
			</filter>
		</link-entity>
	</entity>
</fetch>		

Facebook アプリケーション用 FetchXML

<fetch>
	<entity name="msdyn_ocfbapplication">
		<link-entity name="msdyn_ocfbpage" from="msdyn_ocfbapplicationid" to="msdyn_ocfbapplicationid" link-type="inner" alias="ab">
			<link-entity name="msdyn_liveworkstream" from="msdyn_liveworkstreamid" to="msdyn_liveworkstreamid" link-type="inner" alias="ac">
				<filter type="and">
					<condition attribute="msdyn_liveworkstreamid" operator="eq" uiname="ALM Facebook Test Workstream" uitype="msdyn_liveworkstream" value="{87bf4384-a02f-4802-8be7-1d6884a7e73f}" />
				</filter>
			</link-entity>
		</link-entity>
	</entity>
</fetch>

Facebook ページ用 FetchXML

<fetch>
	<entity name="msdyn_ocfbpage">
		<link-entity name="msdyn_liveworkstream" from="msdyn_liveworkstreamid" to="msdyn_liveworkstreamid" link-type="inner" alias="ab">
			<filter type="and">
				<condition attribute="msdyn_liveworkstreamid" operator="eq" uiname="ALM Facebook Test Workstream" uitype="msdyn_liveworkstream" value="{87bf4384-a02f-4802-8be7-1d6884a7e73f}" />
			</filter>
		</link-entity>
	</entity>
</fetch>

Google’s Business Messages のパートナーアカウント用 FetchXML

<fetch>
	<entity name="msdyn_ocgooglebusinessmessagespartneraccount">
		<link-entity name="msdyn_ocgooglebusinessmessagesagentaccount" from=" msdyn_ocgooglebusinessmessagespartneraccountid" to="msdyn_ocgbmpartneraccount" link-type="inner" alias="ab">
			<link-entity name="msdyn_liveworkstream" from="msdyn_liveworkstreamid" to="msdyn_liveworkstreamid" link-type="inner" alias="ac">
				<filter type="and">
					<condition attribute="msdyn_liveworkstreamid" operator="eq" uiname="ALM Google Test Workstream" uitype="msdyn_liveworkstream" value="{87bf4384-a02f-4802-8be7-1d6884a7e73f}" />
				</filter>
			</link-entity>
		</link-entity>
	</entity>
</fetch>

Google’s Business Messages のエージェント アカウント用 FetchXML

<fetch>
	<entity name="msdyn_ocgooglebusinessmessagesagentaccount">
		<link-entity name="msdyn_liveworkstream" from="msdyn_liveworkstreamid" to="msdyn_liveworkstreamid" link-type="inner" alias="ab">
			<filter type="and">
				<condition attribute="msdyn_liveworkstreamid" operator="eq" uiname="ALM Google Test Workstream" uitype="msdyn_liveworkstream" value="{87bf4384-a02f-4802-8be7-1d6884a7e73f}" />
			</filter>
		</link-entity>
	</entity>
</fetch>

LINE アカウント用 FetchXML

<fetch>
	<entity name="msdyn_oclinechannelconfig">
		<link-entity name="msdyn_liveworkstream" from="msdyn_liveworkstreamid" to="msdyn_liveworkstreamid" link-type="inner" alias="ab">
			<filter type="and">
				<condition attribute="msdyn_liveworkstreamid" operator="eq" uiname="ALM LINE Test Workstream" uitype="msdyn_liveworkstream" value="{87bf4384-a02f-4802-8be7-1d6884a7e73f}" />
			</filter>
		</link-entity>
	</entity>
</fetch>

カスタム メッセージング チャネル用 FetchXML

<fetch>
	<entity name="msdyn_occustommessagingchannel">
		<link-entity name="msdyn_liveworkstream" from="msdyn_liveworkstreamid" to="msdyn_liveworkstreamid" link-type="inner" alias="ab">
			<filter type="and">
				<condition attribute="msdyn_liveworkstreamid" operator="eq" uiname="ALM Custom Channel Test Workstream" uitype="msdyn_liveworkstream" value="{87bf4384-a02f-4802-8be7-1d6884a7e73f}" />
			</filter>
		</link-entity>
	</entity>
</fetch>

Microsoft Teams アカウント用 FetchXML

<fetch>
	<entity name="msdyn_octeamschannelconfig">
		<link-entity name="msdyn_liveworkstream" from="msdyn_liveworkstreamid" to="msdyn_liveworkstreamid" link-type="inner" alias="ab">
			<filter type="and">
				<condition attribute="msdyn_liveworkstreamid" operator="eq" uiname="ALM Teams Test Workstream" uitype="msdyn_liveworkstream" value="{87bf4384-a02f-4802-8be7-1d6884a7e73f}" />
			</filter>
		</link-entity>
	</entity>
</fetch>

カスタム メッセージング アカウント用 FetchXML

<fetch>
	<entity name="msdyn_ocbotchannelregistration">
		<filter type="or">
			<condition attribute="msdyn_liveworkstreamid" entityname="ac" operator="eq" uiname="ALM Custom Channel Test Workstream" uitype="msdyn_liveworkstream" value="{87bf4384-a02f-4802-8be7-1d6884a7e73f}" />
			<condition attribute="msdyn_liveworkstreamid" entityname="bd" operator="eq" uiname="ALM Facebook Test Workstream" uitype="msdyn_liveworkstream" value="{87bf4384-a02f-4802-8be7-1d6884a7e73f}" />
			<condition attribute="msdyn_liveworkstreamid" entityname="cc" operator="eq" uiname="ALM Google Test Workstream" uitype="msdyn_liveworkstream" value="{87bf4384-a02f-4802-8be7-1d6884a7e73f}" />
			<condition attribute="msdyn_liveworkstreamid" entityname="dc" operator="eq" uiname="ALM LINE Test Workstream" uitype="msdyn_liveworkstream" value="{87bf4384-a02f-4802-8be7-1d6884a7e73f}" />
			<condition attribute="msdyn_liveworkstreamid" entityname="ec" operator="eq" uiname="ALM Teams Test Workstream" uitype="msdyn_liveworkstream" value="{87bf4384-a02f-4802-8be7-1d6884a7e73f}" />
		</filter>
		<link-entity name="msdyn_occustommessagingchannel" from="msdyn_custombotchannelregistration" to="msdyn_ocbotchannelregistrationid" link-type="outer" alias="ab">
			<link-entity name="msdyn_liveworkstream" from="msdyn_liveworkstreamid" to="msdyn_liveworkstreamid" link-type="outer" alias="ac">
			</link-entity>
		</link-entity>
		<link-entity name="msdyn_ocfbapplication" from="msdyn_ocfbapplicationid" to="msdyn_ocfbapplicationid" link-type="outer" alias="bb">
			<link-entity name="msdyn_ocfbpage" from="msdyn_ocfbapplicationid" to="msdyn_ocfbapplicationid" link-type="outer" alias="bc">
				<link-entity name="msdyn_liveworkstream" from="msdyn_liveworkstreamid" to="msdyn_liveworkstreamid" link-type="outer" alias="bd">
				</link-entity>
			</link-entity>
		</link-entity>
		<link-entity name="msdyn_ocgooglebusinessmessagesagentaccount" from="msdyn_ocgbmagentaccount" to="msdyn_ocgooglebusinessmessagesagentaccountid" link-type="outer" alias="cb">
			<link-entity name="msdyn_liveworkstream" from="msdyn_liveworkstreamid" to="msdyn_liveworkstreamid" link-type="outer" alias="cc">
			</link-entity>
		</link-entity>
		<link-entity name="msdyn_oclinechannelconfig" from="msdyn_oclinechannelconfigid" to="msdyn_oclinechannelconfigid" link-type="outer" alias="db">
			<link-entity name="msdyn_liveworkstream" from="msdyn_liveworkstreamid" to="msdyn_liveworkstreamid" link-type="outer" alias="dc">
			</link-entity>
		</link-entity>
		<link-entity name="msdyn_octeamschannelconfig" from="msdyn_octeamschannelconfigid" to="msdyn_octeamschannelconfigid" link-type="outer" alias="eb">
			<link-entity name="msdyn_liveworkstream" from="msdyn_liveworkstreamid" to="msdyn_liveworkstreamid" link-type="outer" alias="ec">
			</link-entity>
		</link-entity>
	</entity>
</fetch>

移行を検証する

ソースの環境からターゲット組織への統合ルーティング関連の設定データを正常にインポートに成功し、ターゲット環境で次の手順を実行します:

  1. UI で、統合ルーティングの設定とルールセットが正しくレンダリングされ、エラーが表示されないことを確認します。

  2. スキルと評価値が統合ルーティングルールセットで使用されている場合は、ユーザー、予約可能なリソース、および予約可能なリソースの特性レコードを手動でリンク、関連付け、または作成する必要があります。

  3. 統合ルーティングのルールセットや作業ストリームで容量プロファイルを使用する場合は、ユーザー、予約可能なリソース、予約可能なリソースの容量プロファイルレコードを手動でリンク、関連付け、または作成する必要があります。

データのエクスポートとインポートに関する考慮点

移行中に直面する可能性のある問題のトラブルシューティングには、以下のようにログファイルを確認します:

  • 対象組織にデータをインポートする際、黄色の警告マークが表示された場合は、構成移行ツール で以下のログを確認してください:

    • Login_ErrorLog.log: 構成管理ツールを使用して組織にサインインしたときに発生した問題についての情報を提供します。
    • DataMigrationUtility.log: 前回の移行時にツールを使用して実行されたタスクに関する情報を提供します。
    • ImportDataDetail.log: 前回のデータインポート時にツールでインポートしたデータに関する情報を提供します。

    詳細: ログ ファイルを使用して、構成データ移行に関する問題をトラブルシューティングする

    データのインポート中のエラーを示す黄色の警告。

  • ログにネットワーク エラーが含まれている場合は、インポートの作業を繰り返してください。

    次に例を示します。

    Time: 11:46:09 PM
    Error: There was no endpoint listening at `https://www.contoso.com/XRMServices/2011/Organization.svc/web?SDKClientVersion=9.2.46.5279` that could accept the message. This is often caused by an incorrect address or SOAP action. See InnerException, if present, for more details.
    Stack Trace: Service stack trace:
    

参照

ソリューションを使用したレコード ルーティングの構成の移行
Microsoft Power Platform Build Tools for Azure DevOps