> ## Documentation Index
> Fetch the complete documentation index at: https://docs.umoh.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 参加者の追加とインポート

> 参加者を1人ずつ追加する方法と、CSV・Excelの名簿を4ステップのインポートウィザードで取り込み、列を対応づけて確認し、結果を見る手順です。

参加者は1人ずつ追加するか、ファイルからまとめてインポートします。どちらも公開の前後を問わず使え、こうして登録した参加者は自動的に承認され、招待を送るまで名簿に「未招待」として表示されます。

<Note>
  どちらの方法にも参加カテゴリが1つ以上必要です。インポートできるファイルはCSVまたはExcelで4MB以下、Excelは最初のシートだけを読み取ります。イベントが終了すると追加もインポートもできなくなります。
</Note>

<Steps>
  <Step title="1人を追加する">
    「参加者」で「参加者を追加」を押します。「参加カテゴリ」を選び、「氏名」と「メールアドレス」を入力して「追加」を押してください。メールアドレスは1つのイベントに1回しか登録できません。

    公開中のイベントでは、続けて「招待を送信しますか？」ダイアログが開き、その場で招待できます。後で送る場合は「キャンセル」を押します。
  </Step>

  <Step title="ファイルをアップロードする">
    「インポート」を押すと「参加者をインポート」ダイアログが開きます。「テンプレートをダウンロード」で受け取るCSVには、イベントのプロフィールフィールドまで列として入っています。ファイルをドラッグするか「ファイルを選択」で選び、「次へ」を押してください。
  </Step>

  <Step title="列を対応づける">
    「ファイルの列」ごとに「マッピング先」が見出しから提案されます。「氏名」と「メールアドレス」は必ず対応づけ、不要な列は「インポートしない」にしておきます。

    「参加カテゴリ」に対応づけた列がない場合は、全行に適用する「デフォルト参加カテゴリ」を選びます。必須フィールドが対応づけられていないか、2つの列が同じフィールドを指している間は「次へ」が押せません。
  </Step>

  <Step title="内容を確認する">
    「行数」「新規」「更新」「警告」「エラー」の件数が並び、「問題のある行」の表に行ごとの理由が出ます。エラーのある行は除外され、警告のある行はインポートされますが、名簿で「要修正」が付くことがあります。

    「既存の参加者」では、すでに名簿にいる人をそのままにする「既存の参加者をスキップ」か、ファイルの値で参加カテゴリと回答を上書きする「既存の参加者を更新」を選びます。既存の参加者はメールアドレスで照合されます。「インポートを開始」を押してください。
  </Step>

  <Step title="完了を待つ">
    進行状況が表示されている間にダイアログを閉じても、インポートは続き、名簿は自動で更新されます。

    結果は「インポート完了」「インポート完了（一部失敗）」「インポート失敗」のいずれかで、追加・更新・スキップの件数も表示されます。取り込めなかった行は「失敗した行をダウンロード」で受け取り、「完了」でダイアログを閉じます。
  </Step>
</Steps>

## 結果を確認する

「インポート」の横にある時計アイコンを押すと「インポート履歴」が開き、インポートごとに「処理中」「完了」「一部失敗」「失敗」のステータスと失敗した行のダウンロードリンクが残ります。

## 次のステップ

* 追加した人に[招待を送信](/ja/host/participants/invitations)します。
* インポートの前に[プロフィールフィールド](/ja/host/settings/profile-fields)を作っておくと、テンプレートにその列が含まれます。

## トラブルシューティング

<AccordionGroup>
  <Accordion title="CSVまたはExcel（.xlsx）ファイルのみ対応しています">
    ファイルを.csvまたは.xlsxで保存してください。4MBを超えるファイルも受け付けないため、長い名簿は数回に分けてインポートします。Excelファイルは最初のシートしか読み取らないので、データを最初のシートに移してください。
  </Accordion>

  <Accordion title="マッピングされていない必須フィールド">
    「氏名」または「メールアドレス」の列がないか、「インポートしない」になっています。ウィザードが認識できなかった見出しはすべて「インポートしない」から始まるため、対応表を1行ずつ確認してください。テンプレートから始めればこの問題は起こりません。
  </Accordion>

  <Accordion title="更新した参加者が承認済みでない">
    「既存の参加者を更新」はプロフィールのデータだけを変えます。「承認待ち」や「却下」だった人はそのままで、招待の対象から外れます。参加させる人は名簿で承認してください。
  </Accordion>

  <Accordion title="インポート失敗">
    ファイル全体を処理できなかった状態です。もう一度試し、失敗が続く場合は結果画面に表示されるお問い合わせ先に連絡してください。
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.