[ファイル属性の設定] アクティビティ

リリースバージョン: Zurich

更新日 2025年07月31日

所要時間：2分

[ファイル属性の設定] アクティビティは、SFTP サーバー上のファイルまたはディレクトリーの一般的なファイル属性 (タイムスタンプ、サイズ、権限、UID/GID など) を設定します。

最初に [ファイルリストを入手] アクティビティを使用して、ファイルとその属性のリストを返すことをお勧めします。次に、ソースホストからターゲットホストにファイルを移動する場合、[ファイル属性の設定] アクティビティを使用してターゲットファイル上でソースファイル属性を設定します。これは SFTP ファイル転送ワークフローで説明します。

入力変数

表 : 1. [ファイル属性の設定] 入力変数
変数	説明
sourceHost	属性を変更するファイルまたはディレクトリーを含むサーバーの名前または IP アドレス。
sourcePort	ターゲットサーバーとの通信に使用するポート番号。デフォルトのポート番号は 22 です。
sourceFilePath	属性を変更するファイルまたはディレクトリーの完全パス。
userID	ファイルまたはディレクトリーに適用するユーザー ID 属性。UID 変数と GUID 変数は、ペアとして一緒に設定する必要があります。
groupID	ファイルまたはディレクトリーに適用するグループ ID 属性。UID 変数と GUID 変数は、ペアとして一緒に設定する必要があります。
permissions	指定されたユーザーおよびグループに対して設定されたファイルまたはディレクトリーの権限。この値は整数で表す必要があります (例：16877)。この値が rwxr-xr-x のような権限を定義します。注: 権限番号は、[ファイルリストを入手] アクティビティによって返される内部値です。
accessTimestamp	ファイルまたはディレクトリーが最後にアクセスされたタイムスタンプを上書きします。アクセスおよび変更のタイムスタンプは、ペアとして一緒に設定する必要があります。
modificationTimestamp	ファイルまたはディレクトリーが最後に変更されたときのタイムスタンプを上書きします。アクセスおよび変更のタイムスタンプは、ペアとして一緒に設定する必要があります。
sizeInBytes	ファイルまたはディレクトリーのサイズ (バイト単位)。
sourceCredentialTag	ホストで SSH コマンドを実行するために、このアクティビティが使用する必要のある特定のオーケストレーションアクティビティの認証情報エイリアス。

出力変数

表 : 2. [ファイル属性の設定] 出力変数
変数	説明
errorMessage	アクティビティデザイナーの解析ソースからの executionResult.errorMessages。この変数が NULL 以外の場合、操作は失敗します。
result	コマンドが正常に実行されたことを通知するテキストメッセージ。

条件

表 : 3. [ファイル属性の設定] 条件
条件	説明
成功	アクティビティが指定されたファイルまたはディレクトリーの属性の変更に成功しました。
失敗	アクティビティが指定されたファイルまたはディレクトリーの属性の変更に失敗しました。