Tableau Cloud ヘルプ

このトピックでは、CSV ファイル自体の詳細について説明します。CSV を使用してユーザーをインポートするには、次の方法があります。

• サイトの管理ページを使用します。詳細については、「ユーザーのインポート」を参照してください。
• tabcmd ユーティリティを使用します。詳細については、「createsiteusers filename.csv」を参照してください。
• Tableau Cloud Manager を使用します。詳細については、「Tableau Cloud Manager でのユーザーの管理」を参照してください。

ユーザーをインポートするための CSV ファイルには、次の書式要件があります。

• 列の見出しはありません。Tableau Cloudファイル内の各行を 1 人のユーザーと見なします。
• バイト オーダー マーク (BOM) 付きの UTF-8 形式。
  • BIG-5 などの文字エンコーディングは UTF-8 に変換する必要があります。この操作を行うには、テキスト エディターでファイルを開き、[名前を付けて保存] コマンドを使用します。
  • @ 文字がドメイン セパレーター以外のユーザー名フィールドに存在する場合は、16 進形式 (\0x40) にする必要があります。たとえば、user@fremont@mycompany.com は user\0x40fremont@mycompany.com にする必要があります。

ファイルにはヘッダー行を含めないでください。すべての列に入力する必要はありませんが、すべてのコンマ区切り記号をそのまま含めることによって、必須の列構造を保持する必要があります。

列構造は、製品やインポート ツールによって異なります。環境に適した構造を使用していることを確認します。

• Tableau Cloud: ユーザー名 (メール)、パスワード、表示名、ライセンス レベル、管理者レベル、パブリッシュ機能
• Tableau Cloud Manager を使用する Tableau Cloud: ユーザー名 (メール)、パスワード、サイト URI、表示名、ライセンス レベル、管理者レベル、パブリッシュ機能、 認証タイプ
• Tableau Server: ユーザー名、パスワード、表示名、ライセンス レベル、管理者レベル、パブリッシュ権限、メール アドレス
• アイデンティティ プールを使用する Tableau Server: ユーザー名、パスワード、表示名、ライセンス レベル、管理者レベル、パブリッシュ機能、メール アドレス、アイデンティティ プール名、識別子

各列に指定できる値の詳細については、以下の「列の詳細」セクションを参照してください。

重要: 列の順序には重要な意味があります。列のコンテンツに関係なく、最初の列はユーザー名、2 番目の列はパスワード、3 番目の列は表示名などと表示されます。フィールドの値を省略する場合でも、フィールドのコンマ区切り記号は含める必要があります。

CSV ファイルにユーザー名の値 (メールアドレス) のみが含まれる場合 、そのユーザーはメールでサイトへの招待状を受け取ります。ユーザーはサイトを結合してアカウントを作成できますが、管理者がアカウント (表示名、ライセンス レベルなど) を構成するまでアカウントはライセンスなしのままとなります。

CSV ファイルの列構造: ユーザー名 (メール)、パスワード、表示名、ライセンス レベル、管理者レベル、パブリッシュ権限

列の詳細:

ユーザー名: 必須。ユーザーのメール アドレス。

パスワード: 無視されます。ベスト プラクティスとして、この列は空白のままにします。

• 新規ユーザーは、Tableau Cloud に初めてサインインする際にパスワードと表示名を選択する必要があります。ユーザーがすでに Tableau アカウントを持っている場合は、パスワードもすでに設定されているはずです。

表示名: 無視されます。ベスト プラクティスとして、この列は空白のままにします。

ライセンス レベル: Creator、Explorer、Viewer、またはライセンスなしのいずれかです。空白にした場合、ライセンス レベルは「ライセンスなし」になります。

管理者レベル: サイトまたはなしのいずれかです。空白にした場合、管理者レベルは「なし」になります。

• サイト = サイト管理者、なし = 管理者ではない、を示します。
• 注: Cloud は、Tableau Cloud Manager を使用する場合にのみ関連値となります。詳細については、「Tableau Cloud Manager でのユーザーの管理」を参照してください。

パブリッシュ機能: Yes/True/1 または No/False/0 のいずれかです。空白にすると、パブリッシュ機能は false になります。

• ライセンス レベルが Creator の場合、パブリッシュ機能は Yes/True/1 である必要があります。
• ライセンス レベルが Explorer の場合、パブリッシュ機能の値によって Explorer (パブリッシュ可能) と Explorer のサイト ロールが区別されます。
• ライセンス レベルが Viewer またはライセンスなしの場合、この列の値に関係なく、ユーザーはパブリッシュすることはできません。

空白のままの列は、列構造を保持するためにコンマで区切る必要があります。

Tableau Cloud Manager を使用していない場合、アップロード時に設定できる既定の認証タイプは 1 つだけです。個々のユーザーの認証タイプは、後で変更できます。

• Tableau Cloud で CSV ファイルを直接アップロードする場合、ファイルをインポートするときに認証タイプを指定すると、その設定はインポートされたすべてのユーザーに適用されます。
• tabcmd を使用してユーザーをインポートする場合、アップロード時に CSV ファイル内のすべてのユーザーに適用される認証タイプとサイト ロールを設定します。詳細については、「createsiteusers filename.csv」を参照してください。

アップロード時にユーザーごとに特定の認証タイプを設定するには、Tableau Cloud Manager を使用する必要があります。詳細については、「Tableau Cloud Manager でのユーザーの管理」を参照してください。

ヒント: 構造は、username email, password, display name, license level, administrator level, publishing capability のようにし、列が空白のままの場合は、コンマの間に何も入れないでください。

以下の例は Explorer (パブリッシュ可能) サイトロールを付与されているが、サイト管理者ではなく、適切なコンテンツパーミッションが付与されているプロジェクトに対してパブリッシュ可能なユーザーを示しています。

user1@domain.com,,,Explorer,None,true

管理者レベル列を変更することで、次のユーザーをサイト管理者 Explorer サイト ロールのあるサイト管理者としてインポートできます。

adminuser@domain.com,,,Explorer,Site,true

CSV ファイルにユーザー名 (メールアドレス) 値のみが含まれる場合、そのユーザーはメールでサイトへの招待状を受け取ります。ユーザーはサイトを結合してアカウントを作成できますが、管理者がアカウント (表示名、ライセンス レベルなど) を構成するまでアカウントはライセンスなしのままとなります。

空白のままの列は、列構造を保持するためにコンマで区切る必要があることに注意してください。

CSV ファイルの列構造: username email, password, site URI, display name, license level, administrator level, publishing capability, authentication type

列の詳細: 

ユーザー名: 必須。ユーザーのメール アドレス。

パスワード: 無視されます。ベスト プラクティスとして、この列は空白のままにします。

• 新規ユーザーは、Tableau Cloud に初めてサインインする際にパスワードと表示名を選択する必要があります。ユーザーがすでに Tableau アカウントを持っている場合は、パスワードもすでに設定されているはずです。

サイト URI: サイトの統一リソース識別子。ユーザーを Cloud 管理者としてインポートするには、サイト URI 列を含めますが、空白のままにします。

表示名: 無視されます。ベスト プラクティスとして、この列は空白のままにします。

ライセンス レベル: Creator、Explorer、Viewer、またはライセンスなしのいずれかです。空白にした場合、ライセンス レベルは「ライセンスなし」になります。

管理者レベル: サイト、なし、Cloud のいずれかです。空白にした場合、管理者レベルは「なし」になります。

• サイト= サイト管理者、なし = 管理者でない、Cloud = Cloud 管理者、を示します。

パブリッシュ機能: Yes/True/1 または No/False/0 のいずれかです。空白にすると、パブリッシュ機能は false になります。

• ライセンス レベルが Creator の場合、パブリッシュ機能は Yes/True/1 である必要があります。
• ライセンス レベルが Explorer の場合、パブリッシュ機能の値によって Explorer (パブリッシュ可能) と Explorer のサイト ロールが区別されます。
• ライセンス レベルが Viewer またはライセンスなしの場合、この列の値に関係なく、ユーザーはパブリッシュすることはできません。

認証タイプ: サイトまたは Tableau Cloud Manager にアクセスするためのユーザー認証タイプ。

ヒント: 構造は、username email, password, site URI, display name, license level, administrator level, publishing capability, authentication type のようにし、列が空白のままの場合は、コンマの間に何も入れないでください。

次の例は、Tableau Cloud Manager で Cloud 管理者ロールが付与され、MFA を使用した Tableau を使用して認証するユーザーを示しています。

cloudadminuser@domain.com,,,,,Cloud,,Tableau with MFA

Tableau Cloud Manager で別の認証タイプが設定されている場合は、認証列を変更することで、以下のように別の認証タイプのユーザーをインポートできます。

cloudadminuser@domain.com,,,,,Cloud,,Salesforce

CSV 設定とサイト ロール