# 権限

Mashmatrix Sheetでは、Mashmatrix Sheetアプリケーション上でユーザーが可能な操作を制御するために、あらかじめ権限を定義できます。この権限はSalesforceのカスタム権限として作成され、プロファイルおよび権限セットを通してユーザーに割り当てることが可能です。

## 権限の管理 <a href="#manage-permissions" id="manage-permissions"></a>

{% hint style="info" %}
管理コンソールの権限ページを利用するには、ログインユーザーがSalesforceの管理者であるか、または「メタデータ API 関数を使用したメタデータの変更」権限を付与されている必要があります。
{% endhint %}

管理コンソールの「セキュリティ > 権限」メニューから、Mashmatrix Sheetで利用できる権限を確認・管理できます。

<figure><img src="https://918299401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAdS8j6AOK0kqiLE6LBdM%2Fuploads%2Fgit-blob-59b1f8b32414535561553491ffed8f4dd8bc56b3%2Fpermissions.png?alt=media" alt=""><figcaption></figcaption></figure>

「権限の作成」ボタンをクリックすることで、新しく権限を定義するためのダイアログが表示されます。権限名には英数文字列のみが入力可能です。

<figure><img src="https://918299401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAdS8j6AOK0kqiLE6LBdM%2Fuploads%2Fgit-blob-72c963dd68211d9fdb0681de8ff36dbaebbe3d1d%2Fcreate_perm_dialog.png?alt=media" alt=""><figcaption></figcaption></figure>

作成された権限は、Salesforceの設定画面では「カスタム権限」メニューから確認できます。管理コンソールから定義した権限は、必ずカスタム権限の名前の先頭に "MsmxPerm\_" というプレフィックスが追加されます。

<figure><img src="https://918299401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAdS8j6AOK0kqiLE6LBdM%2Fuploads%2Fgit-blob-b192eaef4dbaaac7ac3823e1bf20eb2ff9018b3b%2Fcustom_perms_in_salesforce.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
カスタム権限の一覧には「Mashmatrix Sheet - Base Access」というカスタム権限があらかじめ一覧に含まれていますが、このカスタム権限はMashmatrix Sheetアプリケーションの内部で利用するものであり、すでにユーザーに付与済みの権限セットに含まれています。このため以下の作業ではこのカスタム権限については無視して構いません。
{% endhint %}

## 権限の割り当て <a href="#assign-permissions" id="assign-permissions"></a>

権限を作成した後に、適切なユーザーに対してその権限を割り当てる必要があります。この作業はSalesforceの設定画面から行います。

### プロファイルによるカスタム権限の割り当て <a href="#assign-custom-permission-via-profile" id="assign-custom-permission-via-profile"></a>

ユーザが所属するプロファイルに対してカスタム権限を追加することにより、ユーザーにその権限を割り当てることが可能です。

プロファイルに対してカスタム権限を追加するには、以下の手順に従います。

1. 設定画面の左サイドバー内の「クイック検索」から「プロファイル」を検索し、同メニューをクリック
2. プロファイルの一覧から、権限を割り当てたいユーザの所属しているプロファイルをクリック
3. プロファイル詳細画面のユーザインターフェースに応じて以下のいずれかを実施
   * （拡張プロファイルユーザインターフェースが有効の場合）「アプリケーション > カスタム権限」のリンクをクリックし、カスタム権限セクションの編集ボタンをクリック

     <figure><img src="https://918299401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAdS8j6AOK0kqiLE6LBdM%2Fuploads%2Fgit-blob-77445290643252d1be6f897a161ed5f2538f8a7f%2Fprofile_custom_perm_1.png?alt=media" alt=""><figcaption></figcaption></figure>
   * （拡張プロファイルユーザインターフェースが無効の場合）関連リストの「有効になっているカスタム権限」の編集ボタンをクリック

     <figure><img src="https://918299401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAdS8j6AOK0kqiLE6LBdM%2Fuploads%2Fgit-blob-8f4980e0c80789b754d40d6f9e1d6a20d9ef0fe3%2Fprofile_custom_perm_2.png?alt=media" alt=""><figcaption></figcaption></figure>
4. 「使用可能なカスタム権限」に表示されている権限のうち、割り当てたい権限を選択して追加ボタンをクリックし、保存

   <figure><img src="https://918299401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAdS8j6AOK0kqiLE6LBdM%2Fuploads%2Fgit-blob-974199a2bd02cf20e1ce9966bd4b0fc597bea9f8%2Fadd_custom_perm.png?alt=media" alt=""><figcaption></figcaption></figure>

### 権限セットによるカスタム権限の割り当て <a href="#assign-custom-permission-via-permission-set" id="assign-custom-permission-via-permission-set"></a>

ユーザに付与された権限セットに対してカスタム権限を追加することにより、ユーザーにその権限を割り当てることが可能です。

権限セットに対してカスタム権限を追加するには、以下の手順に従います。

1. 設定画面の左サイドバー内の「クイック検索」から「権限セット」を検索し、同メニューをクリック
2. 権限セットの一覧から、対象の権限セットをクリック
3. 権限セットの詳細画面から「アプリケーション > カスタム権限」のリンクをクリックし、カスタム権限セクションの編集ボタンをクリック

   <figure><img src="https://918299401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAdS8j6AOK0kqiLE6LBdM%2Fuploads%2Fgit-blob-77445290643252d1be6f897a161ed5f2538f8a7f%2Fprofile_custom_perm_1.png?alt=media" alt=""><figcaption></figcaption></figure>
4. 「使用可能なカスタム権限」に表示されている権限のうち、割り当てたい権限を選択して追加ボタンをクリックし、保存

   <figure><img src="https://918299401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAdS8j6AOK0kqiLE6LBdM%2Fuploads%2Fgit-blob-974199a2bd02cf20e1ce9966bd4b0fc597bea9f8%2Fadd_custom_perm.png?alt=media" alt=""><figcaption></figcaption></figure>