--- title: "Sitecore Content Hub DAM Contentfulのためのコネクター" slug: "sitecore-content-hub-dam-connector-for-contentful" abstract: "コネクターを使ってContent HubとContentfulを統合し、Content HubのアセットをContentfulで使えるようにする方法。" --- # Sitecore Content Hub DAM Contentfulのためのコネクター ContentfulのSitecore Content Hub DAMコネクターはContent HubとContentfulを統合し、著者や編集者が承認されたアセットを直接Contentfulフィールドに挿入できます。これにより、Contentfulを使いながらアセットをContent Hubに集中管理できます。 > !注コネクターをインストールし設定するには、*スーパーユーザー* であるか、[ユーザーグループポリシー](https://doc.sitecore.com/ch/ja/users/content-hub/configure-a-user-group-policy.html "Configure a user group policy")を通じて必要な権限が付与されている必要があります。また、コンテンツフルの組織とスペースの*Admin*ロールも必要です。 コネクターの使用方法: :::攻略 1. [アプリの定義を作成する](https://doc.sitecore.com/ch/ja/users/content-hub/sitecore-content-hub-dam-connector-for-contentful.html#create-the-app-definition) 2. [ページ名を探す](https://doc.sitecore.com/ch/ja/users/content-hub/sitecore-content-hub-dam-connector-for-contentful.html#find-the-page-name) 3. [コンテンツを充実した空間にインストールしてください](https://doc.sitecore.com/ch/ja/users/content-hub/sitecore-content-hub-dam-connector-for-contentful.html#install-the-app-in-a-contentful-space) 4. [アプリをコンテンツタイプに割り当ててください](https://doc.sitecore.com/ch/ja/users/content-hub/sitecore-content-hub-dam-connector-for-contentful.html#assign-your-app-to-a-content-type) 5. [コネクターが動作しているか確認してください](https://doc.sitecore.com/ch/ja/users/content-hub/sitecore-content-hub-dam-connector-for-contentful.html#validate-that-the-connector-works)::: ## アプリの定義を作成する アプリの定義は、Contentfulがインストール、提供、実行時にどのようにアプリを扱うべきかを理解するために必要なメタデータを定義しています。 アプリの定義を作成するには: 1. [Contentfulウェブアプリ](https://www.contentful.com/help/getting-started/contentful-web-app-overview/)にログインしてください。 2. 権限に応じて整理設定やスペース設定を開きます。 3. アプリ **タブをクリックすると** 、**アプリ詳細** ページを開きます。 4. **アプリ詳細**ページで「**アプリを作成」**をクリックします。 ![Apps dialog from where you can create an app](https://doc.sitecore.com/api/markdown-image/ch/ja/users/content-hub/images/contentful-apps-dialog.png) 5. 以下の情報を指定してください: - **名前** - 例えば記述的な名前、 *Sitecore DAM*。 - **アイコン** - アプリを識別するためのアイコンです。 - **フロントエンドURL** - CloudflareにデプロイされたContentfulコネクタの公開URL(https://ch-connector-contentful.sitecorecontenthub.cloud/)。本番環境にデプロイされていないコネクタのバージョンを試すには、公開統合URL(https://ch-connector-contentful-staging.sitecore-staging.cloud/)を使い、Content Hubインスタンスの CORSConfiguration に必ず追加してください。統合URLにデプロイされたバージョンは不安定になることがあります。 ![Contentful app details dialog where you can define the name, assign an icon, and provide frontend details](https://doc.sitecore.com/api/markdown-image/ch/ja/users/content-hub/images/contentful-app-details.png) 6. **「ロケーション」**ダイアログで、アプリに必要なロケーションを選択してください: - **アプリ設定画面** - Content Hubの基本URLとページ名を指定する場です。デフォルトではページ名は SCAssetConnectorです。 - **エントリフィールド** - コンテンツ作成者や編集者がContentfulフィールド内でContent Hubの資産と直接やり取りする主要なユーザー向けコンポーネントを示すJSONオブジェクトです。 他のチェックボックスはすべて選択していないままにしてください。 ![Locations section where you specify how the app will render](https://doc.sitecore.com/api/markdown-image/ch/ja/users/content-hub/images/contentful-locations.png) 7. **「保存**」をクリックします。 ## ページ名を探す アプリの定義を設定する際には、ベースURLとページ名を指定します。ページ名はContentfulポータルでレンダリングされるページです。デフォルトではSCAssetConnectorですが、必要に応じて自分でページ名を定義することもできます。 ページ名を見つけるには: 1. メニューバーで **「管理** :mdiCogOutline:」をクリックします。 2. **管理**ページで「**ページ」**をクリックします。 3. **ページ**ページ左のペインで、扱いたいページを選択し、**情報**タブをクリックします。 **名前**フィールドには[コネクタを取り付け](https://doc.sitecore.com/ch/ja/users/content-hub/sitecore-content-hub-dam-connector-for-contentful.html#UUID-6e103cd8-127c-bc81-3275-dd191ff899ca_section-id23539404189111 "Install the app in a Contentful space")る際に使うページ名が表示されます。 ![Location of the page name to use with the connector](https://doc.sitecore.com/api/markdown-image/ch/ja/users/content-hub/images/page-name-location.png) ## コンテンツを充実した空間にインストールしてください アプリの定義を作成したら、Contentfulスペースにアプリをインストールしてください。 コンテンツを充実した空間にインストールするには: 1. Contentfulウェブアプリで、アプリをインストールしたいスペースを開きます。 2. アプリの定義を保存してください。 3. **アクション**のドロップダウンリストから**「スペースにインストール**」を選択してください。 ![App details dialog where you can install your app](https://doc.sitecore.com/api/markdown-image/ch/ja/users/content-hub/images/contentful-install-to-space.png) 4. 必要なスペースと環境を選択し、「 **続ける**」をクリックしてください。 5. アクセス **管理** ダイアログで、選択した環境が正しいか確認し、アクセス **を承認**をクリックします。 ![Manage Access dialog where you authorize access to a space](https://doc.sitecore.com/api/markdown-image/ch/ja/users/content-hub/images/contentful-authorize-access.png) アクセスが承認されると、Sitecore DAMインスタンス設定ページに移動し、ContentHubの基本URLを設定できます。 6. インスタンス**Sitecore DAM構成** ページで、Contentful内のコネクタダイアログに表示されるContent Hubの検索ページ名Content HubベースURLと検索 [ページ名](https://doc.sitecore.com/ch/ja/users/content-hub/sitecore-content-hub-dam-connector-for-contentful.html#UUID-6e103cd8-127c-bc81-3275-dd191ff899ca_section-id235437355922371 "Find the page name") を入力します(デフォルトではSCAssetConnector。デフォルトページを使っていない場合は、自分のページ名を入力してください。 ![Configure Sitecore DAM instance dialog from where you install your app](https://doc.sitecore.com/api/markdown-image/ch/ja/users/content-hub/images/contentful-install-to-environment.png) 7. **選択した環境にインストール**をクリックします。 8. **「保存**」をクリックします。 > !ヒントアプリタブからもアプリをインストールすることができます。**アプリ**タブで**「カスタムアプリ**」を選択し、アプリの**アクション**メニューを開き、「**インストール**」を選択します。これにより*、「スペースにインストール」*フローを進み、「**アクセス管理**」ダイアログが表示され、権限を確認しアクセスを承認します。 ## アプリをコンテンツタイプに割り当ててください コンテンツモデルは扱うコンテンツの種類を定義します。アプリをインストールした後は、コンテンツタイプに割り当てる必要があります。 アプリをコンテンツタイプに割り当てるには: 1. **コンテンツモデル**タブで、希望するコンテンツタイプを選択します(例:*Recipe*)。 2. 「 **Add Field** 」をクリックして**JSONオブジェクト** を選択します(コネクターはアセットデータをJSON形式で保存します)。 3. **名前**欄にフィールド名(例:Media)を入力し、「**追加」と「設定**」をクリックします。 ![Dialog to add a new JSON object field](https://doc.sitecore.com/api/markdown-image/ch/ja/users/content-hub/images/add-field-json-object.png) 4. 設定ページの **「外観** 」セクションでアプリを選択します。他の設定は必要ありません。 ![Validation page configuration for the app](https://doc.sitecore.com/api/markdown-image/ch/ja/users/content-hub/images/contentful-validation.png) 5. **確認**をクリックします。 ## コネクターが動作しているか確認してください カスタムアプリを作成・設定した後は、Content Hubにアクセスしてアセットを選択して、コネクターが正しく実装されているか、正しく動作しているかを確認してください。 ![Dialog where you can select Content Hub assets](https://doc.sitecore.com/api/markdown-image/ch/ja/users/content-hub/images/validate-contentful-connector.png) コネクターが動作することを確認するために: 1. **コンテンツ**タブで「**追加」**をクリックして、コンテンツタイプ(例:*Recipe*)でエントリを作成します。エントリフィールド(*Media*)はSitecore Content Hub DAMコネクターで表示されます。 2. 「 **Content Hubから選択** 」をクリックすると、Content Hubに保存されているアセットを閲覧・選択できます。 ![Content tab where you can select the Editor tab and click Select from Content Hub](https://doc.sitecore.com/api/markdown-image/ch/ja/users/content-hub/images/select-from-ch.png)