> For the complete documentation index, see [llms.txt](https://manuals.i-reporter.jp/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://manuals.i-reporter.jp/output-the-data/motionboard-cloud/manager-25070.md).
# i-Repo Manager(ConMas Manager) 8.2.25070以降での設定
{% hint style="success" %}
ConMas Manager バージョン「8.2.25070」より、MotionBoard Cloudとの連携時に、i-Repo Manager側でデータストレージを自動作成できるようになりました。\
これにより、MotionBoard側でデータストレージを手動で作成する必要がなくなり、i-Repo Managerからボタン1つで連携設定を完了できます。
{% endhint %}
## **事前設定**
{% hint style="warning" %}
**【設定を行う上での注意事項】**
i-Repo Manager(ConMas Manager) バージョン 8.2.25070 以降で本設定を行うためには、i-Repo Managerの「MotionBoard Cloud連携設定」 ＞ 「ID」 に設定するユーザーに対して、MotionBoard Cloud側で下記権限が付与されている必要があります。
* WEBAPI
* ファイル（作成/アップロード/編集）
* スナップショット管理
ConMas Managerバージョン 8.1.25050以前でMotionBoard Cloud連携設定を行っていたお客様で、i-Repo Manager(ConMas Manager) バージョン 8.2.25070以降にバージョンアップした場合は、特にご注意ください。
{% endhint %}
### **MotionBoard Cloud連携設定**
【手順】
1. i-Repo Managerにログインします。\
画面上部の「システム管理」タブ ＞ 画面左側ツリーの「外部システム連携設定」 ＞ 「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
- ファイル（作成/アップロード/編集）
- スナップショット管理
|
| リアルタイム連携 | 帳票保存時にリアルタイムに連携 「する」、「しない」 を選択します。
詳細は、「連携タイミングの設定」をご参照ください。 |
### **帳票定義の準備**
データ連携テーブル（連携用テーブル）出力設定をした帳票定義を作成します。
i-Repo Designerの「帳票定義情報設定」タブ＞「連携用テーブルの作成（BIとの連携用）」設定
【データー出力対象帳票定義の「連携ビューの選択」画面を開く方法について】
i-Repo Manager(ConMas Manager) バージョン 8.2.25070 以降では、下記方法で「連携ビューの選択」画面を開くこともできます。
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 8.2.26010 で追加された項目です。
【注意事項】
- 削除データは「非同期連携（一定時間間隔で連携）」で反映されるためリアルタイムに削除されません。
- オンプレミス版をご利用の場合、Windowsサービスプログラム「IRService」最新バージョンをインストールし、正しく設定していることを前提とします。
※マニュアル参照：連携タイミングの設定 ＞ 非同期連携を実行するための設定 - ピン打ち連携ビューは「利用する」を選択できません。
「入力帳票がリビジョンアップされた場合に別レコードとして保存する」は、ConMas Manager 8.2.26010 で追加された項目です。
【設定時の注意事項】
ConMas Manager 8.2.26010より前のバージョンで作成した定義で、MotionBoard Cloud連携設定済みの場合、以下の点にご留意ください。
- 「レコードの自動削除」設定は「利用しない」が選択状態となっており、変更できません。
帳票定義をリビジョンアップすることで、「レコードの自動削除」が変更可能になります。 - 「レコードの自動削除」を「利用しない」→「利用する」に変更し、「更新」すると、連携先のMotionBoard スナップショット詳細設定の「レコードの自動削除設定」を上書きします。
対象スナップショットの「レコードの自動削除設定」を確認し、上書きの可否を判断した上で設定を更新してください。 - 「入力帳票がリビジョンアップされた場合に別レコードとして保存する」設定を
「チェックあり」→「チェックなし」に変更する場合、スナップショットの更新キーが変更となりエラーが発生します。
更新キーの変更を伴うMotionBoard Cloud連携の更新はできないため、既存のスナップショットを退避の上、スナップショットを新規作成してください。
ConMas Manager 8.2.25070 ～ 8.2.25101 をご利用の場合、「更新」ボタンを「データストレージの作成」ボタンに読み替えて操作してください。
#### **連携内容のチェック**
チェック対象は下記表のとおりです。\
連携不可の項目があれば、内容に応じたエラーメッセージを表示して連携処理を中断します。
| チェック対象 | 連携可能な値/範囲 | エラーメッセージ |
|---|
| 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を超えています。出力項目設定から項目数を減らしてください。 |
| 出力項目の名称 | 重複する項目名称が存在しない | 重複する項目名があります。出力項目設定から該当項目を外す、またはi-Repo Designerで修正してください。 |
※注1\
「入力帳票がリビジョンアップされた場合に別レコードとして保存する」の項目により、必須項目が変わります。\
チェックなし：元帳票ID（rep\_top\_org）\
チェックあり：帳票ID（rep\_top\_id）
※注2\
レコードの自動削除「利用する」選択時のみ必須です。
{% hint style="success" %}
**【「重複する項目名があります。出力項目設定から～」のエラーが表示された場合】**
出力項目の名称が重複している状態です。\
エラーを解消するためには、「データストレージ項目名」で 「物理項目名を使用する」を選択するか、もしくはi-Repo Designerで項目名称を変更します。
{% endhint %}
#### **連携処理の実行**
MotionBoard Cloudにデータストレージを作成します。
データストレージ名が重複していた場合は下記確認メッセージが表示されますので、内容をご確認ください。\
### **連携処理が失敗した場合**
連携処理が失敗した場合は、内容に応じてエラーメッセージが表示されます。\
各メッセージの「対処方法」をご確認ください。
| エラーメッセージ | 対処方法 |
|---|
| 認証に失敗しました。MotionBoard Cloud連携設定を確認してください。 | MotionBoard側から認証エラーのレスポンスがあった場合に表示されます。 i-Repo Managerの「システム管理」 ＞ 「MotionBoard Cloud連携設定」を再度確認し、正しい認証情報を設定してください。 i-Repo 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」の変更はできません。
{% hint style="warning" %}
詳細は、「 [【注意事項】既にMotionBoard Cloud連携をご利用中のお客様へ](/output-the-data/motionboard-cloud/manager-25070/caution.md) 」も併せてご確認ください。
{% endhint %}
