Bynder (DAM) と Optimizely の統合

Bynderは、企業が画像、動画、ドキュメント、その他のメディアファイルを含むデジタルコンテンツやブランド資産を効率的に管理、保存、整理、共有できるようにする包括的なデジタル資産管理（DAM）プラットフォームです。詳細については、 バインダーこのブログでは、BynderをOptimilzeyプラットフォームに統合し、スムーズな開発プロセスを確保し、Bynderの豊富な機能を活用してプロジェクトのニーズを満たす方法について説明します。

Bynder を Optimizely と統合するには、次の手順に従います。

インストール

ステップ 1: サポートによって提供された Bynder.xxxnupkg パッケージをプロジェクトに追加します。

ステップ 2: 「パッケージ マネージャー コンソール」設定アイコンをクリックし、物理的なプロジェクト ディレクトリの場所から Bynder のパッケージ ソースを追加します。

ステップ3: Bynderパッケージの相対フォルダパス参照を nuget.config ビルドとデプロイメントを開始すると、NuGet パッケージは指定されたソースからパッケージの場所を選択するためです。

ステップ4: コマンドを実行します: Install-Package Bynder

構成：

ステップ 1: Bynder を Startup.cs に登録する

注記：

• appsettings.json: 環境固有の設定には、このファイルがよく使用されます。次のような設定値を保存するのに適しています。 BaseUrl、 ClientId、 そして ClientSecret。
• ワークフローファイル: 必要に応じて、デプロイメントまたは CI/CD セットアップに応じて、ワークフロー ファイルでこれらの設定を管理することもできます。
• この記事の推奨事項は、デモンストレーションのために簡略化されています。本番環境では、シークレットを安全に保管したり、環境固有の構成を使用するなど、セキュリティのベストプラクティスに従ってください。

ステップ 2: CMS エリアにログイン — アドオン — Bynder

ステップ 3: Bynder を Optimizely と統合してアセットを管理するには、次の手順に従います。

1. 認証トークンを取得する:

   • クリック 「トークンを取得」 認証プロセスを開始します。このトークンを使用すると、Bynder DAM から Optimizely にアイテムを追加できるようになります。

2. ホワイトリストのリダイレクト URL:

   • あなたの ‘リダイレクト URL’ Bynder ではホワイトリストに登録されています。この手順は、認証と承認を成功させるために非常に重要です。

3. トラブルシューティング:

   • Bynder アセットの追加で問題が発生した場合は、既存のトークンを削除して新しいトークンを生成してみてください。これにより、多くの場合、認証の問題が解決されます。

ステップ4: 設定するには AllowedTypes そして UIHints Bynder および Optimizely アセットのプロパティ レベルでは、通常、アセット プロパティを定義するコード内でこれを行います。設定方法は次のとおりです。

[Display(GroupName = GroupNames.Content,Order = 10)]
[AllowedTypes(typeof(VideoFile), typeof(BynderVideoAsset))]
public virtual ContentReference? Video { get; set; }

[Display(GroupName = GroupNames.Content,    Order = 10)]
[UIHint(UIHint.Image)]
[AllowedTypes(typeof(ImageFile), typeof(BynderImageAsset))]
public virtual ContentReference? Image { get; set; }

許可されるタイプ:

• ビデオファイル: 現在の機能を削除せずに、Optimizely 内の既存のビデオ アセットを最適化または変更する場合に使用します。
• 画像ファイル: Optimizely で既存の画像アセットを最適化または更新するために使用します。
• BinderVideoAsset: Optimizely のメディア フォルダーに直接アップロードされたビデオ アセットではなく、Bynder に保存されているビデオ アセットを参照または使用するには、これを使用します。
• バインダー画像アセット: Optimizely のメディア フォルダーに直接アップロードされた画像アセットではなく、Bynder に保存されている画像アセットを参照または使用するには、これを使用します。

UIヒント – 以下のいずれかの UIHint を使用してサムネイル画像を表示できます。

• [UIHint(UIHint.Image)] – これにより、Bynder と Optimizely の両方の種類のアセットのサムネイル画像が表示されます。これは、画像として指定したすべてのアセット タイプに適用される一般的な UI ヒントです。
• [UIHint(Bynder.UIHints.Bynder)] – これにより、Bynder アセットのみのサムネイル画像が表示されます。Optimizely アセットには影響しません。

注記: Bynder画像アセットのサムネイル画像が表示されない場合は、Bynderポータルにログインし、許可を得て画像を編集してください。 「公開としてマーク」

ステップ 5: Bynder または Optimizely メディア アセットからアセットをアップロードしてテストします。

ステップ 6: Bynder ジョブを実行してコンテンツを同期および更新します。

他の Bynder メディア アセットのモデル タイプとレンダリングを理解するための追加のヘルプを次に示します。

モデル：

public class BynderBlock : BlockData
{
      [AllowedTypes(typeof(BynderImageAsset))]
      [Display(GroupName = GroupNames.Content, Order = 10)]
      [UIHint(Bynder.UIHints.Bynder)]
      public virtual ContentReference? BynderImage { get; set; }

      [AllowedTypes(typeof(BynderAudioAsset))]
      [Display(GroupName = GroupNames.Content, Order = 20)]
      public virtual ContentReference? BynderAudio { get; set; }

      [AllowedTypes(typeof(BynderVideoAsset))]
      [Display(GroupName = GroupNames.Content, Order = 30)]
      public virtual ContentReference? BynderVideo { get; set; }

      [AllowedTypes(typeof(BynderDocumentAsset))]
      [Display(GroupName = GroupNames.Content, Order = 40)]
      public virtual ContentReference? BynderDocument { get; set; }
}

レンダリング：

@Html.PropertyFor(x => x.CurrentBlock.BynderImage)

OR
 
var url= Model.CurrentBlock.BynderImage.GetUrl()

Bynder メディア アセット タイプから画像 URL を読み取る拡張メソッドを作成するには、次の手順に従います。

1. 拡張メソッドを保持する静的クラスを作成します。
2. メディア アセット タイプから URL を抽出するための拡張メソッドを定義します。

このような拡張メソッドを実装する方法の例を次に示します。

public static string GetUrl(this ContentReference contentReference)
{
    if (!string.equals(contentReference.ProviderName, "bynder-assets-provider"))
    {
      return _urlResolver.GetUrl(contentReference);
    }

    IBynderAsset assetData = _contentLoader.Get(contentReference);
    if (assetData != null && assetData.AssetType.Equals("image"))
    {
        return assetData.ImageUrl;
    }
    else if (assetData != null && assetData.AssetType.Equals("video"))
    {
        var videoAsset = assetData as BynderVideoAsset;
        return videoAsset?.VideoPreviewURLs.FirstOrDefault() ?? string.Empty;
    }
    else if (assetData != null && assetData.AssetType.Equals("document"))
    {
        var documentAsset = assetData as BynderAssetData;
        return documentAsset?.TransformBaseUrl ?? documentAsset?.Original ?? string.Empty;
    }
    else if (assetData != null && assetData.AssetType.Equals("audio"))
    {
        var audioAsset = assetData as BynderAssetData;
        return audioAsset?.TransformBaseUrl ?? audioAsset?.Original ?? string.Empty;
    }

    return string.Empty;
}

このガイドが、Bynder と Optimizely を統合するための基本構成の設定に役立つことを願っています。

コメント欄にフィードバックを残してください。

ご来訪ありがとうございました！

2024年7月22日