＜シリーズ2 第2回＞ 株式会社オムニサイエンス社の「API-Bridge」を使ったIBM i とkintoneのAPI連携をやってみた！

｢IBM i ｣側のデータは、23件存在しています。

それでは、｢kintone｣からデータを登録します。
｢kintone｣アプリ｢customer｣のビュー選択プルダウンメニューから｢登録｣を選択します。

次に、データ登録画面が表示されますので、登録したいデータを入力します。

登録データを入力したら、｢登録｣ボタンをクリック！

データの登録処理が正常終了すると一覧画面が表示されますので登録したデータが追加されていることを確認してください。
ちゃんと登録されていますね！

では、｢IBM i ｣側の得意先マスタを確認してみましょう。
24行目に登録データが追加されていることが確認できます。

完成イメージをご覧いただいたところで、実装方法についてご紹介していきましょう。
今回も用意するのは、｢API-Bridgeサーバー｣でのSQL定義、｢kintone｣での、HTML、JavaScriptとなります。

まず、｢API-Bridgeサーバー｣の定義です。
｢IBM i ｣のデータに登録するために以下の通り定義(｢regData｣というPOSTメソッドを処理するAPI)を作成しました。

登録するデータの受け渡し方法は、URLのパラメータを使用する方法、登録するデータをJSONファイルとして作成しBODYに指定する方法などがありますが、今回は初心者にも簡単なURLのパラメータを使用する方法を採用しています。
今回のパスパラメータ定義は以下の通りです。

今回は、12項目ありますので、パラメータ定義は以下のように行ないました。

これで、｢API-Bridgeサーバー｣の定義は終了です。｢IBM i ｣のデータに登録する準備ができました。

続いて、登録データを入力する画面定義及び処理を司るJavaScriptを作成していきましょう。

まず、登録データを入力する画面のHTMLは以下となります。
前回の教訓通り、＜form＞での画面定義ですが、ボタンはここには定義しません！

続いて、データ登録のJavaScriptです。

いかがだったでしょうか。
前回苦労した分、今回は画面周りの実装はそれほど苦労せずできました。

ただ一つ、データを登録するところがうまくいかずちょっと頭を悩ませました。
更新のログを確認すると、どうも｢IBM i ｣のデータベースにジャーナルがかかっていないことが原因のようでした。
今回、検証環境で実証実験を行なっているため、データベースにジャーナルはかけていないし、かける予定もありませんでした。
賢明な読者の皆様はすでにお気づきかと思いますが・・・そうです｢更新のSQLに『with NC』パラメータを記述する｣必要がありました。
もちろん、対象のデータベースにジャーナルがかかっていれば、こんなパラメータは不要なのですが、もしジャーナルを使用していない場合は、この｢with NC｣をお忘れなく！