WCF アプリケーションで Adobe Experience Manager のデータの OData サービスを公開

Jerod Johnson
Director, Technology Evangelism

この記事では、WCF サービスアプリケーションを開発してAdobe Experience Manager のデータの OData フィードを生成する方法を解説します。

CData ADO.NET Provider for Adobe Experience Manager を使用すると、Windows Communication Foundation（WCF）フレームワークを活用してサービス指向アプリケーションを素早く開発し、Adobe Experience Manager のデータを OData コンシューマーに提供できます。この記事では、接続用の Entity Data Model を作成し、WCF Data Service を構成して OData サービスを公開する方法を解説します。公開したフィードは、Power Pivot や CData ADO.NET Provider for OData を使用するアプリケーションなど、さまざまな OData クライアントから利用できます。

OData サービスの作成

以下の手順で、OData 経由でAdobe Experience Manager のデータへの接続を提供する WCF サービスアプリケーションを作成します。

Visual Studio を開き、新しいプロジェクトを作成します。WCF Service Application テンプレートを選択します。
自動生成された IService.cs と Service1.svc を削除します。
Entity Framework 6 をインストールします：
Visual Studio のパッケージマネージャーコンソールを使用して、最新バージョンの Entity Framework をインストールします。以下のコマンドを実行すると、Entity Framework が自動的にダウンロード・インストールされます。
```
Install-Package EntityFramework
```
Entity Framework プロバイダーを登録します：
1. App.config または Web.config ファイルの "providers" セクションに、以下のプロバイダーエントリを追加します。Entity Framework のインストールが成功していれば、このセクションはすでに存在しているはずです。
```
<configuration>
...
<entityFramework>
  <providers>
    ...
    <provider invariantName="System.Data.CData.AdobeExperienceManager" type="System.Data.CData.AdobeExperienceManager.AdobeExperienceManagerProviderServices, System.Data.CData.AdobeExperienceManager.Entities.EF6" />
  </providers>
</entityFramework>
</configuration>
```
2. インストールディレクトリの lib/4.0 にある System.Data.CData.AdobeExperienceManager.Entities.dll への参照を追加します。
3. プロジェクトをビルドして、EF6 のセットアップを完了します。
Project -> Add New Item -> ADO.NET Entity Data Model をクリックします。
表示される Entity Data Model ウィザードで、'EF Designer from Database' オプションを選択します。
Choose Your Connection ダイアログが表示されたら、New Connection をクリックします。
Connection properties ダイアログで、CData Adobe Experience Manager Data Source を選択し、必要な認証情報を入力します。
一般的な接続文字列は以下のとおりです：
```
URL=https://author-p12345-e67890.adobeaemcloud.com/crx/server;User=admin;Password=admin;
```
Adobe Experience Manager（AEM）の WebDAV 経由で JCR リポジトリを公開するインスタンスに接続します。オンプレミスの AEM と AEM as a Cloud Service の両方のデプロイメントに対応しています。

接続するには、以下のプロパティを設定してください。
- URL: WebDAV 対応の JCR サーバー URL。
  - AEM as a Cloud Service: https://author-pXXXXX-eXXXXX.adobeaemcloud.com/crx/server
  - ローカル開発: http://localhost:4502/crx/server
- User: AEM のユーザー名。
- Password: AEM のパスワード。
注意: テーブルは JCR リポジトリの構造に基づいて動的に生成されます。設定したユーザーが AEM リポジトリ内の必要なコンテンツパスにアクセスするための十分な権限を持っていることを確認してください。
OData クライアントからアクセスさせたい Adobe Experience Manager のテーブルとビューを選択します。
Project -> Add New Item -> WCF Data Service をクリックします。

データソースクラスを指定し、新しい WCF Data Service へのアクセスを構成します。以下の例では、エンティティの Access Rule が All に設定されています。これは、すべてのユーザーがデータの読み取りと変更を行えることを意味します。

  
using System;
using System.Collections.Generic;
using System.Data.Services;
using System.Data.Services.Common;
using System.Linq;
using System.ServiceModel.Web;
using System.Web;

namespace AdobeExperienceManagerService{
  public class AdobeExperienceManagerDataService : DataService<AdobeExperienceManagerEntities> {
    public static void InitializeService(DataServiceConfiguration config) {
      config.SetEntitySetAccessRule("*", EntitySetRights.All);
      config.DataServiceBehavior.MaxProtocolVersion = DataServiceProtocolVersion.V3;
    }
  }
}

プロジェクトを実行します。これで、OData 対応アプリケーションから Salesforce データにアクセスし、変更を反映できるようになります。ブラウザでフィードにアクセスできます。フィードは次のように表示されます：

Power Pivot から OData サービスを利用する

これで、任意の OData クライアント（例：Excel Power Pivot）からサービスを利用できます。

Excel を開き、Power Pivot Window ボタンをクリックします。
新しいポップアップが表示されます。From Data Feeds オプションを選択します。
表示される Table Import Wizard で、OData URL を入力します（例：http://localhost:12449/AdobeExperienceManagerDataService.svc/）。
OData サービスへの接続後、ウィンドウ下部の Next ボタンをクリックします。
ウィザードの次のウィンドウに、利用可能なテーブルの一覧が表示されます。インポートするテーブルを選択し、Finish をクリックします。
Close をクリックして、Power Pivot にデータをインポートします。