Optimizely OMVP の 1 日

OptiGraphExtensions アドオンは、Optimizely コミュニティの多くの人々が待ち望んでいた重要なアップデートを受け取りました。 包括的な Webhook 管理 CMS 管理インターフェイス内で直接実行できます。

このプロジェクトに詳しくない方のために説明すると、OptiGraphExtensions は、使い慣れた CMS 環境に高度な Optimizely Graph 管理機能をもたらす Optimizely CMS 12 のオープンソース アドオンです。同義語とピン留めされた結果を管理するための強力な機能がすでに提供されていましたが、今回 Webhook が加わりました。

Webhook が重要な理由

Webhook は、最新のイベント駆動型アーキテクチャのバックボーンです。 Optimizely Graph のコンテキストでは、コンテンツの変更が発生したときにアプリケーションがリアルタイムの通知を受信できるようにします。静的サイトの再構築、キャッシュの無効化、検索インデックスの更新、またはダウンストリーム システムへの通知のいずれをトリガーする場合でも、Webhook により定期的なポーリングの必要性がなくなり、真にリアクティブなコンテンツ ワークフローが可能になります。

これまで、これらの Webhook を管理するには、API 呼び出しまたは外部ツールを使用する必要がありました。 OptiGraphExtensions は、Webhook 管理を Optimizely CMS 管理パネルに直接導入することで、この状況を変えます。

Webhook 管理で何ができるでしょうか?

新しい Webhook 機能は、既存の CMS 管理エクスペリエンスとシームレスに統合されるクリーンで直感的なインターフェイスを備えた完全な CRUD 操作を提供します。

特定のイベントを購読する

トピック選択システムを使用すると、どのイベントが Webhook をトリガーするかを詳細に制御できます。次のような個別のイベントを購読できます。 doc.created、 doc.updated、 または doc.deleted、または次のようなワイルドカード パターンを使用します。 doc.* すべてのドキュメント イベントまたは *.* すべての通知を受け取ることができます。この柔軟性は、関連する変更が発生した場合にのみ起動される、正確にターゲットを絞った Webhook を設定できることを意味します。

精度を高めるためのフィルターの構成

すべてのコンテンツ変更がすべての Webhook をトリガーする必要があるわけではありません。フィルター構成を使用すると、特定の基準に基づいて Webhook を起動するタイミングを絞り込むことができます。たとえば、「公開済み」ステータスのコンテンツが変更された場合にのみ実稼働 CDN キャッシュを無効にし、下書きの保存とプレビューの更新を完全に無視するようにフィルターを構成できます。

HTTP メソッドとステータスの制御

各 Webhook は、POST、GET、PUT、PATCH、DELETE など、エンドポイントに適切な HTTP メソッドを使用して構成できます。また、Webhook のステータスを完全に制御できるため、Webhook を削除せずに有効または無効にすることができます。これは、メンテナンス期間中や統合の問題をデバッグするときに特に役立ちます。

リアルタイム同期

既存のシノニム機能やピン留めされた結果機能と同様に、Webhook 管理は Optimizely Graph API とのリアルタイム同期の恩恵を受けます。管理インターフェイスで行った変更はすぐにグラフに反映され、インターフェイスは同期ステータスに関する明確なフィードバックを提供します。

はじめる

すでに OptiGraphExtensions を使用している場合は、最新バージョンに更新すると、CMS 管理パネル内の OptiGraph Extensions メニューに新しい Webhook オプションが表示されます。

アドオンを初めて使用する場合、インストールは簡単です。新しい v4.0.0 NuGet パッケージを Optimizely CMS 12 プロジェクトに追加します。

dotnet add package OptiGraphExtensions

次に、サービスを設定します Program.cs または Startup.cs:

// Add services
services.AddOptiGraphExtensions(options =>
{
    options.ConnectionStringName = "EPiServerDB";
});

// Configure the application
app.UseOptiGraphExtensions();

OptiGraphExtensions は対話型管理インターフェイスに Blazor を使用するため、Blazor サーバー側が構成されていることを確認します。

services.AddServerSideBlazor();

app.UseEndpoints(endpoints =>
{
    endpoints.MapContent();
    endpoints.MapBlazorHub();
    endpoints.MapControllers();
});

最後に、Optimizely Graph 構成を appsettings.json:

{
  "Optimizely": {
    "ContentGraph": {
      "GatewayAddress": "",
      "AppKey": "",
      "Secret": ""
    }
  }
}

実装に関する注意事項

言及する価値のある技術的な詳細が 1 つあります。Optimizely Graph PUT エンドポイントの制限 (トピックとフィルターを確実に更新しない) のため、OptiGraphExtensions は Webhook を削除して再作成することで Webhook 更新を実装します。これは、Webhook ID が編集後に変更されることを意味します。Webhook ID を外部で追跡している場合は、注意が必要です。

全体像

シノニムとピン留めされた結果を結合する Webhook 管理により、OptiGraphExtensions は Optimizely Graph 管理ツールの包括的なスイートを提供するようになりました。コンテンツ編集者と管理者は、使い慣れた CMS 環境を離れることなく、検索エクスペリエンスを微調整したり、イベント駆動型の統合を構成したりできます。

このアドオンは、インテリジェントなキャッシュ、接続プーリングを備えたクリーンなアーキテクチャ原則に従い続けます。 IHttpClientFactoryおよび、Graph が一時的に利用できない場合にローカル データに正常にフォールバックする堅牢なエラー処理。

参加してみよう

OptiGraphExtensions はオープンソースであり、コミュニティからの貢献を歓迎します。バグ レポート、機能リクエスト、プル リクエストのいずれであっても、皆様のご意見は、Optimizely エコシステムの全員にとってこのツールをより良いものにするのに役立ちます。

GitHub でプロジェクトをチェックしてください。 https://github.com/adayinthelifeofapro/OptiGraphExtensions

このアドオンは NuGet で入手でき、Optimizely CMS 12+ で .NET 6.0 と .NET 8.0 の両方をサポートします。

OptiGraphExtensions は、Optimizely CMS プラットフォームを強化するために設計された独立したオープンソース プロジェクトです。

2026 年 1 月 7 日