本書の説明本書は ConMas i-reporter の外部システムとの連携について標準パッケージの機能で可能なこととオプション機能 : 外部連携 API セットで可能なことについて概要をまとめたものです Copyright 2015 CIMTOPS CORPORATION - All R

外部システムとのインターフェース概要図標準機能 ConMas Manager 標準機能標準機能 Web Browser ConMas Server 定義情報参照ビュー ASP.NET 帳票トップ定義ビューシート定義ビュー Web HTTP/HTTPS ( REST ) クラスタ定義ビュー Application 定義権限ビュー定義クラスター権限ビュー PostgreSQL 9.1 Data Base 設定管理機能定義参考資料ビュー定義ラベルマスタービュー管理閲覧編集承認定義ラベルビュー帳票データー出力サーバー内の自動帳票作成指定ディレクトリへの帳票ラベル定義ビュー,XMLファイル出力各種マスター取り込み標準機能範囲帳票画像帳票PDFの出力帳票情報参照ビュー ConMas Web API Web API オプション機能オプション機能帳票トップビューシートビュー ASP.NET Web Application クラスタービューログイン帳票権限ビューログアウト帳票クラスター権限ビュー定義一覧取得帳票簡易詳細情報取得定義簡易詳細情報取得帳票ロック取得解除定義ロック取得解除帳票権限情報取得設定定義権限情報取得設定帳票ラベル情報取得設定定義ラベル情報取得設定ユーザー情報取得選択値情報更新ユーザー情報登録定義削除 HTTP/HTTPS ( REST ) 帳票一覧取得 ConMas Generator オプション機能 Windows Service 自動帳票作成グループ情報更新監視ジョブ実行外部Application 実行帳票更新端末取得帳票参考資料ビュー帳票ラベルマスタージョブ設定入力フォルダー設定出力フォルダー設定ログ出力設定 Application インポートグループ情報取得フォルダー監視実行帳票ダウンロードマスター情報参照ビューユーザーマスタービューエクスポート外部Application 実行帳票削除 URLスキーム取得グループマスタービューグループ所属マスタービュー端末マスタービューシステム設定ビューカスタムマスタービュージョブスケジュール実行 postgresql Client Web Client File System File System 外部取り込み外部取り込み外部取り込み外部取り込みアプリケーションアプリケーションアプリケーションアプリケーション外部システム外部システム外部システム外部システムデータデータデータデータ Web API 連携オプション機能範囲フォルダ監視ジョブスケジュールデーター参照ビュー ConMas Web Server が提供するREST形式のWebAPIを利用してデータの取得登録が可能ですログインからセッションを保持した連続した操作が可能です ConMas Generator によりフォルダ監視によるデータのインポート及び定期ジョブ実行によるi-Repo rterデータのエクスポートが可能です ConMas i-reporter のデータベースから postgresql に直接接続し参照ビューからデータを取得できます呼び出し例 RESTコマンドログイン POST RESTコマンド帳票取得 POST RESTコマンド帳票登録 POST RESTコマンドログアウト ConMas Generatorの入出力形式はシステム標準形式となるため個別の外部プログラムによりデータ変換が必要となりますコマンドライン形式による外部プログラム実行が可能です postgresql のクライアントミドルウェア等の接続モジュールやドライバーが必要となります ConMas Generator から変換プログラムを呼び出すことが可能ですブラウザを始め WebClient機能を実装できるコマンドリファレンス及び.NET(C#)サンプルコードをご提供します外部システム Copyright 2015 CIMTOPS CORPORATION - All Rights Reserved. 3

標準パッケージの機能でできること標準機能では主にユーザー操作による手動取り込み標準出力ファイルの参照データベース接続によるビュー参照が可能です外部システム i-reporter ConMas Manager(Web 管理画面 ) のシステムメニューから手動実行にて i-reporter へデーターを取り込むことができます自動帳票作成外部システムから出力されたもしくは XML データの i-reporter 標準レイアウト形式ファイルを取り込んで複数枚の帳票を自動生成します選択候補値の取り込み外部システムから出力されたもしくは XML データの i-reporter 標準レイアウト形式ファイルを取り込んで指定した帳票定義の選択クラスターの候補値を更新しますマスターの取り込み外部システムから出力されたもしくは XML データの i-reporter 標準レイアウト形式ファイルを取り込んで i-reporter のマスターの値を更新します Copyright 2015 CIMTOPS CORPORATION - All Rights Reserved. 4

標準パッケージの機能でできること i-reporter 外部システム指定ディレクトリへの帳票データの自動出力帳票が完了処理されると指定ディレクトリへ以下を自動出力します帳票に入力されたデーター帳票に入力された XML データー帳票の画像 (PNG) 帳票の PDF 帳票の Excel(Excel ファイルから帳票定義を作成したもののみ ) お客様サイドにて指定ディレクトリーの監視型プログラムを開発することにより帳票データーを自動に取得し外部システムへ連携することができます帳票データ一括出力 ConMas Manager( 管理画面 ) から複数の帳票データを形式で一括出力することが可能です同一定義から作成された複数の帳票データが 1 行 1 帳票のファイルに出力されます画像 PDF ファイルを同時に出力することも可能です (ZIP 圧縮形式 ) 外部システム参照用ビューの公開 i-reporter のデータベース PostgreSQL に直接接続し参照用のビューから各種帳票データを取得できます postgresql に接続できる環境が必要となります参照のみとなりますので追加変更削除はできません定義情報参照ビュー帳票情報参照ビューマスター情報参照ビュー Copyright 2015 CIMTOPS CORPORATION - All Rights Reserved. 5

完了した帳票のデーター自動出力概念図完了時の指定ディレクトリへの帳票データの自動出力帳票が完了処理されると指定ディレクトリへひとつの帳票に対して以下のセットを自動出力します出力するファイルは帳票定義単位に指定可能です帳票に入力されたデーター帳票に入力された XML データー帳票の画像 PNG 帳票の PDF 帳票の Excel(Excel ファイルから帳票定義を作成したもののみ ) サーバーの指定ディレクトリーの監視型プログラムを開発することにより帳票データーを自動に取得し外部システムへ連携することができます指定ディレクトリーの監視型プログラムサーバー内の指定ディレクトリへのファイル出力 XML ファイル出力帳票画像 PNG 出力帳票 PDF の出力帳票 Excel の出力 Copyright 2015 CIMTOPS CORPORATION - All Rights Reserved. 6

外部参照ビューの公開概念図外部システムから ConMasDB の全ての情報を取得可能な参照ビューが公開されています ConMas データベース PostgreSQL に直接接続し参照用のビューからすべての帳票定義情報帳票情報マスター情報を取得できます postgresql DB に接続できる環境が必要となります参照のみで ConMasDB の情報の追加変更削除はできません参照ビュー帳票定義情報参照ビュー帳票情報参照ビューマスター情報参照ビュー定義情報参照ビュー帳票情報参照ビューマスター情報参照ビュー帳票トップ定義ビューシート定義ビュークラスタ定義ビュー定義権限ビュー定義クラスター権限ビュー定義参考資料ビュー定義ラベルマスタービュー定義ラベルビュー帳票ラベル定義ビュー帳票トップビューシートビュークラスタービュー帳票権限ビュー帳票クラスター権限ビュー帳票参考資料ビュー帳票ラベルマスター帳票ラベルビューユーザーマスタービューグループマスタービューグループ所属マスタービュー端末マスタービューシステム設定ビューカスタムマスタービュー Copyright 2015 CIMTOPS CORPORATION - All Rights Reserved. 7

Option 外部連携 API セットでできることオプションの外部連携 API セットには以下の二つが用意されていますこれを利用して外部システムにおいてプログラムを開発することにより ConMas i-reporter との各種の自動処理のしくみを容易に構築することが可能です連携の方法は以下の 2 つがあります 1Web API 連携 ConMas Web API 外部システムのプログラムからの API 呼び出しのリアルタイム連携 2Windows Service Application 連携 ConMas Generator 外部システムからのファイル出力によるフォルダ監視 + ジョブスケジュールによる連携 Copyright 2015 CIMTOPS CORPORATION - All Rights Reserved. 8

Option 外部連携 API セットでできること 1ConMas Web API WebAPI 連携外部アプリケーションから i-reporter を直接操作するための API セットです ConMas Web Service の API 呼び出し用 URL に必要なパラメーター付加して呼び出すことでデータの取り込み抽出などが可能です Web クライアントととして動作できるアプリケーションまたはブラウザーから利用できます本 API にて取り込み出力する XML ファイルのレイアウトは i-reporter 標準レイアウト形式画像形式は PNG 形式となります ConMas Web Server が提供する REST 形式の各種 WebAPI を利用して外部システムからデータの取得登録更新が可能ですログインからセッションを保持した連続した操作が可能ですブラウザを始め WebClient 機能を実装できるコマンドリファレンス及び.NET(C#) サンプルコードが添付されます Copyright 2015 CIMTOPS CORPORATION - All Rights Reserved. 9

Option 外部連携 API セットでできること提供される Web API 一覧システムメンテナンスグループ情報取得グループ情報更新ユーザー情報取得ユーザー情報登録グループ所属取得グループ所属更新定義ラベルマスタ取得定義ラベルマスタ登録帳票ラベルマスタ取得帳票ラベルマスタ登録参考資料情報取得参考資料情報更新端末情報取得 URL スキーム取得 Copyright 2015 CIMTOPS CORPORATION - All Rights Reserved. 13

Option 外部連携 API セットでできること 2Windows Service Application 連携指定フォルダ監視フォルダに出力されたファイルを自動で i-reporter に取り込みますスケジュール実行時間指定で外部システムから出力された i-reporter 標準レイアウト形式のファイルを自動で i-reporter に取り込みます時間指定で i-reporter から i-reporter 標準レイアウト形式のファイルを出力することが可能です取り込み処理出力処理実行時に外部アプリケーションを呼び出すことが可能です ( コマンドライン形式による外部プログラム実行 ) ConMas Generator の入出力形式は i-reporter のシステム標準形式となるため個別の外部プログラムによりデータ変換が必要となります Copyright 2015 CIMTOPS CORPORATION - All Rights Reserved. 14

Web API 連携概念図 ConMas Web API を使用すれば外部システムのプログラムから各種 API を呼び出し ConMasDB の全ての情報にリアルタイムにアクセスすることができます REST 形式の WebAPI を利用してデータの取得登録が可能ですログインからセッションを保持した連続した操作が可能です ConMas DB Web API 一覧 ConMas Web API ASP.NET Web Application ログインログアウト自動帳票作成選択値情報更新帳票削除定義削除帳票一括ダウンロードユーザー情報取得ユーザー情報登録グループ情報取得グループ情報更新共通情報取得共通情報更新端末取得定義一覧取得定義取得 / 登録 / 削除定義ロック取得 / 解除権限情報取得 / 設定ラベル情報取得 / 設定参考資料取得 / 設定新規帳票取得帳票一覧取得帳票取得 / 登録 / 削除帳票ロック取得 / 解除権限情報取得 / 設定ラベル情報取得 / 設定参考資料取得 / 設定 Web Client 外部取り込みアプリケーション外部システムデータ < 呼び出し例 > RESTコマンド ( ログイン ) (POST) RESTコマンド ( 帳票取得 ) (POST) RESTコマンド ( 帳票登録 ) (POST) RESTコマンド ( ログアウト ) ブラウザを始め WebClient 機能を実装できるコマンドリファレンス及び.NET(C#) サンプルコードをご提供 Copyright 2015 CIMTOPS CORPORATION - All Rights Reserved. 15

Windows Service Application連携概念図 ConMas Web API を使用すれば外部システムのプログラムからのファイル出力によるフォルダ監視ジョブスケジュールによる連携によりConMasDBの全ての情報に自動連携することができます取込処理出力処理実行時に外部アプリケーションを呼び出すことが可能ですコマンドライン形式による外部プログラム実行 ConMas DB ジョブ設定入力フォルダー設定出力フォルダー設定ログ出力設定 ConMas Generator ConMas Web API HTTP/HTTPS ( REST ) Windows Service Application 監視ジョブ実行インポート外部Application フォルダー監視実行実行 ASP.NET Web Application エクスポート外部Application 実行フォルダ監視ジョブスケジュールジョブスケジュール実行フォルダ監視によるデータのインポート及び定期ジョブ実行によるi-Reporterデータのエクスポートが可能です File System File System 外部取り込みアプリケーション外部取り込みアプリケーション ConMas Generatorの入出力形式はシステム標準形式となるため個別の外部プログラムによりデータ変換が必要となりますコマンドライン形式による外部プログラム実行が可能です ConMas Generator から変換プログラムを呼外部システムデータ外部システムデータび出すことが可能です Copyright 2015 CIMTOPS CORPORATION - All Rights Reserved. 16

データーを差し込んだ帳票の自動発行概念図日々必要となる大量の入力帳票の作成を自動化します帳票作成の負担を現場にかけません外部システムから出力し作成した情報を外部連携APIセットを使用して帳票内の複数の特定のクラスターに差し込み帳票を自動作成します上位システム ConMas DB 帳票定義ID ABC000用のデータ 100件帳票定義ID ABC0001 オーダ No. ABC12345 製造No. XYZ000121234 Lot No. LOT2011121213 機械 No. MAC2101 帳票定義ID:ABC0001 検査記録に対して 100件分のデータを各帳票の指定場所に差し込みした検査記録帳票(入力前)を 100枚自動作成します入力前帳票 100枚検査記録 ConMas Web API オーダ No. 製造No. Lot No. 機械 No. ASP.NET Web Application 帳票定義ID ABC0001 帳票定義ID:ABC0001 検査記録に対する100件のオーダーNO.,製造 NO.,LotNO,機械NO.の情報を作成します検査記録オーダ No. 製造No. Lot No. 機械 No. 測定X 測定Y 測定Z 品質判定記録者上位システムから自動設定される入力項目測定X 測定Y 測定Z 品質判定記録者作業者が現場で入力する項目 Copyright 2015 CIMTOPS CORPORATION - All Rights Reserved. ABC12345 XYZ000121234 LOT2011121213 MAC2101 検査記録 ipadアプリで入力オーダ No. 製造No. Lot No. 機械 No ABC12345 XYZ01234 LOT21213 MAC2101 測定X 測定Y 測定Z 品質判定記録者 17

選択候補値の自動反映概念図選択クラスターの選択候補値を上位システムのマスターから自動アップデートすることができます外部システムから出力し作成した情報を外部連携APIセットを使用して複数の帳票定義の各選択クラスターの選択候補値のデーターをまとめて自動アップデートすることが可能です上位システム帳票定義の各選択クラスターの選択候補値情報 ConMas DB 帳票定義ID ABC0001 検査記録クラスターNO.21 生出筒井伊賀上松尾土井帳票定義ID CBD0005 品質記録クラスターNO.30 生出筒井伊賀上帳票定義ID:ABC0001 検査記録のクラスターNO.21 単一選択クラスター帳票定義ID:CBD0005 品質記録のクラスターNO.30 単一選択クラスターの選択候補値情報を作成します ipadアプリでの帳票入力 ConMas Web API ASP.NET Web Application 帳票定義ID:ABC0001 検査記録のクラスターNO.21 単一選択クラスターの選択候補値がアップデートされる Copyright 2015 CIMTOPS CORPORATION - All Rights Reserved. 18