SFTP CSVファイルからQuickbaseレコードを更新するレシピ

このページは機械翻訳により提供されています。翻訳内容と英語版に相違がある場合は、英語版が優先されます。

このユースケースでは、SFTPCSVツール by WorkatoQuickbaseを接続して、強力な自動化を作成する方法を説明します。

このレシピの機能

このレシピは、SFTPサーバーからCSVファイルを取得し、ファイルの内容を解析して、Quickbaseテーブル内の対応するレコードを更新します。

このレシピはどのように使用できますか?

このレシピは、次のユースケースを含むさまざまな方法でワークフローの自動化に適用できます。

  • 在庫追跡:サプライヤーのSFTPサーバーから在庫更新を定期的に取得し、Quickbaseデータベースで正確な在庫レベルを維持できます。
  • 売上データ管理:SFTPサーバーから日次売上レポートのインポートを自動化し、Quickbaseレコードを常に最新の売上数値で最新の状態に保ちます。
  • 注文処理:SFTPサーバーから注文詳細を定期的にダウンロードし、Quickbaseの注文管理システムを更新します。 これにより、注文フルフィルメントと追跡を効率化できます。
  • 顧客情報の更新:CSVファイルで受信した新しいデータに基づいて顧客レコードを自動的に更新し、チームが常に最新情報をすぐに利用できるようにします。

レシピの作成

SFTPサーバーからCSVファイルを取得し、その内容を解析して、Quickbaseテーブル内のレコードを更新するレシピを作成するには、次の手順を完了します。

ユースケースは例示のみを目的としています

このユースケースは一例です。 このレシピをワークフローに合わせて適応させるには、トリガー、アクション、または条件ロジックの変更が必要になる場合があります。

1

Workatoにサインインします。

2

レシピを作成する予定のプロジェクトを選択します。

3

SFTPとQuickbaseのコネクションを作成します。

Workatoユーティリティコネクターにはセットアップが不要です

CSVツール by Workatoコネクターにはコネクションの設定は必要ありません。

SFTPコネクションを作成します。

SFTPコネクションの作成

このステップでは、レシピ用のSFTPコネクションを作成します。

SFTP認証でのSSHキーの使用

SFTPはSecure Shell Protocol(SSH)上に構築されており、認証フローでSSHキーを使用できます。 SSHキーは、ユーザーIDとパスワードと併用することも、単独で使用してWorkatoをSFTPサーバーで認証することもできます。 これにより、公開キーと秘密キーにSSH暗号化を使用して、コネクションのセキュリティが強化されます。

コネクション設定

SFTPコネクションを設定するには、次の手順を完了します。

1

作成 > コネクションをクリックするか、Cを2回押します。

2

新規コネクションページでSFTPを検索して選択します。

3

コネクション名フィールドにコネクションの名前を入力します。

コネクション設定SFTPコネクションの設定

4

ロケーションドロップダウンメニューを使用して、コネクションを保存するプロジェクトを選択します。

5

コネクションタイプドロップダウンメニューを使用して、使用する予定のコネクション方式を選択します。 オンプレミスグループ名を選択するか、Cloudを選択して直接コネクションを使用できます。

6

認証タイプフィールドで認証方法を選択します。 使用可能なオプションは次のとおりです。

  • ユーザー名/パスワード
  • 公開キー/秘密キーペア
  • 公開キー/秘密キーペアとパスワード
7

接続先のSFTPサーバーのユーザー名をユーザー名フィールドに入力します。

8

認証タイプフィールドでの選択に基づいて、追加の認証情報を入力します。

  • ユーザー名/パスワード、または公開キー/秘密キーペアとパスワード認証パスワードフィールドに、SFTPサーバーのユーザー名に関連付けられたパスワードを入力します。

  • 公開キー/秘密キー、または公開キー/秘密キーペアとパスワード認証秘密キーフィールドに、SFTPサーバーのSSH秘密キーを入力します。 秘密キーはOpenSSH形式である必要があります。 キーを保存する際に、形式パラメーターとしてSecureShellPrivateKeyFormat.NewOpenSecureShellを指定します。 詳細については、秘密キーの形式例セクションを参照してください。

9

SFTPサーバーのアドレスをホスト名フィールドに入力します。

10

SFTPサーバーのポートをポートフィールドに入力します。 SFTPのデフォルトポートは22です。

11

任意です。 ホストキーのフィンガープリントフィールドに、SSH公開キーのハッシュを入力します。 WorkatoはSHA256およびMD5暗号化をサポートしています。 オンプレミスコネクションの場合は、SFTPサーバー管理者に連絡してBase64形式の公開キーを取得します。

12

任意です。 ファイル転送に使用するバッファーのサイズを転送バッファーサイズフィールドに入力します。

13

任意です。 各トランザクションの終了時にSSHコネクションを閉じるかどうかを、強制クローズフィールドで指定します。 SFTPサーバーコネクションが応答しなくなる場合は、このオプションを切り替えます。 それ以外の場合は、空白のままにします。

14

任意です。 明示的なバージョンフィールドで、使用するSFTPプロトコルバージョンを設定します。

15

追加操作をサポートしていますか?ドロップダウンメニューを使用して、SFTPプロバイダーが追加または変更操作をサポートするかどうかを指定します。 デフォルト設定はYesです。

16

接続をクリックします。

Quickbaseコネクションを作成します。

Quickbaseコネクションを作成する

このステップでは、WorkatoとQuickbaseアカウント間のコネクションを作成します。

Workatoでは、Quickbaseへの接続に次の認証方法がサポートされています:

ユーザートークン認証

1

作成 > コネクションをクリックするか、Cを2回押します。

2

新規コネクションページでQuickbaseを検索して選択します。

3

接続先のQuickbaseインスタンスを識別する一意のコネクション名を指定します。

4

ロケーションドロップダウンメニューを使用して、コネクションを保存するプロジェクトを選択します。

5

Quickbaseサブドメインを入力します。 これは通常、会社名です。

6

ユーザートークン認証?ドロップダウンメニューを使用して、はいを選択します。

7

ユーザートークンを入力します。 詳細については、ユーザートークンを生成するセクションを参照してください。

8

接続をクリックします。

ユーザー名とパスワードによる認証

1

作成 > コネクションをクリックするか、Cを2回押します。

2

新規コネクションページでQuickbaseを検索して選択します。

3

使用する予定のQuickbaseインスタンスを識別する一意のコネクション名を入力します。

Quickbaseコネクションの設定ユーザー名とパスワードを使用してQuickbaseコネクションを設定する

4

ロケーションドロップダウンメニューを使用して、コネクションを保存するプロジェクトを選択します。

5

Quickbaseサブドメインを入力します。 これは通常、会社名です。

6

ユーザートークン認証?ドロップダウンメニューを使用して、いいえを選択します。

7

Quickbaseのユーザー名パスワードを指定します。

8

接続をクリックします。

4

プロジェクトに戻り、Create > Recipeをクリックするか、C+Rを押します。

新しいレシピを作成新しいレシピを作成

5

Nameフィールドにレシピの名前を入力します。

6

Locationドロップダウンメニューを使用して、レシピを保存するプロジェクトを選択します。

7

ビルドを開始をクリックします。

レシピの構築を開始レシピの構築を開始

8

Pick a starting pointをクリックし、Run on a scheduleを選択します。 これにより、スケジューラー by WorkatoのNew recurring eventトリガーを使用する新しいレシピが作成されます。 このトリガーにはコネクションは不要です。

9
スケジューラー by Workato New recurring eventトリガーを設定します。

スケジューラー by Workato New recurring eventトリガーの設定

この手順では、このレシピを実行する頻度の間隔またはカスタムスケジュールを設定します。

1

レシピエディターでトリガーをクリックします。

トリガーをクリックトリガーをクリック

2

Time unitフィールドで間隔またはカスタムスケジュールを選択します。 使用可能なオプションには、MinutesHoursDaysWeeksMonths、またはCustom scheduleがあります。

3

このトリガーを実行する頻度を指定します。 設定するフィールドは、Time unitフィールドでの選択によって異なります。

  • Custom scheduleが選択されていない場合Trigger everyフィールドで繰り返しスケジュールを定義します。 整数のみを入力します。 許可される最小値は5分です。

  • Custom scheduleが選択されている場合:次の形式でCron expressionを入力します。

    text
    [minute] [hour] [day of month] [month] [day of week]
4

任意です。 Timezoneフィールドでタイムゾーンを選択します。 空白のままにすると、America/Los_Angelesが使用されます。

5

任意です。 Start afterフィールドで開始日時を設定するか、フィールドを空白のままにして、レシピの開始直後にトリガーを有効化します。 レシピを実行またはテストした後は、この値を変更できません。

6

保存をクリックします。

10

+ Add stepをクリックし、Action in appを選択します。

アクションを追加Add step > Add action in appをクリック

11
SFTP Download fileアクションをセットアップします。

SFTP Download fileアクションをセットアップする

このアクションは、SFTPサーバーからCSVファイルの内容を取得します。

1

SFTPを検索し、アプリとして選択します。

アプリを選択アプリとしてSFTPを選択

2

Download fileアクションを選択します。

Download fileアクションを選択Download fileアクションを選択

3

前の手順で作成したSFTPコネクションを選択します。

4

File pathフィールドに、ファイル拡張子を含むCSVファイルの完全パスを入力します。 たとえば、ファイルが/sftp/Customer_orders.csvにある場合は、この値をフィールドに入力します。

5

任意です。 Encodingドロップダウンメニューでエンコーディング値を選択し、明示的に設定します。

6

任意です。 SFTPサーバーがマルチパートダウンロードをサポートしていない場合に、ファイルを一括でダウンロードするかどうかを決定するには、Download file in one goドロップダウンメニューを使用します。 サポートされる最大サイズは200 MBです。 デフォルト値はNoに設定されています。 より大きなファイルのダウンロードには、このオプションを選択しないでください。

7

保存をクリックします。

12

+ Add stepをクリックし、Action in appを選択します。

13
CSVツール by Workato Parse CSVアクションを設定します。

CSVツール by Workato Parse CSVアクションの設定

このアクションは、前の手順のファイル内容(CSV形式の文字列)をマッピングし、その内容を行の配列に解析します。 このアクションでは最大50,000行を変換できます。

1

CSVツール by Workatoを検索し、アプリとして選択します。

CSVツール by Workatoを選択CSVツール by Workatoを選択

2

Parse CSVアクションを選択します。

Parse CSVアクションを選択Parse CSVアクションを選択

3
ファイルの内容Step 2データピルをCSV contentsフィールドにマッピングします。

ファイルの内容データピルをマッピングファイルの内容Step 2データピルをマッピング

4

Column delimiterフィールドに移動し、CSV内容で列を区切る方法を定義する区切り文字を選択するか、カスタム文字を入力します。

使用可能なオプションには、commaspacetabcolonsemicolonpipeがあります。

5

CSV contents contain header line?ドロップダウンメニューを使用して、解析から除外するヘッダー行がCSVに含まれているかどうかを指定します。

6

Header schemaでCSV列を説明します。 サンプルCSVファイルをアップロードしてすべての列名を一度に入力するか、Add column nameをクリックして列名を手動で追加できます。

この例では、次のスキーマを使用します。

csv
Order ID,Customer Name,Customer Email,Product SKU,Product Name,Quantity Ordered,Order Status,Shipping Address,Order Total,Order Date
7

任意です。 Keep track of columns byフィールドで、Workatoが列を追跡する方法を指定します。 Column orderまたはColumn nameを選択できます。 想定するCSV内容で列の順序または名前が変わる場合は、このフィールドを設定します。

8

任意です。 Quote characterフィールドで、CSVセル値を引用するために使用する文字を指定します。 使用可能なオプションには、Double quoteSingle quoteNoneがあります。 引用文字を使用しない場合は、Noneを選択します。

9

任意です。 Encoding of the file contentフィールドでファイルのエンコーディングを指定します。 デフォルトでは、エンコーディングはUTF-8に設定されています。

10

保存をクリックします。

14

+ Add stepをクリックし、Repeat for eachを選択します。

Repeat for eachを追加Add step > Repeat for eachをクリック

Repeat for each条件はどのように機能しますか?

CSVとQuickbaseのRepeat for each条件の例

Repeat for eachループは、リスト内の各アイテムに対して1つ以上のアクションを繰り返します。 リスト全体の処理が完了すると、ループは自動的に終了します。

15
CSVとQuickbaseのRepeat for eachループをセットアップします。

CSVとQuickbaseのRepeat for eachループをセットアップする

この手順では、CSVファイルの各行をRepeat for eachループで処理します。 ループを設定した後、各行に対して実行するアクションを定義します。 このレシピはQuickbaseテーブル内のレコードを更新します。

1
Step 3データピルをInput listフィールドにマッピングします。

LinesデータピルをマッピングStep 3データピルをマッピング

2

Repeat modeフィールドでOne item at a timeが選択されていることを確認します。

3

Clear step outputフィールドでNoが選択されていることを確認します。

4

保存をクリックします。

16
Quickbase Update recordアクションをセットアップします。

Quickbase Update recordアクションをセットアップする

この手順はRepeat for eachループ内で実行されます。 このアクションは、解析されたCSVファイルから処理された各行について、Quickbaseテーブル内の対応するレコードを更新します。

1

Select an app and actionをクリックします。

2

Quickbaseを検索し、アプリとして選択します。

アプリとしてQuickbaseを選択アプリとしてQuickbaseを選択

3

Update recordアクションを選択します。

Update recordアクションを選択Update recordアクションを選択

4

前の手順で作成したQuickbaseコネクションを選択します。

5

Applicationドロップダウンメニューで、Quickbaseアカウントからアプリケーションを選択します。

6

アプリがデータアクセスにトークンを要求するよう設定されている場合は、Application tokenを指定します。

アプリトークンを取得する方法については、Quickbaseドキュメントを参照してください。

7

リストからテーブルを選択するか、Table/Table IDフィールドにテーブルIDを入力します。

8

変更するレコードの識別子または主キーを指定するには、Record IDフィールドを使用します。

9

更新するテーブルフィールドを選択するには、Table field listドロップダウンメニューを使用します。 Workatoは、Quickbaseテーブルから最大150個のフィールドをサポートしています。

10

Foreach (Step 4 output) のデータツリーのデータピルを、それぞれのフィールドにマッピングします。 たとえば、顧客名Step 4データピルをCustomer Nameフィールドにマッピングし、顧客メールStep 4データピルをCustomer Emailフィールドにマッピングします。

Repeat for eachループの出力をマッピングRepeat for eachループの出力をマッピング

11

保存をクリックします。

SFTP CSVファイルからQuickbaseレコードを更新するレシピをテストして実装する準備ができました。

Last updated: