事前コミットトリガーを持つアクションスクリプト

文字

using System.Linq;

var webExtensions = new { ".jpg", ".jpeg", ".png", ".gif" };

var entity = Context.Target as IEntity;

// Make sure that the following members are loaded await entity.LoadMembersAsync(new PropertyLoadOption("FileName"), new RelationLoadOption("AssetTypeToAsset"));

var filename = entity.GetPropertyValue("FileName"); if (string.IsNullOrEmpty(filename)) return; // No filename, nothing to do.

var extension = GetExtension(filename)?.ToLowerInvariant();

if (string.IsNullOrEmpty(extension)) return; if (!webExtensions.Contains(extension)) return;

var query = Query.CreateQuery(entities => from e in entities where e.Identifier == "M.AssetType.Web" select e);

var webTypeId = await MClient.Querying.SingleIdAsync(query); if (!webTypeId.HasValue) return;

var relation = entity.GetRelation("AssetTypeToAsset"); if (relation == null) return;

relation.Parent = webTypeId;

string GetExtension(string path) { var tokens = path.Split('.'); if (tokens.Length > 1) { return "." + tokenstokens.Length - 1; } return null; }

脚本の説明

このセクションでは、スクリプトを実行順に順に進め、各パートについて説明します。番号付きの項目はシーケンスを記述しており、実行命令ではありません。

1. スクリプトで使用するライブラリを含めてください。どのライブラリを含めるべきかを理解するには、「 コンテキストプロパティ (プロパティタイプ)」を参照してください。

   using System.Linq;

2. ウェブ互換のファイル拡張子のリストを定義し、どのファイルがウェブアセットと認められるかを判断します。

   var webExtensions = new { ".jpg", ".jpeg", ".png", ".gif" };

3. ファイル名プロパティとアセットタイプの関係が読み込まれていることを確認してください。もし読み込まれていなければ、怠惰に読み込まれます。

   // Make sure that the following members are loaded await entity.LoadMembersAsync(new PropertyLoadOption("FileName"), new RelationLoadOption("AssetTypeToAsset"));

4. コンテキスト(Context.Target)からターゲットエンティティを取得し、必要なメンバーを読み込みます。これにはFileNameプロパティとAssetTypeToAsset関係が含まれます。エンティティが無効またはファイル名が空の場合、スクリプトは終了します。

   var entity = Context.Target as IEntity;

   // Make sure that the following members are loaded await entity.LoadMembersAsync(new PropertyLoadOption("FileName"), new RelationLoadOption("AssetTypeToAsset"));

   var filename = entity.GetPropertyValue("FileName"); if (string.IsNullOrEmpty(filename)) return;

   !警告Targetオブジェクトタイプはトリガーの目的(例えばエンティティ、エンティティ定義、ポリシー)に依存します。この場合、トリガーの目的はEntity creationとEntity modificationです。したがって、IEntityにTargetをキャストする必要があります。

5. GetExtensionヘルパーメソッドを使ってファイル名から拡張子を抽出します。拡張子がウェブ互換拡張子のリストに存在しない場合、スクリプトは終了します。

   var extension = GetExtension(filename)?.ToLowerInvariant();

   if (string.IsNullOrEmpty(extension)) return; if (!webExtensions.Contains(extension)) return;

6. M.AssetType.Webエンティティを見つけるクエリを作成します。エンティティが見つからなければ、スクリプトは終了します。

   var query = Query.CreateQuery(entities => from e in entities where e.Identifier == "M.AssetType.Web" select e);

   var webTypeId = await MClient.Querying.SingleIdAsync(query); if (!webTypeId.HasValue) return;

   !注MClientオブジェクトは常に利用可能で、すべてのスクリプトタイプで使用できます。

7. アセットからAssetTypeToAssetリレーションを取得します。リレーションが存在する場合、そのリレーションの親をM.AssetType.Webエンティティに設定し、アセットをウェブアセットタイプにリンクさせます。リレーションがなければスクリプトは終了します。

   var relation = entity.GetRelation("AssetTypeToAsset"); if (relation == null) return;

   relation.Parent = webTypeId;

8. ヘルパーメソッドGetExtensionファイル名から拡張子を抽出し、関連するファイルタイプのみが処理されるようにします。

   string GetExtension(string path) { var tokens = path.Split('.'); if (tokens.Length > 1) { return "." + tokenstokens.Length - 1; } return null; }

!注IDだけを回収するにはContext.TargetIdを使えますが、エンティティ全体を取り戻したい場合はContext.Targetを使うことをお勧めします。

セットアップ

1. タクソノミーページで、識別子M.AssetType.WebのWeb名のアセットタイプを作成します。
2. 上記のスクリプトを作成Action
3. Action scriptのアクションを作成し、スクリプトにリンクします。
4. 新しいトリガーを作成し 、そのトリガーの目標を Entity creation と Entity modificationに設定します。
   • トリガー条件でエンティティの定義を追加 Asset 「 *Filename has changed」*という条件を追加します。
   • トリガーアクションで新しいアクションを 事前コミットアクションに追加します。
5. トリガーをセーブして有効化してください。