WorkSuite/CSVアップロード・ダウンロードについて
概要
WorksuiteのCSVアップロード・ダウンロード機能は、大量のデータを効率的に一括処理するための機能です。
マスター情報やメンバー情報などのデータをCSVファイルで一括登録・更新・削除することができます。
前提条件
- Worksuiteの管理者権限を持っていること
- 対象のアプリケーションが作成済みであること
主な機能
1. マスター情報のCSV操作
マスターデータの一括管理
- 新規レコード追加
- 既存レコード上書き
- 既存レコード上書き(コード)
2. メンバー情報のCSV操作
メンバー情報の一括管理
- メンバー上書き
- メンバー上書き(全体追加項目グループ)
- メンバー上書き(個別追加項目グループ)
- 追加モード:新しいデータを追加
- 上書きモード:既存データを全て上書き
基本的な使い方
STEP1:操作内容を選択
-
CSVアップロード画面を開きます
- マスター情報の場合: データ設定画面 → マスター情報 → 「一括アップロード」ボタン
- メンバー情報の場合: データ設定画面 → メンバー情報 → 「一括アップロード」ボタン
-
操作内容を選択します
- ドロップダウンから目的の操作を選択します
マスターデータの操作内容
| 操作内容 | 説明 |
|---|---|
| 新規レコード追加 | 新しいデータを一括で追加します |
| 既存レコード上書き | 既存データを一括で更新します |
| 既存レコード上書き(コード) | コードを指定して既存データを更新します |
メンバーデータの操作内容
| 操作内容 | 説明 |
|---|---|
| メンバー上書き | メンバー情報を一括で更新します |
| メンバー上書き(全体追加項目グループ) | 全体追加項目グループを一括で更新します |
| メンバー上書き(個別追加項目グループ) | 個別追加項目グループを一括で更新します |
STEP2:対象項目を選択(該当する場合のみ)
全体追加項目グループ・個別追加項目グループの場合
-
対象項目を選択します
- ドロップダウンから編集したい項目を選択します
- 子項目が存在する項目のみ選択可能です
STEP3:追加・上書きを選択(個別追加項目グループのみ)
個別追加項目グループの場合
-
追加・上書きモードを選択します
- 追加:新しいデータを追加
- 上書き:既に登録されているデータを全て上書き
STEP4:テンプレートをダウンロード
-
テンプレートをダウンロードします
- 「テンプレートをダウンロード」ボタンをクリックします
- CSVファイルがダウンロードされます
-
CSVファイルを編集します
- ダウンロードしたCSVファイルを開きます
- 必要なデータを入力します
STEP5:CSVをアップロード
-
CSVファイルを選択します
- 「ファイルを選択」ボタンをクリックします
- 編集したCSVファイルを選択します
-
アップロードを実行します
- 「実行」ボタンをクリックします
- 確認モーダルで「実行」をクリックします
入力フォーマットについて
ファイル形式
- 文字コード: UTF-8(必須)
- ファイル形式: CSV(.csv)
- 最大ファイルサイズ: 25MB
- 最大レコード数: 5,000件
- 個別追加項目グループ制限: 1メンバーあたり200件
- ヘッダー行: 1行目(必須)
データ形式
| 項目タイプ | 形式 | 制限 | 例 |
|---|---|---|---|
| テキスト | 文字列 | 100文字以内 | 田中太郎 |
| 文章 | 文字列 | 4,000文字以内 | 詳細な説明文 |
| 数値 | 数値 | - | 100 |
| 日付 | YYYY-MM-DD | 1年1月1日〜9999年12月31日 | 2024-01-01 |
| メールアドレス | メール形式 | - | user@example.com |
| コード | 一意の文字列 | 50文字以内、重複不可 | CODE001 |
削除フラグ
- 未入力: データを保持(デフォルト)
- 1: データを削除
注意事項
操作別の注意事項
マスター情報(既存レコード上書き)
- 全ての既存レコードに[コード]が登録されている必要があります
- [削除フラグ]の列に[1]を入れたレコードは削除対象となります
- 作成済または削除済のレコードと重複したコードは使用できません
マスター情報(既存レコード上書き(コード))
- ダウンロードしたCSVファイルは他のファイルへ貼り付け等はせずに編集してください
- ゼロ埋めされた数値[001]等をExcelで編集した場合、[1]等のゼロ埋めがない値に変換され、意図通りに登録できない場合があります
メンバー情報(メンバー上書き)
- アプリ内の項目のみ編集可能です。社員名簿の項目は編集できません
- 計算項目(年齢・通勤手当・通勤費 等)はアップロードできません
共通の注意事項
- 更新前に必ずお客様自身でバックアップ用のCSVを保存してください
- ダウンロードしたCSVファイルは他のファイルへ貼り付け等はせずに編集してください
トラブルシューティング
よくある問題と解決方法
1. 文字コードエラー
エラーメッセージ: ファイルの文字コードがサポートしていない形式です
原因: 文字コードがUTF-8以外
解決方法:
- CSVファイルをテキストエディタで開く
- 「名前を付けて保存」を選択
- 文字コードを「UTF-8」に設定して保存
2. ファイルサイズエラー
エラーメッセージ: ファイルのサイズが上限を超えています
原因: ファイルサイズが25MBを超過
解決方法:
- ファイルを分割してアップロード
- 不要なデータを削除してファイルサイズを削減
3. レコード数制限エラー
エラーメッセージ: 登録可能なレコードの上限数は5,000件です
原因: レコード数が5,000件を超過
解決方法:
- ファイルを分割してアップロード
- 不要なレコードを削除
4. 個別追加項目グループ制限エラー
エラーメッセージ: 1メンバーの登録上限(200件)を超えて登録することはできません
原因: 1メンバーの個別追加項目グループが200件を超過
解決方法:
- 該当メンバーのデータを分割
- 不要なデータを削除
5. 処理時間制限エラー
エラーメッセージ: 処理時間が制限を超えました
原因: CSVファイルの行数や列数が多すぎる
解決方法:
- CSVファイルの行数もしくは列数を減らして再度実行
- ファイルを分割してアップロード
6. 一括登録実行中エラー
エラーメッセージ: 一括登録が実行中です。実行完了までアップロードできません
原因: 他のCSVアップロードが実行中
解決方法:
- 実行完了まで待機
- アップロード中に他のCSVファイルをアップロードすることはできません
7. コード重複エラー
原因: 既存のコードと重複している
解決方法:
- 重複しているコードを確認
- 一意のコードに変更
- 既存データを更新する場合は、該当するレコードのコードを確認
8. 文字数制限エラー
原因: テキスト項目の文字数が制限を超過
解決方法:
- テキスト項目:100文字以内に調整
- 文章項目:4,000文字以内に調整
- コード項目:50文字以内に調整
9. 日付範囲エラー
原因: 日付が有効な範囲外
解決方法:
- 日付を1年1月1日〜9999年12月31日の範囲内に調整
- 正しい日付形式(YYYY-MM-DD)で入力