---
title: "OCR タスクの履歴を確認し、失敗したファイルを調査する"
description: "タスク一覧、実行履歴、ファイル詳細の順に 1 つのファイルの結果を追跡し、ステータスラベルを読み解き、失敗メッセージごとに対処します"
canonical_url: "https://docs.ardge.com/ja/knowledge/precisemd/ocr-task-history"
---
# OCR タスクの履歴を確認し、失敗したファイルを調査する

> タスク一覧、実行履歴、ファイル詳細の順に 1 つのファイルの結果を追跡し、ステータスラベルを読み解き、失敗メッセージごとに対処します

## 概要

実行が完了したのに、出力フォルダーのファイル数が想定より少ない場合は、どのファイルが結果を生成しなかったのか、そしてその理由を突き止める必要があります。PreciseMD は実行情報を 3 つの階層に分けて表示します。タスク一覧には最新の結果、**History** には各実行の統計、**File details** には 1 回の実行内における全ファイルの処理ステータスと失敗理由が表示されます。

この記事では、これらの階層をたどって 1 つのファイルの結果を追跡する方法、ステータスラベルの読み方、よくある失敗メッセージへの対処について説明します。

## この記事で学べること

- タスク一覧から 1 つのファイルの結果を追跡する
- 実行レベルとファイルレベルの両方のステータスラベルを読み解く
- メッセージから失敗の原因を診断し、対処する
- 実行中のタスクをキャンセルする

**所要時間: 約 10 分**

## 対象バージョン

- PreciseMD 1.4.0 以降

## 事前準備

- OCR タスクが作成済みで、少なくとも 1 回実行されていること。作成方法については [OCR タスクをスケジュールしてフォルダーを自動処理する](https://docs.ardge.com/ja/knowledge/precisemd/schedule-ocr-tasks) を参照してください

## ステップ 1: 最新の実行を確認する

1. **OCR tasks** ページに移動します
2. タスクの **Last run** 列を確認します

この列には、最新の実行のステータスラベルと完了時刻が表示されます。各ステータスの意味は次のとおりです。

<table>
<thead>
  <tr>
    <th>
      ラベル
    </th>
    
    <th>
      意味
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        Queued
      </strong>
    </td>
    
    <td>
      キューに入っており、まだ開始していない
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Processing
      </strong>
    </td>
    
    <td>
      実行中
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Completed
      </strong>
    </td>
    
    <td>
      すべてのファイルが正常に処理された
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Partially failed
      </strong>
    </td>
    
    <td>
      一部のファイルの処理に失敗した
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Failed
      </strong>
    </td>
    
    <td>
      実行が失敗した
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Stopping
      </strong>
    </td>
    
    <td>
      キャンセル要求が送信され、実行が停止処理中
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Stopped
      </strong>
    </td>
    
    <td>
      キャンセルされた
    </td>
  </tr>
</tbody>
</table>

![タスク一覧の前回の実行ステータス](https://docs.ardge.com/screenshots/knowledge/ja/precisemd/ocr-task-history/step-1.webp)

## ステップ 2: 履歴を開く

1. そのタスクの行のアクションメニューをクリックします
2. **History** を選択します

**History** ページの各行が 1 回の実行にあたり、次の列があります。

<table>
<thead>
  <tr>
    <th>
      列
    </th>
    
    <th>
      表示内容
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        Start time
      </strong>
    </td>
    
    <td>
      実行が開始された時刻
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        End time
      </strong>
    </td>
    
    <td>
      実行が完了した時刻
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Trigger
      </strong>
    </td>
    
    <td>
      <strong>
        Scheduled
      </strong>
      
       または <strong>
        Manual
      </strong>
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Status
      </strong>
    </td>
    
    <td>
      その実行のステータスラベル
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Progress
      </strong>
    </td>
    
    <td>
      全体に対する完了ファイルの割合
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Total files
      </strong>
    </td>
    
    <td>
      その実行でスキャンされたファイル数
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Succeeded
      </strong>
    </td>
    
    <td>
      正常に処理されたファイル数
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Failed
      </strong>
    </td>
    
    <td>
      失敗したファイル数
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Duration
      </strong>
    </td>
    
    <td>
      開始から終了までの経過時間
    </td>
  </tr>
</tbody>
</table>

実行が終了すると、**Progress** 列はアイコンに切り替わります。完了はチェック、**Failed** と **Partially failed** はクロス、**Stopped** と **Stopping** はマイナスで表示されます。

![操作メニュー](https://docs.ardge.com/screenshots/knowledge/ja/precisemd/ocr-task-history/step-2-1.webp)

![実行履歴](https://docs.ardge.com/screenshots/knowledge/ja/precisemd/ocr-task-history/step-2-2.webp)

## ステップ 3: 個別のファイルの結果を確認する

1. 確認したい実行記録の **More details** をクリックします

**File details** ウィンドウの各行が 1 つのファイルにあたり、**Updated**、**File name**、**Status**、**Duration**、**Pages**、**Notes** の列があります。

**Notes** 列の内容はステータスによって異なります。

<table>
<thead>
  <tr>
    <th>
      ステータス
    </th>
    
    <th>
      Notes の表示内容
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        Completed
      </strong>
    </td>
    
    <td>
      空欄
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Skipped
      </strong>
    </td>
    
    <td>
      <strong>
        Content unchanged
      </strong>
      
      。前回の実行と一致するため、再解析されませんでした
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Deleted
      </strong>
    </td>
    
    <td>
      <strong>
        Source deleted
      </strong>
      
      。ソースファイルが存在しなくなりました
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Failed
      </strong>
    </td>
    
    <td>
      具体的な失敗メッセージ、または該当するものがない場合は <strong>
        Processing failed
      </strong>
    </td>
  </tr>
</tbody>
</table>

![ファイルの結果（失敗の理由）](https://docs.ardge.com/screenshots/knowledge/ja/precisemd/ocr-task-history/step-3-1.webp)

![ファイルの結果（スキップ）](https://docs.ardge.com/screenshots/knowledge/ja/precisemd/ocr-task-history/step-3-2.webp)

## ステップ 4: 実際の出力を確認する

正常に処理されたファイルは、インターフェースから直接読むことができます。

1. **OCR tasks** ページに移動し、タスク名をクリックします
2. **Run results** ページでそのファイルの行を探します
3. **Result** 列の **View result** をクリックします

**Run results** ページには **File name**、**Status**、**Result**、**Processing time**、**Notes** の列があります。ステータスが **Completed** ではないファイルには **View result** は表示されません。

## ステップ 5: 実行中のタスクをキャンセルする

1. **History** ページで、ステータスが **Queued** または **Processing** の実行を探します
2. その行の **Cancel** をクリックします

ページに「Cancel request sent」と表示され、ステータスが **Stopping** に変わり、停止処理が完了すると **Stopped** になります。

<warning>

**完了した実行はキャンセルできません：**

要求が届く前に実行がすでに終了していた場合、システムは「Can't cancel: the task is no longer running」と応答します。

</warning>

## トラブルシューティング

**Notes** 列に表示される可能性のある失敗メッセージ:

<table>
<thead>
  <tr>
    <th>
      メッセージ
    </th>
    
    <th>
      考えられる原因
    </th>
    
    <th>
      対処方法
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        OCR processing failed — check whether the file content is valid
      </code>
    </td>
    
    <td>
      そのファイルの内容を解析できなかった
    </td>
    
    <td>
      <strong>
        Playground
      </strong>
      
       でそのファイルを単体でアップロードし、ファイル自体に問題があるかを確認します
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        The file is corrupt or unreadable
      </code>
    </td>
    
    <td>
      ソースファイルが破損している、または読み取りが中断された
    </td>
    
    <td>
      ソース側でファイルを再生成し、もう一度実行します
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        Unsupported file format
      </code>
    </td>
    
    <td>
      拡張子は受け付けられたが、実際の内容が対応形式ではない
    </td>
    
    <td>
      内容が拡張子と一致しているか確認します。対応形式の一覧については <a href="https://docs.ardge.com/ja/knowledge/precisemd/formats-and-limits">
        PreciseMD が対応するファイル形式と制限は？
      </a>
      
       を参照してください
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        Not enough disk space. Free up space and try again
      </code>
    </td>
    
    <td>
      出力先の空き容量が不足している
    </td>
    
    <td>
      NAS の空き容量を確保し、タスクをもう一度実行します
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        The service restarted. Run again
      </code>
    </td>
    
    <td>
      実行中にサービスが再起動した
    </td>
    
    <td>
      タスクをもう一度実行します
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        The AI service is temporarily unavailable. Try again later
      </code>
    </td>
    
    <td>
      モデルサービスが応答していない
    </td>
    
    <td>
      AI Model Center でモデルのステータスが <strong>
        Running
      </strong>
      
       であることを確認し、もう一度実行します
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        Lost connection to the NAS — check the network and share path settings
      </code>
    </td>
    
    <td>
      実行中に NAS への接続が切断された
    </td>
    
    <td>
      ネットワークと共有フォルダーの設定を確認し、もう一度実行します
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        Insufficient NAS permissions
      </code>
    </td>
    
    <td>
      NAS アカウントにそのフォルダーへの権限がない
    </td>
    
    <td>
      NAS 側で、ソースフォルダーへの読み取り権限とターゲットフォルダーへの書き込み権限を付与します
    </td>
  </tr>
</tbody>
</table>

タスクの操作中に表示される可能性のあるメッセージ:

<table>
<thead>
  <tr>
    <th>
      メッセージ
    </th>
    
    <th>
      考えられる原因
    </th>
    
    <th>
      対処方法
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        A run is already in progress. Try again later
      </code>
    </td>
    
    <td>
      前回の実行が完了していない
    </td>
    
    <td>
      完了するまで待ってから、次の実行を開始します
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        The task is running and can't be modified
      </code>
    </td>
    
    <td>
      実行中のタスクを編集または削除しようとした
    </td>
    
    <td>
      実行が完了するまで待つか、先にキャンセルします
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        Can't cancel: the task is no longer running
      </code>
    </td>
    
    <td>
      要求が届く前に実行が終了した
    </td>
    
    <td>
      ページを再読み込みして、現在のステータスを確認します
    </td>
  </tr>
</tbody>
</table>

## 関連記事

- [OCR タスクをスケジュールしてフォルダーを自動処理する](https://docs.ardge.com/ja/knowledge/precisemd/schedule-ocr-tasks)
- [OCR 出力フォルダーにはどのようなファイルが生成されますか？](https://docs.ardge.com/ja/knowledge/precisemd/ocr-output-files)
- [PreciseMD が対応するファイル形式と制限は？](https://docs.ardge.com/ja/knowledge/precisemd/formats-and-limits)


## Sitemap

See the full [sitemap](https://docs.ardge.com/sitemap.md) for all pages.