クイックスタート - 行の操作

概要

このガイドの目的は、Smartsheet のシート上の行を操作する方法の例をいくつか説明することです。 次のアクティビティを使用します。

• 行のリストを取得 (List Rows
• 行を取得
• 添付ファイルを取得
• 行を更新

この実用的なサンプルでは、行のリストを取得してから、行のリストを反復処理し、最初にその行の添付ファイルを取得してから、その行の値を更新できます。

このページの手順を完了すると、以下のアクションを実行するオートメーション シーケンスが使用できるようになります。

1. Smartsheet インスタンスへの接続を確立します ([Smartsheet スコープ])。
2. シートから行のリストを取得します ([リストの行])。
3. 取得した各行について、以下の手順を実行します。
4. その行の添付ファイルを取得します ([行のリストを取得])。
5. その行のすべての添付ファイルを ダウンロードします。
6. その行の値を 更新します。

上記の項目 4 では、Row[] オブジェクトを作成して 1 回の Update コールを作成することもできますが、このデモの目的のために、更新する行ごとに 1 回呼び出します。

以下に、サンプル シートのスクリーンショットを示します。

シート ID を取得するには、File->Properties に移動し、[シート ID] を参照します。 5903706102228868のようになります。

前提条件

はじめる前に

1. Smartsheet の 「セットアップ」 の手順を完了します。
2. 添付ファイルのダウンロード先のローカル フォルダー パスです。

手順

プロジェクトをビルドする

1. [ API トークン ] の値に対し、 String 変数を作成して入力します (例: apiToken)。
2. [Smartsheet スコープ] を追加します。
3. [認証の種類] に [ API トークン] を選択します。
4. [API アクセス トークン ] の値として、「 apiToken 」型変数を入力します。

複数のアクティビティで使用される変数を作成および設定する

1. [ シート ID] の値に対し、 Int64 変数を作成して入力します (例: sheetId)。
2. [ ダウンロード パス ] の値に String 変数を作成して入力します (例: downloadPath)。

添付ファイルを取得し更新する行のリストを取得し、各ループを設定します。

1. [リストの行] アクティビティを追加します。
2. [ List Rows ] アクティビティの [ Configure ] ボタンをクリックします。
3. フィールドの [ シート ID] に、Value (値) 列の シート ID を入力します。
4. [ 行] フィールドに Row[] 変数を作成します (例: [リトリブ済みの行])。
5. [完了] ボタンをクリックします。
6. [リストの行] アクティビティの後に [繰り返し (コレクションの各要素)] アクティビティを追加します。
7. [ 値 ] プロパティに、 行のリトリブド変数を 入力します。
8. [ 型引数 ] プロパティで、 Smartsheet.Api.Models.Rowを使用します。
9. [繰り返し (コレクションの各要素)] アクティビティの本体に、[ リストの行] アクティビティを追加します。
10. [ シート ID] に sheetId 変数を入力します。
11. [ 行 ID] に 「item」と入力します。Id.value"
12. [添付 ファイル] をオプションとして選択します。
13. [ 行] に、 Row 型変数を作成して入力します (例: rowRetrieved)。
    
    

    

    
    
    
    

    

    
    

[条件分岐 (if)] 条件チェックを設定する

1. [行 を取得] アクティビティの後に [条件分岐 (if)] アクティビティを追加します。
2. 条件 に [RowRetretrieved.Attachments is Nothing] という値を使用します。
3. [条件分岐 (if )] アクティビティの [ Else ] セクションで、[繰り返し (コレクションの各 要素)] アクティビティを追加します。
4. [繰り返し (コレクションの各要素 )] アクティビティで、次のプロパティを設定します。
5. [Values]に [rowRetrieved.Attachments] に設定します (上記 7d あたりに rowRetrieved が出力変数として使用されていると推定します)。
6. TypeArgument を 「Smartsheet.Api.Model.Attachment」に設定します。
7. [繰り返し (要素)] 変数の名前を 「項目 」から 「添付ファイル」に変更します。

添付ファイルのある各行について、添付ファイルをダウンロードし、その行の値を更新します。

1. [添付ファイルを取得] アクティビティを追加します。
2. [ シート ID] に sheetId 変数を入力します。
3. [ 添付ファイル ID] に「"attachment"」と入力します。Id.Value"
4. [ フォルダー パスをダウンロード]に ダウンロード パス 変数を入力します。
5. [添付ファイルを取得 ] アクティビティの後に [ 代入 ] アクティビティを追加します。
6. [ 追加先] の場合は、 Row 変数を作成します (例: rowUpdate)。
7. [ 値] に新しい Row オブジェクトを作成し、以下のパターンと同様のコードを使用して設定します。

   New Row() With { 
   .Id = RowRetrieved.Id,
   .Cells = New List(Of Cell) From {
       New Cell() With {.Value = '100', .ColumnId = RowRetrieved.Cells(3).ColumnId}
       }
   }

   
   

   

   
   
8. [ 代入 ] アクティビティの後に [行を更新] アクティビティを追加します。
9. [ 設定 ] ボタンをクリックします。
10. [ シート ID ] フィールドでは、 sheetId 変数を使用します。
11. [ 行 ] フィールドで、[ 行 リンク] ボタンをクリックします。
12. [ 追加 ] ボタンをクリックします。
13. 前に作成した rowUpdate 変数を入力します。
14. [ 完了 ] ボタンをクリックします。

完了です!

Smartsheet アクティビティの詳細 (プロパティの入力/出力の例を含む) については「 アクティビティ 」をご覧ください。すべてのアクティビティが記載されたリストと、アクティビティの詳細な説明ページへのリンクが記載されています。

このロボットのコピーは、次のリンクからダウンロードできます。

https://discourse-cloud-file-uploads.s3.dualstack.us-west-2.amazonaws.com/uipath/original/3X/2/8/28b17aad52194518cf0c4977635e8e381a68636d.zip