> For the complete documentation index, see [llms.txt](https://help.verkada.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.verkada.com/access-control/ja/yzto/add-a-user-to-the-verkada-access-system/import-access-control-users-csv.md).

# アクセスユーザーをインポート - CSV

{% hint style="info" %}
組織がアクセスコントロールにDirectoriesを使用している場合は、次を参照してください [Directoriesでユーザーを管理する](/command/ja/yzto/manage-users-in-your-organization/directories-for-user-group-management.md) 変更を行う前に。Directoriesがユーザーの管理場所と適用される権限にどのように影響するかを説明しています。
{% endhint %}

複数のVerkadaアクセスコントロールユーザーを同時に管理しやすくするため、アクセス管理者はコンマ区切り値（CSV）ファイルを使用して、組織内のユーザーをエクスポート、インポート、編集できます。

{% hint style="warning" %}
同じ名前のユーザーが複数存在し（すでにCommandまたはCSVにあり）、メールアドレスがない場合、インポートにより同じ名前の重複ユーザーが作成されます。
{% endhint %}

***

## 既存のユーザーをエクスポート

ユーザーを更新するたびにユーザー一覧を手動で作成する手間を省くには、Commandから現在のユーザー一覧をエクスポートし、インポートファイルのテンプレートとして使用できます。

{% stepper %}
{% step %}
**Verkada Commandで、すべての製品 > アクセス に移動します。**
{% endstep %}

{% step %}
**左側のメニューで、アクセスユーザーとグループをクリックします。**
{% endstep %}

{% step %}
**エクスポート > ユーザーをエクスポート をクリックしてCSVをダウンロードします。**
{% endstep %}
{% endstepper %}

***

## 必須フィールド

アクセスユーザーをインポートする場合、次のフィールドが必須です：

* **名**
* **姓**

アクセスユーザーを上書きする場合、 *少なくとも1つ* のフィールドが必要です：

* **userId**
* **externalId**
* **email**

{% hint style="danger" %}

* その **email** フィールドは、ユーザーが次のものにアクセスするために必要です： **Verkada Pass** アプリ、および [アクセスコントロールのロール](/access-control/ja/hajimeni/roles-and-permissions-for-access-control.md) がCommand内で割り当てられているユーザーにも必要です。
* その **userId** そのフィールドはVerkadaによって生成され、ユーザーの識別に使用できます。
  {% endhint %}

ユーザーにカード番号を割り当てる場合、次のフィールドが必要です：

* **cardFormat**
* **facilityCode** （カード形式で必要な場合）
* **cardNumber** （カード形式で必要な場合）
* **cardNumberHex** （カード形式で必要な場合）

{% hint style="warning" %}
ユーザーCSVのアップロードでは認証情報を削除できません。さらに、既存ユーザーに属する認証情報は新しいユーザーに再割り当てされません。認証情報の再割り当てには、次の [認証情報のインポート](/access-control/ja/yzto/commission-access-control-cards/import-and-export-credentials-with-csv-files.md) 機能を使用できます。
{% endhint %}

***

## CSVアップロードの列見出し

アップロード [**アップロード**](#h_763fa8346a) ユーザーインポートのページで、覚えておくべき点がいくつかあります：

* **必須列：** 必須列にはアスタリスクが付いています <i class="fa-asterisk" style="color:$primary;">:asterisk:</i>。各行には、アスタリスク付きフィールドのうち少なくとも1つが必要です。行に必須列が1つもない場合、そのユーザーのアップロードは失敗します。
* **キー列：** キー列には <i class="fa-key" style="color:$primary;">:key:</i>. *少なくとも1つ* のキー列が必要です。ユーザーデータを上書きする必要がある場合、既存ユーザーと一致させるためです。
* **追加型：** 列に <i class="fa-plus">:plus:</i>が付いている場合、既存ユーザーを上書きすると、新しい値がユーザープロフィールに追加されます。既存の値は削除されません。
* **開始日・終了日の形式：** MM/DD/YYYY hh:mm:ss AM/PM。

{% hint style="warning" %}
ユーザーの電話番号を自動的に確認するには、次のいずれかの形式でその番号をCSVに追加します：

* +1 XXX XXX XXXX&#x20;
* +1 XXX-XXX-XXXX
  {% endhint %}

{% hint style="info" %}
複数の **ナンバープレート** または **グループ** をユーザーに追加できます。各項目はセミコロンで区切る必要があります。
{% endhint %}

***

## ユーザーを一括インポート

{% hint style="warning" %}
CSVアップロードは最大20,000ユーザーに対応しています。
{% endhint %}

{% stepper %}
{% step %}
**Verkada Commandで、すべての製品 > アクセス に移動します。**
{% endstep %}

{% step %}
**左側のメニューで、アクセスユーザーとグループをクリックします。**
{% endstep %}

{% step %}
**インポート > ユーザーをインポート をクリックします。**
{% endstep %}

{% step %}
**アップロード時：**

1. （任意）次をクリック： [**テンプレートをダウンロード**](https://verkada.intercom-attachments-2.com/i/o/q5re5q6g/1338754475/5ed2df67ad764a6d5fd2e74fb5fb/UsersTemplate.csv?expires=1760022000\&signature=6b78b69cd9394d3b54e948fc31230545c419470b330cbdd04652f5246c4531f6\&req=dSMkHs57mYVYXPMW3Hu4gVzXus8N8mMmr%2FjcW1UHpNu28VPJSWD4Lb%2FLHNkv%0Afw%3D%3D%0A) して、Verkada推奨テンプレートをアップロードのベースとして使用します。
2. 次の項目で **CSVをアップロード** ユーザー情報が含まれるCSVをドラッグするか、次を選択します： **コンピューターから選択**
3. 次をクリック： **続行** して次へ進みます： **設定**.

{% hint style="warning" %}
CSVファイルに特殊文字が含まれている場合は、UTF-8でエンコードされていることを確認してください。
{% endhint %}
{% endstep %}

{% step %}
**設定時：**

1. **既存ユーザーを上書き：** もし *はい* が選択されている場合、 **userId、externalId、** または **email** （この優先順位で）一致するユーザーは、CSVの情報で更新されます。
2. **省略されたグループからユーザーを削除：** 選択して *はい* CSVに指定されていないグループからユーザーを削除します。指定グループがないユーザー（空白セル）は、グループ所属が変更されません。
3. **Verkada Passアプリの招待を送信：** Verkada Passアプリのダウンロードリンクを、すべてのユーザー、新規ユーザー、または送信しない、のいずれかに送信します。このリンクは新規ユーザーに送信することを推奨します。
4. 次をクリック： **次に、列を確認します。**
   {% endstep %}

{% step %}
**列の確認時：**

1. インポートする列の情報を確認します。
2. インポートできない列がある場合は、この画面に、インポート対象として認識されなかった列を示すメッセージが表示されます。
3. 次をクリック： **次に、行を確認します。**
   {% endstep %}

{% step %}
**行の確認時：**

1. 行に問題が検出された場合、その内容を説明するメッセージが表示されます。
2. 次をクリック： **行を表示** を問題の横で選択すると、影響を受ける行を確認できます。
3. CSV上の問題を修正して、アップロードを再開します。これらのエラーが表示されている行はアップロードされる場合がありますが、成功する可能性は非常に低いです。

{% hint style="warning" %}
この初回レビューでは、既存のユーザーデータとの競合など、考えられるすべてのエラーは示されません。
{% endhint %}
{% endstep %}

{% step %}
**［インポートを続行］ をクリックします。**

1. インポートが完了すると、成功した内容を詳しく記載したメールが届きます。
2. 失敗したインポートがある場合は、次をクリックします： **エラー付きCSVをダウンロード** して、インポート失敗の原因となったエラーを確認します。 [UsersTemplate.csv](https://verkada.intercom-attachments-2.com/i/o/q5re5q6g/1338754475/5ed2df67ad764a6d5fd2e74fb5fb/UsersTemplate.csv?expires=1760022000\&signature=6b78b69cd9394d3b54e948fc31230545c419470b330cbdd04652f5246c4531f6\&req=dSMkHs57mYVYXPMW3Hu4gVzXus8N8mMmr%2FjcW1UHpNu28VPJSWD4Lb%2FLHNkv%0Afw%3D%3D%0A)
   {% endstep %}
   {% endstepper %}

{% hint style="warning" %}
再割り当てされた認証情報や無効なナンバープレート番号などの軽微なエラーは、ユーザーのアップロードを妨げません。これらのエラーがあるユーザーは、インポート完了後に送信されるメールからダウンロードできます。エラーを修正する際、ユーザーにメールアドレスがない場合は、その **userId** を指定して、重複ユーザーの作成を防ぐことができます。
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.verkada.com/access-control/ja/yzto/add-a-user-to-the-verkada-access-system/import-access-control-users-csv.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.