Documentation Index
Fetch the complete documentation index at: https://docs.jitera.ai/llms.txt
Use this file to discover all available pages before exploring further.
メンバーの一括インポートでは、1つのCSVファイルをアップロードすることで、組織全体のメンバー一覧、チーム配属、ロールをまとめて反映できます。ファイルに含まれない既存のメンバーやチームは削除され、新しい行は招待を作成し、変更された行は既存メンバーを更新します。
メンバーの一括インポートはマージではなく置き換え操作です。インポート成功後、組織のメンバー構成はアップロードしたファイルと完全に一致します。ファイルに含まれていないアクティブなメンバー、チーム、チーム配属はすべて無効化されます。必ず現在のメンバー一覧をエクスポートしてから編集してください。
このページに記載されている値はすべてサンプルです。実際の組織の値に置き換えてください。
前提条件
- EnterpriseプランのJitera組織（メンバーの一括インポートはEnterpriseプラン限定機能です）
- 組織でのオーナーまたは管理者ロール
- 下記のフォーマットに従ったCSVファイル。現在のメンバー一覧をダウンロードして編集することを推奨します
ステップ1: 一括インポートページを開く
組織設定 > メンバー に移動し、一括インポート をクリックします。
ページは3つのセクションに分かれています。
| セクション | 用途 |
|---|
| 現在のメンバー一覧 | アクティブなメンバー、保留中の招待、チーム配属をCSVでダウンロードします |
| アップロードエリア | 新しいCSVをドロップして組織を反映します |
| 過去のインポート | これまでのインポート履歴。ステータス、統計、エラーレポートのダウンロードが確認できます |
ステップ2: 現在のメンバー一覧をダウンロードする
現在のメンバー一覧 カードで CSVをダウンロード をクリックします。ダウンロードしたファイルをテンプレートとして編集します。
現在の一覧から始めるのが最も安全な方法です。既存のメンバーとチームが必ずファイルに含まれるため、追加・変更・削除したい差分の行だけ編集すれば済みます。
アップロードのたびに、必ず最新のCSVをダウンロードしてください。 インポートが成功すると、組織の状態には新しいチーム、保留中の招待、ロール変更などが反映されます。前回のインポート前にダウンロードした古いCSVにはそれらの行が含まれず、次回のアップロードでそれらが無効化されてしまいます。通常 last_owner_team や last_owner_company エラーとして表示されます。
ステップ3: CSVを編集する
CSVはチーム配属ごとに1行です。2つのチームに所属するユーザーは、同じメールアドレスで2行になります。
| 列 | 必須 | 説明 |
|---|
email | はい | ユーザーのメールアドレス |
team | はい | チーム名。存在しないチームはインポート時に作成されます |
team_role | はい | チーム内のロール。owner、admin、member のいずれか |
organization_role | いいえ | 組織レベルのロール。owner、admin、member のいずれか。省略時は member。同じメールの行ではすべて同じ値にする必要があります |
サンプル
email,organization_role,team,team_role
alice@example.com,owner,Platform,owner
alice@example.com,owner,Mobile,member
bob@example.com,admin,Platform,admin
carol@example.com,member,Mobile,member
owner に統一されています。
制限とルール
| 項目 | 値 |
|---|
| ファイル形式 | .csv |
| 最大ファイルサイズ | 10 MB |
| 最大データ行数 | 30,000行 |
| チーム名の最大文字数 | 50文字 |
| メール形式 | 標準メール形式（name@domain.tld） |
organization_role の一貫性 | 同じメールアドレスのすべての行で同じ値にする必要があります |
保護したいメンバー（自分自身のアカウントや他のオーナーなど）は、その行をファイルに残しておけば変更されません。現在のメンバー一覧にあってアップロードしたファイルに含まれないメンバーは無効化されるため、保護対象は必ずファイルに含めてください。
ステップ4: ファイルをアップロードする
CSVをアップロードエリアにドロップするか、エリアをクリックしてファイルピッカーを開きます。
確認ダイアログが表示されます。
ファイル名を確認して、インポートを開始する場合は 置き換える をクリックします。中止する場合は キャンセル をクリックします。
ステップ5: ステータスバナーを確認する
アップロードが始まると、ページ上部にステータスバナーが表示され、リアルタイムで更新されます。
処理中
インポートがキューに入り、適用中です。通常は数分で完了します。
インポートが成功しました。バナーには各統計値のサマリーが表示されます。
| 統計 | 意味 |
|---|
| 作成されたメンバー | ファイルに含まれる新しいメールアドレスに対して作成された招待 |
| 更新されたメンバー | 名前、組織ロール、チーム配属が変更された既存メンバー |
| 無効化されたメンバー | 現在の一覧にあってアップロードファイルに含まれないメンバー |
| 作成されたチーム | ファイルで参照されていて以前は存在しなかったチーム |
| スキップされた保護行 | 保護対象のアカウントを操作しようとした行（例: 自分自身のオーナーロールを下げる行など、許可されない操作） |
行レベルの失敗の場合、バナーには行エラーの件数と エラーCSVをダウンロード ボタンが表示されます。エラーCSVは元のファイルに各エラーの詳細列を追加したものです。該当行を修正して再アップロードしてください。
プランレベルの失敗（例: シート上限を超える）の場合、バナーには具体的なメッセージが表示されます。失敗したインポートでは部分的な変更も保持されません。
ステップ6: 過去のインポートを確認する
過去のインポート セクションには、これまでのすべてのインポートが新しい順に表示されます。
各行に表示される情報:
- ファイル名とアップロード者
- ステータスバッジ（処理中、完了、失敗）
- 完了したインポートの作成・更新・無効化の統計
- 失敗したインポートの行エラー件数と、後からエラーレポートを取得するための エラーCSVをダウンロード リンク
CSV フォーマット
ヘッダー行
ファイルの先頭には必須列を含むヘッダー行が必要です。追加の列があっても無視されます。
必須列（順序は任意）: email、team、team_role。任意列: organization_role。
行の意味
| 操作 | ファイルでの表現方法 |
|---|
| 新しいメンバーを追加する | 新しいメールアドレスの行を追加 |
| メンバーを別のチームへ移す | 既存のメールアドレスと新しいチーム名の行を追加 |
| メンバーをチームから外す | 該当の (email, team) 行を削除 |
| チームロールを変更する | 該当行の team_role を変更 |
| 組織ロールを変更する | そのメールの全行で organization_role を統一的に変更 |
| メンバーを無効化する | そのメールの行をすべて削除 |
| チームを削除する | そのチームを参照する行をすべて削除 |
| チームを作成する | 任意の行で新しいチーム名を指定 |
トラブルシューティング
インポートの問題は2箇所に表示されます。ファイルレベルの問題はアップロード前にアップロードエリアで拒否され、行レベルおよびプランレベルの問題はアップロード後にステータスバナーに表示されます。
ファイルサイズが大きすぎる
エラー: 「ファイルが10 MBを超えています。サイズを小さくして再度お試しください。」
ファイルを圧縮、重複除去、または分割してください。10 MBの上限は生ファイルサイズに対するものです。
CSV形式ではない
エラー: 「ファイルはCSV形式ではありません。.csv 形式で保存して再度お試しください。」
スプレッドシートツールから .csv 拡張子で保存し直してください。ExcelとGoogleスプレッドシートの両方に「CSVとして保存」オプションがあります。
ファイルが空 / ヘッダー行がない
エラー: 「ファイルが空です。」または「ヘッダー行が見つかりません。」
ファイルにはヘッダー行と少なくとも1つのデータ行が必要です。
必須列が不足している
エラー: 「必須列が不足しています: <column>」
ヘッダー行に不足している列を追加してください。必須列は email、team、team_role です。
列の重複
エラー: 「重複する列が見つかりました: <column>」
ヘッダー行から重複する列を削除してください。
行の列数が一致しない
エラー: 「<n> 行目の列数が一致しません。」
すべてのデータ行はヘッダー行と同じ列数である必要があります。セル内のエスケープされていないカンマがないか確認し、必要に応じてセルをダブルクォートで囲んでください。
セルが長すぎる
エラー: 「<n> 行目、<column> 列: セルが長すぎます。」
その列の最大文字数を超えています。値を短くして再アップロードしてください。
行数が多すぎる
エラー: 「ファイルのデータ行数が <max> を超えています。」
ファイルを30,000行以下に分割するか、実際に変更しない行を削除してください。
シート数の上限を超える
エラー: 「プランで利用可能なシート数は <n> ですが、このインポートでは <m> 名の新規メンバーが作成されます。新規メンバーの行を削除するか、プランをアップグレードしてください。」
新規メンバーの行を削減するか、シート上限を増やすためにプランをアップグレードしてから再アップロードしてください。
組織にオーナーが残らない
エラー: 「このインポートでは組織にオーナーが1人もいなくなります。再アップロード前に別のメンバーをオーナーに昇格してください。」
組織には常に最低1人のオーナーが必要です。organization_role: owner の行を追加してから再アップロードしてください。
チームにオーナーが残らない
エラー: 「このインポートではチーム <team> にオーナーが1人もいなくなります。再アップロード前に別のメンバーをチームオーナーに昇格してください。」
各チームには常に最低1人のオーナーが必要です。該当チームに team_role: owner の行を追加してから再アップロードしてください。
別のインポートが実行中
エラー: 「別のインポートが適用中です。完了してから再度アップロードしてください。」
1組織につき同時に実行できるインポートは1つです。進行中のインポートが終わるのを待ってから再アップロードしてください。
ダウンロード時のエンコーディングエラー
エラー: 「元のファイルをデコードできませんでした。」
インポート時に元のファイルは後でダウンロードできるよう保存されます。ただし、システムがデコードできないエンコーディング（BOMなしの非UTF-8など）でアップロードされた場合、ダウンロードできません。復元が必要な場合はUTF-8で再アップロードしてください。
参照: 列のサマリー
| 列 | 必須 | 許可される値 | 例 |
|---|
email | はい | 標準メールアドレス | alice@example.com |
team | はい | チーム名、50文字以内 | Platform |
team_role | はい | owner、admin、member | member |
organization_role | いいえ | owner、admin、member（省略時は member）。同じメールの行で値を統一する必要があります | owner |
- 組織メンバー — メンバーを1人ずつ追加・更新・削除する
- 組織設定 — プラン、シート、その他の組織全体の設定
