# Experience Cloudでの利用

Mashmatrix Sheetは、Experience Cloud上での利用もサポートしています。サポートされるExperience Cloudユーザライセンスの種類は以下のとおりです。

* Partner Community
* Customer Community Plus
* Customer Community

## 設定手順 <a href="#setup-procedure" id="setup-procedure"></a>

### ライセンスの割当 <a href="#assign-licenses" id="assign-licenses"></a>

サイトにログインするパートナーユーザ・カスタマーユーザにはMashmatrix Sheetの有効なライセンスをあらかじめ付与しておく必要があります。パートナーユーザ・カスタマーユーザへのライセンスの割当方法は、通常のユーザと同じです。詳しくは「[ライセンスの割当](https://docs.mashmatrix.com/mashmatrix-sheet/ja/settings_for_admin/license_assignment)」を参照してください。

### 権限セットの付与 <a href="#assign-permission-set" id="assign-permission-set"></a>

サイトにログインするパートナーユーザ・カスタマーユーザにはMashmatrix Sheetの権限セットを付与する必要があります。割当可能な権限セットは以下のとおりです

**Partner Communityユーザ**

* Mashmatrix Sheet User (Read Only)

#### **Customer Community / Customer Community Plus ユーザ**

* Mashmatrix Sheet User (Customer)

{% hint style="info" %}
サイトがセルフ登録をサポートする場合、サイトにログインするユーザは動的に作成されるため、Mashmatrix Sheetライセンスの割当および権限セットの付与も動的に行う必要があります。そのため、多くの場合、Apexコードを記述するインテグレーションが必要となります。
{% endhint %}

### ブックの作成と共有 <a href="#create-and-share-books" id="create-and-share-books"></a>

サイトにアクセスするExperience Cloudユーザが利用するためのブックをあらかじめ作成しておきます。

Experience Cloudサイトで共有するための専用のフォルダを作成し、その中にブックを共有します。フォルダの共有先にはサイトのユーザが所属するロールあるいは公開グループを共有先として含めます。

{% hint style="info" %}
この共有設定によって利用が可能なのはPartner Community あるいはCustomer Community Plusユーザのみです。Customer Communityユーザに対して共有するには「[Customer Communityユーザへの公開方法](#sharing-to-customer-community-users)」を参照してください。
{% endhint %}

### サイトへの配置 <a href="#embed-site-page" id="embed-site-page"></a>

Experience CloudでMashmatrix Sheetを利用するには、エクスペリエンスビルダーを利用してコミュニティサイトにMashmatrix Sheetの画面を配置する必要があります。サイトに配置できる画面として「Mashmatrix Sheetアプリケーション画面」「特定のブック・シートの画面」の２種類があります。

#### Mashmatrix Sheetアプリケーション全体を利用する

![](https://2817247209-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FS2wT6ommdiuYru74JEtd%2Fuploads%2Fgit-blob-9fcdd6930ff3f62d5334a1130e0913f7dbe1ab8c%2Fmashmatrix_sheet_app_in_experience_cloud.png?alt=media)

Mashmatrix Sheet アプリケーション全体をサイトに配置することで、サイトにログインしたユーザが公開されているブックをナビゲーションメニューから選択して自由に切り替えることができます。

1. エクスペリエンスビルダーで、コンポーネント一覧から「Visualforce Page」を選択してサイトのコンテンツ領域にドラッグ＆ドロップします。
2. ドロップしたVisualforce Pageコンポーネントを選択し、プロパティパネルから「Visualforceページ名」として「Mashmatrix Sheet App」を選びます。
3. 高さプロパティには適当な高さ（推奨は800以上）の値を入力しておきます。
4. サイトを公開します。

{% hint style="info" %}
エクスペリエンスビルダー上でのプレビューではMashmatrix Sheetアプリケーションの中身が崩れて表示される場合がありますが、公開後のサイトに影響はありません。
{% endhint %}

#### 特定のブック・シートの画面を利用する

![](https://2817247209-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FS2wT6ommdiuYru74JEtd%2Fuploads%2Fgit-blob-4b9c6b5e6e1f2f20a84b3e2a6fa13a44f198ba24%2Fsheet_component_in_experience_cloud.png?alt=media)

サイトにログインするユーザが利用するMashmatrix Sheetのブック・シートがあらかじめ決まっている場合、特定のブック・シートをSheetコンポーネントを利用して自由にサイト内に配置できます。

1. サイト内に配置したいブックのブック設定、あるいはシートのシート設定から、ブックIDおよびシートIDを確認しメモしておきます。
2. エクスペリエンスビルダーで、コンポーネント一覧から「Mashmatrix Sheet」を選択してサイトのページのコンテンツ領域にドラッグ＆ドロップします。
3. ドロップしたMashmatrix Sheetコンポーネントを選択し、プロパティパネルから「Book ID」としてサイトに配置したいブックのブックIDを入力します。ブック内の特定のシートのみ表示したい場合、「Sheet ID」にシートIDを入力します。
4. 「Height」にはコンポーネントの高さとして適当な値を入力します。
5. サイトを公開します。

## Customer Communityユーザへの公開方法 <a href="#sharing-to-customer-community-users" id="sharing-to-customer-community-users"></a>

Mashmatrix Sheetで作成されたブックをCustomer CommunityユーザがExperience Cloudサイト上で利用するには、フォルダの共有設定で共有するのではなく、共有セットを用いて制御します。詳しくは以下の手順に従います。

1. 「Mashmatrixフォルダ」オブジェクトのレコード一覧を表示するシートをMashmatrix Sheetで作成・表示します。シートに「取引先」列が含まれていることを確認し、含まれていない場合は列を追加します。
2. サイト上で共有したいブックを含むフォルダのレコードを特定し、レコードの「取引先」列の値に該当のコミュニティユーザが所属している取引先を設定します。
3. 設定 > 機能設定 > デジタルエクスペリエンス > 設定 から、共有セットを新規作成します
4. プロファイルに対象のカスタマーユーザの所属するプロファイルを指定します。
5. オブジェクトとして「Mashmatrixフォルダ」「Mashmatrixブック」を追加します
6. アクセス権の設定から、 「Mashmatrixフォルダ」「Mashmatrixブック」に対してアクセス権をそれぞれ以下のように設定します。
   * Mashmatrixフォルダのアクセスマッピング
     * ユーザ: **Account**
     * ターゲット Mashmatrixフォルダ: **msmxSheet*****\_\_*****Account\_\_c**
     * アクセス権: **参照のみ**
   * Mashmatrixブックのアクセスマッピング
     * ユーザ: **Account**
     * ターゲット Mashmatrixブック: **msmxSheet\_\_Folder\_\_c.msmxSheet*****\_\_*****Account\_\_c**
     * アクセス権: **参照のみ**

![](https://2817247209-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FS2wT6ommdiuYru74JEtd%2Fuploads%2Fgit-blob-dab4d290d6b8439971becfa655071b101750ff01%2Fsharing_set_access_mapping_for_folder.png?alt=media)

![](https://2817247209-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FS2wT6ommdiuYru74JEtd%2Fuploads%2Fgit-blob-dc09bede1f74392f2626a90925a4a8e34a854be5%2Fsharing_set_access_mapping_for_book.png?alt=media)

## 注意事項 <a href="#notices" id="notices"></a>

Mashmatrix Book オブジェクト・Mashmatrix Sheetオブジェクトのリスト画面からのブック画面へのアクセスについてはサポートしていません。Mashmatrix Sheet Appページを配置してご利用ください。
