はじめに
ユーザー管理ツールは、設定DataSetを使用して、管理対象のリモートインスタンスを含むDomoインスタンスでのユーザーの作成と更新を自動化します。 設定DataSetを使用して、インスタンスメンバーの属性を一括で定義することもできます。Domoの属性の詳細については、 こちら を参照してください。 この記事では、ユーザー管理ツールへのアクセス方法、属性を含む設定DataSetの作成方法、ツールでジョブを作成して目的のタスクを実行する方法について説明します。必要な許可
ユーザー管理は管理ツールキットの一部です。ツールキットにアクセスするには、以下の許可が有効になっている権限が必要です。- カスタムのパイプライン処理を作成する — ジョブの作成、更新、共有、削除をユーザーに許可します。この許可を持つユーザーは、自分が作成したジョブまたは自分に共有されたジョブだけを閲覧できます。
- DataSetを編集 — アクセス権を持つDataSetの作成と編集をユーザーに許可します。
- 全てのユーザーを管理 — ユーザーの作成、編集、削除とパスワードのリセットをユーザーに許可します。
- ユーザーを追加 — 新しいユーザーのDomoへの追加をユーザーに許可します。
- （管理者レベル）全ての権限を管理 — カスタマイズされた権限の作成、編集、削除とインスタンス内の任意の権限への任意のユーザーの割り当てをユーザーに許可します。
ユーザー管理にアクセスする
管理ツールキットでユーザー管理にアクセスするには、以下の手順に従います。- ［管理者］ > ［ガバナンス］ > ［管理ツールキット］ に移動します。
-
［ユーザー管理］ に移動します。
注記： ［管理ツールキット］または［ユーザー管理］オプションが表示されていない場合は、自分の権限に 必要な許可 があることを確認してください。Domoアカウントでツールキットを有効にするには、アカウントチームにお問い合わせください。
設定DataSetを作成する
ユーザー管理の設定DataSetを作成する必要があります。このDataSetは、管理者設定の［ガバナンス］の ［一括インポート］ 機能（ ［管理者］ > ［ガバナンス］ > ［ユーザー］ ）のフォーマットと一致している必要があります。ここでは、インポートファイルのサンプルをダウンロードできます。一括インポートの詳細については、 こちら を参照してください。 以下の表は、設定DataSetに必要なすべてのフィールドを示しています。| 列ヘッダー | タイプ | フォーマット |
| displayName | 文字列 | John Smith |
| roleId この表に記載されているほかのすべてのフィールドと同様、roleIdは必須です。 | 数値 | 有効なroleIdの値には以下が含まれます（Null値は許容されません）。
注記： インスタンスでカスタマイズされた権限機能が有効になっている場合は、ユーザーのカスタマイズされた権限IDを入力することもできます。 権限IDを確認するには、 ［管理者］ > ［ガバナンス］ > ［権限］ に移動します。リストから権限を選択し、 ［詳細］ タブに進みます。 権限ID を見つけます。  |
| title | 文字列 | Software Engineer |
| department | 文字列 | Development |
| メールアドレス | johnsmith @ example. com | |
| alternateEmail | メールアドレス | john_smith @ example. com |
| phoneNumber | 国際電話番号 | 例： (800)899-1000 |
| deskPhoneNumber | 国際電話番号 | 例： (800)899-1000 |
| employeeNumber | 数値 — long型またはinteger型 | 0074 |
| location | 文字列 | Utah |
| timeZone | 文字列 | 例：America/Denver tzデータベースタイムゾーンのリストについては、 こちらのWikipediaの記事  を参照してください。 |
| locale | ロケール言語タグ | 有効なlocaleの値には以下が含まれます。 de-DE、de-AT、de-CH、en-AU、en-CA、en-150、en-HK、en-IE、en-IL、en-MO、en-NZ、en-SG、en-GB、en-US、en-001、es-ES、es-US、es-419、es-MX、fr-BE、fr-CA、fr-FR、fr-CH、nl-BE、nl-NL、pt-BR、pt-PT、ja-JP、zh-CN、zh-Hans-HK、zh-Hans-MO、zh-Hans-SG |
| employeeId | 文字列 | UT000034065 |
このページのトップへ
ジョブを作成する
ジョブを作成するには、以下の手順に従います。- ユーザー管理に アクセス します。
- ［+新規ジョブ］ を選択します。
-
以下の情報を入力します。
注記： アスタリスク（ * ）の付いたフィールドは必須です。
- ［ジョブ名］ *
- ［ジョブの説明］
- ［設定DataSet］ * 設定DataSetの作成方法については、 上記 を参照してください。
- ［招待を送信］ — このボックスにチェックを入れると、新しく作成されたすべてのユーザーにメールが送信されます。
- ［孤立したユーザーを削除］ — 警告： 設定DataSetに含まれていないユーザーがインスタンスで削除されます。
- ［このジョブをどこで実行しますか？］ — このジョブを現在のインスタンスで実行するか、管理対象のリモートインスタンスで実行するかを選択します。
- ［実行ログをどこに保存しますか？］ — 各ジョブはジョブの実行状況とその関連情報を記録します。新規または既存のDataSetのいずれかを選択して実行ログを保存することができます。
- ［新規DataSet］ — これを選択すると、Domoインスタンスに新しいDataSetを作成します。その新しいDataSetに、すべてのジョブ実行が書き込まれます。
- ［既存のDataSet］ — これを選択すると、選択した既存のDataSetによって、複数のユーザー管理ジョブを1つのログ収集DataSetにまとめることができます。 このDataSetは、ユーザー管理ツールで作成されたDataSetであることが必要です。 また、DataSetには既にデータ行が含まれている必要があります。
- ［通知を受け取るメールアドレス：］ — このフィールドにはユーザーのメールアドレスを追加できます。それぞれの受信者は、ジョブが実行されるたびにDomoからメール通知を受け取ります。この通知には、ジョブが実行したアクションの概要のほか、障害が発生した場合にはその障害が記載されます。
- 変更を送信します。
ジョブを実行する
ジョブを実行する場合は、 ［無効］/［アクティブ］ スイッチを切り替えてジョブ実行を有効にすることができます。有効にすると、ジョブをスケジュール通りに実行できます。
- トグルを［無効］にすると、ジョブは必ず手動で実行する必要があります。
- トグルを［アクティブ］にすると、ジョブは6時間ごと、および、設定DataSetが更新されるたびに実行されます。
- ユーザー管理に アクセス します。
-
実行するジョブにマウスポインターを合わせ、 ［オプション］ > ［ジョブを実行］ を選択します。
設定DataSetを使用して属性を管理する
ユーザー管理の 設定DataSet を使用して、インスタンスのシステム属性やカスタム属性を一括で作成、管理できます。設定DataSetを使用してカスタム属性を追加する
管理者設定の［ガバナンス］の ［属性］ ページ（ ［管理者］ > ［ガバナンス］ > ［属性］ ）からカスタム属性を作成する場合、キー値を指定する必要があります。Domoは、ユーザーの認証時にこのキーを探します。詳細については、「 属性 」を参照してください。
-
設定DataSetに各カスタム属性の< カスタム属性 >列を追加します。列名はカスタム属性のキーです。
例えば、キーが「teamId」のチームID属性を追加するには、設定DataSetに「teamId」という新しい列を追加します。
-
各ユーザーの値を列に入力します。属性値のデータタイプは、列のデータタイプと一致する必要があります。例えば、属性が数値である必要があり、設定DataSetには文字が含まれている場合、ユーザー管理ジョブは正常に実行されません。
例えば、データタイプが文字列で、各ユーザーの値が「Sales」の場合は適正です。
注記： リストタイプのカスタム属性もサポートされており、「|」（パイプ）文字で区切ることができます。例えば「
abc|def」は「abc」と「def」の両方を値として単一のカスタムリスト属性に追加します。 - 設定DataSetを保存して、Domoに再アップロードします。
- ユーザー管理に アクセス し、既存のジョブに移動します。
- ［編集］ を選択して変更を行います。
-
［設定DataSet］ ドロップダウンで更新したDataSetを選択します。
- 変更を送信してジョブを実行します。
カスタム属性を表示する
設定DataSetを使用してカスタム属性を追加した後、設定DataSetに含まれるユーザーまたはグループのプロフィールページを表示することで、それらが正しく設定されているかを確認できます（ ［管理者］ > ［ガバナンス］ > ［ユーザー］ > <<ユーザー>> ）。 ［カスタム］ にユーザー/グループのカスタム属性とその値が表示されます。
リモートインスタンス設定
リモートインスタンス設定を使用すると、1つのDomoインスタンスにいるときに、アクセスできるほかのインスタンスのユーザーを管理できます。ユーザーをリモートで管理するには、 設定DataSet の設定を行います。 Domoアクセストークンアカウント を、 Domoアクセストークン またはリモートインスタンスのユーザー名とパスワードのいずれかで設定します。リモートインスタンスのユーザー管理を設定する
また、アクセスできる任意のリモートインスタンスに対してユーザー管理設定を設定を行うこともできます。リモートインスタンスのユーザー管理を設定するには、以下の手順に従います。- ジョブを作成または編集するときは、 ［設定］ で設定DataSetを選択します。この設定DataSetには、 上記 のユーザー管理のガイドラインに従って、リモートインスタンスの有効な値を入力する必要があります。
-
［このジョブをどこで実行しますか？］ で ［リモートインスタンス］ を選択します。
- ［インスタンス：］ フィールドに、PDPを管理するリモートインスタンスのドメインを入力します。ドメインのフォーマットは example.domo.com である必要があります。
- ［次のインスタンスのアカウントを選択します。］ ドロップダウンを使用して、有効なDomoアクセスアカウントを選択します。Domoアクセストークンアカウントを設定する方法については、 後述のセクション を参照してください。
- ［レポート作成］ で実行ログを保存する場所を選択します。 注記： 通知メールとメトリクスログは、ポリシーが実行されているインスタンスに書き込まれます。リモートインスタンスには書き込まれません。
- ［送信］ を選択して変更を保存します。
Domoアクセストークンアカウントを設定する
Domoアクセストークンアカウントを設定するには、以下の手順を実行します。- Domoで ［アカウント］ に移動します。
-
［新規に追加］ > ［アカウント］ を選択し、ドロップダウンを使用して、Domoアクセストークンアカウントを選択します。
-
モーダルで、以下のいずれかのオプションを入力します。
- アクセストークン ： ［Remote Instance Access Token］ フィールドにアクセストークンを入力します。
- ユーザー名とパスワード ： ［Remote Instance Username］ と ［Remote Instance Password］ フィールドに認証情報を入力します。
- ［接続］ を選択します。
アクセストークンを生成する
アクセストークンを生成するには、以下の手順に従います。- ［管理者］ > ［認証］ > ［アクセストークン］ に移動します。
-
［アクセストークン］ ページで、 ［+アクセストークンを生成］ を選択します。
-
［アクセストークンの説明］ フィールドに説明を入力します。
- アクセストークンを生成するユーザーを検索して選択します。
- ［有効期限：］ リストで有効期限を選択します。
- ［生成する］ を選択します。
- 使用するコードをコピーします。