ConMas Manager 8.2.25070以降での設定

ConMas Manager バージョン「8.2.25070」より、MotionBoard Cloudとの連携時に、ConMas Manager側でデータストレージを自動作成できるようになりました。 これにより、MotionBoard側でデータストレージを手動で作成する必要がなくなり、ConMas Managerからボタン1つで連携設定を完了できます。

事前設定

【設定を行う上での注意事項】

ConMas Manager バージョン 8.2.25070以降で本設定を行うためには、ConMas Managerの「MotionBoard Cloud連携設定」 ＞ 「ID」 に設定するユーザーに対して、MotionBoard Cloud側で下記権限が付与されている必要があります。

• WEBAPI

• ファイル（作成/アップロード/編集）

• スナップショット管理

ConMas Managerバージョン 8.1.25050以前でMotionBoard Cloud連携設定を行っていたお客様で、ConMas Manager バージョン 8.2.25070以降にバージョンアップした場合は、特にご注意ください。

MotionBoard Cloud連携設定

【手順】

1. ConMasManagerにログインします。 画面上部の「システム管理」タブ ＞ 画面左側ツリーの「外部システム連携設定」 ＞ 「MotionBoardCloud連携設定」を選択し、画面右上の「編集ボタン」をクリックします。

2. 「MotionBoardCloud連携設定」画面にて連携に必要な情報を入力し、「登録」ボタン をクリックします。

   

必要な接続情報は下記のとおりです。

項目	入力する内容
CSVファイルのスナップショット直接取込（同期）リソースURI	MotionBoard Cloudマニュアル「WebAPIの使い方」に記載されている「リクエストURL」と、MotionBoard Cloudマニュアル「CSVファイルのスナップショット直接取り込み（同期）」に記載されている「リソースURI」を結合させた状態で入力します。 ※<スナップショット名>部分は不要です。 【例】 リクエストURL：https://XXXX-up.motionboard.jp/motionboard リソースURI：rest/snapshot/task/import/exec/csv/ →結合：https://XXXX-up.motionboard.jp/motionboard/rest/snapshot/task/import/exec/csv/
スナップショットの設定の作成、更新 リソースURI	MotionBoard Cloudマニュアル「WebAPIの使い方」に記載されている「リクエストURL」と、MotionBoard Cloudマニュアル「スナップショットの設定の作成、更新」に記載されている「リソースURI」を結合させた状態で入力します。 ※<スナップショット名>部分は不要です。 【例】 リクエストURL：https://XXXX-up.motionboard.jp/motionboard リソースURI：rest/snapshot/create/def/replication/ →結合：https://XXXX-up.motionboard.jp/motionboard/rest/snapshot/create/def/replication/
テナント	MotionBoard Cloudより提供されているテナントを入力します。
ID / パスワード	MotionBoard CloudのユーザーID、パスワードを入力します。 このユーザーに対してMotionBoard Cloud側で下記権限が付与されていることをご確認ください。 WEBAPI ファイル（作成/アップロード/編集） スナップショット管理
リアルタイム連携	帳票保存時にリアルタイムに連携 「する」、「しない」 を選択します。 詳細は、「連携タイミングの設定」をご参照ください。

帳票定義の準備

データ連携テーブル（連携用テーブル）出力設定をした帳票定義を作成します。

ConMas Designerの「帳票定義情報設定」タブ＞「連携用テーブルの作成（BIとの連携用）」設定

帳票内の表形式項目を連携テーブル対象とすることも可能です。

「データ連携テーブル機能」について、詳細は 「i-Reporter利用者マニュアル ＞ 入力帳票・データーを出力する ＞ 入力帳票の値をデータ連携テーブルに出力する」 をご参照ください。

帳票定義ごとのMotionBoard Cloud連携設定

【多言語環境でご利用される場合の注意事項】

多言語環境でご利用の場合、「データストレージ作成」時は、以下のいずれかの方法で対応してください。

• i-Reporterサーバーと同じ言語設定のブラウザを使用して、データストレージを作成する

• 「データストレージ項目名」は「物理項目名」を使用する

データストレージの項目名として「クラスター名称／表設定の列名を使用する」を選択した場合、 操作時のブラウザの言語設定により、クラスター項目以外のフィールド名が異なる名称で表示されます。 そのため、「データストレージ作成」は実行したブラウザの言語設定に従って、フィールド名が自動的に設定されます。

【例】 　日本語：帳票ID、更新者、更新日時 　英語　：Document ID, Last updated by, Last update date and time 　中国語：报表编码、更新者、更新时间

　※いずれも物理項目名は同じです：rep_top_id、sys_update_user、sys_update_time

一方で、MotionBoard Cloud連携では、i-Reporterを構築しているサーバーOSの言語設定が適用されるため、 データストレージ作成時と連携時で言語設定が異なると、フィールド名の不一致による連携エラーが発生する場合があります。

【手順】

1. ConMas Manager画面上部の「データー出力」タブをクリックします。 データー出力対象の帳票定義を選択し、画面右上の「連携ビューへ 」をクリックします。

   

   【データー出力対象帳票定義の「連携ビューの選択」画面を開く方法について】

   ConMas Manager バージョン 8.2.25070以降では、下記方法で「連携ビューの選択」画面を開くこともできます。

   • 帳票定義の基本情報から開く ConMas Managerの「帳票定義」タブ ＞ 該当の帳票定義を選択 ＞ 「基本情報」画面右上に表示される「データー出力 ＞ 連携ビュー選択画面へ」をクリックすると、該当帳票定義の「連携ビューの選択」画面へ遷移します。

     

   • 「連携ビュー：あり/なし」で帳票定義を検索する 帳票定義一覧画面右上の「検索（虫眼鏡）」ボタンから帳票定義を検索することができます。 ConMas Manager バージョン「8.2.25070」では、検索メニューに「連携ビュー」が追加されており、「連携ビュー：あり/なし」で帳票定義を検索することが可能です。 【オンプレミス版・サブスクリプション版をご利用の場合】 上記「連携ビュー」欄では、ConMas Managerを8.2.25070以降のバージョンにアップデートした後に、ConMas Designerでリビジョンアップを行った帳票定義のみが検索対象になります。 ConMas Managerを8.2.25070以降にアップデートしただけでは、既存の帳票定義は「連携ビュー：あり/なし」で検索できません。 「連携ビュー」欄を使用した検索を行いたい場合は、検索対象にしたい帳票定義をリビジョンアップしてください。 [リビジョンアップ手順] ConMas Designerで該当の帳票定義を開き、「公開」でサーバーに保存することでリビジョンアップします。 （リビジョンアップすると、定義IDが変わります。） ※クラウド版をご利用の場合は、すべての帳票定義が「連携ビュー」欄の検索対象になります。 　お客様にて帳票定義のリビジョンアップ操作は不要です。

2. 「連携ビューの選択」画面で、連携対象のビューの「ビュー物理名」をクリックします。

   

3. 「▼MotionBoard Cloud連携設定」にて、連携に関する設定を行います。

   • しない／する 「する」を選択します。

   • 「編集保存時も対象とする」 チェックを付けると、編集保存時もデータ連携します。

   • 「データストレージ名」 MotionBoardのデータストレージ名を指定します。

4. 「詳細設定」をクリックします。

   

   • 「Encoding」 「utf-8」を選択してください。

     【注意事項】

     選択肢としては「utf-8」と「shift_jis」がありますが、「utf-8」のみご利用いただけます。

   • 「データストレージ項目名」 「クラスター名称/表設定の列名称を使用する」 または 「物理項目名を使用する」から選択します。

     「クラスター名称/表設定の列名称を使用する」

     • メリット： ユーザーがi-Reporter上で自由に項目名を設定でき、視認性が向上します。

     • デメリット： 重複する名称が存在した場合、i-ReporterからMotionBoard連携を実行する際にエラーとなり、連携できません。エラーを解消するには、重複する項目の選択 または 名称が重複しないような定義の編集が必要になります。

     「物理項目名を使用する」

     • メリット： 項目名はi-Reporterで自動生成されるため、MotionBoard連携時に重複エラーは発生しません。

     • デメリット： 項目名がシステムによって自動生成された文字列となるため、視認性が低下します。既存の視認性を維持するためには、MotionBoard側で手作業による名称設定が必要です。

   • 「日時フォーマット」 手動で変更が可能です。 デフォルトでは、ConMas Managerの「システム管理」 ＞ 「共通マスター管理」

     • 共通キー：MB_SETTING

     • 共通項目名称：DATETIME_FORMAT

     の「共通項目値」の設定値が表示されています。

   • 「レコードの自動削除」

     「レコードの自動削除」は、ConMas Manager 8.2.26010 で追加された項目です。

     「利用しない」 または 「利用する」から選択します。

     • 「利用しない」（デフォルト） i-Reporterから入力帳票を削除しても、MotionBoardに連携済みのレコードは削除されません。 運用想定：i-Reporterの入力帳票は定期的に削除し、MotionBoard側でレコードを保持

     • 「利用する」 i-Reporterから入力帳票を削除した場合、MotionBoardに連携済みのレコードが削除されます。

     【注意事項】

     • 削除データは「非同期連携（一定時間間隔で連携）」で反映されるためリアルタイムに削除されません。

     • オンプレミス版をご利用の場合、Windowsサービスプログラム「IRService」最新バージョンをインストールし、正しく設定していることを前提とします。 ※マニュアル参照：連携タイミングの設定 ＞ 非同期連携を実行するための設定

     • ピン打ち連携ビューは「利用する」を選択できません。

   • 「入力帳票がリビジョンアップされた場合に別レコードとして保存する」

     「入力帳票がリビジョンアップされた場合に別レコードとして保存する」は、ConMas Manager 8.2.26010 で追加された項目です。

     • チェックなし（デフォルト） リビジョンの異なる帳票は同一レコードとして扱われるため、新しいリビジョンのレコードで更新されます。

       対象のスナップショットの更新キーが「元帳票ID」となります。

     • チェックあり リビジョンの異なる帳票は別レコードとして扱われます。

       対象のスナップショットの更新キーが「帳票ID」となります。

   【設定時の注意事項】 ConMas Manager 8.2.26010より前のバージョンで作成した定義で、MotionBoard Cloud連携設定済みの場合、以下の点にご留意ください。

   • 「レコードの自動削除」設定は「利用しない」が選択状態となっており、変更できません。 帳票定義をリビジョンアップすることで、「レコードの自動削除」が変更可能になります。

   • 「レコードの自動削除」を「利用しない」→「利用する」に変更し、「更新」すると、連携先のMotionBoard スナップショット詳細設定の「レコードの自動削除設定」を上書きします。 対象スナップショットの「レコードの自動削除設定」を確認し、上書きの可否を判断した上で設定を更新してください。　

   • 「入力帳票がリビジョンアップされた場合に別レコードとして保存する」設定を 「チェックあり」→「チェックなし」に変更する場合、スナップショットの更新キーが変更となりエラーが発生します。 更新キーの変更を伴うMotionBoard Cloud連携の更新はできないため、既存のスナップショットを退避の上、スナップショットを新規作成してください。

5. 出力項目の設定を行います。 「▼プレビュー表示」欄にある「編集」ボタンをクリックします。

   

   「出力項目設定」ウィンドウで、MotionBoard Cloud に連携するフィールドの順番や各項目の出力可否を設定します。

   

   出力項目の設定について、詳細は「入力帳票・データーを出力する ＞ 入力帳票の値をデータ連携テーブルに出力する ＞ ConMas Managerからの連携ビュー参照機能 ＞ 出力定義の選択 ＞ 出力項目設定」をご参照ください。

6. 設定完了後、「更新」ボタンをクリックします。

   ConMas Manager 8.2.25070 ～ 8.2.25101 をご利用の場合、「更新」ボタンを「データストレージの作成」ボタンに読み替えて操作してください。

「更新」ボタン クリック時の動作

「更新」ボタンをクリックすると、確認メッセージが表示されます。 「OK」をクリックすると、連携内容のチェックと連携処理が実行されます。

連携内容のチェック

チェック対象は下記表のとおりです。 連携不可の項目があれば、内容に応じたエラーメッセージを表示して連携処理を中断します。

チェック対象	連携可能な値/範囲	エラーメッセージ
Encoding	utf-8	選択されたEncoding”XXXX”ではデータストレージを作成できません。”utf-8”を選択してください。
日時フォーマット	空白 日時型へ変換できる書式	日時フォーマットの値が不正です。
データストレージ名	空白以外	データストレージ名を入力してください。
必須である出力項目	単票形式の場合 帳票ID（rep_top_id）※注1 元帳票ID（rep_top_org）※注1 削除フラグ（deleted）※注2 表形式の場合 帳票ID（rep_top_id）※注1 元帳票ID（rep_top_org）※注1 行番号（rep_row_no） 削除フラグ（deleted）※注2	必須の出力項目”XXXX”が不足しています。出力項目設定から追加してください。
出力項目の数	999以下	出力項目数が999を超えています。出力項目設定から項目数を減らしてください。
出力項目の名称	重複する項目名称が存在しない	重複する項目名があります。出力項目設定から該当項目を外す、またはConMas Designerで修正してください。

※注1 「入力帳票がリビジョンアップされた場合に別レコードとして保存する」の項目により、必須項目が変わります。 チェックなし：元帳票ID（rep_top_org） チェックあり：帳票ID（rep_top_id）

※注2 レコードの自動削除「利用する」選択時のみ必須です。

【「重複する項目名があります。出力項目設定から～」のエラーが表示された場合】

出力項目の名称が重複している状態です。 エラーを解消するためには、「データストレージ項目名」で 「物理項目名を使用する」を選択するか、もしくはConMas Designerで項目名称を変更します。

連携処理の実行

MotionBoard Cloudにデータストレージを作成します。

データストレージ名が重複していた場合は下記確認メッセージが表示されますので、内容をご確認ください。

連携処理が失敗した場合

連携処理が失敗した場合は、内容に応じてエラーメッセージが表示されます。 各メッセージの「対処方法」をご確認ください。

エラーメッセージ	対処方法
認証に失敗しました。MotionBoard Cloud連携設定を確認してください。	MotionBoard側から認証エラーのレスポンスがあった場合に表示されます。 ConMas Managerの「システム管理」 ＞ 「MotionBoard Cloud連携設定」を再度確認し、正しい認証情報を設定してください。 ConMas Managerの「システム管理」 ＞ 「MotionBoard Cloud連携設定」＞ 「ID」 に設定されているユーザーに対してMotionBoard Cloud側で権限が不足している場合にも、本エラーが表示されます。下記権限が付与されていることをご確認ください。 WEBAPI ファイル（作成/アップロード/編集） スナップショット管理
データストレージの作成・更新に失敗しました。HTTPステータスコード：400 body：{xxxxxx}	MotionBoard側からリクエストエラーのレスポンスがあった場合に表示されます。 原因として下記のような例が考えられますので、ご確認いただき、解決しない場合はMotionBoard サポートへお問い合わせください。 {"code":"E-COMMUNICATOR-04613","message":"「_」は開始文字として使用できません。"} データストレージ名の開始文字に「_」が設定されている 【対応方法】 データストレージ名の開始文字「_」を削除する {"code":"E-COMMUNICATOR-04610","message":"項目名に予約語が使われています。(項目名: <予約語>)"} データストレージ名または選択した項目名にDr.Sumの予約語が含まれている 【対応方法】 レスポンスの”<予約語>”と同名のデータストレージ名または項目名を修正する {"code":"E-COMMUNICATOR-04612","message":"使用できない文字が含まれています。(値: <使用できない文字> )"} データストレージ名に使用できない文字が含まれている 【対応方法】 レスポンスの”<使用できない文字>”をデータストレージ名から削除する {"code":"E-MOTION-BOARD-00382","message":"更新キーが変更されています。(定義名:<データストレージ名>)"} 既存データストレージ更新時に、異なる”データストレージ項目名”を選択している 【対応方法】 既存と同じ”データストレージ項目名”を選択する MotionBoard Cloud に存在しないデータストレージ名を設定する 既存データストレージ更新時に、更新キーの指定が変更されている。 ※「入力帳票がリビジョンアップされた場合に別レコードとして保存する」の設定を変更する場合に発生 【対応方法】 MotionBoard Cloud側で、既存のストレージ（スナップショット）をリネームもしくは削除の上、新規ストレージを作成する。 もしくは、MotionBoard Cloud に存在しないデータストレージ名を設定する。
データストレージの作成・更新に失敗しました。HTTPステータスコード：500	MotionBoard側からサーバー内部エラーのレスポンスがあった場合に表示されます。 本エラーが発生した場合は、MotionBoardサポートへ状況をご確認ください。

注意事項

ConMas Manager バージョン 8.1.25050以前でMotionBoard Cloudにデータストレージを作成している場合

連携項目の追加や変更が発生し、連携の設定を修正する場合、Encodingにご注意ください。 過去に「Encoding：shift_jis」で連携を行っていた帳票定義の連携設定を修正することはできません。 ※「Encoding」の変更はできません。

詳細は、「 【注意事項】既にMotionBoard Cloud連携をご利用中のお客様へ 」も併せてご確認ください。