レポート作成（アップロード）

SoilReport Cloudでは、手元の土壌分析結果のExcelファイルをアップロードすることで、WEB上で見やすくきれいな診断レポートに自動変換します。 本画面は、管理者・メンバーのみがアクセス可能です。

!IMPORTANT 前提条件: レポートを作成する前に、対象となるユーザーを「ユーザー管理」であらかじめ登録しておく必要があります。

1. 単体アップロード（1件ずつ作成）

特定のユーザーに対して、1件のレポートを作成し確認しながら公開する標準的なフローです。

1.1 画面へのアクセス方法

レポート作成画面へは、ユーザー管理画面からアクセスします。

操作手順:

1. サイドメニューまたはメインメニューから 「ユーザー管理」 （/settings/farmers）を開きます。
2. ユーザー一覧テーブルから、レポートを作成したい対象ユーザーの行を探します。
3. その行の 「レポート」列 にある 「作成」ボタン（緑色）をクリックします。
4. アップロード画面（/dashboard/upload）が開きます。
   • ユーザーがすでに選択された状態で開きます（選び間違いを防止）。

!TIP この方法を使うと、ユーザー選択を間違えるリスクが減るため推奨です。

1.2 アップロード画面の構成

アップロード画面は以下のように構成されています。

ヘッダー（画面上部）:

ファイル読込バー:

!NOTE ファイルはページ全体へのドラッグ＆ドロップでも追加できます。ドラッグ中は画面全体が半透明の青色で覆われ、中央に「ファイルをドロップしてください」と表示されます。ExcelとPDFの判別はシステムが自動で行います。

フォームエリア:

ファイル読込バーの下には、レポート編集用のフォームが表示されています。ファイル読込前は空欄ですが、Excelアップロード後は抽出されたデータが自動的に各項目に設定されます。

保存ボタン:

1.3 ファイルのアップロード手順

ステップ1: ユーザを確認

ファイル読込バーの左端に、ユーザ管理画面で選択したユーザ名が固定表示されています。正しいユーザが表示されていることを確認してください。

!NOTE ユーザ管理画面から遷移しているため、ユーザが未選択の状態になることはありません。

ステップ2: Excelファイルをアップロード

ファイルの追加方法は2通りあります。

方法A: 選択ボタン

1. ファイル読込バーの Excel「選択」ボタン をクリックします。
2. ファイル選択ダイアログから .xlsx または .xls ファイルを選択します。

方法B: ドラッグ＆ドロップ

1. Excelファイルをブラウザ上の任意の場所にドラッグ＆ドロップします。
2. ドラッグ中は画面全体が半透明の青色で覆われ、中央にドロップエリアが表示されます。
3. ファイルをドロップすると、データ抽出が自動的に開始されます。
   • 画面に「処理中...」と表示されます。

ステップ3: PDFファイルをアップロード（任意）

証明書や印刷用レポート等のPDFファイルがある場合：

1. ファイル読込バーの PDF「選択」ボタン をクリックするか、PDFファイルをドラッグ＆ドロップします。
2. 選択済みのファイル名が表示されます。

!NOTE PDFのアップロードは任意です。Excelデータから自動生成されるWEBレポートとは別に、追加資料としてユーザに提供できます。

ステップ4: フォームの内容を確認

データ抽出が成功すると、フォームの各項目に抽出された値が自動的に設定されます。

フォームの見方:

フォームの内容を確認します。

• 数値が正しく抽出されているか
• 圃場名やレポート番号が正しいか

!WARNING この段階では、レポートはまだ保存されていません。ブラウザを閉じると入力内容が失われます。

ステップ6: 保存または公開

画面下部に2つの保存ボタンがあります。

!NOTE 「下書き保存」で保存したレポートは、後からレポート管理画面で内容を確認・編集し、公開できます。

公開後の確認モーダル:

「公開する」ボタンで公開すると、以下のボタンがある確認モーダルが表示されます。

1.4 エラーが表示された場合

データ抽出に失敗すると、エラーメッセージが表示されます。

よくあるエラーと対処法:

!TIP マッピング設定は、管理者権限で「設定」→「マッピング設定」から確認・編集できます。

1.5 レポートの状態（ステータス）

アップロード画面のヘッダーには、現在のレポートの状態が表示されます。

公開状態:

!NOTE 「下書き保存」を押すと非公開（draft）として保存され、ヘッダーのステータスが「保存済み」に変わります。内容を確認してから「公開する」ボタンで公開してください。

1.6 次のステップ

「下書き保存」後は、ヘッダーに表示される 「レポート一覧」ボタン からレポート管理画面（/settings/reports）へ移動できます。

ここで以下の操作が可能です:

• レポート内容の確認・編集
• 公開（ユーザへの共有）
• 削除

「公開する」で公開した場合は、確認モーダルの 「続けて作成」 ボタンで、同じユーザ向けに新しいレポート作成を続けられます。

詳細は レポート管理と公開 を参照してください。

2. 一括アップロード

複数の分析結果をまとめて処理し、自動で分割して一気にレポートを生成する機能です。処理は ファイル選択 → プレビュー → 完了 の3ステップで進みます。

2.1 画面へのアクセス方法

一括アップロード画面へは、ユーザ管理画面からアクセスします。

操作手順:

1. サイドメニューから 「ユーザ管理」 （/settings/farmers）を開きます。
2. ユーザ一覧テーブルから、対象ユーザの行を探します。
3. その行の 「レポート」列 にある 「ファイル読み込み」 アイコンボタン（上矢印アイコン）をクリックします。
4. 一括アップロード画面（/dashboard/batch-upload）が開き、対象ユーザが事前選択された状態になります。

!TIP 画面左上に「〇〇様 のレポートを一括作成」と表示され、どのユーザ向けかが常に確認できます。

2.2 画面の構成

一括アップロード画面は以下のように構成されています。

ヘッダー:

ステップインジケーター:

画面中央に ① ファイル選択 → ② プレビュー → ③ 完了 のステップ表示があります。現在のステップが緑色でハイライトされます。

2.3 ステップ1: ファイル選択

ファイルを選択し、解析を実行します。

UI要素:

操作手順:

1. Excelファイルをドロップゾーンにドラッグ＆ドロップ、またはクリックして選択します。
2. ファイルが追加されると、自動的に解析が開始されます（「ファイルを解析中...」と表示）。
3. 各ファイルの解析結果を確認します。
   • ✅ 成功: 正常に解析されました
   • ❌ エラー: 解析に失敗しました（エラー内容が表示されます）
4. 問題なければ 「次へ」 ボタンをクリックします。

制限事項:

!NOTE 不適切な拡張子のファイルがドロップされた場合はエラーメッセージが表示され、スキップされます。

2.4 ステップ2: プレビュー

解析結果を一覧で確認します。

UI要素:

テーブルの列:

!NOTE 1つのExcelファイルに複数シートがある場合、シートごとに個別のレポートとして処理されます。空のシートは自動的にスキップされます。

操作手順:

1. テーブルの内容を確認します。
2. 問題なければ 「レポート作成」 ボタンをクリックします。
3. すべてのレポートが**非公開（draft）**として一括保存され、ステップ3に進みます。

2.5 ステップ3: 完了

作成結果が表示されます。

UI要素:

操作手順:

以下の3つのボタンから選択します。

!IMPORTANT 一括アップロードでは、Excelファイル自体は保存されず、抽出されたデータのみがデータベースに保存されます。

2.6 エラーの確認と対処

3. よくある質問

Q1. アップロードしたレポートはすぐにユーザーに見えますか？

A. いいえ。アップロード直後は「非公開」状態です。レポート管理画面から「公開する」ボタンをクリックして初めてユーザーがアクセスできるようになります。

Q2. 同じユーザーに複数のレポートを作成できますか？

A. はい。同じユーザーに対して、複数の診断結果（異なる圃場、異なる時期など）を何度でもアップロードできます。

Q3. アップロード後に内容を修正できますか？

A. はい。レポート管理画面から該当レポートを開き、編集できます。公開後でも編集可能です。

Q4. ユーザーが登録されていない場合はどうなりますか？

A. アップロード前にユーザー管理画面でユーザーを追加してください。登録されていないユーザーにはレポートを紐付けできません。