# mulesoft API コミュニティマネージャー (api-community-manager) - Full Documentation # \[Request Access (アクセス権の要求)\] ボタン設定がない パブリッシュ済みの API バージョンに **\[Request access (アクセス権の要求)\]** ボタンが表示されない場合、次の手順に従います。 1. API Manager で API バージョンが管理されていることを確認します。 2. 管理されていない場合、**\[Import from Exchange (Exchange からインポート)\]** をクリックします。 3. API バージョンに少なくとも 1 つのエンドポイントが定義されていることを確認します。 4. エンドポイントに表示ラベルを付けます。 5. この表示ラベルはコミュニティに表示されます。 6. その API バージョンのエンドポイントの少なくとも 1 つが Exchange で公開されていることを確認します。 コミュニティビルダーで、[\[API Access Requester (API アクセスリクエスター)](https://docs.mulesoft.com/jp/api-community-manager/acm-lightning-components#api-access-requester)\] Lightning コンポーネントの対象オーディエンスを確認します。\[API Access Requester (API アクセスリクエスター)\] をすべてのメンバーに表示するには、それがどのオーディエンスにも割り当てられていないことを確認します。特定のオーディエンスのみに表示するには、それが適切なオーディエンスに割り当てられていることを確認し、そのオーディエンスのメンバーであるアカウントにログインしてページを表示することで確認します。 # 「Unauthorized endpoint (未承認エンドポイント)」エラー コンソールから実際のエンドポイントを呼び出したときに**「Unauthorized endpoint (未承認エンドポイント)」**エラーが表示される場合は、次の手順に従います。 1. Salesforce の \[設定\] を開きます。 2. コミュニティのコンテンツセキュリティポリシー (CSP) 信頼済みサイトリストを開きます。 3. リストにエンドポイントサイトドメインが含まれていることを確認します。 コンソールはユーザーのブラウザーで動作し、信頼済みエンドポイントサイトのみを呼び出すことができます。 # 1 つの API バージョンのデータが不正確か欠落している 1 つの API バージョンに不正確または欠落したデータが含まれるドキュメントやコンソールコンポーネントがある場合は、次の手順に従います。 1. API コミュニティマネージャーコントロールパネルを開きます。 2. API バージョンを編集します。 3. **\[View asset in Exchange (Exchange でアセットを表示)\]** をクリックします。 4. API コミュニティマネージャーの API バージョンが Exchange の正しい API バージョンを参照していることを確認します。 5. Exchange の API バージョンはドラフトモードではなくパブリッシュ済みであることを確認します。 # API Community Manager Release Notes Use Anypoint API Community Manager to build and operate communities around your APIs for developers and partners, both inside and outside of your organization, who write applications that use your APIs. The following release notes are provided for API Community Manager: - [Anypoint API Community Manager Release Notes](https://docs.mulesoft.com/jp/release-notes/api-community-manager/api-community-manager-release-notes) ## [](#see-also)See Also - [API コミュニティマネージャー](https://docs.mulesoft.com/jp/api-community-manager/) - [Known Issues](https://help.salesforce.com/s/issues) # API Console (API コンソール) 対話型の API Console (API コンソール) コンポーネントには REST API とメソッドの情報が表示され、ユーザーが要求を送信してメソッドをテストできます。 エンドポイントはアルファベット順に表示されます。 コンソールコンポーネントには、API Console (API コンソール)、API Console Documentation (API コンソールドキュメント)、API Console Instances (API コンソールインスタンス)、API Console Navigation (API コンソールナビゲーション)、API Console Request Panel (API コンソールリクエストパネル) が含まれます。コミュニティビルダーで、同じページに複数のコンソールコンポーネントを追加できます。コンソールコンポーネントへの変更は、同じ API を表示するそのページの他のすべてのコンソールコンポーネントに表示されます。たとえば、API Console (API コンソール) で **\[Summary (概要)\]** タブを選択すると、同じ API を表示する同じページのすべての API Console (API コンソール) で **\[Summary (概要)\]** タブが選択されます。 このコンポーネントには、[Anypoint Exchange](https://docs.mulesoft.com/jp/exchange/) からの公開 API インスタンスとドキュメントが表示されます。 API の仕様に OAuth 2.0 セキュリティが含まれている場合、ユーザーは **\[Credentials source (ログイン情報の取得源)\]** リストでクライアントアプリケーションを選択してクライアント ID とクライアントシークレットを自動的に入力するか、リストで **\[Custom credentials (カスタムログイン情報)\]** を選択してクライアント ID とクライアントシークレットを手動で入力します。  デフォルトでは、API コンソールは 2 メガバイト以下の要求をブラウザーから Salesforce Experience Cloud を介して API に送信します。サイズ制限なしで要求を許可する API インスタンスにブラウザーから直接要求を送信するには、**\[設定\]** > **\[カスタムメタデータ型\]** > **\[ACM API Console Configuration Metadata (ACM API コンソール設定メタデータ)\]** > **\[ACM API Console Configuration Metadata (ACM API コンソール設定メタデータ) を管理\]** > **\[ACM API Console Configuration (ACM API コンソール設定)\]** > **\[編集\]** を開き、**\[Browser Requests Enabled (ブラウザー要求有効)\]** を選択します。この設定は、コミュニティ内のすべての API インスタンスに適用され、モッキングサービスには影響しません。 API コンソールの次のパラメーターの値を指定できます。 **API** 表示する API を指定します。 **Show Documentation Pages (ドキュメントページを表示)** API のドキュメントページを表示します。 **Expand endpoints on start (開始時にエンドポイントを拡張)** ページの読み込み時に API エンドポイントのドキュメントを拡張します。 **Enable resource filtering (リソースの絞り込みを有効化)** ユーザーが API リソースを絞り込み、検索語に一致するリソースのみを表示できるように、ナビゲーションパネルに検索バーを表示します。 **Show endpoints toggle button (エンドポイント切り替えボタンを表示)** すべてのエンドポイントを展開または折りたたむためのボタンをナビゲーションパネルに表示します。 **Remove overview items from navigation (ナビゲーションから概要項目を削除)** 概要リンクを削除し、ユーザーがエンドポイント名をクリックしたときに概要を表示します。 **Enable expandable request panel (展開可能な要求パネルを有効化)** パネルの端にある矢印をクリックすることで、要求パネルを展開および折りたたみできるようにします。 **Link Hover Color (フロート表示リンクの色)** フロート表示リンクの色を指定します。 **Button Text Color (ボタンテキスト色) (省略可能)** ボタンテキストの色を指定します。 **Button Hover Text Color (ボタンのフロート表示テキストの色) (省略可能)** ボタンのフロート表示テキストの色を指定します。デフォルトはボタンのテキスト色です。 **Headline Font Family (見出しフォントファミリー) (省略可能)** API コンソールの見出しのフォントファミリーを指定します。 **Error Color (エラー色) (省略可能)** エラーメッセージの色を指定します。 **Method Label Get Background Color (GET メソッド表示ラベルの背景色)** GET メソッド表示ラベルの背景色を指定します。 **Method Label Get Color (GET メソッド表示ラベルの色)** GET メソッド表示ラベルの色を指定します。 **Method Label Post Background Color (POST メソッド表示ラベルの背景色)** POST メソッド表示ラベルの背景色を指定します。 **Method Label Post Color (POST メソッド表示ラベルの色)** POST メソッド表示ラベルの色を指定します。 **Method Label Put Background Color (PUT メソッド表示ラベルの背景色)** PUT メソッド表示ラベルの背景色を指定します。 **Method Label Put Color (PUT メソッド表示ラベルの色)** PUT メソッド表示ラベルの色を指定します。 **Method Label Delete Background Color (DELETE メソッド表示ラベルの背景色)** DELETE メソッド表示ラベルの背景色を指定します。 **Method Label Delete Color (DELETE メソッド表示ラベルの色)** DELETE メソッド表示ラベルの色を指定します。 **Method Label Patch Background Color (PATCH メソッド表示ラベルの背景色)** PATCH メソッド表示ラベルの背景色を指定します。 **Method Label Patch Color (PATCH メソッド表示ラベルの色)** PATCH メソッド表示ラベルの色を指定します。 **Method Label Options Background Color (OPTIONS メソッド表示ラベルの背景色)** OPTIONS メソッド表示ラベルの背景色を指定します。 **Method Label Options Color (OPTIONS メソッド表示ラベルの色)** OPTIONS メソッド表示ラベルの色を指定します。 **Method Label Head Background Color (HEAD メソッド表示ラベルの背景色)** HEAD メソッド表示ラベルの背景色を指定します。 **Method Label Head Color (HEAD メソッド表示ラベルの色)** HEAD メソッド表示ラベルの色を指定します。 **\[API Console (API コンソール)\]** ナビゲーション項目 (API エンドポイントや API メソッドなど) の名前が長い場合、2 行目に折り返されます。デフォルトでは、`word-break` CSS プロパティの値が `break-word` に設定されているため、単語の末尾で改行されます。改行の動作を変更する手順は、次のとおりです。 1. API コミュニティマネージャーコントロールパネルで **\[Community Builder (コミュニティビルダー)\]** > **\[設定\]** > **\[詳細\]** をクリックします。 2. **\[ヘッドマークアップ\]** セクションで、**\[ヘッドマークアップを編集\]** をクリックします。 3. 次のコードを挿入します。 ```html ``` 4. 必要に応じて、`api-navigation` を `api-navigation` コンポーネントが含まれるセレクターに置き換えます。 5. 必要に応じて、`break-word` を `word-break` CSS プロパティの有効な値に置き換えます。 このコンポーネントのエンドポイントまたは種類に直接リンクするには、URL クエリパラメーター `method`、`path`、`type` を設定します。`method` は小文字にする必要があります。`type` は大文字と小文字が区別されます。`method` や `path` が定義されていて API 定義に存在する場合、`type` パラメーターに関係なく、そこでナビゲーションが開きます。`method` または `path` が定義されておらず、`type` が定義されていて API 定義に存在する場合、指定した `type` でナビゲーションが開きます。例: - `communityapi/a003D000001pQpjQAE/basicapi?method=get&path=/users/{id}` - `communityapi/a003D000001pQpjQAE/basicapi?type=Users` ## [](#api-console-documentation-api-コンソールドキュメント)API Console Documentation (API コンソールドキュメント) API Console Documentation (API コンソールドキュメント) コンポーネントは、[Anypoint Exchange](https://docs.mulesoft.com/jp/exchange/) からの API に関するドキュメントを表示します。 API Console Documentation (API コンソールドキュメント) の次のパラメーターの値を指定できます。 **API** 表示する API を指定します。 **Show Documentation Pages (ドキュメントページを表示)** API ドキュメントページを表示します。 **Method Label Get Background Color (GET メソッド表示ラベルの背景色)** GET メソッド表示ラベルの背景色を指定します。 **Method Label Get Color (GET メソッド表示ラベルの色)** GET メソッド表示ラベルの色を指定します。 **Method Label Post Background Color (POST メソッド表示ラベルの背景色)** POST メソッド表示ラベルの背景色を指定します。 **Method Label Post Color (POST メソッド表示ラベルの色)** POST メソッド表示ラベルの色を指定します。 **Method Label Put Background Color (PUT メソッド表示ラベルの背景色)** PUT メソッド表示ラベルの背景色を指定します。 **Method Label Put Color (PUT メソッド表示ラベルの色)** PUT メソッド表示ラベルの色を指定します。 **Method Label Delete Background Color (DELETE メソッド表示ラベルの背景色)** DELETE メソッド表示ラベルの背景色を指定します。 **Method Label Delete Color (DELETE メソッド表示ラベルの色)** DELETE メソッド表示ラベルの色を指定します。 **Method Label Patch Background Color (PATCH メソッド表示ラベルの背景色)** PATCH メソッド表示ラベルの背景色を指定します。 **Method Label Patch Color (PATCH メソッド表示ラベルの色)** PATCH メソッド表示ラベルの色を指定します。 **Method Label Options Background Color (OPTIONS メソッド表示ラベルの背景色)** OPTIONS メソッド表示ラベルの背景色を指定します。 **Method Label Options Color (OPTIONS メソッド表示ラベルの色)** OPTIONS メソッド表示ラベルの色を指定します。 **Method Label Head Background Color (HEAD メソッド表示ラベルの背景色)** HEAD メソッド表示ラベルの背景色を指定します。 **Method Label Head Color (HEAD メソッド表示ラベルの色)** HEAD メソッド表示ラベルの色を指定します。 **Headline Font Family (見出しフォントファミリー) (省略可能)** API コンソールの見出しのフォントファミリーを指定します。 ## [](#api-console-instances-api-コンソールインスタンス)API Console Instances (API コンソールインスタンス) API Console Instances (API コンソールインスタンス) コンポーネントは、エンドポイントとも呼ばれる API の公開インスタンスのリストを表示します。 このコンポーネントには、[Anypoint API Manager](https://docs.mulesoft.com/jp/api-manager/latest/) からの公開 API インスタンスが表示されます。 API Console Instances (API コンソールインスタンス) の次のパラメーターの値を指定できます。 **API** インスタンスを表示する API を指定します。 ## [](#api-console-navigation-api-コンソールナビゲーション)API Console Navigation (API コンソールナビゲーション) API Console Navigation (API コンソールナビゲーション) コンポーネントは、API コンソールコンポーネントのナビゲーションを表示します。 このコンポーネントには、[Anypoint Exchange](https://docs.mulesoft.com/jp/exchange/) からの公開 API インスタンスとドキュメントが表示されます。 API Console Navigation (API コンソールナビゲーション) の次のパラメーターの値を指定できます。 **API** 表示する API を指定します。 **Show Documentation Pages (ドキュメントページを表示)** API のドキュメントページを表示します。 **Method Label Get Background Color (GET メソッド表示ラベルの背景色)** GET メソッド表示ラベルの背景色を指定します。 **Method Label Get Color (GET メソッド表示ラベルの色)** GET メソッド表示ラベルの色を指定します。 **Method Label Post Background Color (POST メソッド表示ラベルの背景色)** POST メソッド表示ラベルの背景色を指定します。 **Method Label Post Color (POST メソッド表示ラベルの色)** POST メソッド表示ラベルの色を指定します。 **Method Label Put Background Color (PUT メソッド表示ラベルの背景色)** PUT メソッド表示ラベルの背景色を指定します。 **Method Label Put Color (PUT メソッド表示ラベルの色)** PUT メソッド表示ラベルの色を指定します。 **Method Label Delete Background Color (DELETE メソッド表示ラベルの背景色)** DELETE メソッド表示ラベルの背景色を指定します。 **Method Label Delete Color (DELETE メソッド表示ラベルの色)** DELETE メソッド表示ラベルの色を指定します。 **Method Label Patch Background Color (PATCH メソッド表示ラベルの背景色)** PATCH メソッド表示ラベルの背景色を指定します。 **Method Label Patch Color (PATCH メソッド表示ラベルの色)** PATCH メソッド表示ラベルの色を指定します。 **Method Label Options Background Color (OPTIONS メソッド表示ラベルの背景色)** OPTIONS メソッド表示ラベルの背景色を指定します。 **Method Label Options Color (OPTIONS メソッド表示ラベルの色)** OPTIONS メソッド表示ラベルの色を指定します。 **Method Label Head Background Color (HEAD メソッド表示ラベルの背景色)** HEAD メソッド表示ラベルの背景色を指定します。 **Method Label Head Color (HEAD メソッド表示ラベルの色)** HEAD メソッド表示ラベルの色を指定します。 ## [](#api-console-request-panel-api-コンソールリクエストパネル)API Console Request Panel (API コンソールリクエストパネル) API Console Request Panel (API コンソールリクエストパネル) コンポーネントは、ユーザーがリクエストを送信して API をテストできるパネルを表示します。 このコンポーネントには、[Anypoint API Manager](https://docs.mulesoft.com/jp/api-manager/latest/) からの公開および管理 API インスタンスが表示されます。 API Console Request Panel (API コンソールリクエストパネル) の次のパラメーターの値を指定できます。 **API** 表示する API を指定します。 **Show Documentation Pages (ドキュメントページを表示)** API のドキュメントページを表示します。 **Method Label Get Background Color (GET メソッド表示ラベルの背景色)** GET メソッド表示ラベルの背景色を指定します。 **Method Label Get Color (GET メソッド表示ラベルの色)** GET メソッド表示ラベルの色を指定します。 **Method Label Post Background Color (POST メソッド表示ラベルの背景色)** POST メソッド表示ラベルの背景色を指定します。 **Method Label Post Color (POST メソッド表示ラベルの色)** POST メソッド表示ラベルの色を指定します。 **Method Label Put Background Color (PUT メソッド表示ラベルの背景色)** PUT メソッド表示ラベルの背景色を指定します。 **Method Label Put Color (PUT メソッド表示ラベルの色)** PUT メソッド表示ラベルの色を指定します。 **Method Label Delete Background Color (DELETE メソッド表示ラベルの背景色)** DELETE メソッド表示ラベルの背景色を指定します。 **Method Label Delete Color (DELETE メソッド表示ラベルの色)** DELETE メソッド表示ラベルの色を指定します。 **Method Label Patch Background Color (PATCH メソッド表示ラベルの背景色)** PATCH メソッド表示ラベルの背景色を指定します。 **Method Label Patch Color (PATCH メソッド表示ラベルの色)** PATCH メソッド表示ラベルの色を指定します。 **Method Label Options Background Color (OPTIONS メソッド表示ラベルの背景色)** OPTIONS メソッド表示ラベルの背景色を指定します。 **Method Label Options Color (OPTIONS メソッド表示ラベルの色)** OPTIONS メソッド表示ラベルの色を指定します。 **Method Label Head Background Color (HEAD メソッド表示ラベルの背景色)** HEAD メソッド表示ラベルの背景色を指定します。 **Method Label Head Color (HEAD メソッド表示ラベルの色)** HEAD メソッド表示ラベルの色を指定します。 **Link Hover Color (フロート表示リンクの色)** リンクにカーソルを合わせたときのリンクの表示色を指定します。 **Button Text Color (ボタンテキスト色) (省略可能)** ボタンテキストの色を指定します。 **Button Hover Text Color (ボタンのフロート表示テキストの色) (省略可能)** ボタンのフロート表示テキストの色を指定します。デフォルトはボタンのテキスト色です。 **Headline Font Family (見出しフォントファミリー) (省略可能)** 見出しのフォントファミリーを指定します。 **Error Color (エラー色) (省略可能)** エラーメッセージの色を指定します。 ユーザーがアプリケーションを選択して `clientId` や `clientSecret` のログイン情報値を入力できるようにするには、ログイン情報アノテーションをアプリケーション仕様に追加します。 ```text /all-query: get: queryParameters: query_id: type: string (credentialType): id query_secret: type: string (credentialType): secret /all-headers: get: headers: header_id: type: string (credentialType): id header_secret: type: string (credentialType): secret ``` サイトにアクセス権の要求のカスタム実装がある場合は、次のイベントをディスパッチしてアプリケーションセレクターを更新します。このイベントがない場合、ユーザーがアプリケーションを追加するたびにページを更新して、**\[Application (アプリケーション)\]** メニューにアプリケーションを表示しなければなりません。 ```text this.dispatchEvent(new Event('acm:application_created_success', {bubbles: true})) ``` # API コミュニティの操作 以下のページでは、Anypoint API コミュニティマネージャーコミュニティへの API やコンテンツのパブリッシュ方法と、フォーラム、メンバー、サポートケースの管理方法について説明します。 API コミュニティでは、API と API ドキュメントは Anypoint Exchange からパブリッシュされ、記事は [Salesforce コンテンツ管理システム (CMS)](https://help.salesforce.com/articleView?id=community_managed_content_overview.htm&type=5)からパブリッシュされます。 Exchange の API ドキュメントは、各 API バージョンについて詳細に説明しています。 このドキュメントは、API リリースサイクルで更新され、通常は開発チームが更新に深く関与します。 Salesforce CMS 記事は、イベント、マーケティング、ビジョンの情報を提供します。これらの記事は、それぞれのサイクルとプロセスでリリースされ、通常はマーケティングチームがリリースに深く関与します。 これらのアクションは、すべて API コミュニティマネージャーコントロールパネルで実行します。  API コミュニティマネージャーコントロールパネルは、Salesforce **アプリケーションランチャー**を開いて、**\[API コミュニティマネージャー\]** を選択することで、いつでも開けます。 ## [](#コミュニティの操作)コミュニティの操作 - [API のパブリッシュ](https://docs.mulesoft.com/jp/api-community-manager/publish-apis) - [API 表示の設定](https://docs.mulesoft.com/jp/api-community-manager/visibility) - [コンテンツと CMS 記事のパブリッシュ](https://docs.mulesoft.com/jp/api-community-manager/publish-content) - [フォーラムのモデレート](https://docs.mulesoft.com/jp/api-community-manager/moderate-forums) - [クライアントアプリケーションとコントラクトの管理](https://docs.mulesoft.com/jp/api-community-manager/client-apps-contracts) - [メンバーの管理](https://docs.mulesoft.com/jp/api-community-manager/manage-members) # API コミュニティマネージャー Anypoint API コミュニティマネージャーを使用すると、あなたの API を使用してアプリケーションを作成する (組織の内部と外部の両方の) 開発者やパートナー向けに、API のコミュニティを構築して運営することができます。 API コミュニティマネージャーは **[Salesforce Experience Cloud](https://www.salesforce.com/products/experience-cloud/overview/)** によって提供されており、開発者のさまざまなニーズに応えるためのカスタマイズ、ブランディング、マーケティング、エンゲージメントの各機能を提供します。API コミュニティマネージャーを使用して、 [Anypoint Exchange](https://docs.mulesoft.com/exchange/) に登録されている API を見やすく表示し、クライアントアプリケーション、API アクセスログイン情報、コンシュームメトリクスを管理します。 以下の便利なリソースには、Salesforce Experience Cloud の機能に関する情報があります。 - [Experience Cloud 製品ドキュメント](https://help.salesforce.com/articleView?id=networks_resources.htm&type=5) - [Experience Cloud Trailhead](https://trailhead.salesforce.com/en/content/learn/trails/communities) ## [](#api-コミュニティとは)API コミュニティとは あなたの API を開発者に活用してもらうためには、開発者が API を見つけやすいようにしておくことと、API の使用方法を効果的に学習できるようにしておくことが必要です。また、パーソナライズとブランディングによって、開発者があなたの API を使いたくなるようなエクスペリエンスを用意しましょう。さらに、開発者が API を利用してアプリケーション開発を成功させられるように、常に開発者と交流することが必要です。Anypoint API コミュニティマネージャーを使用すれば、パーソナライズされた、いつでも接続されているエクスペリエンスを提供し、開発者はあなたの (Anypoint Platform で設計、提供、管理される) API を活用できるようになります。 コミュニティ管理者として、組織のブランドアイデンティティと一貫した、視覚的にも魅力的なデジタルエクスペリエンスを API コミュニティマネージャーで作成してください。コミュニティは、 [Anypoint Exchange](https://docs.mulesoft.com/exchange/) から直接選択した API と、関連するコンテンツ、そしてセルフサービスリソースを提供することで、開発者の意欲を高め、開発者を助けます。 ## [](#コンシューマー開発者向けの接続されパーソナライズされたデジタルエクスペリエンス)コンシューマー開発者向けの接続され、パーソナライズされたデジタルエクスペリエンス API コミュニティにアクセスするコンシューマー開発者は、ブランディングされ、カスタマイズされたエクスペリエンスにおいて、ニュース、イベント、チュートリアル、開発者ブログへの投稿記事、そして API に関連したビジネス情報と技術情報を見ることができます。 コミュニティの情報には、技術的な API ドキュメントや、API の機能を試したり、使用方法を学習したりするためのセルフサービス API Console に加えて、利用者が API の価値提案を理解しやすいようにマーケティングおよびビジネス開発チームが作成したコンテンツなどがあります。API の技術情報は、Anypoint Platform の API デザインから直接提供されます。 コンシューマー開発者は、Anypoint Platform と [API Manager](https://docs.mulesoft.com/api-manager/2.x/latest-overview-concept) が提供する API ライフサイクルの通常ガバナンスモデルに従って、API を新規または既存のクライアントアプリケーションで使用するためのアクセス申請を行います。開発者は、自分のクライアントアプリケーションとアクセスログイン情報 (API キーとシークレット) を管理し、アプリケーションでの API の使用に伴って、アプリケーションのパフォーマンスに関するインサイトを入手できます。 また開発者は、ディスカッションフォーラムを利用して、質問や回答を投稿したり、アイデアを共有したり、見つかった問題について意見を交換したりすることで、ユーザー組織や他のコミュニティメンバーと交流できます。 さらに他の API コミュニティマネージャー機能を活用することで、パートナーと交流し、パートナーを常にサポートできます。 ## [](#api-コミュニティの構築)API コミュニティの構築 コミュニティの外観、ブランディング、そしてサイト構造は、[エクスペリエンスビルダー](https://help.salesforce.com/articleView?id=community_designer_overview.htm&type=5)を使用してパーソナライズできます。コミュニティビルダーは、ドラッグアンドドロップ操作でエクスペリエンスを作成して非常に詳細なレベルまでカスタマイズできるエディターです。エクスペリエンスビルダーにより、既存の Lightning コンポーネントを利用して、単純なクリック操作だけでカスタマイズされたエクスペリエンスを簡単に作成できます。あるいは、HTML と CSS の高い柔軟性を利用して、ピクセル単位で精密にカスタマイズしたエクスペリエンスを作成することもできます。 ## [](#開発者のコミュニティへの参加方法)開発者のコミュニティへの参加方法 [構築済みのダッシュボード](https://help.salesforce.com/articleView?id=networks_appexchange_overview_dashboard_and_reports.htm&type=5)により、コミュニティのコンテンツとアセットの利用状況が表示されるため、エコシステムでの活動を把握できます。これらの構築済みダッシュボードは、10 年以上に渡って蓄積された Salesforce のエクスペリエンスに基づいて、コミュニティエンゲージメントのベストプラクティスを反映しています。 ## [](#関連情報)関連情報 - [API コミュニティマネージャーリリースノート](https://docs.mulesoft.com/jp/release-notes/api-community-manager/api-community-manager-release-notes) - [MuleSoft フォーラム](https://forums.mulesoft.com) - [ナレッジベース記事](https://help.mulesoft.com/s/knowledge) # API コミュニティマネージャー Lightning コンポーネントの説明 コミュニティビルダーで Lightning コンポーネントを追加および設定することで、Anypoint API コミュニティマネージャーポータルのページを設計します。 これらの Lightning コンポーネントには、すべての Salesforce デジタルエクスペリエンスで使用可能な Lightning コンポーネントと、API コミュニティマネージャーでのみ使用可能な API コミュニティマネージャー Lightning コンポーネントの両方が含まれます。 各 API コミュニティマネージャー Lightning コンポーネントには異なる設定オプションがあり、異なる機能がポータルに追加されます。 多くの API コミュニティマネージャー Lightning コンポーネントには、Anypoint Platform からのデータが表示されます。コミュニティ管理者は、これらのデータ項目の一部 (API 参照名、説明、アイコンなど) を変更できます。API コミュニティマネージャーはこれらの変更を保存しますが、変更を Anypoint Platform に転送しません。 ## [](#acm-search-box)ACM Search Box (ACM 検索ボックス) Anypoint API コミュニティマネージャーの Search Box (検索ボックス) コンポーネントを使用すると、ユーザーは Salesforce Experience Cloud に存在するコンテンツ (ナレッジ記事、サポートケース、お知らせなど) および Anypoint Platform に存在するコンテンツ (API やクライアントアプリケーションなど) の両方を検索できます。検索の結果は、[ACM Search Results (ACM 検索結果)](#acm-search-results) コンポーネントに表示されます。 API コミュニティマネージャーの Search Box (検索ボックス) の次のパラメーターの値を指定できます。 **Result Page URL (結果ページ URL)** ユーザーが検索を入力した後に表示される検索結果ページの URL を指定します。 **Search Areas (検索領域)** 検索するコンテンツのタイプ (**\[APIs (API)\]**、**\[API Groups (API グループ)\]**、**\[Applications (アプリケーション)\]**、**\[Knowledge Articles (ナレッジ記事)\]**、**\[Cases (ケース)\]**、**\[Discussions (ディスカッション)\]**, **\[Topics (トピック)\]**, **\[Managed Content (CMS) (管理コンテンツ (CMS))\]**, **\[API Specifications (API 仕様)\]**, **\[Documentation Pages (ドキュメントページ)\]**、**\[Custom Fields (カスタム項目)\]**) を選択します。 **Number of results to show (表示する結果の数)** ユーザーがクエリを入力するときに表示される結果の数を指定します。 **Enable advance links (高度なリンクを有効化)** 検索結果が、タブセット ID に基づいて、API の詳細ページの特定のタブ (コンソール、ドキュメント、カスタム項目、アプリケーションなどのタブ) にリンクされるようにします。 **\[Result Page URL (結果ページ URL)\]** パラメーターで検索結果ページの URL を指定します。検索結果を表示するには、検索結果ページに **ACM Search Results (ACM 検索結果)** コンポーネントを含める必要があります。ページに **ACM Search Results (ACM 検索結果)** コンポーネントが含まれていない場合、検索を入力してページに移動したメンバーとゲストユーザーには結果が表示されません。 **\[Search Areas (検索領域)\]** パラメーターでコンテンツタイプが選択されていない場合、リンクされた **ACM Search Results (ACM 検索結果)** コンポーネントではそのコンテンツタイプの結果が省略されます。MuleSoft Government Cloud では、API 仕様またはドキュメントページでの検索はサポートされていません。 **\[Enable advance links (高度なリンクを有効化)\]** を選択するときは、タブセット ID 項目が API の詳細ページのタブのカスタマイズ (`Console Tab Set Id`、`Documentation Tab Set Id`、`Custom fields Tab Set Id`、`Applications Tab Set Id` など) と一致するように設定します。 1. ビルダーを開きます。 2. 認証済みユーザーとしてコミュニティをプレビューします。 3. API の詳細ページを開きます。 4. タブを選択します。 5. 現在のページの URL で、`tabset-1a2b3c=2` や `tabset-1a2b3c=4d5e6f` のようなタブセット ID を見つけます。 6. このタブセット ID を `Console Tab Set Id` などのタブセット ID 項目にコピーします。 コミュニティのデフォルトページには、1 つの ACM Search Box (ACM 検索ボックス) および 1 つの ACM Search Results (ACM 検索結果) コンポーネントがあります。これは、設定ミスの可能性を最小限に抑えるためのベストプラクティスですが、コミュニティのメンバー内の個別の利用者に対して個別の検索を使用することができます。 検索結果は、最後に変更された日付 (新しい日付から古い日付の順序) で並び替えられます。 検索設定と結果ページの表示をテストおよびプレビューするには、[API コミュニティをプレビュー](https://docs.mulesoft.com/jp/api-community-manager/preview-community)して検索を実行します。 ## [](#acm-search-results)ACM Search Results (ACM 検索結果) API コミュニティマネージャーの Search Results (検索結果) コンポーネントは、[ACM Search Box (ACM 検索ボックス)](#acm-search-box) コンポーネントにユーザーが検索を入力した後の結果を表示します。 Search Results (検索結果) の次のパラメーターの値を指定できます。 **Component Title (コンポーネントタイトル)** 結果のタイトルを指定します。 **Border (境界線)** 境界線の太さを指定します。値は、**\[Thick (太)\]**、**\[Medium (中)\]**、**\[Thin (細)\]**、または **\[None (なし)\]** です。デフォルトは **\[Thin (細)\]** です。 **Show Search Input (検索の入力を表示)** 結果ページに検索の入力を表示します。 **Enable advance links (高度なリンクを有効化)** 検索結果が、タブセット ID に基づいて、API の詳細ページの特定のタブ (コンソール、ドキュメント、カスタム項目、アプリケーションなどのタブ) にリンクされるようにします。 **\[Enable advance links (高度なリンクを有効化)\]** を選択するときは、タブセット ID 項目が API の詳細ページのタブのカスタマイズ (`Console Tab Set Id`、`Documentation Tab Set Id`、`Custom fields Tab Set Id`、`Applications Tab Set Id` など) と一致するように設定します。 1. ビルダーを開きます。 2. 認証済みユーザーとしてコミュニティをプレビューします。 3. API の詳細ページを開きます。 4. タブを選択します。 5. 現在のページの URL で、`tabset-1a2b3c=2` や `tabset-1a2b3c=4d5e6f` のようなタブセット ID を見つけます。 6. このタブセット ID を `Console Tab Set Id` などのタブセット ID 項目にコピーします。 ## [](#api-access-requester)API Access Requester (API アクセスリクエスター) API Access Requester (API アクセスリクエスター) コンポーネントでは、コミュニティメンバーが新規または既存のアプリケーションで API へのアクセスをリクエストできます。 少なくとも 1 つの公開管理 API インスタンスの[表示が Exchange で公開に設定](https://docs.mulesoft.com/jp/exchange/to-configure-api-settings)されている場合、API ページに **\[API Access Request (API アクセス要求)\]** ボタンが表示されます。 コミュニティメンバーは、既存のクライアントアプリケーションと API インスタンスへのアクセスをリクエストするか、またはアプリケーション名と説明を指定して API インスタンスを選択することで、API にアクセスできる新規クライアントアプリケーションを作成するようにリクエストできます。 コンシューマー開発者が ID プロバイダー (IDP) を含む API インスタンスに対して新しいクライアントアプリケーションへのアクセス権を要求する場合、コンシューマー開発者は OAuth 2.0 許可種別である Authorization Code Grant (認証コード許可)、Implicit Grant (暗黙的許可)、Refresh Token (更新トークン)、Resource Owner Grant (リソースオーナー許可) の 1 つ以上を指定する必要があります。一部の IDP では、サポートされていない許可種別もあります。アクセスを要求し、サポートされていない許可種別を指定すると、エラー `Error creating application.` が表示されます。 API Access Requester (API アクセスリクエスター) の次のパラメーターの値を指定できます。 **API** API を指定します。 **Button Border Radius (ボタンの境界線の半径)** ボタンの境界線の半径を選択します。半径が大きいほど、ボタンの丸みが増します。 **Button Align (ボタン位置揃え)** 左、右、または中央の位置揃えを指定します。 **Show Modal Title Line (モーダルタイトル行を表示)** アクセスリクエストモーダルにタイトル行を表示します。 ## [](#api-card-api-カード)API Card (API カード) API Card (API カード) コンポーネントは、API または API グループに関する情報 (アイコン、名前、説明など) を表示します。 表示されるアイコン、名前、説明は、[コミュニティに API または API グループバージョンを追加](https://docs.mulesoft.com/jp/api-community-manager/publish-apis)するときに API コミュニティマネージャーのコントロールパネルで設定されます。 API Card (API カード) の次のパラメーターの値を指定できます。 **API** 表示される API を指定します。 **Override URL (URL を上書き)** デフォルトでは、\[API Details (API の詳細)\] ボタンは API メインページにリンクされます。必要に応じて、ドキュメントやマーケティング資料などの他の情報にユーザーを誘導するように \[Override URL (URL を上書き)\] を設定できます。 **Show Buttons (ボタンを表示)** \[API Details (API の詳細)\] ボタンを表示します。ボタンが表示されていない場合は、カード上の任意の場所をクリックすることで API の詳細を表示できます。 **Card Height (カードの高さ)** カードの高さを指定します。 **Card Margin (カードの余白)** カード周囲の余白の量を指定します。 **Card Border (カードの境界線)** カードの境界線の太さを指定します。 **Card Border Radius (カードの境界線の半径)** カードの境界線の半径を指定します。半径が大きいほど、カードの丸みが増します。 **Card Shadow (カードの影)** カードの下に表示する影を指定します。 **API Details Button Label (API 詳細ボタン表示ラベル)** API 詳細ボタン表示ラベルを設定できます。デフォルトは **\[API Details (API の詳細)\]** です。 **Learn More Button Label (詳細ボタン表示ラベル)** 詳細ボタン表示ラベルを設定できます。デフォルトは **\[Learn More (詳細はこちら)\]** です。 ## [](#api-carousel)API Carousel (API カルーセル) API Carousel (API カルーセル) コンポーネントは、水平方向にスクロール可能な API カードのセットを表示します。各カードには、API または API グループが表示されます。 表示される API アイコン、名前、説明は、[コミュニティに API バージョンを追加](https://docs.mulesoft.com/jp/api-community-manager/publish-apis)するときに API コミュニティマネージャーのコントロールパネルで設定されます。 API Carousel (カルーセル) の次のパラメーターの値を指定できます。 **Show Buttons (ボタンを表示)** 各カード上に \[API Details (API の詳細)\] ボタンを表示します。ユーザーはボタンが存在する場合はボタンをクリックし、存在しない場合はカードの任意の場所をクリックして、API の詳細を表示できます。 **Max Cards Display (最大カード表示数)** 表示するカードの最大数を指定します。 **Rows (行数)** カルーセル内のカードの行数を指定します。 **Show Arrows (矢印を表示)** カルーセルの右端と左端に矢印を表示します。矢印をクリックすると、クリックした矢印の方向にカードがスクロールします。 **Arrow Size (矢印のサイズ)** 右端と左端の矢印のサイズを指定します。 **Show Dots (ドットを表示)** カードの下にドットを表示します。各ドットは、カルーセル内のカードのページにリンクされます。 **Card Height (カードの高さ)** カードの高さを指定します。 **Card Margin (カードの余白)** 各カードの周囲の余白を指定します。 **Card Border (カードの境界線)** カードの境界線の太さを指定します。 **Card Border Radius (カードの境界線の半径)** カードの境界線の半径を指定します。半径が大きいほど、カードの丸みが増します。 **Card Shadow (カードの影)** 各カードの下に表示する影を設定します。 **Message If Empty (空白時のメッセージ)** カルーセルに API がない場合にメッセージを表示します。デフォルトは `There are no APIs available right now.` です。 **Show (表示)** **\[APIs (API)\]**、**\[Groups (グループ)\]**、**\[APIs and Groups (API とグループ)\]**、**\[Children (子)\]** のいずれを表示するかを指定します。デフォルトは **\[APIs and Groups (API とグループ)\]** です。**\[Children (子)\]** には API グループ内の API が表示されます。**\[Children (子)\]** 設定は、**\[Page Variation (ページのバリエーション)\]** が **\[API Detail (API の詳細)\]** ではなく **\[API Group Detail (API グループの詳細)\]** に設定されているページでのみ使用します。 **Filter Condition (Advanced) (検索条件 (詳細))** 「[検索条件](#filter-conditions)」で説明されている構文を使用して指定された検索条件に一致する API のみをカルーセルに表示します。 **Categories Filter (Advanced) (カテゴリ検索条件 (詳細))** 「[カテゴリ検索条件](#categories-filter)」で説明されている構文を使用して指定されたカテゴリに一致する API のみをカルーセルに表示します。 **API Details Button Label (API 詳細ボタン表示ラベル)** API 詳細ボタン表示ラベルを設定できます。デフォルトは **\[API Details (API の詳細)\]** です。 **Learn More Button Label (詳細ボタン表示ラベル)** 詳細ボタン表示ラベルを設定できます。デフォルトは **\[Learn More (詳細はこちら)\]** です。 ## [](#api-catalog)API Catalog (API カタログ) API Catalog (API カタログ) コンポーネントは、API コミュニティグループで使用可能なすべての API と API グループを探索する対話的な方法を API コンシューマーに提供します。API Catalog (API カタログ) には、ページに分割された行と列に API カード、および表示する API と API グループをカテゴリと検索語で絞り込むコントロールが表示されます。各カードには、API または API グループが表示されます。カタログを使用すると、ユーザーは多数の API バージョンを表示して探索できます。 API カタログ検索と [ACM Search Box (ACM 検索ボックス)](#acm-search-box) コンポーネントを使用して実行する検索は、同じ検索ではありません。API カタログ検索は API と API グループの基本的な検索であり、ACM Search Box (ACM 検索ボックス) コンポーネントは API コミュニティ内のすべてのアセットを検索するための高度な検索機能を提供します。 テンプレートコミュニティでは、API Catalog (API カタログ) コンポーネントへのリンクが API Carousel (API カルーセル) コンポーネントの下に表示されます。コミュニティの複数のページに複数の API Catalog (API カタログ) インスタンスがある場合、ページを標準化し、可能な限り一貫したインスタンスを配置することをお勧めします。 混乱を防ぐため、API Catalog (API カタログ) コンポーネントはタグではなく最大 5 個の管理カテゴリを使用するように設計されています。 Anypoint Exchange で新しいカテゴリを追加すると、キャッシュが自動的に更新されるときに、5 分以内に API Catalog (API カタログ) 設定にそのカテゴリが表示されます。 少なくとも 1 つの API にそのカテゴリの値がある場合にのみ、API Catalog (API カタログ) 設定にカテゴリが表示されます。 Exchange でカテゴリが削除または変更されると、すべての API Catalog (API カタログ) インスタンスに変更が自動的に反映されます。 カードには、1 つのカテゴリの複数のバッジを使用できます。最大 3 個のバッジを表示可能で、さらにバッジがある場合は、それらを表示するためのツールチップが提供されます。 カテゴリの色を指定しない場合、コミュニティテーマがデフォルトとして使用されます。色は、`#FF0000` や `#0000FF` などの 16 進数値、または `red` や `blue` などの標準の CSS の色名で指定できます。 URL パラメーターを使用して、検索条件をカタログに渡すことができます。たとえば、カタログコンポーネントを含むページの URL の末尾を `?catalogFilters=Country:Argentina,USA;Payment:Cash,Credit` にすることができます。 表示される API アイコン、名前、説明は、[コミュニティに API バージョンを追加](https://docs.mulesoft.com/jp/api-community-manager/publish-apis)するときに API コミュニティマネージャーのコントロールパネルで設定されます。 API Catalog (API カタログ) コンポーネントの次のパラメーターの値を指定できます。 **Component Title (コンポーネントタイトル)** カタログのタイトルを指定します。デフォルトは **\[API Catalog (API カタログ)\]** です。 **Show API Counter (API カウンターを表示)** 現在の検索と検索条件に一致する API の数を表示する API カウンターを表示できます。 **APIs Per Page (ページあたりの API 数)** カタログの各ページに表示される API の数を指定します。デフォルトは値 12 です。 **Category Filter 1 through Category Filter 5 (カテゴリ検索条件 1 ~ カテゴリ検索条件 5)** コミュニティメンバーとゲストユーザーが API を絞り込むために使用できるカテゴリを指定します。デフォルトは **\[None (なし)\]** です。 **Category Color 1 through Category Color 5 (カテゴリの色 1 ~ カテゴリの色 5)** 各カテゴリの色を指定します。 **Search Input Position (検索入力位置)** 検索ボックスの位置が検索条件の横か、検索条件の下かつカードの上かを指定します。 **Category Card Badge 1 through Category Card Badge 3 (カテゴリカードバッジ 1 ~ カテゴリカードバッジ 3)** カードの上部にバッジとして表示されるカテゴリを指定します。色はカテゴリの色と同じです。 **Show (表示)** **\[APIs (API)\]**、**\[Groups (グループ)\]**、**\[APIs and Groups (API とグループ)\]**、**\[Children (子)\]** のいずれを表示するかを指定します。デフォルトは **\[APIs and Groups (API とグループ)\]** です。**\[Children (子)\]** には API グループ内の API が表示されます。**\[Children (子)\]** 設定は、**\[Page Variation (ページのバリエーション)\]** が **\[API Detail (API の詳細)\]** ではなく **\[API Group Detail (API グループの詳細)\]** に設定されているページでのみ使用します。 **Filter Condition (Advanced) (検索条件 (詳細))** 「[検索条件](#filter-conditions)」で説明されている構文を使用して指定された検索条件に一致する API のみをカタログに表示します。 **Categories Filter (Advanced) (カテゴリ検索条件 (詳細))** 「[カテゴリ検索条件](#categories-filter)」で説明されている構文を使用して指定されたカテゴリに一致する API のみをカタログに表示します。 ## [](#api-console-api-コンソール)API Console (API コンソール) API コンソールのコンポーネントについての詳細は、[「API Console (API コンソール)」](https://docs.mulesoft.com/jp/api-community-manager/api-console)を参照してください。 ## [](#api-custom-field-table-api-カスタム項目テーブル)API Custom Field Table (API カスタム項目テーブル) **API Custom Field Table (API カスタム項目テーブル)** コンポーネントには、API のすべてのカスタム項目とその値が表示されます。 **API Custom Field Table (API カスタム項目テーブル)** の次のパラメーターの値を指定できます。 **Record Id (レコード ID)** API を指定します。デフォルトは `{!recordId}` で、現在のページで選択されている API のインスタンスが表示されます。 **Show Table Header** (テーブルヘッダーを表示) テーブルヘッダーを表示します。 デフォルトでは、テーブルには Anypoint 組織にリストされているすべてのカスタム項目が表示されます。一部の項目のみを表示する手順は、次のとおりです。 1. **\[設定\]** > **\[カスタムメタデータ型\]** > **\[ACM General Configuration Metadata (ACM 一般設定メタデータ)\]** > **\[レコードの管理\]** を開きます。 2. **\[ACM Configuration (ACM 設定)\]** の横で、**\[編集\]** をクリックします。 3. **\[CustomFieldsFilter\]** ボックスで、一連のカスタム項目キーをカンマ区切りリスト (`email,rating,case` など) として入力します。 すべてのカスタム項目キーをリストするには、開発者コンソールを開いてクエリ `SELECT acm_pkg\_TagKey_c FROM acm_pkg\_AnypointCustomFields_x` を実行します。 ## [](#api-custom-field-pills-api-カスタム項目ピル)API Custom Field Pills (API カスタム項目ピル) **API Custom Field Pills (API カスタム項目ピル)** コンポーネントには、最大 5 個の API のカスタム項目とその値が一連の項目と値のペアとして表示されます。 **API Custom Field Pills (API カスタム項目ピル)** の次のパラメーターの値を指定できます。 **Record Id (レコード ID)** API を指定します。デフォルトは `{!recordId}` で、現在のページで選択されている API のインスタンスが表示されます。 **Custom Fields (カスタム項目)** 表示する 5 個のカスタム項目を指定します。 ## [](#api-details-button-api-の詳細ボタン)API Details Button (API の詳細ボタン) API Details Button (API の詳細ボタン) コンポーネントは、API に関する詳細をポータルユーザーに提供します。 API Details Button (API の詳細ボタン) の次のパラメーターの値を指定できます。 **API** 表示する API を指定します。 **Button Label (ボタンの表示ラベル)** ボタンの表示ラベルを指定します。デフォルトは **\[API Details (API の詳細)\]** です。 **Button Align (ボタン位置揃え)** UI 項目の左、右、または中央にボタンの位置を揃えます。 **API Name (API 参照名)** ボタンの表示ラベルに API 参照名を追加します。値は、**\[Append (追加)\]**、**\[Prepend (先頭に追加)\]**、または **\[None (なし)\]** です。デフォルトは **\[None (なし)\]** です。 **API Version (API バージョン)** ボタンの表示ラベルに API バージョンを追加します。値は、**\[Append (追加)\]**、**\[Prepend (先頭に追加)\]**、または **\[None (なし)\]** です。デフォルトは **\[None (なし)\]** です。 ## [](#api-documentation-viewer)API Documentation Viewer (API ドキュメントビューアー) API Documentation Viewer (API ドキュメントビューアー) コンポーネントは、[Anypoint Exchange](https://docs.mulesoft.com/jp/exchange/) からの API のドキュメントを表示します。ドキュメントは複数のページで構成され、各ページは複数のセクションで構成されることもあります。 API Documentation Viewer (API ドキュメントビューアー) の次のパラメーターの値を指定できます。 **API** API を指定します。 **Section (セクション) (省略可能)** 開くセクションを選択します。**Selected Page (選択されたページ) (省略可能)** の設定が空白である場合は、**Section (省略可能)** の設定は無視されます。 **Selected Page (選択されたページ) (省略可能)** 開くページを選択します。 このコンポーネントのマークダウンページに直接リンクするには、URL クエリパラメーター `selectedPage` をページ名とまったく同じ名前に設定します。たとえば、ページの名前が「Details」の場合、URL は `/communityapi/a003D000001pQpjQAE/basicapi?selectedPage=Details` のようになります。`selectedPage` がこのコンポーネントのコミュニティビルダーと URL の両方で定義されている場合、コミュニティビルダーの値が使用され、URL の値は無視されます。 ## [](#api-engagement)API Engagement (API エンゲージメント) API Engagement (API エンゲージメント) コンポーネントは、API に対するいいね! 数やサブスクリプション数を示し、ユーザーが API にいいね! と言ったり、サブスクライブしたりすることができます。 API Engagement (API エンゲージメント) コンポーネントの次のパラメーターの値を指定できます。 **Record Id (レコード ID)** API を指定します。デフォルトは `{!recordId}` で、現在のページで選択されている API のインスタンスが表示されます。 ## [](#api-header)API Header (API ヘッダー) API Header (API ヘッダー) コンポーネントは、API ヘッダーにアイコン、名前、連絡先メール、説明などを表示します。 表示される API アイコン、名前、説明は、[コミュニティに API バージョンを追加](https://docs.mulesoft.com/jp/api-community-manager/publish-apis)するときに API コミュニティマネージャーのコントロールパネルで設定されます。連絡先メールは、Anypoint Exchange で設定されます。 API Header (API ヘッダー) の次のパラメーターの値を指定できます。 **API** 表示する API を指定します。 **Show "Learn More" Button (\[Learn more (詳細はこちら)\] ボタンを表示)** \[Learn more (詳細はこちら)\] ボタンを表示します。 **API Learn More Button Label (API の \[Learn More (詳細はこちら)\] ボタンの表示ラベル)** API のボタンの表示ラベルを指定します。デフォルトは **\[Learn More (詳細はこちら)\]** です。 **API Group Learn More Button Label (API グループの \[Learn More (詳細はこちら)\] ボタンの表示ラベル)** API グループのボタンの表示ラベルを指定します。デフォルトは **\[Learn More about this API Group (この API グループの詳細はこちら)\]** です。 **Show API Access Requester (API アクセスリクエスターを表示)** API アクセスリクエスターを表示します。 **Show API Version (API バージョンを表示)** 1 つのバージョンのみが表示される場合、Exchange からのアセットバージョンを表示します。 **Show Contact Email (連絡先メールを表示)** Exchange からの連絡先メールを表示します。 アセットの複数のバージョンが表示される場合、API Header (API ヘッダー) コンポーネントにはバージョンセレクターが表示され、**\[Show API Version (API バージョンを表示)\]** チェックボックスが無効になります。 メール連絡先を表示する手順は、次のとおりです。 1. **\[設定\]** > **\[カスタムメタデータ型\]** > **\[ACM General Configuration Metadata (ACM 一般設定メタデータ)\]** > **\[レコードの管理\]** を開きます。 2. **\[Show Contact Email (連絡先メールを表示)\]** をオンにします。 3. **\[Save (保存)\]** をクリックします。 ## [](#application-analytics-graph)アプリケーション分析グラフ Application Analytics Graph (アプリケーション分析グラフ) コンポーネントは、アプリケーションの使用に関する統計情報 (トラフィック、応答時間、アプリケーションの健全性など) を表示します。 このコンポーネントには、[Anypoint API Manager](https://docs.mulesoft.com/jp/api-manager/latest/) からのアプリケーション統計情報が表示されます。 Application Analytics Graph (アプリケーション分析グラフ) の次のパラメーターの値を指定できます。 **Application (アプリケーション)** 表示するアプリケーションを指定します。 ## [](#application-details)Application Details (アプリケーション詳細) Application Details (アプリケーション詳細) コンポーネントは、[Anypoint API Manager](https://docs.mulesoft.com/jp/api-manager/latest/) からアプリケーションの詳細を表示します。 このコンポーネントには、アプリケーションの説明、アプリケーション URL、リダイレクト URI、クライアント ID、クライアントシークレット、API および API グループとのアプリケーションのコントラクトが表示されます。 Application Details (アプリケーション詳細) の次のパラメーターの値を指定できます。 **Application (アプリケーション)** 表示する API を指定します。 **Enable Application Editing (アプリケーション編集を有効化)** 名前や説明などのアプリケーションの詳細を編集できるようにします。 アプリケーション編集が有効になっている場合、コンポーネントには **\[Reset Credentials (ログイン情報をリセット)\]** ボタンが表示されます。デフォルトでは、このボタンはクライアントプロバイダー種別が Anypoint のアプリケーションで機能し、OpenID などの異なるクライアントプロバイダー種別のアプリケーションではエラーが表示されます。管理者はボタンをカスタマイズして、Anypoint 以外のクライアントプロバイダー種別のアプリケーションでログイン情報を正常にリセットできます。 ## [](#application-listing)Application Listing (アプリケーションリスト) Application Listing (アプリケーションリスト) コンポーネントは、API を使用しているアプリケーションのリストを表示します。 API の詳細ページなどのスコープ内の API レコード ID があるページでは、コンポーネントにはその API の現在のバージョンにアクセスできるアプリケーションのみが表示されます。 このコンポーネントには、[Anypoint API Manager](https://docs.mulesoft.com/jp/api-manager/latest/) からのアプリケーションの名前、クライアント ID、およびクライアントシークレットが表示されます。 Application Listing (アプリケーションリスト) の次のパラメーターの値を指定できます。 **New Application URL (新規アプリケーション URL)** 新しいアプリケーション URL を指定します。 **Card Margin (カードの余白)** カード周囲の余白の量を指定します。 **Card Border (カードの境界線)** カードの境界線の太さを指定します。 **Card Border Radius (カードの境界線の半径)** カードの境界線の半径を指定します。半径が大きいほど、カードの丸みが増します。 **Card Shadow (カードの影)** カードの下に表示する影を指定します。 **Card Width (カードの幅)** カードの幅を指定します。 **Card Height (カードの高さ)** カードの高さを指定します。 ## [](#instance-viewer-インスタンスビューアー)Instance Viewer (インスタンスビューアー) Instance Viewer (インスタンスビューアー) コンポーネントには、API インスタンス環境、表示ラベル、URL が表示されます。 Instance Viewer (インスタンスビューアー) の次のパラメーターの値を指定できます。 **Record Id (レコード ID)** API を指定します。デフォルトは `{!recordId}` で、現在のページで選択されている API のインスタンスが表示されます。 **Show Copy URL Icon (\[Copy URL (URL をコピー)\] アイコンを表示)** **\[Copy URL (URL をコピー)\]** アイコンを表示します。 **Show content in a Box (ボックス内にコンテンツを表示)** インスタンス情報の周囲にボックスを表示します。 **Show Production-type environments (本番種別環境を表示)** 本番種別環境環境を表示します。 **Show Sandbox-type environments (Sandbox 種別環境を表示)** Sandbox 種別環境環境を表示します。 **Show Instance Label (インスタンス表示ラベルを表示)** 各インスタンスの名前を表示します。 **Show table header (テーブルヘッダーを表示)** テーブルヘッダーを表示します。 **Advanced Filter (詳細な検索条件)** Salesforce Object Query Language (SOQL) の条件を満たす API のみを表示します。条件では、`Name`、`Environment`、`URL` 項目を使用できます (例: `Name LIKE 'v1%'`)。 ## [](#learn-more-button-詳細ボタン)Learn More Button (詳細ボタン) Learn More Button (詳細ボタン) コンポーネントは、API に関する追加情報を含むカスタムページをポータルユーザーに提供します。 Learn More Button (詳細ボタン) の次のパラメーターの値を指定できます。 **API** 表示する API を指定します。 **Button Label (ボタンの表示ラベル)** ボタンの表示ラベルを指定します。デフォルトは、`Learn more about this API` です。 **Button Align (ボタン位置揃え)** UI 項目の左、右、または中央にボタンの位置を揃えます。 **API Name (API 参照名)** ボタンの表示ラベルに API 参照名を追加します。値は、**\[Append (追加)\]**、**\[Prepend (先頭に追加)\]**、または **\[None (なし)\]** です。デフォルトは **\[None (なし)\]** です。 **API Version (API バージョン)** ボタンの表示ラベルに API バージョンを追加します。値は、**\[Append (追加)\]**、**\[Prepend (先頭に追加)\]**、または **\[None (なし)\]** です。デフォルトは **\[None (なし)\]** です。 ## [](#login-form)Login Form (ログインフォーム) Login Form (ログインフォーム) コンポーネントは、コミュニティメンバーがポータルにログインできるようにします。 Login Form (ログインフォーム) の次のパラメーターの値を指定できます。 **Start URL (開始 URL)** ログイン後にメンバーに表示する URL を指定します。 デフォルト値はポータルのホームページです。 **Username Label (ユーザー名表示ラベル)** ユーザー名項目の表示ラベルを指定します。デフォルトは、`Email` です。 **Password Label (パスワード表示ラベル)** パスワード項目の表示ラベルを指定します。デフォルトは、`Password` です。 **Login Button Label (ログインボタン表示ラベル)** ログインボタンの表示ラベルを指定します。デフォルトは、`Log in` です。 **Forgot Password Label (パスワードを忘れた場合の表示ラベル)** パスワードを忘れた場合のリンクの表示ラベルを指定します。デフォルトは、`Forgot your password?` です。 **Forgot Password URL (パスワードを忘れた場合の URL)** パスワードを忘れた場合のリンクの URL を指定します。デフォルトは、`/ForgotPassword` です。 **Self Register Label (セルフ登録表示ラベル)** セルフ登録リンクの表示ラベルを指定します。デフォルトは、`Not a member?` です。 **Self Register URL (セルフ登録 URL)** セルフ登録リンクの URL を指定します。デフォルトは、`/SelfRegister` です。 ## [](#login-requester)Login Requester (ログイン要求機能) Login Requester (ログイン要求機能) コンポーネントは、API のユーザーフォーラムのフィードバックやディスカッションアクティビティにアクセスするためにはログインする必要があることをゲストユーザーに通知します。 ## [](#self-register)Self Register (セルフ登録) Self Register (セルフ登録) コンポーネントは、ユーザーがポータルアカウントに登録できるようにします。 Self Register (セルフ登録) コンポーネントの次のパラメーターの値を指定できます。 **Start URL (開始 URL)** 開始 URL を指定します。デフォルトはポータルのホームページです。 **Confirm URL (確認 URL)** 確認用の URL を指定します。デフォルトは、`/CheckPasswordResetEmail` です。 **First Name Label (名表示ラベル)** 名項目の表示ラベルを指定します。デフォルトは、`First Name` です。 **Last Name Label (姓表示ラベル)** 姓項目の表示ラベルを指定します。デフォルトは、`Last Name` です。 **Email Label (メール表示ラベル)** メールアドレス項目の表示ラベルを指定します。デフォルトは、`Email` です。 **Password Label (パスワード表示ラベル)** パスワード項目の表示ラベルを指定します。デフォルトは、`Create Password` です。 **Confirm Password Label (パスワード確認表示ラベル)** パスワード確認項目の表示ラベルを指定します。デフォルトは、`Confirm Password` です。 **Submit Button Label (送信ボタン表示ラベル)** 送信ボタンの表示ラベルを指定します。デフォルトは、`Sign Up` です。 **Include Password Field (パスワード項目を含める)** パスワード項目を表示します。 **Extra Field Set (追加項目セット)** 追加項目を指定します。 **Registrations Require Approval (登録に承認が必要)** 登録に承認が必要かどうかを選択します。 **Approver ID (承認者 ID)** 承認者の ID を指定します。 ## [](#spec-downloader)Spec Downloader (仕様ダウンローダー) Spec Downloader (仕様ダウンローダー) コンポーネントは、ユーザーが API 仕様をダウンロードできるようにします。 API コミュニティマネージャーからダウンロードした API 仕様は、Anypoint Exchange からダウンロードした仕様と同じです。 使用可能なボタンは、**\[Download Spec as RAML (RAML として仕様をダウンロード)\]** および **\[Download Spec as OAS (OAS として仕様をダウンロード)\]** です。 仕様を RAML、OAS 2.0、または OAS 3.0 としてアップロードします。RAML バージョンをアップロードすると、自動的に OAS 2.0 バージョンが生成されます。OAS 2.0 または OAS 3.0 バージョンをアップロードすると、自動的に RAML バージョンが生成されます。RAML と OAS 形式のわずかな違いにより、自動的に生成されたバージョンは、アップロードされたバージョンと若干異なる可能性があります。 Spec Downloader (仕様ダウンローダー) コンポーネントの次のパラメーターの値を指定できます。 **Record Id (レコード ID)** API を指定します。デフォルトは `{!recordId}` です。これは、現在のページで選択されている API の仕様をダウンロードします。 **Layout (レイアウト)** ボタンのレイアウトを **\[Horizontal (横方向)\]** (デフォルト) または **\[Vertical (縦方向)\]** から指定します。 **Buttons Color Picker (ボタンカラーピッカー)** ボタンの色を指定します。 **Download Spec Options (仕様オプションをダウンロード)** **\[Original Format (元の形式)\]**, **\[All (すべて)\]** (デフォルト), **\[OAS3\]**、**\[RAML\]** を表示するダウンロードボタンを指定します。 **Show Export Message (エクスポートメッセージを表示)** エクスポートボタンの横にアイコンを表示し、API 仕様を別のバージョンにエクスポートするときに考えられる不整合について警告するツールチップを表示します。 ## [](#user-settings)User Settings (ユーザー設定) User Settings (ユーザー設定) コンポーネントでは、ユーザーが通知設定を定義して、どのメールを受信するか制御できます。 ## [](#user-subscriptions)User Subscriptions (ユーザーサブスクリプション) User Subscriptions (ユーザーサブスクリプション) コンポーネントには、ユーザーの API サブスクリプションと、各 API のサブスクライブを解除するオプションが示されます。 ## [](#filter-conditions)検索条件 API Carousel (API カルーセル) コンポーネントと API Catalog (API カタログ) コンポーネントは **\[Filter Condition (Advanced) (検索条件 (詳細))\]** パラメーターを使用して、_条件_ (Salesforce Object Query Language (SOQL) の標準検索) を満たす API のみを表示します。 条件には次の項目を使用できます。 - `Icon` - `Name` - `NavigateUrl` - `VersionGroup` 次の例は検索条件を示しています。 - `Name = 'My API'`: API 参照名が `My API` と完全に等しい。 - `Name LIKE '%My API%'`: API 参照名にテキスト `My API` が含まれる。 - `(NOT Name LIKE '%BETA%')`: API 参照名にテキスト `BETA` が含まれない。 - `(Name = 'API Alpha' OR Name = 'API Bravo')`: API 参照名が `API Alpha` または `API Bravo` である。 - `(Name = 'My API' AND VersionGroup = 'v1')`: API 参照名が `My API`、API バージョングループが `v1` である。 - `(Name LIKE 'Product%' OR Name LIKE 'Shipping%' OR Name LIKE 'Order%')`: API 参照名が `Product`、`Shipping`、または `Order` で始まる。 - `Icon != ''`: API にアイコンが含まれる。 - `NavigateUrl != ''`: API に詳細を含むカスタムページにリンクする \[Learn More (詳細はこちら)\] ボタンが含まれる。 - `VersionGroup = 'v2'`: API バージョングループが `v2` と完全に等しい。 - `VersionGroup > 'v1'`: API バージョングループが `v1` より後。 - `VersionGroup < 'v1'`: API バージョングループが `v1` より前。 - `VersionGroup >= 'v2'`: API バージョングループが `v2` 以降。 - `VersionGroup <= 'v2'`: API バージョングループが `v2` 以前。 `OR` または `AND` を使用するクエリは、条件全体を括弧で囲む必要があります。 API コミュニティマネージャーは、通常の文字列比較を使用してバージョングループを比較します。 SOQL についての詳細は、『Salesforce SOQL および SOSL リファレンス』を参照してください。 ## [](#categories-filter)カテゴリ検索条件 API Carousel (API カルーセル) コンポーネントと API Catalog (API カタログ) コンポーネントは **\[Categories Filter (Advanced) (カテゴリ検索条件 (詳細))\]** パラメーターを使用して、Anypoint Exchange で指定した値のカテゴリに属する API のみを表示します。 カテゴリと値は、`Country=Argentina;Payment=Credit` のようにセミコロン区切りのペアとして記述します。同じカテゴリの複数の値を区切るには、`Country=Argentina,Spain;Payment=Credit` のようにカンマを使用します。 API Carousel (API カルーセル) または API Catalog (API カタログ) には、カテゴリ検索条件のすべてのカテゴリと値のペア、およびすべての検索条件に一致する API のみが表示されます。 # API コミュニティマネージャーパッケージのインストール
| Mulesoft Government Cloud のサポートは API コミュニティマネージャーバージョン 2.4.x 以前でのみ利用できます。 |
| インストールプロセスに時間が掛かっていると言うメッセージが表示された場合は、インストールの完了時にメールが届きます。 |
| クラス | 説明 |
|---|---|
|
コンテナ |
|
結果 |
|
結果 |
|
結果グループ |
| クラス | 説明 |
|---|---|
|
検索結果 |
|
名前 |
|
説明 |
|
API の詳細 |
|
API の詳細はこちら |
|
すべてのページ |
|
ページ |
|
コンテナ |
|
タブメニューコンテナ |
|
情報 |
|
空のメインテキストメッセージ |
|
空のヘッダーメッセージ |
| クラス | 説明 |
|---|---|
|
カルーセルコンテナ |
|
空カードメッセージ |
|
Slick スライダーコンポーネントコンテナ |
|
カルーセルのボトムドットナビゲーション |
|
左右矢印ナビゲーション |
| クラス | 説明 |
|---|---|
|
カタログコンテナ |
|
カタログヘッダー |
|
カテゴリコンテナ |
|
検索バーがカテゴリの横にあるときに使用される小さい検索 |
|
小さい検索入力 |
|
複数選択コンテナ |
|
複数選択の表示ラベル |
|
カテゴリの複数選択コンポーネント |
|
チップ、選択したカテゴリの表示ラベル、[Clear All (すべてクリア)] ボタンのコンテナ |
|
チップの表示ラベル |
|
[Clear All (すべてクリア)] ボタン |
|
チップコンテナ |
|
表示ラベルと閉じるアイコンを含む 1 つのチップのコンテナ |
|
チップの表示ラベル |
|
チップの閉じるアイコン |
|
区切り文字 |
|
検索コンテナ |
|
検索バーがカテゴリの下にあるときに使用される標準サイズの検索 |
|
API コンテナ |
|
ページインジケーター |
|
空カードメッセージ |
|
カードコンテナ |
|
カードバッジコンテナ |
|
カードバッジ |
|
カードアイコン |
|
カード名 |
|
カードの説明 |
|
カードボタンコンテナ |
|
カードの [Details (詳細)] ボタン |
|
カードの [Learn More (詳細はこちら)] ボタン |
|
ページネーターコンテナ |
| クラス | 説明 |
|---|---|
|
[API Details (API の詳細)] ボタン |
| クラス | 説明 |
|---|---|
|
API カードコンテナ |
|
API カードの境界線と影 |
|
アイコンとタイトルのコンテナ |
|
カードアイコン |
|
カードタイトル |
|
カードの説明 |
|
[API Details (API の詳細)] と [Learn more (詳細はこちら)] ボタンのコンテナ |
|
[API Details (API の詳細)] ボタン |
|
[Learn more (詳細はこちら)] ボタン |
| クラス | 説明 |
|---|---|
|
検索バーコンテナ |
|
検索入力 |
| クラス | 説明 |
|---|---|
|
ボタンとアプリケーション検索入力のコンテナ |
|
アプリケーションカードがない場合のメッセージ |
|
検索入力コンテナ |
|
アプリケーションカードコンテナ |
| クラス | 説明 |
|---|---|
|
アプリケーションカードコンテナ (境界線と影) |
|
タイトルとカードボタンのコンテナ |
|
アプリケーションカードタイトル |
|
ボタンコンテナ |
|
編集コンテナ |
|
削除コンテナ |
|
情報カードコンテナ |
|
1 行目仕切り |
|
分析情報コンテナ |
|
要求の表示ラベルと値 |
|
スループットの表示ラベルと値 |
|
エラーの表示ラベルと値 |
|
レイテンシーの表示ラベルと値 |
|
2 行目仕切り |
|
「要求情報」コンテナ |
|
アクセスの表示ラベル |
|
承認済み要求の表示ラベルと値 |
|
拒否済み要求の表示ラベルと値 |
|
保留中の要求の表示ラベルと値 |
| クラス | 説明 |
|---|---|
|
新規アプリケーション登録ラッパー |
|
アプリケーションタイトルの作成 |
|
アプリケーション情報サブタイトル |
|
アプリケーション名の表示ラベル |
|
アプリケーション名の入力 |
|
メッセージアプリケーション名はすでに登録済み |
|
説明の表示ラベル |
|
説明の入力 |
|
コールバックの表示ラベル |
|
コールバックの入力 |
|
作成ボタン |
| クラス | 説明 |
|---|---|
|
アプリケーション名 |
|
行仕切り |
|
クライアントログイン情報の表示ラベル |
|
クライアント ID のコンテナ |
|
クライアント ID の表示ラベル |
|
クライアント ID の値 |
|
クライアントシークレットのコンテナ |
|
クライアントシークレットの表示ラベル |
|
クライアントシークレットの入力 |
|
API アクセス状況の表示ラベル |
|
承認済みの表示ラベルと値 |
|
拒否済みの表示ラベルと値 |
|
保留中の承認の表示ラベルと値 |
| クラス | 説明 |
|---|---|
|
インスタンスセレクターのコンテナ |
|
API 追加の表示ラベル |
|
行区切り文字 |
|
インスタンスセレクターの境界線 |
|
インスタンスセレクターのリスト |
| クラス | 説明 |
|---|---|
|
コントラクトセレクターのコンテナ |
|
アプリケーション名の表示ラベル |
|
行区切り文字 |
|
コントラクトセレクターの境界線 |
|
コントラクトセレクターのリスト |
|
API 参照名の表示ラベル |
|
矢印ボタン |
| クラス | 説明 |
|---|---|
|
コミュニティのメインヘッダー |
|
コミュニティのロゴ |
| クラス | 説明 |
|---|---|
|
[Learn more (詳細はこちら)] ボタン |
| Mulesoft Government Cloud のサポートは API コミュニティマネージャーバージョン 2.4.x 以前でのみ利用できます。 |
| Mulesoft Government Cloud のサポートは API コミュニティマネージャーバージョン 2.4.x 以前でのみ利用できます。 |
|
可能な場合は、Equality の会社の値に一致するように、含めない用語を変更しました。顧客の実装に対する影響を回避するために、一部の用語は変更されていません。 |
| コミュニティ名を変更してある場合は、この設定を必ず更新してください。 |
| API コミュニティマネージャーのインストール、更新、設定は、API コミュニティマネージャー Salesforce 組織でシステム管理者プロファイルを持つユーザーが行う必要があります。 |
Anypoint Platform 組織が EU 地域、role=externalでホストされている場合は、このセクションのすべての手順で anypoint.mulesoft.com ドメインを eu1.anypoint.mulesoft.com に置き換えてください。 |
| 変更内容を保存するときに [ルールを有効化] チェックボックスがオンになっていることを確認してください。 |
| サイト名を変更してある場合は、この設定を必ず更新してください。 |
| [選択済みプロファイル] セクションから [システム管理者] プロファイルを削除しないでください。[システム管理者] プロファイルを削除すると、コミュニティには一切アクセスできなくなります。 |
| ログインページと登録ページの外観を設定する方法については、「API コミュニティのブランディングとカスタマイズ」を参照してください。 |
| API コミュニティマネージャーコンテンツは、CMS Connect 経由で外部の CMS システムで作成することもできます。 |
|
可能な場合は、Equality の会社の値に一致するように、含めない用語を変更しました。顧客の実装に対する影響を回避するために、一部の用語は変更されていません。 |
| 登録メンバーはライセンスが必要です。ゲストユーザーにはライセンスは必要ありません。ライセンスの詳細については、「ライセンスの概要」を参照してください。 |