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

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

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

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

***

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

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

{% stepper %}
{% step %}
**Verkada Commandで、All Products > Access に移動します。**
{% endstep %}

{% step %}
**左側のメニューで、Access Users and Groups をクリックします。**
{% endstep %}

{% step %}
**Export > Export Users をクリックしてCSVをダウンロードします。**
{% endstep %}
{% endstepper %}

***

## 必須項目

アクセスユーザーをインポートする場合、これらの項目は必須です：

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

アクセスユーザーを上書きする場合、 *少なくとも1つ* のこれらの項目が必要です：

* **userId**
* **externalId**
* **メール**

{% hint style="danger" %}

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

ユーザーにカード番号を割り当てる際、次の項目が必要です：

* **cardFormat**
* **facilityCode** （カードフォーマットで必要な場合）
* **cardNumber** （カードフォーマットで必要な場合）
* **cardNumberHex** （カードフォーマットで必要な場合）

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

***

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

ユーザーインポートの [**Upload**](#h_763fa8346a) ページでは、いくつか注意すべき点があります：

* **必須列：** 必須列はアスタリスク（\*）でマークされています。各行につき少なくとも1つのアスタリスク付き項目が必要です。行に必須列がまったくない場合、そのユーザーはアップロードに失敗します。
* **キー列：** キー列は でマークされています。 *少なくとも1つの* キー列は、ユーザーデータを上書きする必要がある場合に既存ユーザーと一致させるために必要です。
* **加算式：** 列に がマークされている場合、既存ユーザーを上書きする際に新しい値はユーザープロファイルに追加されます。既存の値は削除されません。
* **開始日と終了日の形式：** MM/DD/YYYY hh:mm:ss AM/PM

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

***

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

{% hint style="warning" %}
CSVアップロードは最大20,000ユーザーをサポートします。
{% endhint %}

{% stepper %}
{% step %}
**Verkada Commandで、All Products > Access に移動します。**
{% endstep %}

{% step %}
**左側のメニューで、Access Users and Groups をクリックします。**
{% endstep %}

{% step %}
**Import > Import Users をクリックします。**
{% endstep %}

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

a.（任意）クリック [**Download Template**](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推奨のテンプレートをアップロードのベースとして使用するには。\
b. 「 **Upload CSV,** の下に、ユーザー情報を含むCSVをドラッグするか、 **select from your computer.**\
c. クリック **Continue** をクリックして次に進み、 **Configure**.

**注意：** CSVファイルに特殊文字が含まれている場合は、CSV UTF-8 エンコーディングでエンコードされていることを確認してください。
{% endstep %}

{% step %}
**Configureで：**

a. **既存ユーザーを上書き：** もし *yes* が選択されている場合、userId、externalId、 **（その階層順）に一致する任意のユーザーはCSVの情報で更新されます。**\
**b.** または **メール** CSV内の情報で更新されます。\
 **CSVに記載されていないグループからユーザーを削除：** を選択してCSVに指定されていないグループからユーザーを削除します。グループが指定されていないユーザー（空白セル）はグループメンバーシップが変更されません。\
c. *yes* を選択してCSVに指定されていないグループからユーザーを削除します。ユーザーにグループが指定されていない場合（空白セル）は、グループメンバーシップは変更されません。\
 **Passアプリの招待を送信：** すべてのユーザー、新しいユーザー、または誰にもVerkada Passアプリのダウンロードリンクを送信します。新しいユーザーにはこのリンクを送ることを推奨します。\
d. クリック **Next, Review Columns.**
{% endstep %}

{% step %}
**Review Columnsで：**

a. インポートする列の情報を確認します。\
b. インポートできない列がある場合、この画面にインポートとして認識されなかった列の詳細が表示されます。\
c. クリック **Next, Review Rows.**
{% endstep %}

{% step %}
**Review Rowsで：**

a. 行に問題が検出された場合、その問題の説明を表示するメッセージが表示されます。\
b. クリック **View rows** 問題の横にあるリンクをクリックしてどの行が影響を受けているかを確認します。\
c. CSVの問題を修正してアップロードを再開します。これらのエラーを示す行はアップロードされる可能性がありますが、成功する可能性は非常に低いです。

**注記**：この初期レビューは、既存のユーザーデータとの競合など、すべての可能なエラーを説明するものではありません。
{% endstep %}

{% step %}
**Proceed with Import をクリックします。**

a. インポートが完了すると、インポートの成功内容を記載したメールが届きます。\
b. インポートに失敗したものがある場合は、クリックしてください。 **Download CSV with errors** をクリックして、インポート失敗の原因となったエラーを表示します。 [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: 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:

```
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>
```

The question should be specific, self-contained, and written in natural language.
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.