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

概要

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

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

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

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

注:

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

ワークフロー

1. Studio Web を開いて、新しいプロジェクトを作成します。
2. [オートメーションの開始方法] で [イベント ベース] を選択し、Microsoft 365 の [ファイルの作成時] トリガー アクティビティを選択します。
3. トリガー アクティビティで、以下の手順を実行します。
   1. Microsoft OneDrive と SharePoint のコネクションを設定します。
   2. [作成場所] フィールドを設定します。たとえば、OneDrive のフォルダーのいずれかを選択します。
      
      

      

      
      
4. [繰り返し (ブックの各行)] アクティビティを追加します。
   1. [ブック] フィールドで、[ファイルの作成時] トリガー アクティビティの出力変数を選択します。
   2. [範囲] を選択します。たとえば、ブックの最初のシートである Sheet1 です。
   3. 必要に応じて、その他のフィールドを設定します。例:
      1. 先頭行をヘッダーとする - True に設定します。
      2. 行が空の場合 - [スキップ] に設定します。
         
         

         

         
         
5. [繰り返し (各行)] アクティビティ内に、新しい顧客を作成するための、SharePoint の [リスト アイテムを追加] アクティビティを追加します。
   1. 必要な [SharePoint リスト] を選択します。
      
      

      

      
      
6. 次に、[繰り返し (コレクションの各要素)] 内にアクティビティをさらに追加します。後で簡単に識別できるように、名前を Write Cell - Status に変更して設定します。
   1. [ブック] フィールドで、[ファイルの作成時] トリガー アクティビティの出力変数を選択します。
   2. [シート/名前付き範囲] を選択します。
   3. [セル] フィールドで、[繰り返し (ブックの各行)] アクティビティの CurrentRow 変数を選択してから、下方の Status_Address プロパティを選択します。
   4. 書き込む内容 - フィールドに Added と入力します。
      
      

      

      
      
7. 2 つ目の [セルに書き込み] アクティビティを追加します。名前を Write Cell - SharePoint List ID に変更して設定します。
   1. [ブック] フィールドで、[ファイルの作成時] トリガー アクティビティの出力変数を選択します。
   2. [シート/名前付き範囲] を選択します。
   3. [セル] フィールドで、[繰り返し (ブックの各行)] アクティビティの CurrentRow 変数を選択してから、下方の SP_List_ID_Address プロパティを選択します。
   4. 書き込む内容 - [リスト アイテムを追加] アクティビティの出力変数を選択してから、下方の ID プロパティを選択します。
      
      

      

      
      
8. 次に、[繰り返し (各行)] アクティビティの外に [リスト アイテムを取得] アクティビティを追加します。これにより、顧客情報が取得されます。
   1. [SharePoint] リストを選択します。
   2. [取得する列] フィールドで、必要なすべての顧客フィールドを選択します。例: Firstname、Lastname、Email、Phone、Salesforce ID、ID、Title
      メモ: これらは列の表示名です。バックエンドの列タイトルは異なります。
      
      

      

      
      
      
      

      

      
      
9. [繰り返し (コレクションの各要素)] アクティビティを追加します。
   1. [項目のリスト] フィールドで、前の [リスト アイテムを取得] アクティビティの出力変数を選択してから、下方の Rows プロパティを選択します。
   2. [アイテム] フィールドは自動的に currentDataRow に設定されます。
      
      

      

      
      
10. [繰り返し (コレクションの各要素)] 内に [条件分岐 (if)] アクティビティを追加します。これにより、Salesforce ID フィールドが空の場合の実行内容が設定されます。
    1. [条件] を設定: currentDataRow.field_5 ([取得する列] の Salesforce ID) が空のテキストの場合に設定します。式エディターの条件は、string.IsNullOrEmpty(currentDataRow.field_5) = true です。
       注: Salesforce ID は表示名です。field_5 はバックエンドの列名です。

       
       

       

       
       
11. [Then] 分岐を設定します。条件が True の場合に実行するアクティビティです。
    1. リスト アイテムのタイトルを代わりにログに記録するには、[メッセージをログ] アクティビティを追加します。[メッセージ] フィールドで、[繰り返し (コレクションの各要素)] の currentDataRow 変数を選択してから、下方の Title プロパティを選択します。これは、顧客名 (SharePoint リストの [Title] 列) に対応しています。
12. Salesforce の [アカウントを作成] アクティビティを追加します。
    1. [アカウント名] に currentDataRow.Title 変数を選択します。
13. 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 変数として表示されます。
       
       

       

       
       
14. 次に、[単一のリスト アイテムを更新] アクティビティを追加して設定します。
    1. SharePoint リストを選択します。
    2. [リスト アイテム ID] で、[繰り返し (コレクションの各要素)] の currentDataRow.ID 変数を選択します。
    
    

    

    
    
15. [Else] 分岐は設定しないでください。
16. 次に、[ファイル/フォルダーを取得] アクティビティを追加します。
    1. ファイルまたはフォルダーの URL - [ファイルの作成時] トリガー アクティビティの出力変数を選択してから、下方の ParentUri プロパティを選択します。
       
       

       

       
       
17. [フォルダーを作成] アクティビティを追加し、設定します。
    1. フォルダー名 - たとえば、名前を Processed Files に設定します。
    2. 親フォルダー - [ファイル/フォルダーを取得] アクティビティの出力変数を選択します。
    3. フォルダーが既に存在する場合 - [名前を自動変更] に設定します。
       
       

       

       
       
18. [ファイル/フォルダーを移動] アクティビティを追加して、新しいファイルを処理済みのアイテム フォルダーに移動します。
    1. 移動するファイルまたはフォルダー - [ファイルの作成時] トリガー アクティビティの出力変数を選択します。
    2. 移動先フォルダー - [フォルダーを作成] アクティビティの出力変数を選択します。
    3. ファイル/フォルダーが既に存在する場合 - [置換] に設定します。
       
       

       

       
       
19. これで完了です。プロジェクトを実行できます。