Dynamics CRM 2013/Fall '13 ユーザー定義アクション その 4
みなさん、こんにちは。
今回は新規に入出力パラメータを利用する操作を作成し、SDK
から利用する方法を紹介します。前回までの内容を把握している
ことが前提となりますのでご注意ください。
Dynamics CRM 2013/Fall '13 ユーザー定義アクション その 1
Dynamics CRM 2013/Fall '13 ユーザー定義アクション その 2
Dynamics CRM 2013/Fall '13 ユーザー定義アクション その 3
シナリオ
作成後 1 か月以上週間経過したサポート案件に対して以下の
プロセスでエスカレーションを実施します。
- エスカレーション担当者にサポート案件をアサインする
- 担当者のウォールにエスカレーションされた旨を投稿する
- 元担当者のウォールにエスカレーションされた旨を投稿する
操作の作成
シナリオを満たせるよう、エスカレーション担当者を入力
パラメータとして受け取れる操作を作成します。また出力
パラメータのサンプルとしてすべての操作の最後に作業が
完了した旨を記した文字列を返すこととします。
1. 設定モジュールよりプロセスをクリックします。
2. 新規ボタンをクリックして、以下の様に操作を作成します。
3. OK をクリックします。
4. 一意の名前として new_escalateIncident と入力します。
5. プロセスの引数で [＋] ボタンをクリックします。
6. 名前、種類、エンティティなど以下の様に指定します。
※必須出席者と表示されているのは表示バグであり、本来は
”必須” です。この入力パラメータが必須であるか指定します。
7. ステップの追加よりレコードの作成を追加します。
8. 作成から投稿を選択して、以下の様にプロパティを設定します。
動的な値で入力パラメーターで指定した値が利用できることを
確認します。
[ステップ]
[動的な値]
[投稿レコードのプロパティ]
9. もう一つ投稿作成ステップを追加します。
10. レコードの割り当てステップを追加します。動的な値で
入力パラメータで指定したユーザーに割り当てます。
11. 次に出力パラメータを追加します。プロセスの引数で
[＋] ボタンをクリックして、以下の様に設定します。
12. ステップの追加より値の割り当てを追加します。
13. プロパティの設定をクリックし、以下の様に設定します。
出力パラメータが複数ある場合、ドロップダウンより任意の
ものを選択できます。
14. 操作を保存して、アクティブ化します。
SDK からの呼び出し
1. こちらの記事と同じ手順で SDK の準備を行います。
2. 以下のコードを Program.cs に貼り付けます。
using Microsoft.Crm.Sdk.Samples;
using Microsoft.Xrm.Sdk;
using Microsoft.Xrm.Sdk.Client;
using Microsoft.Xrm.Sdk.Query;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
namespace CustomActionSample
{
class Program
{
static void Main(string[] args)
{
// ヘルパーを利用してサービスプロキシの生成
ServerConnection serverConnect = new ServerConnection();
ServerConnection.Configuration config = serverConnect.GetServerConfiguration();
using (OrganizationServiceProxy _serviceProxy = ServerConnection.GetOrganizationProxy(config))
{
// 事前バインドの利用
_serviceProxy.EnableProxyTypes();
// エスカレーション担当者の GUID を取得するロジックをここに記述
// 結果として GUID を取得したと想定
Guid escalationEngineer = new Guid("F5D307DA-E434-E311-904F-D89D676560BC");
// 1 か月以上前に作成され、エスカレーション担当者が所有者でないサポート案件
string fetch = String.Format(@"<fetch version='1.0' output-format='xml-platform'
mapping='logical' distinct='false'>
<entity name='incident'>
<attribute name='title' />
<attribute name='ticketnumber' />
<attribute name='createdon' />
<attribute name='incidentid' />
<order attribute='title' descending='false' />
<filter type='and'>
<condition attribute='createdon' operator='olderthan-x-months' value='1' />
<condition attribute='ownerid' operator='ne' uiname=''
uitype='systemuser' value='{0}' />
</filter>
</entity>
</fetch>", escalationEngineer.ToString());
EntityCollection results =
_serviceProxy.RetrieveMultiple(new FetchExpression(fetch));
// 取得したレコードに対してカスタムアクションを実行
foreach (Incident incident in results.Entities)
{
// 操作に紐づく要求の作成
new_escalateIncidentRequest request = new new_escalateIncidentRequest();
// アクションのターゲットとして取得したサポート案件を指定
request.Target = new EntityReference(Incident.EntityLogicalName, incident.Id);
// 要求の入力パラメータとして EscalationEngineer を設定
request.EscalationEngineer = new EntityReference(SystemUser.EntityLogicalName, escalationEngineer);
// 操作に紐づく応答の取得
new_escalateIncidentResponse response =
(new_escalateIncidentResponse)_serviceProxy.Execute(request);
// 応答のパラメータとして Result を表示
Console.WriteLine(response.Result);
}
}
}
}
}
3. プログラムを実行します。画面に設定した出力パラメータ
の文字列が表示されることを確認します。
4. 実際のレコードがエスカレーション担当者に割り当てられ、
それぞれのユーザーウォールに投稿が作成されていることを
確認します。
次回はユーザー定義アクションをプラグインやスクリプト
から呼び出す方法を紹介します。
- 中村 憲一郎