PkScan のバックアップ(No.23) - PrimeKarte

[ トップ ] [ 新規 | 一覧 | 単語検索 | 最終更新 | ヘルプ ]

PrimeKarte > PkScan

ソース構成
マスタ
関連
依存ライブラリ
- Newtone ImageKit.NET3
- Aspose
よくある質問
トラブルシューティング
開発時の注意点

ソース構成 †

※まだまだ書き途中!!

PkScan画面系.png

マスタ †

解像度 †

テーブル	マスタコード	カラム	内容
COMMON_DOC	05000002	CODE	コード
		NAME	解像度
		DISP_ORDER	表示順
		BIKO	備考

色数 †

テーブル	マスタコード	カラム	内容
COMMON_DOC	05000003	CODE	コード
		NAME	色数
		DISP_ORDER	表示順
		BIKO	備考

用紙サイズ †

テーブル	マスタコード	カラム	内容
COMMON_DOC	05000004	CODE	コード
		NAME	用紙サイズ
		DISP_ORDER	表示順
		BIKO	備考

設定	値	内容
0501.xml[26]	1	推奨設定時に自動幅読み込みする(対応機種のみ)
0501.xml[26]	0	推奨設定時にA4で読み込みする

端末設定 †

スキャンパラメータの初期値 †

TANMATSU.STR_06

タイマによる自動スキャン有無 †

TANMATSU.FLGTBL_01[22]

「スキャン登録時に取込文書を印刷する」チェックボックスの初期状態 †

TANMATSU.FLGTBL_01[45]

「半折り原稿」チェックボックスの表示 †

TANMATSU.FLGTBL_04[4]
半折り = 山折りした原稿を一枚の原稿として取り込む機能
- 例: A3を山折りで半折り読み込み -> A4ではなくA3で登録できる
- 主には、A4までのサイズしか取り込めないスキャナ等で使用
- ドライバで重送チェックを行っている場合はうまく動作しないことがあるので注意

「前回情報を復元」チェックボックス内容 †

TANMATSU.FLGTBL_04[5]
- オーダ発行後に文書情報を維持するかどうか
- QRコード文書の場合は復元しない
- 設定は[設定]ダイアログから

「QR解析を行わない」チェックボックスの表示 †

TANMATSU.FLGTBL_04[6]
- チェック時はQRコードの解析をスキップする
- 運用上、特定のQRコード無文書しか読まないような端末で使用
- チェック時は確認ダイアログが表示される

Adobe Reader実行ファイルパス †

BYOIN.STR_29
- スキャン登録時の印刷や指示歴からのスキャンオーダの印刷で必要
- 指示歴からの印刷ができないとの問合せがあったら、本設定が正しいか、インストールパスが正しいか確認する

スキャンオーダの権限判定用オーダ種別コード †

テーブル	マスタコード	カラム	内容
COMMON_DOC	05000005	CODE_STR	文書作成とスキャンの権限を区別したい場合に「0501」を指定設定がない場合は「0502」で判定

文書番号毎のスキャンパラメータ †

テーブル	マスタコード	カラム	内容
CONTROL	00020039	CODE_01	文書番号
		CODE_02	解像度コード(COMMON_DOC[05000002].CODE)
		CODE_03	色数コード(COMMON_DOC[05000003].CODE)
		CODE_04	用紙サイズコード(COMMON_DOC[05000004].CODE)

オーダボタン †

DLL呼出
- USER_BUTTON_INF.CODE_03 = 205
EXE呼出
- USER_BUTTON_INF.CODE_03 = 499
  - DLL呼出の場合にメモリリークが発生する事例が過去にあった
  - 特に理由がない場合は、EXE呼出とする
スキャンによる文書取消画面
- USER_BUTTON_INF.CODE_03 = 475
PDF取り込み画面
- USER_BUTTON_INF.CODE_03 = 397

関連 †

依存ライブラリ †

.NET2.0で使っていたライブラリはこちらを参照

Newtone ImageKit.NET3 †

TWAIN対応デバイスの制御や画像処理
TWAIN制御としてSaraff.Twain.NETやNTwainで実装を行ったが、画質・速度・メモリ消費などで問題があった

Aspose †

QRコードの解析や画像処理

よくある質問 †

両面スキャンはできませんか？ †

機種的には両面スキャンできる機種であってもPkScanからは片面スキャンのみの対応となってます(2018/07時点)
半折りスキャンは内部的には両面スキャンをしていますが、最終的には1枚の用紙として扱っています

この◯◯ってスキャナがPKで動作するか検証してほしい †

TWAIN対応のスキャナなら問題なく動作する(はず)なので検証してみる
TWAIN非対応のものはそもそもドライバを操作できないので事前に調べておく
- 沼津で要望のあったSnapScan SV600なんかがこれに該当した

スキャンが遅い †

QRコード解析で時間がかかっている場合が多い
- QRコードがない文書でも、読み込んだ文書内にQRコードがあるかチェックを行うため
- 0501.xml[20]で解析の範囲を狭めてみる
- 運用的に同一文書しか読まないような場合は[QRコード解析を行わない]を使う

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

「文書の取り込みに失敗しました」と表示されスキャンが行えない †

一番問い合わせが多く、一番原因が多様なトラブル
- スキャンドライバが正しいものか確認
  - 64bitOSには64bitのドライバが入っているかどうか(ImageKit.Net3の仕様上、ビット数が合致している必要がある)
- スキャナの給紙レバー等は正しい位置かどうか
  - 機種によるため現物を見たいところだが、これをガチャガチャいじると動くようになるケースがある
- [手動]にして用紙サイズ、解像度、色数をいじってみる
  - 主にEPSONを繋いでいる時はこれが原因のことが多い
  - 色数等はCannonスキャナベースのマスタなので、EPSONで指定不可のものが選べてしまっているケースがある(要修正)

クリアシートに紙を挟んでスキャンすると重送エラーになる †

下記の添付ファイルを参照して設定を行う。
- クリアファイルをスキャナで使用する設定方法.pdf

PrimeKarteがスキャナを認識しない †

まずPrimeKarte以外のツールからスキャナが認識できているかを確認する
- できていなければドライバの再インストールや端末の再起動等を行う
- ハード面での不具合の可能性もあることを考慮する

「取り込んだ用紙が裏面の可能性があります」と表示される †

用紙の空白率が高すぎて白紙チェックに引っかかっている可能性がある
0501.xml[15]で白紙と判定する閾値を指定できるので、再設定して動作確認をする
値は"/"区切りでそれぞれ
- ①ピクセル走査間隔(1～10)
- ②白でないとする閾値(1～255)
- ③白紙と判定する割合(1～100)
白紙チェックを行いたくない場合は"0/0/0"で設定

半折りスキャン実行時に取り込めない †

そもそも原稿が詰まる場合
- スキャナの給紙レバーが非分離給紙(Canon製ならオレンジの表示)になっているか確認
- 通常給紙のままだと半折り原稿のように厚みのある用紙が入らず、紙詰まりになる
原稿は取り込むが正しく取り込まない場合
- 重送検知に引っかかっている可能性がある
- Canon製ならスキャナの付属アプリから設定を変更する必要がある
- 詳しくはこちらを参照

スキャンした文書に変な線が入る †

キャリブレーションという操作を試してみる
- キャリブレーション=スキャナの劣化をドライバ側で補正する操作
手順は以下の通り(ここではCanonScan LiDE220を想定)
- プログラムから[IJ Scan Utility]を起動
- 画面右の[ScanGear]を選択
- 画面下部の[詳細設定]を選択
- [紙/写真用キャリブレーション]から[実行]を押下
ドライバ毎の補正情報を持つため、この事象が発生している端末毎の行う必要がある。

ビルド時に"Lc.exeはコード-1を伴って終了しました"と表示される †

その端末にライセンスがあるか確認→開発環境セットアップ手順（.NET Framework 4.x対応版）
基本的に製品版ライセンスはPkScan開発を行う端末+ビルド用端末にのみインストール
それ以外の原因の場合はこちらを参照

開発時の注意点 †

画面作成時
- コンポーネントクラスはComponent, ISbsDialogではなくScanBaseDialogを継承する
- フォームクラスはSbsDialogBaseではなくScanBaseDialogFormを継承する
- ScanBaseDialog,ScanBaseDialogFormはPkScan内画面で共通で持ちたいプロパティやメソッドのために設けた基底クラス
- コンポーネントがフォームを呼ぶ前に必ずSetFormProperty()を呼び、基底プロパティを渡すこと
- 将来的な展望としてはログの書き出しも基底クラスに持たせて、各画面ではメソッドを呼ぶだけにしたい