ファイル管理

ファイル管理

お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

早期アクセス
[ファイル管理]タブは、すべてのユーザーに対して有効になっているわけではありません。お試しになりたい場合は、早期アクセスについてメールでサポートチームにお問い合わせください。

[ファイル管理]タブでは、さまざまな場所間でファイル転送操作を実行でき、ファイル管理を柔軟かつ便利に行えます。ネットワーク内でファイルを移動したり、クラウドストレージとの間でファイルを転送したりできます。
 
このタブでは、次の3つのファイル転送モードを利用できます。
  1. リモートからクラウド(ファイルアップロード) - リモートマシンからQntrlの[ファイル]タブにファイルを転送します。これにより、クラウドベースのストレージにアップロードされます。
  2. クラウドからリモート(ファイルダウンロード) - Qntrlの[ファイル]タブからリモートマシンにファイルを転送します。クラウドに保存されているファイルを取得し、ローカルデバイスにダウンロードする必要がある場合に特に便利です。
  3. リモートからリモート(ファイル転送) - 同じネットワークに接続されている2台のマシン間でファイルを転送します。ネットワーク内のリモートデバイス間でファイルを直接移動する場合に適しています。

対応しているファイル操作

移動- 転送元から転送先にファイルを移動します。ただし、転送元の場所から削除されるのはファイルのみで、転送元フォルダーは元の場所に残ります。
コピー - コピーすると、ファイルの完全な複製が作成され、別の場所に保存されます。元のファイルは転送元に残ります。
再帰- 転送元ディレクトリー内のすべてのファイルとサブフォルダー(入れ子になったサブディレクトリー内のファイルを含む)を移動/コピーします。フォルダー構造全体を複製し、元の階層を維持する場合に便利です。
クラウドストレージからファイルをダウンロードするファイルダウンロードのタスクでは、再帰はサポートされていません。

ユースケース

一般的なビジネスシナリオでは、購入が完了した際に、請求書や請求関連書類のコピーをリモートマシンに保存する必要があります。このタブでは、これらのコピーを効率的に保存できます。プロセス所有者は、ジョブまたは[ファイル]タブに関連する請求書や請求関連ファイルをリモートデバイス上の指定フォルダーに転送でき、整理された安全なファイル管理を実現できます。

 

前提条件

  • 認証情報の作成時に種類]で[SSHを選択し、リモートマシンのユーザー名とパスワードを入力します。こちらをクリックして、認証情報の作成方法を確認してください。

  • [ファイル]タブとやり取りするには、認証済みの接続を確立する必要があります。[ファイル]タブに接続するには、Bridge Agent内のOAuth設定セクションを参照してください。

ペイロード形式

各ファイル転送操作のペイロード例は以下のとおりです。

1. クラウドからリモート(ファイルダウンロード)

{
'task_name': 'file_task',
'task_details': {
'source': {
'cloud': {
'path': '<QNTRL FILE タブ PATH>',
'type': 'qntrl_files'
}
  },
'destination': {
'remote': {
'path': '<REMOTE FILE PATH>',
'credential_name': '<CREDENTIAL_NAME>',
'host': 'localhost'
}
}
}
}

 

2. リモートからクラウドへ(ファイルアップロード)

{
'task_name': 'file_task',
'action': '<move/copy>',
'subfolder_copy': <true/false>,
'task_details': {
'source': {
'remote': {
'path': '<REMOTE FILE タブ PATH>',
'credential_name': '<CREDENTIAL_NAME>',
'host': 'localhost'
}
},
       'destination': {
'cloud': {
'path': '<QNTRL FILE タブ PATH>',
'type': 'qntrl_files',
'overwrite': true
}
}
}
}

 


3. リモートからリモートへ(ファイル転送)
{
'task_name': 'file_task',
'action': '<move/copy>',
'subfolder_copy': <true/false>,
'task_details': {
'source': {
'remote': {
'path': '<FILE PATH>',
  'credential_name': '<REMOTE CREDENTIAL NAME>',
'host': '<HOST NAME>'
}
},
'destination': {
'remote': {
'path': '<FILE PATH>',
'credential_name': '<REMOTE CREDENTIAL NAME>',
'host': '<Host Name>'
}
}
} 
}


正規表現パターン(*)は、移動操作ではサポートされていません。
各項目は次のとおりです。

キー

説明

task_name

該当するタブのシステム定義名です。'file_task'は、ファイル管理タスクのタスク名です。

action

実行するファイル操作の種類を指定します。

  1. move
  2. copy

subfolder_copy

(任意)

再帰的な転送を実行するかどうかを指定します。

  1. true
  2. false

指定しない場合、初期設定では'true'に設定されます。

task_details

タスクの詳細を含むJSONオブジェクトです。

destination

ファイルの転送先の場所に関する情報を含むJSONオブジェクトです。

source

ファイルの転送元の場所に関する詳細を含むJSONオブジェクトです。

remote

接続先のリモートマシンの詳細を含むJSONオブジェクトです。

cloud

クラウドネットワーク/ストレージを指します。

path

リモートマシン内のファイルの場所です。

credential_name

リモートマシン用に[認証情報]タブ内で作成された認証情報オブジェクトの名前です。

host

リモートマシンのホスト名です。

type

'qntrl_files':ファイルがQntrlの[ファイル]タブで利用可能な場合に指定します。

overwrite

既存ファイルの内容を更新する場合に使用します。

  1. true
  2. false

Windowsマシンの場合、ファイルパスは'\\'にする必要があります。




    • Related Articles

    • ファイル

      お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 Filesタスクでは、ファイル管理用のワークフローを作成できます。利用可能な状態は次のとおりです。 ファイルアップロード ファイル転送 ファイルダウンロード 前提条件 有効なBridgeエージェント。こちらを参照して、Bridgeをインストールして設定します。 ...
    • Circuitの状態の概要

      お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 ステートは、タスクの実行、判断、またはあるステートから別のステートへの出力の受け渡しを行うサーキットの構成要素です。ステートは、サーキットのその区間で実行する必要がある特定のタスクやプロセスを定義します。 サーキットのステートは次のように分類されます。 フロー制御 機能 通知 ...
    • Bridge Agentの設定

      お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 Bridge Agentは、Bridgeのインストール環境におけるローカル管理コンソールとして機能します。サービス設定、実行ログ、メッセージ、認証情報、通信設定にアクセスできます。 Agent UIには、Bridgeがインストールされている同じネットワーク内からのみアクセスできます。 ...
    • 関数

      お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 早期アクセス 関数はすべてのユーザーに対して有効になっているわけではありません。組織で Circuit を有効にしている場合、すべてのカスタム関数は関数として移行されます。Circuit をお試しになりたい場合は、早期アクセスについてサポートチームにメールでお問い合わせください。 ...
    • 追加コンポーネントの設定

      お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 早期アクセス Qntrl StudioのCircuitテンプレートは、すべてのユーザーには有効になっていません。お試しになりたい場合は、早期アクセスについてサポートチームにメールでお問い合わせください。 Webhook ...