IBM Notes/Domino

IBM Domino AppDev Pack ベータ

Share this post:

IBM Notes/Domino V10 リリーステーマの目玉の 1 つに JavaScript によるアプリケーション開発機能の強化がありました。

具体的には、Node.js で IBM Notes/Domino と連携したアプリケーションを開発できるようするという話になります。

その Node.js でのアプリケーション開発を実現にするために提供されるのが IBM Domino AppDev Pack と呼ばれる、

IBM Notes/Domino V10 用のアドオンモジュールになります。

IBM Domino App Dev Pack のリリースが迫ってきましたので、ここで公開中のベータを元に内容について少し解説しようと思います。

 

IBM Domino App Dev Pack のベータプログラムには以下のリンクから登録可能です。
https://ibm.biz/V10AppDevPack

 

IBM Domino App Dev Pack で提供予定のモジュールは

  • dominoDB NPM : IBM Notes/Domino 連携のための Node.js 用パッケージ
  • サーバーアドオン(Proton) : IBM Domino が Node.js アプリと通信するためのモジュール
  • IAM (Identity and Access Management) : Node.js のアプリが IBM Notes/Domino にアクセスする際のユーザー毎の権限管理
  • OIDC (OpenID Connect) : Node.js アプリのユーザー識別
  • OAuth : Node.js アプリにユーザーの権限を委譲

になります。

 

公開中のベータ版には Linux 版 IBM Domino に対応したサーバーアドオンモジュールと、Node.js 用のパッケージが含まれています。

Windows 版 IBM Domino 対応版や、IAM/OIDC/OAuth に関してはベータ版では試すことができないので注意してください。

 

ベータ版ではサーバーアドオンである Proton と呼ばれるモジュールはバイナリファイルで提供されており、

Linux 版 IBM Domino のプログラムディレクトリーにコピーしてパーミッションを設定するだけで利用する事が可能になります。

HTTP などの他のタスクと同様に Proton も IBM Domino のサーバータスクとして動作します。

以下のように Proton がインストール済みの環境であれば、load コマンドで実行する事が可能です。

 

load proton
> [013486:000002-00007FC39A557840] 12/10/2018 03:13:07.43 PM PROTON> Build 0.1.0-5497660
[013486:000002-00007FC39A557840] 12/10/2018 03:13:07.43 PM PROTON> Listening on 0.0.0.0:6009, INSECURE
[013486:000002-00007FC39A557840] 12/10/2018 03:13:07.43 PM PROTON> Note: Requested port was 0, Actual listen port is 6009
[013486:000002-00007FC39A557840] 12/10/2018 03:13:07.43 PM PROTON> Server initialized
[013486:000002-00007FC39A557840] 12/10/2018 03:13:07.43 PM PROTON> Server allows Anonymous access only.

 

これで IBM Domino に Node.js アプリから接続し操作する事が可能になります。

例えば、以下のようなプログラムを書いて実行すると、対象の IBM Notes アプリケーションに新規に 2 文書が追加されます。

 

const { useServer } = require(‘@domino/domino-db’);

const serverConfig = {
hostName: ‘xxxx.yyy.co.jp’, // Host name of your server
connection: {
port: ‘6009’, // Proton port on your server
},
};

const databaseConfig = {
filePath: ‘node-demo.nsf’, // The database file name
};

const createOptions = {
documents: [
{
Form: ‘Contact’,
FirstName: ‘Aaron’,
LastName: ‘Aardman’,
City: ‘Arlington’,
State: ‘MA’,
},
{
Form: ‘Contact’,
FirstName: ‘Brian’,
LastName: ‘Zelnick’,
City: ‘Chelmsford’,
State: ‘MA’,
},
],
};

useServer(serverConfig).then(async server => {
const database = await server.useDatabase(databaseConfig);
const response = await database.bulkCreateDocuments(createOptions);

// Display the new document UNIDs
const unids = response.documents.map(doc => doc[‘@unid’]);
console.log(`Documents created: ${unids}`);
});

 

プログラムを実行する前に dominoDB パッケージを取り込む必要があることに注意してください。

 

より詳細な IBM Domino AppDev Pack の情報については先日行ったテクてく Lotus 技術者夜会の資料を参考にしてみてください。

https://www.ibm.com/developerworks/community/files/app#/folder/944d94ba-6b6e-41b6-b6ac-712af016e223

 

IBM Domino AppDev Pack のリリース後にたくさんの IBM Notes/Domino と連携した Node.js アプリが見られることを楽しみにしています。

Customer Success Manager for IBM Collaboration Solutions

More IBM Notes/Domino stories
By Atsushi Sato on April 1, 2019

IBM Domino AppDev Pack 1.0.1

IBM Notes/Domino アプリケーション開発機能を拡張し、外部アプリケーションの権限管理、 OAuth によるアプリケーションにアクセスの認可を与える仕組み、Node.js アプリケーションから IBM Notes/Domino にアクセスする仕組みなどを提供する IBM Domino AppDevPack の バージョン 1.0.1 がリリースされました!パーツ番号 CC0NGEN で検索してみてください。 また英語でのアナウンスは以下のブログにあります。 https://www.ibm.com/blogs/collaboration-solutions/2019/03/29/exciting-news-ibm-domino-appdev-pack-1-0-1-is-now-available-on-windows-and-verse-on-premises-1-0-7-has-ical-import/   IBM Domino AppDev Pack 1.0.1 のもっとも大きな機能拡張は Windows 版のサポートかと思います。 ベータ版およびバージョン 1.0 では Linux 版のみのサポートだったため、二の足を踏まれていた開発者も多くいらっしゃるかと思いますが、 今回からは Windows 上の IBM Domino に導入し利用する事が可能になっています。   その他には、アプリケーションの権限などを管理する仕組みである IAM サーバーが正式版になったり、 Node.js から IBM Notes/Domino へのアクセスを実現するためのパッケージである domino-db が機能拡張されたりしています。 その domino-db の機能拡張の中で、テストスクリプトが用意されたのが開発時に役立つのでは無いかと思います。 このテストスクリプトを利用する事で、Node.js アプリケーションと […]

Continue reading

By Atsushi Sato on February 25, 2019

IBM Notes/Domino Day 2019 Spring

2月22日(金)に IBM Notes/Domino Day 2019 Spring が開催されました。 同日は、ノーツコンソーシアム主催の ノーツコンソーシアム FESTA 2019 も開催され、 たくさんの IBM Notes/Domino に関わるお客さま、パートナーさまにご参加いただきました。 ご来場いただいたみなさま、どうもありがとうございました!   ノーツコンソーシアム FESTA 2019 では、IBM Domino Application on Cloud (DAC) の事例として 浜松ホトニクスさまに登壇いただき、よかった点も改善されるべき点もお話しいただき DAC の可能性を感じさせていただける内容でした。 また、2018 年度の各研究会の成果発表も同時に行われました。   ザ・ノーツ研究会 – IBM Notes/Domino の製品評価をグループワークで実施し大きな視点での評価を実現 XPages 研究会 – XPages をより有効利用してもらえるよう学習も兼ねて逆引きリファレンスを作成し公開(http://code.xpages.jp/) クラウド研究会 – クラウドで提供される Watson や Azure AD と IBM Notes/Domino との連携の実証検証 […]

Continue reading

By Atsushi Sato on February 12, 2019

IBM Notes/Domino V10.0.1 日本語版

IBM Notes/Domino V10 の日本語対応版が2月5日から公開されています。 https://www-01.ibm.com/common/ssi/ShowDoc.wss?docURL=/common/ssi/rep_ca/0/760/JAJPJP19-0140/index.html&request_locale=ja   今回のリリースにて先日リリースをした IBM Domino V10.0.1 に適用可能な日本語対応した言語パックおよび 日本語版の IBM Notes V10.0.1 がリリースされています。なおクライアントは Windows 版と macOS 版の両方のリリースです。 IBM Client Application Access (ICAA) に関しても同様に日本語版がリリースされています。 V10 のリリースから4ヶ月ほどお待たせしてしまいましたが、日本語で IBM Notes/Domino V10 をご利用いただけるようになりました。 ダウンロードする際のパーツ番号などは以下のサイトを参考にしてみてください。 https://www-01.ibm.com/support/docview.wss?uid=ibm10737609   日本語版の IBM Notes を起動してみると、このように日本語のユーザーインターフェースが問題無く表示されます。 ちなみに、IBM Notes に関しては、ショートカットに不具合があり一旦はリリースを控えましたが、その後リリースされています。 http://www-01.ibm.com/support/docview.wss?uid=ibm10870434   今まで紹介してきた IBM Notes/Domino V10 の新機能を是非とも日本語版でも評価いただき、 バージョンアップの計画をたてていただけることを期待しております。

Continue reading