> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-openapi-sync-dataflows.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# グループの管理

export const InlineImage = ({src, alt = '', height = '1.6em'}) => {
  return <img noZoom src={src} alt={alt} style={{
    display: 'inline',
    verticalAlign: 'start',
    height: height,
    margin: '0'
  }} />;
};

### はじめに

グループの管理では、Domoグループを一括管理することができます。グループのメンバー用のランディングページを設定することもできます。

***

この記事では、グループの管理の設定について以下のトピックで説明します。

* [ツールキットにアクセスする](#access_the_toolkit)
* [必要な許可](#required_grants)
* [グループにメンバーを追加するための設定DataSet](#configuration_dataset)
* [グループのランディングページを設定するための設定DataSet](#configuration_dataset_landing_page)
* [ジョブを作成する](#create_a_job)
* [ジョブを実行する](#run_a_job)
* [リモートインスタンス設定](#remote_instance_configuration)
  * [リモートインスタンスのグループの管理を設定する](#configure_group_management_remote_instance)
  * [Domoアクセストークンアカウントを設定する](#configure_domo_access_token)
  * [アクセストークンを生成する](#generate_access_token)

***

### ツールキットにアクセスする

管理ツールキットにアクセスするには、以下の手順に従ってください。

1. ナビゲーションヘッダーで **［その他］** > **［管理者］** に進みます。
2. **［ガバナンス］** メニューで **［ツールキット］を選択します。**

   <Note>
     **注記：** **［ツールキット］** オプションが **［ガバナンス］** メニューに表示されない場合は、必要な許可が自分のユーザー権限にあるか確認してください。アカウントエグゼクティブ（AE）に連絡してツールキットを有効にする必要がある場合があります。
   </Note>

### 必要な許可

管理ツールキットにアクセスするには、「カスタムのパイプライン処理を作成する」または「カスタムのパイプライン処理を管理する」の2つの許可のうち1つが、そのユーザー権限で有効になっている必要があります。カスタマイズされたユーザー権限に、許可を付与することができます。デフォルトでは、「カスタムのパイプライン処理を管理する」の許可は管理者ユーザーに対して有効になっています。

* **カスタムのパイプライン処理を作成する ：** 所有者に、ジョブの作成、更新、共有、削除を許可します。 ユーザーは自分が作成したジョブまたは自分に共有されたジョブだけを閲覧できます。
* **カスタムのパイプライン処理を管理する ：** 所有者に、ジョブの作成、更新、共有、削除を許可します。 ユーザーはパイプライン内のすべてのジョブを閲覧できます。
* **DataSetを管理 —** 所有者に、このインスタンス内のDataSetの表示、編集、削除を許可します。
* **全てのグループを管理 —** 所有者に、グループの作成、編集、削除や、グループへのユーザーの追加、削除を許可します。
* **全てのカード、ページ、App（App Studio/ワークシート）、レポート（Report Builder）の管理 —** 所有者に、インスタンス内のカード、ダッシュボード、App StudioのApp、Report Builderのレポートの表示、編集、共有、削除を許可します。所有者は、ほかのインスタンスのパブリケーションをサブスクライブすることもできます。パブリケーションの詳細については、 [こちら](/ja/s/article/360045120554) を参照してください。

カスタマイズされた権限および許可の詳細については、「 [カスタマイズされた権限を管理する](/s/article/360043438973) 」を参照してください。

### グループにメンバーを追加するための設定DataSet

<Warning>
  **重要：** 設定DataSetでは、「オンデマンド」のDataSetビューはサポートされていません。スケジュール通りに更新されたビュー、またはDataSet更新によって更新されたビューのみ許可されます。
</Warning>

このセクションでは、グループにメンバーを追加するための設定DataSetの列について説明します。

* User

  * グループに含めるユーザー。

  * ユーザーが複数の場合、パイプ「|」で区切ります。

  * ユーザーIDとメールアドレスを使用できます。
* Group

  * ユーザーを追加するグループの名称またはID。

  <Frame>
    <img alt="group management dataset.png" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/ag1wPXP26szkgB9J/images/kb/ka0Vq000000GUN7-00N5w00000Ri7BU-0EM5w000005wpSB.jpg?fit=max&auto=format&n=ag1wPXP26szkgB9J&q=85&s=e18a8a43782f1c21fbb8857208be0497" style={{width: 501, height: 388}} width="1404" height="1088" data-path="images/kb/ka0Vq000000GUN7-00N5w00000Ri7BU-0EM5w000005wpSB.jpg" />
  </Frame>

### グループのランディングページを設定するための設定DataSet

<Warning>
  **重要：** 設定DataSetでは、「オンデマンド」のDataSetビューはサポートされていません。スケジュール通りに更新されたビュー、またはDataSet更新によって更新されたビューのみ許可されます。
</Warning>

このセクションでは、グループのランディングページを設定する際に使用する設定DataSetの列について説明します。

* **priority —** ユーザーが複数のグループに所属している場合、どのランディングページが設定されるかは優先度によって決まります。

  * card\_idとpage\_idの両方が指定されている場合、そのページがランディングページに設定されます。

  * ユーザーが優先度の等しい複数のグループに所属している場合、ランディングページはグループ名のアルファベット順で割り当てられます。
* **group —** ランディングページが設定されているグループの名前またはID。
* **page\_id —** ランディングページに設定されているページのID。

  * 各行で、「page\_id」フィールドのページは「group」フィールドで指定されているグループのすべてのメンバーと共有する必要があります。複数のグループで同じグループランディングページが設定DataSetの同じページに設定されており、すべてのグループのすべてのメンバーに正しく共有されていない場合、含まれているすべてのグループのジョブは失敗します。
* **card\_id —** ランディングページに設定されているカードのID。

<Frame>
  <img alt="set_landing_page.png" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/ag1wPXP26szkgB9J/images/kb/ka0Vq000000GUN7-00N5w00000Ri7BU-0EM5w000005vNob.png?fit=max&auto=format&n=ag1wPXP26szkgB9J&q=85&s=b2de2656feb0b48346b11c80fc6f8ccf" style={{width: 830, height: 198}} width="1430" height="342" data-path="images/kb/ka0Vq000000GUN7-00N5w00000Ri7BU-0EM5w000005vNob.png" />
</Frame>

### ジョブを作成する

グループの管理でジョブを作成するには、以下の手順を実行します。

1. ナビゲーションヘッダーで
   **［その他］** > **［管理者］に進みます。**

2. **［ガバナンス］** メニューで **［ツールキット］を選択します。**

3. **［ツールキット］** で **［グループの管理］** を選択します。

4. **［+新規ジョブ］** を選択します。

新しいジョブを作成するページが表示されます。

<Frame>
  <img alt="Screen_Shot_2022-08-03_at_5.18.10_PM.png" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/ag1wPXP26szkgB9J/images/kb/ka0Vq000000GUN7-00N5w00000Ri7BU-0EM5w000005vNod.png?fit=max&auto=format&n=ag1wPXP26szkgB9J&q=85&s=5c9ece8660280620ca26f95ce808d8a3" style={{width: 902, height: 515}} width="2660" height="1518" data-path="images/kb/ka0Vq000000GUN7-00N5w00000Ri7BU-0EM5w000005vNod.png" />
</Frame>

5. **［ジョブ名］** とオプションの **［ジョブの説明］** を入力します。

6. **［設定］** セクションで、 **［ジョブオプション］** のチェックボックスの一方または両方にチェックを入れます。

* **［グループを管理］ —** このオプションを使用すると、必要に応じてメンバーシップグループを作成し、管理することができます。
* **［ランディングページを管理］ —** このオプションを使用すると、ランディングページまたはカードを既存のグループのメンバーに割り当てることができます。このオプションには、SSOから継承したディレクトリグループのランディングページの割り当てが含まれます。

7. （必須）選択したジョブオプションごとに設定DataSetを選択します。

* **グループの管理設定DataSet** では、自分のグループと各グループに所属するユーザーを定義します。
* **ランディングページの管理設定DataSet** では、どのランディングページを設定するかを定義します。

8. （グループの管理では必須）新規グループの作成方法を選択します。
   **［開始］** または **［閉鎖］** のラジオボタンを選択します。

9. **［レポート作成］** で、実行ログを保存する場所を選択します。

* **［新規DataSet］ —** このオプションは、Domoインスタンスに新しいDataSetを作成します。その新しいDataSetに、すべてのジョブ実行のログが書き込まれます。
* **［既存のDataSet］ —** このオプションでは、複数のグループの管理ジョブを1つのログ収集DataSetにまとめることができます。

  <Warning>
    **重要：** このDataSetは、グループの管理ツールで作成されたDataSetである必要があります。また、DataSetにはデータ行が含まれている必要があります。
  </Warning>

10. **［レポート作成］** に、ジョブの実行ごとにDomoから届く通知を受け取りたいメールアドレスを入力します。この通知には、ジョブの実行内容と発生した障害の概要が記載されます。

通知メールの例

<Frame>
  <img alt="Group_Management_Notification.png" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/ag1wPXP26szkgB9J/images/kb/ka0Vq000000GUN7-00N5w00000Ri7BU-0EM5w000005vNof.png?fit=max&auto=format&n=ag1wPXP26szkgB9J&q=85&s=cdcfdfcc6aaecc161d2701bfac931d06" style={{width: 351, height: 286}} width="1490" height="1218" data-path="images/kb/ka0Vq000000GUN7-00N5w00000Ri7BU-0EM5w000005vNof.png" />
</Frame>

11. 新しいジョブの作成ページに必要事項を入力したら、
    **［送信］** を選択します。

### ジョブを実行する

ジョブを実行するには、 **有効/無効を切り替える** トグルを使用します。このトグルは、ジョブの作成後に **［グループの管理］** ページに表示されます。

トグルを **［アクティブ］** にすると、ジョブは6時間ごと、および、設定DataSetが更新されるたびに実行されます。トグルを **［無効］** にすると、ジョブは手動での実行時にのみ実行されます。

<Frame>
  <img alt="enabled_toggle.png" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/ag1wPXP26szkgB9J/images/kb/ka0Vq000000GUN7-00N5w00000Ri7BU-0EM5w000005vNoZ.png?fit=max&auto=format&n=ag1wPXP26szkgB9J&q=85&s=8d71eec7f8571a64312494bfc432f434" style={{width: 840, height: 78}} width="2272" height="212" data-path="images/kb/ka0Vq000000GUN7-00N5w00000Ri7BU-0EM5w000005vNoZ.png" />
</Frame>

#### ジョブの実行例

* 実行前のグループ：

  <Frame>
    <img alt="Group_Management_5.png" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/ag1wPXP26szkgB9J/images/kb/ka0Vq000000GUN7-00N5w00000Ri7BU-0EM5w000005vNoa.png?fit=max&auto=format&n=ag1wPXP26szkgB9J&q=85&s=d7c590ca7b194fa7823f50c8d8fec453" style={{width: 901, height: 296}} width="5116" height="1680" data-path="images/kb/ka0Vq000000GUN7-00N5w00000Ri7BU-0EM5w000005vNoa.png" />
  </Frame>
* 設定DataSet：

  <Frame>
    <img alt="config_dataset.png" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/ag1wPXP26szkgB9J/images/kb/ka0Vq000000GUN7-00N5w00000Ri7BU-0EM5w000005vNoc.png?fit=max&auto=format&n=ag1wPXP26szkgB9J&q=85&s=f0cc5c23c23fd62c9521c8e25d45f594" style={{width: 901, height: 698}} width="1404" height="1088" data-path="images/kb/ka0Vq000000GUN7-00N5w00000Ri7BU-0EM5w000005vNoc.png" />
  </Frame>
* 実行後のグループ：

  <Frame>
    <img alt="Group_Management_6.png" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/ag1wPXP26szkgB9J/images/kb/ka0Vq000000GUN7-00N5w00000Ri7BU-0EM5w000005vNoe.png?fit=max&auto=format&n=ag1wPXP26szkgB9J&q=85&s=f886c304116a35d87fadc81d6fb7b575" style={{width: 902, height: 359}} width="5118" height="2038" data-path="images/kb/ka0Vq000000GUN7-00N5w00000Ri7BU-0EM5w000005vNoe.png" />
  </Frame>
* ログDataSet：

  <Frame>
    <img alt="Group_Management_Metrics.png" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/ag1wPXP26szkgB9J/images/kb/ka0Vq000000GUN7-00N5w00000Ri7BU-0EM5w000005vNoY.png?fit=max&auto=format&n=ag1wPXP26szkgB9J&q=85&s=4ea0cbc9c8b744ac68325727aff4af4c" style={{width: 901, height: 283}} width="5110" height="1604" data-path="images/kb/ka0Vq000000GUN7-00N5w00000Ri7BU-0EM5w000005vNoY.png" />
  </Frame>

### リモートインスタンス設定

リモートインスタンス設定を使用すると、1つのDomoインスタンスにいるときに、アクセスできるほかのインスタンスのグループの管理を設定できます。グループの管理をリモートで設定するには、この記事で前述した [設定DataSet](#config_dataset) が必要です。また、 [Domoアクセストークンアカウント](#configure_domo_access_token) を、 [Domoアクセストークン](#generate_access_token) またはリモートインスタンスのユーザー名とパスワードのいずれかで設定する必要があります。

# リモートインスタンスのグループの管理を設定する

1. グループの管理のジョブを作成または編集するときは、この記事に記載されているグループの管理のガイドラインに従ってリモートインスタンスの有効な値が入力された設定DataSetを **［設定］** セクションで選択します。「 [設定DataSet](#config_dataset) 」を参照してください。

2. 引き続き **［設定］** セクションで、ジョブを実行する場所として **［リモートインスタンス］** を選択します。

   **［インスタンスの設定］** が表示されます。

3. **［インスタンス：］** フィールドに、グループを管理するリモートインスタンスのドメインを入力します。

4. **［次のインスタンスのアカウントを選択します。］** リストから、有効な [Domoアクセストークンアカウント](#configure_domo_access_token) を選択します。Domoアクセストークンアカウントを設定する方法については、以下のセクションを参照してください。

5. **［レポート作成］** セクションに詳細を入力します。

   <Note>
     **注記：** 通知メールとメトリクスログは、ポリシーが実行されているインスタンスに書き込まれます。リモートインスタンスには書き込まれません。
   </Note>

6. **［送信］** を選択して変更をジョブに保存します。

# Domoアクセストークンアカウントを設定する

Domoアクセストークンアカウントを設定するには、以下の手順を実行します。

1. Domoナビゲーションヘッダーで、 **［データ］** を選択します。

   **Data Center** が開きます。
2. サイドバーで
   <InlineImage src="/images/kb/ja/ka0Vq000000JFzR-00N5w00000Ri7BU-0EM5w000006uFA5.jpg" /> **［アカウント］** を選択します。
3. **［新規に追加］** > **［アカウント］** を選択します。

   **［アカウントを追加］** モーダルが表示されます。

   <Frame>
     <img alt="domo access token.png" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/y73kYVYT02nhoBL7/images/kb/ka05w00000129aT-00N5w00000Ri7BU-0EM5w000006uF9v.jpg?fit=max&auto=format&n=y73kYVYT02nhoBL7&q=85&s=83af8d79dff5c4f1336d08620f5a3aab" style={{width: 576, height: 624}} width="936" height="1014" data-path="images/kb/ka05w00000129aT-00N5w00000Ri7BU-0EM5w000006uF9v.jpg" />
   </Frame>
4. モーダルで、以下のいずれかのオプションを入力します。
   * **アクセストークン** ： **［Remote Instance Access Token］** フィールドにアクセストークンを入力します。トークンの生成方法については、「 [アクセストークンを生成する](#generate_access_token) 」を参照してください。
   * **ユーザー名とパスワード** ： **［Remote Instance Username］** と **［Remote Instance Password］** フィールドに認証情報を入力します。
5. **［接続］** を選択します。

# アクセストークンを生成する

アクセストークンを生成するには、以下の手順を実行します。

1. Domoナビゲーションヘッダーで、 **［その他］** > **［管理者］** を選択します。

   管理者設定が表示されます。
2. 管理者設定の **［認証］** メニューで **［アクセストークン］** を選択します。
3. **［アクセストークン］** ページで、 **［+アクセストークンを生成］** を選択します。

   <Frame>
     <img alt="generate token.jpeg" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/enfTkpqxhZnichpt/images/kb/ka05w00000128xR-00N5w00000Ri7BU-0EM5w000006uFA0.jpg?fit=max&auto=format&n=enfTkpqxhZnichpt&q=85&s=d66be05545cc2be432d7a34000bdfc0c" style={{width: 670, height: 66}} width="1456" height="144" data-path="images/kb/ka05w00000128xR-00N5w00000Ri7BU-0EM5w000006uFA0.jpg" />
   </Frame>
4. **［アクセストークンの説明］** フィールドに説明を入力します。
5. アクセストークンを生成するユーザーを検索して選択します。
6. **［有効期限：］** リストで有効期限を選択します。
7. **［生成する］** を選択します。
8. 使用するコードをコピーします。

[このページのトップへ](#intro)

日本語
