カテゴリー内の他の記事

CSV フォーマット

Index

はじめに

データの読み込み用ファイルのひな形(フォーマット) を参考に、ファイルフォーマットをダウンロードし、フォーマットを変えずにデータを作成してください。
フォーマットを変えるとデータが正常に読み込まれない場合があります。

APIで使用する際のCSV共通仕様

  • ヘッダー項目は不要です。
  • 文字コードはUTF8です。
  • 区切り文字はカンマ( , )です。

ユーザー情報 CSV

項目名 フィールド長 必須 備考
ログイン名 128 必須

新たにユーザーを追加する場合:
他のログイン名と重複しない文字列を指定します。

既存のユーザーを編集する場合:
登録済みのログイン名を指定します。指定したユーザー情報が更新されます。

表示名 128 必須  
新ログイン名 128 必須

新たにユーザーを追加する場合:
「*」または「ログイン名」に指定した値を指定します。

既存のユーザーを編集する場合:
「ログイン名」を変更する場合、変更後のログイン名を指定します。変更しない場合は「*」を指定します

パスワード 128 必須

新たにユーザーを追加する場合:
新しいパスワードを指定します。

既存のユーザーを編集する場合:
「パスワード」を変更する場合、変更後のパスワードを指定します。使用中のパスワードを変更しない場合は「*」を指定します。

64 省略可  
64 省略可  
よみがな(姓) 64 省略可  
よみがな(名) 64 省略可  
別言語での表示名 128 省略可 「別言語での表示名」を指定する場合、「ローカル名を表示する言語」も指定してください。
別言語の名前を表示する言語 - 省略可 「ja」(日本語)、「en」(英語)、「zh」(中国語 簡体字)、「zh-TW」(中国語 繁体字)のいずれかを指定します。
Emailアドレス 256 省略可 RFC 2822に準拠した文字を指定します。
使用状態 1 省略可 「0」(停止状態)、「1」(使用状態)を指定します。
それ以外が指定された場合は「1」が指定されたと同じ意味になります。
言語 - 省略可 「auto」(自動設定)、「ja」(日本語)、「en」(英語)、「zh」(中国語)、「zh-TW」(中国語 繁体字)のいずれかを指定します。
それ以外が指定された場合は「auto」が指定されたと同じ意味になります。
タイムゾーン 256 省略可 タイムゾーンを指定します。空文字列の場合はシステムの初期値が指定されます。
タイムゾーンの例)
  • Asia/Tokyo
  • America/New_York
  • Asia/Shanghai
電話番号 100 省略可  
内線 100 省略可  
携帯電話 100 省略可  
URL 256 省略可  
従業員ID 100 省略可  
入社日 Date型 省略可 「yyyy-MM-dd」フォーマットで指定します。
誕生日 Date型 省略可 「yyyy-MM-dd」フォーマットで指定します。
コメント 1000 省略可  
表示優先度 - 省略可 0~99999999までの値を設定します。数値が小さいほど上位に表示されます。
空文字列を指定した場合「99999999」よりも大きい数値を意味します。
Skype名 32 省略可  
削除 - 省略可 削除する場合、「1」を指定します。
(カスタマイズ項目) - 省略可 カスタマイズ項目は、複数設定可能です。

組織情報 CSV

項目名 フィールド長 必須 備考
組織コード 128 必須

新たに組織を追加する場合:
他の組織コードと重複しない文字列を指定します。

既存の組織を編集する場合:
登録済みの組織コードを指定します。指定した組織情報が更新されます。

表示名 128 必須  
新組織コード 128 必須

新たに組織を追加する場合:
「*」または「組織コード」に指定した値を指定します。

既存の組織を編集する場合:
「組織コード」を変更する場合、変更後の組織コードを指定します。変更しない場合は「*」を指定します

別言語での表示名 128 省略可 「別言語での表示名」を指定する場合、「ローカル名を表示する言語」を指定してください。
別言語の名前を表示する言語 - 省略可 「ja」(日本語)、「en」(英語)、「zh」(中国語 簡体字)、「zh-TW」(中国語 繁体字)のいずれかを指定します。
親組織コード 128 省略可 空文字列の場合、最上位階層の組織として登録/更新されます。
説明 1000 省略可  

役職情報 CSV

項目名 フィールド長 必須 備考
役職コード 128 必須

新たに役職を追加する場合:
他の役職コードと重複しない文字列を指定します。

既存の役職を編集する場合:
登録済みの役職コードを指定します。指定した役職情報が更新されます。

役職名 128 必須  
新役職コード 128 必須

新たに役職を追加する場合:
「*」または「役職コード」に指定した値を指定します。

既存の役職を編集する場合:
「役職コード」を変更する場合、変更後の役職コードを指定します。変更しない場合は「*」を指定します。

説明 1000 省略可  
削除 - 省略可 削除する場合、「1」を指定します。

ユーザーの所属組織情報 CSV

項目名 フィールド長 必須 備考
ログイン名 128 必須

組織コード 128 - 複数の組織に所属する場合、本項目と「役職コード」をセットとして、繰り返し指定します。
役職コード 128 - 複数の組織に所属する場合、「組織コード」と本項目をセットとして、繰り返し指定します。

CSVファイルの例)

user1,org1,title1,org2,title2
user2,org1,title1,org2,,org3,title3
user3

グループ情報 CSV

項目名 フィールド長 必須 備考
グループコード 128 必須

新たにグループを追加する場合:
他のグループコードと重複しない文字列を指定します。

既存のグループを編集する場合:
登録済みのグループコードを指定します。指定したグループ情報が更新されます。

グループ名 128 必須  
新グループコード 128 必須

新たにグループを追加する場合:
「*」または「グループコード」に指定した値を指定します。

既存のグループを編集する場合:
「グループコード」を変更する場合、変更後のグループコードを指定します。変更しない場合は「*」を指定します

タイプ - 省略可 「static」または「dynamic」を指定します。
既存のグループの「タイプ」は変更できません。「*」または既存値を指定してください。
説明 1000 省略可  
削除 - 省略可 削除する場合、「1」を指定します。

ユーザーの所属グループ情報 CSV

項目名 フィールド長 必須項目 備考
ログイン名 128 必須  
グループコード 128 - タイプが「dynamic」のグループは指定できません。
複数のグループに所属する場合、本項目を繰り返し設定します。

ユーザーの利用サービス情報 CSV

項目名 フィールド長 必須 備考
ログイン名 128 必須  
サービスコード 128 - 「サービスコード一覧」から利用するサービスを選択して指定します。
複数のサービスを利用する場合、本項目を繰り返し設定します。

記事に関するフィードバック

記事のコメント欄は記事に対するフィードバックをする場となっております。
右の記事フィードバックのためのガイドを参照してコメントしてください。
記事のリンク切れなど、気になる点がある場合も、こちらのフォームからフィードバックいただけますと幸いです。

Avatar
10raku

ユーザー情報 CSVですが、実際に出力したCSVファイルと項目名が一致していないようです。

・E-mail → Emailアドレス
・携帯 → モバイルフォン
・メモ → コメント

環境によって違いはあるのでしょうか?

Avatar
cybozu Development team

十楽 卓矢 様

お世話になっております。
cybozu developer network 事務局です。

コメントいただいた内容についてですが、混乱を招いてしまい申し訳ございません。

確かに十楽 卓矢 様のコメント通り、
出力したCSVファイルとこちらの記事の「項目名」一致しないことがわかりました。
(「Emailアドレス」、「モバイルフォン」、「コメント」で出力されることを確認いたしました。)

こちら社内にフィードバックし、修正を進めさせて頂きます。
ありがとうございます。

今後ともcybozu developer networkをよろしくお願いいたします。

Avatar
10raku

cybozu developer network 事務局様

修正頂きましてありがとうございました。
承知いたしました。

Avatar
10raku

ユーザー情報 CSVのヘッダ名についてですが、実際にCSVファイルを出力すると「モバイルフォン」は「携帯電話」となっております。

最近のアップデートで変わったということで良いでしょうか?

Avatar
cybozu Development team

十楽 卓矢 様

お世話になっております。
cybozu developer network 事務局です。

CSV出力に限りませんが、cybozu.com 共通管理の変更の影響です。

2021年2月14日のアップデートで変更しており、下記のページで告知しております。
https://kintone.cybozu.co.jp/update/all/210214.html

>プロフィールやユーザー情報に表示する、携帯電話番号を入力する項目名を変更しました。

Avatar
10raku

cybozu developer network 事務局様

ご連絡ありがとうございます。

そうしますと、本ページの「モバイルフォン」の部分は「携帯電話」に修正されるということですね。

Avatar
cybozu Development team

十楽 卓矢 様

はい、こちらの件は修正を進めさせて頂きます。
フィードバックをありがとうございました。

Avatar
10raku

cybozu developer network 事務局様

ご回答ありがとうございました。

今後ともよろしくお願いいたします。

Avatar
t.fujita

[ユーザーの所属グループ情報 CSV]を利用して、ユーザーのグループ設定をしたいのですが、一度に1ユーザーに付けれるグループの数に制限はありますか?

以下を見ましたがわからず。

https://jp.cybozu.help/general/ja/admin/list_useradmin/list_csv/group_member.html

Avatar
cybozu Development team

t.fujita 様

お世話になっております。
cybozu developer network 事務局です。

1ユーザーが所属できるグループ数は最大で1000グループとなっております。

Avatar
t.fujita

承知しました。ありがとうございます。

サインインしてコメントを残してください。