アクティビティ

SharePoint リストに新規顧客を追加する

概要

概要: SharePoint リストに新しい顧客を追加し、そのデータを使用して Salesforce アカウントを作成します。

アプリケーション: SharePoint リスト、Excel、Salesforce

説明:

この例では、新しい Excel ファイルから SharePoint リストに新しい顧客をすべて追加し、新しいアカウントを作成して、そのそれぞれに Salesforce の連絡先を作成する方法について説明しています。次に、SharePoint リストアイテムの Salesforce ID を更新し、ステータスを [処理済み] にします。最後に、処理されたファイルのための新しいフォルダーを作成し、Excel ファイルを移動します。

ここでは、[ファイルの作成時]、[リストアイテムを追加]、[リストアイテムを取得] などの Microsoft 365 アクティビティのほか、[アカウントを作成] や [連絡先を作成] などの Salesforce アクティビティを例として示しています。

注:

「SharePoint リスト」系アクティビティでは列名が使用されますが、Studio のユーザーインターフェイスでは列の表示名が示されますたとえば、Salesforce ID という名前の列がある場合、このフィールドを変数で取得すると、field_5 はバックエンドの列名であるため、変数は [...]field_5 となります。

ワークフロー

Studio Web を開いて、新しいプロジェクトを作成します。
[オートメーションの開始方法] で [イベントベース] を選択し、Microsoft 365 の [ファイルの作成時] トリガーアクティビティを選択します。
トリガーアクティビティで、以下の手順を実行します。
1. Microsoft OneDrive と SharePoint のコネクションを設定します。
2. [作成場所] フィールドを設定します。たとえば、OneDrive のフォルダーのいずれかを選択します。
[繰り返し (ブックの各行)] アクティビティを追加します。
1. [ブック] フィールドで、[ファイルの作成時] トリガーアクティビティの出力変数を選択します。
2. [範囲] を選択します。たとえば、ブックの最初のシートである Sheet1 です。
3. 必要に応じて、その他のフィールドを設定します。例:
  1. 先頭行をヘッダーとする - True に設定します。
  2. 行が空の場合 - [スキップ] に設定します。
[繰り返し (各行)] アクティビティ内に、新しい顧客を作成するための、SharePoint の [リストアイテムを追加] アクティビティを追加します。
1. 必要な [SharePoint リスト] を選択します。
次に、[繰り返し (コレクションの各要素)] 内にアクティビティをさらに追加します。後で簡単に識別できるように、名前を Write Cell - Status に変更して設定します。
1. [ブック] フィールドで、[ファイルの作成時] トリガーアクティビティの出力変数を選択します。
2. [シート/名前付き範囲] を選択します。
3. [セル] フィールドで、[繰り返し (ブックの各行)] アクティビティの CurrentRow 変数を選択してから、下方の Status_Address プロパティを選択します。
4. 書き込む内容 - フィールドに Added と入力します。
2 つ目の [セルに書き込み] アクティビティを追加します。名前を Write Cell - SharePoint List ID に変更して設定します。
1. [ブック] フィールドで、[ファイルの作成時] トリガーアクティビティの出力変数を選択します。
2. [シート/名前付き範囲] を選択します。
3. [セル] フィールドで、[繰り返し (ブックの各行)] アクティビティの CurrentRow 変数を選択してから、下方の SP_List_ID_Address プロパティを選択します。
4. 書き込む内容 - [リストアイテムを追加] アクティビティの出力変数を選択してから、下方の ID プロパティを選択します。
次に、[繰り返し (各行)] アクティビティの外に [リストアイテムを取得] アクティビティを追加します。これにより、顧客情報が取得されます。
1. [SharePoint] リストを選択します。
2. [取得する列] フィールドで、必要なすべての顧客フィールドを選択します。例: Firstname、Lastname、Email、Phone、Salesforce ID、ID、Title
  
  メモ: これらは列の表示名です。バックエンドの列タイトルは異なります。
[繰り返し (コレクションの各要素)] アクティビティを追加します。
1. [項目のリスト] フィールドで、前の [リストアイテムを取得] アクティビティの出力変数を選択してから、下方の Rows プロパティを選択します。
2. [アイテム] フィールドは自動的に currentDataRow に設定されます。
[繰り返し (コレクションの各要素)] 内に [条件分岐 (if)] アクティビティを追加します。これにより、Salesforce ID フィールドが空の場合の実行内容が設定されます。
1. [条件] を設定: currentDataRow.field_5 ([取得する列] の Salesforce ID) が空のテキストの場合に設定します。式エディターの条件は、string.IsNullOrEmpty(currentDataRow.field_5) = true です。
  注: Salesforce ID は表示名です。field_5 はバックエンドの列名です。
[Then] 分岐を設定します。条件が True の場合に実行するアクティビティです。
1. リストアイテムのタイトルを代わりにログに記録するには、[メッセージをログ] アクティビティを追加します。[メッセージ] フィールドで、[繰り返し (コレクションの各要素)] の currentDataRow 変数を選択してから、下方の Title プロパティを選択します。これは、顧客名 (SharePoint リストの [Title] 列) に対応しています。
Salesforce の [アカウントを作成] アクティビティを追加します。
1. [アカウント名] に currentDataRow.Title 変数を選択します。
Salesforce の [連絡先を作成] を追加して設定します。[リストアイテムを取得] アクティビティの [取得する列] フィールドを使用して取得した情報とアクティビティフィールドを一致させます。
1. 姓 - currentDataRow.Lastname 変数を設定します。currentDataRow.field_2 変数として表示されます。
2. [アカウント] - [アカウントを作成] アクティビティの出力変数を選択します。
3. メール - 変数 currentDataRow.Email を設定します。currentDataRow.field_3 として表示されます。
4. 名 - 変数 currentDataRow.Firstname を設定します。currentDataRow.field_1 として表示されます。
5. Phone - currentDataRow.Phone 変数に設定します。currentDataRow.field_4 変数として表示されます。
次に、[単一のリストアイテムを更新] アクティビティを追加して設定します。
1. SharePoint リストを選択します。
2. [リストアイテム ID] で、[繰り返し (コレクションの各要素)] の currentDataRow.ID 変数を選択します。
[Else] 分岐は設定しないでください。
次に、[ファイル/フォルダーを取得] アクティビティを追加します。
1. ファイルまたはフォルダーの URL - [ファイルの作成時] トリガーアクティビティの出力変数を選択してから、下方の ParentUri プロパティを選択します。
[フォルダーを作成] アクティビティを追加し、設定します。
1. フォルダー名 - たとえば、名前を Processed Files に設定します。
2. 親フォルダー - [ファイル/フォルダーを取得] アクティビティの出力変数を選択します。
3. フォルダーが既に存在する場合 - [名前を自動変更] に設定します。
[ファイル/フォルダーを移動] アクティビティを追加して、新しいファイルを処理済みのアイテムフォルダーに移動します。
1. 移動するファイルまたはフォルダー - [ファイルの作成時] トリガーアクティビティの出力変数を選択します。
2. 移動先フォルダー - [フォルダーを作成] アクティビティの出力変数を選択します。
3. ファイル/フォルダーが既に存在する場合 - [置換] に設定します。
これで完了です。プロジェクトを実行できます。