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

概要

このガイドの目的は、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. [行のリストを取得] アクティビティの [設定] ボタンをクリックします。

3. [ シート ID] フィールドの [値] 列に シート ID を入力します。

4. [ 行] フィールドで、 Row[] 変数を作成します (例: rowsRetrieved)。

5. [完了] ボタンをクリックします。

6. [リストの行] アクティビティの後に [繰り返し (コレクションの各要素)] アクティビティを追加します。

7. [値] プロパティに、rowsRetrieved 変数を入力します。

8. [型引数] プロパティには、Smartsheet.Api.Models.Rowを使用します。

9. [繰り返し (コレクションの各要素)] アクティビティの本体に、[ 行のリストを取得] アクティビティを追加します。

10. [ シート ID] に sheetId 変数を入力します。

11. [RowId] に「item.Id.value」です。

12. [含める] では、オプションとして [添付ファイル] を選択します。

13. [ 行] に、 Row 変数 ( 例: rowRetrieved) を作成して入力します

    

    

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

1. [ 行を取得] アクティビティの後に[条件分岐 (if *)] アクティビティを追加します。
2. [条件] には、「RowRetrieved.Attachments is Nothing」という値を使用します。
3. [条件分岐 (if)] アクティビティの [Else] セクションに、[繰り返し (コレクションの各要素)] アクティビティを追加します
4. [繰り返し (コレクションの各要素)] アクティビティで、次のプロパティを設定します。
5. [値] では、rowRetrieved.Attachments に設定します (上記の 7d ごとに出力変数として rowRetrieved を使用していると仮定します)。
6. TypeArgument は、Smartsheet.Api.Model.Attachment に設定します。
7. ForEach 変数の名前を item から attachment に変更します。

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

1. [ 添付ファイルを取得] アクティビティを追加します。

2. [シート ID] に、シート ID 変数を入力します。

3. [AttachmentId] に「attachment」と入力します。Id.Value"

4. [ フォルダー パスをダウンロード] に、 downloadPath 変数を入力します。

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