カテゴリー内の他の記事

CSV フォーマット

フォローする

Index

はじめに

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

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

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

ユーザー情報 CSV

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

cybozuに登録済みのログイン名が指定された場合、該当のレコードは更新処理となります。
未登録のログイン名が指定された場合、該当のレコードは新規登録となります。

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

空文字列、あるいは他のログイン名と重複しない文字列を指定します。
空文字列の場合「ログイン名」項目が指定されたと同じ意味になります。

 パスワード 128 必須  新規作成時に「*」を指定された場合、パスワードは空文字列と同じ意味になります。
 姓 64 省略可  
 名 64 省略可  
 よみがな(姓) 64 省略可  
 よみがな(名) 64 省略可  
 別言語での表示名 128 省略可 本パラメータを設定する場合、「ローカル名を表示する言語」も合わせて設定する必要があります。
 別言語の名前を表示する言語 - 省略可 「ja」(日本語)、「en」(英語)、「zh」(中国語)のいずれかを指定します。
Emailアドレス 256 省略可 RFC 2822に準拠した文字を指定します。
使用状態 1 省略可 「0」(停止状態)、「1」(使用状態)を指定します。
それ以外が指定された場合は「1」が指定されたと同じ意味になります。
言語 - 省略可 「auto」(自動設定)、「ja」(日本語)、「en」(英語)、「zh」(中国語)のいずれかを指定します。
それ以外が指定された場合は「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 必須 cybozuに登録済みの組織コードが指定された場合、該当のレコードは更新処理となります。
未登録の組織コードが指定された場合、該当のレコードは新規登録となります。 
表示名  128 必須  
新組織コード  128 必須 空文字列、あるいは他の組織コードと重複しない文字列を指定します。
「*」の場合「組織コード」項目が指定されたと同じ意味になります。
別言語での表示名  128 省略可 本パラメータを設定する場合、「ローカル名を表示する言語」も合わせて設定する必要があります。
別言語の名前を表示する言語  - 省略可 「ja」(日本語)、「en」(英語)、「zh」(中国語)のいずれかを指定します。
親組織コード  128 省略可 空文字列の場合、最上位階層の組織として登録/更新されます。
説明   1000 省略可  

役職情報 CSV

項目名 フィールド長 必須 備考
役職コード  128 必須 cybozuに登録済みの役職コードが指定された場合、該当のレコードは更新処理となります。
未登録の役職コードが指定された場合、該当のレコードは新規登録となります。
役職名  128 必須  
新役職コード  128 必須 空文字列、あるいは他の役職コードと重複しない文字列を指定します。
「*」の場合「役職コード」項目が指定されたと同じ意味になります。
説明  1000 省略可  
削除  - 省略可 該当レコードを削除する場合に「1」を指定します。

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

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

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

CSVファイルの例)

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

グループ情報 CSV

項目名 フィールド長 必須 備考
グループコード 128 必須 cybozuに登録済みのグループコードが指定された場合、該当のレコードは更新処理となります。
未登録のグループコードが指定された場合、該当のレコードは新規登録となります。

グループ名 128 必須  
新グループコード 128 必須 空文字列、あるいは他のグループコードと重複しない文字列を指定します。
「*」の場合「グループコード」項目が指定されたと同じ意味になります。
タイプ - 省略可 「static」か「dynamic」を指定します。新規登録時は必ずどちらかを指定します。
タイプの更新処理はできないため、更新処理の際は既存値に合わせて指定するか「*」を指定します。
説明 1000 省略可  
削除 - 省略可 該当レコードを削除する場合に「1」を指定します。

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

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

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

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

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

直接的に記事と関連がないご質問はcybozu developer コミュニティをご活用ください。

Avatar
十楽 卓矢

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

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

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

Avatar
cybozu Development team

十楽 卓矢 様

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

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

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

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

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

Avatar
十楽 卓矢

cybozu developer network 事務局様

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

ログインしてコメントを残してください。
Powered by Zendesk