IBM Domino Mobile Apps は、iPad 版のノーツクライアント（ベーシック）と呼べるものです。

制限事項はありますが、既存のノーツアプリケーションの基本「修正なし」でそのまま動作することが大きなメリットです。また、Domino サーバーが V10 でなくても使用できるため、V10 にバージョンアップするのはまだ先というユーザー様も利用できます。

 

その IBM Domino Apps がついに今月リリースされました！現在、Apple App Store からダウンロードできるようになっています。

 

多くの方が期待を寄せている IBM Domino Mobile Apps ですが、実際にどの程度既存のアプリケーションが動作するのか？各機能の検証結果を、XPages.JP ブログで公開しています。なお、検証はリリース前のβ版で行っています。製品版と異なる点がある可能性がありますが、その点はご了承ください。

IBM DOMINO MOBILE APPS の検証結果（UI・操作編）

IBM DOMINO MOBILE APPS の検証結果（UI・操作編２）

IBM DOMINO MOBILE APPS の検証結果（設計要素編）

IBM DOMINO MOBILE APPS の検証結果（セキュリティ＆メール編）

IBM DOMINO MOBILE APPS の検証結果（複製編）

 

10月10日に IBM Notes/Domino Day 2018 Autumn Tokyo が東京で開催されました。

https://www.ibm.com/blogs/solutions/jp-ja/ndday18t/

また、大阪（10月16日）、名古屋（10月19日）でも順次開催されました。

 

待ちに待った IBM Notes/Domino V10 のリリース発表です。

今回、分科会「【B-2】開発者が語る 最新Dominoアプリケーション事例」で、IBM Champion の皆様と合同で発表する機会を頂けました。

私は、今年取り組んでいた Notes/Domino とパートナーロボット「ユニボ」との連携のデモを実施しました。

 

 

リハーサルでは順調だったユニボですが、本番ではネットワークエラーで WiFi に接続できずに焦りました。

再起動を試し、デモの直前に繋がったので何とか無事終わったのですが...ハードウェアを伴うデモは難しいですね。

 

10月19日のテクてく Lotus 技術者夜会では、当日お伝えできなかった部分を追加して話をします。

メールDBのプリファレンスでは、ユーザーが個別に各種設定を行えます。

ポリシーを使って一部は管理者が設定できますが、逆に管理者がユーザーの設定した内容を確認したい場合もあるかと思います。

 

「所有者の設定は正しく設定されているのか？」

「カレンダーのカテゴリの登録状況は？」

「メールやカレンダーへのアクセス権限の付与状況は？」

などをまとめて確認するのに使用できないかとユーザーのメールDBのプリファレンスの情報を収集するDBを作成しました。

 

今回、私が知りたかったのは「カレンダーのカテゴリ」と「アクセス権限の付与状況」だったのでサンプルで3つのビューのみ作成しています。

申し訳ありませんが、その他の情報については必要に応じてビューや列を追加してください。

 

注意事項

• メールDBであるかどうかは判定していません。
• プリファレンスのプロフィール文書が存在するかどうかは「プリファレンス有無」（ビューのアイコン：緑の旗）で確認できます。
• ご使用前に適切なユーザーで署名してください。
• いかなる明示または暗黙の補償も責任も負いかねます。
• ご利用の際には自己責任であることをあらかじめご了承ください。
• 開発環境：Notes 9.0.1 FP10

 

使い方

1. テンプレートをダウンロードします。

こちらからダウンロードできます。

2. 適切なユーザーで署名します。

3. テンプレートからデータベースを作成し適切な ACL を設定します。

4. 調査対象のメールDBへのアクセス権限があるユーザーで開きます。

5. データベースを開きます。

6. 「1.データベース」ビューを開きます。

7. アクション（右端）の「環境設定」ボタンをクリックします。

 

• 調査対象の「サーバー」を設定します。

• 調査対象の「フォルダ」を設定します。

  • 設定したフォルダ以外はスキップします。

  • 複数のフォルダを指定する場合、改行またはカンマで区切って入力してください。

8. 環境設定を保存して閉じます。

9. アクション（右端）の「調査」ボタンをクリックすると調査が開始されます。

10. 結果がビューに表示されます。

「2.プリファレンス」配下のビューから収集したプリファレンスの情報を確認します。
必要なビューが無い場合、自由に追加してください。

 

補足：再調査する場合

再度「調査」を実行した場合、「レプリカID」＆「サーバー」＆「ファイル名」が同一の場合、情報が上書き更新されます。
削除したメールDBがある場合、手動で文書を削除してください。

以上

「今日から始める LotusScript - 公開資料」で使用したアプリケーションを公開しました。（ダウンロード）

 

ソースコードや動作の確認にご利用ください。

ダウンロード後、適切なユーザーで署名してください。

 

 

 

6月28日（木）にノーツコンソーシアムで「新任担当者向けWS開発者編」を開催しました。

その際の結果をもとに、以前の公開した資料「ノーツアプリケーションのデザインを変更してみよう！」を修正しました。（Version 1.1）

大筋は変わっていませんが、他のテキストに合わせて章の順番を入れ替えたり、補足説明を追加・修正しています。

 

先日、ロボットのユニボ (*1) に会議室を予約してもらうデモアプリを作成しました。

会議室予約システムは、Notes/Domino 標準テンプレートのリソース予約 DB を使用しています。また、OnTime for IBM が導入されていて、OnTime Open API を利用してアクセスしています。

 

*1: パートナーロボット「ユニボ」は、生活の中に溶け込み、人と寄り添うことを目指したロボットです。会話を使ってコミュニケーションを取ることができ、感情を表現するための顔や手足があるのが特徴です。

 

 

 

利用シーン

• 急に打ち合わせを行いたい状況になったので、今すぐ使用可能な会議室を探している。
• 空いている会議室があれば、30分だけ予約したい。

 

 

動画

YouTube

 

 

システム概要図

 

動作

1. 利用者は、ユニボに「会議室の検索」と話しかけます。
2. ユニボは、会議室予約システムへ空いている会議室がないかを問い合わせします。
3. ユニボは、音声で結果を返します。あわせて顔の液晶にも結果を表示します。
4. 利用者は、そのまま予約したい場合、顔の液晶に表示された会議室を選択します。
5. ユニボは、予約する会議室を音声で確認します。
6. 利用者は、予約を依頼します。
7. ユニボは、会議室予約システムへ予約を実行します。
8. ユニボは、音声で結果を返します。

 

まとめ

Google Home や Amazon Echo を自宅で使用しているのである程度わかっていたのですが、実際にアプリを作成してみて感じたのは音声での制御は注意点が多いことです。
例えば「予約時間を自由に設定したい」「予約開始時間を変更したい」と考えた場合、音声だと指示が面倒です（受け答えの増加、音声認識のミスなど）。
かと言って、タッチパネルで済ませてしまうとタブレットで良いのでは...ともなります。
無理に何でも音声で制御する必要もありませんが、音声には音声のメリットがあります（手が塞がっていたり、多少離れていても操作できるなど）。
この辺の見極めがこの系統のアプリを作成する際にとても重要です。

 

今後スマートデバイスの利用は増えていくでしょう。その時、Notes/Domino や Office 365 などコラボレーション製品が持つ社内データ（メール、掲示板、ワークフロー、営業）が活用でき、必要とされる機会が出てくると考えています。今回はその良い検証になりました。
どのような形態になるかはわかりませんが、将来的にマイ秘書のようなシステム・デバイスができればと...と夢想しています。

 

 

追記

6月15日（金）にノーツコンソーシアムの第2回ユーザー情報交換会があり、事例展示として今回のデモアプリを展示させて頂きました。

ご覧頂いた皆様、ありがとうございました。

 

 

ちょっとしたデザインの変更でもノーツアプリケーションのイメージが変わってきます。

どのようなカスタマイズができるのか？様々な方法がありますが、その中で比較的簡単な例をまとめました。

 

 

 

2018/07/01 加筆・修正した Version 1.1 を公開しました。

 

先日、LotusScript の入門編をまとめましたが、これで一通りのノーツアプリケーション開発の入門編資料が揃いました。そこで、今まで作成した資料をまとめておきます。

 

下記資料は、どれもアプリケーション開発を始める際の取っ掛かりになることを目的にしています。
私自身それらを学習する当時、どこから手を付ければ良いのかに困りました。
そのことから、まず最低限の操作と時間で最低限のアプリケーションを完成させる経験を積むことを目標としました。

実際の運用を考えると不足する機能や使い勝手が悪い部分があり、それらを実装しようとすると苦労します。

しかし、その際にアプリケーションを完成させたという経験は手助けになるかと思います。

これらの資料が最初の一歩を踏み出す方たちの手助けに少しでもなれば幸いです。

 

 

1. ノーツクライアントアプリケーション開発 入門編

1-1. ノーツ新任担当者向けアプリケーション開発講座（ノーツコンソーシアム：ブログ）

概要

簡単なアンケートアプリケーションの開発を一から学べます。
ノーツコンソーシアム「ノーツ新任担当者向けワークショップ（開発者編）」の内容を再編集して掲載しています。

デザインについては「1-2. ノーツアプリケーションのデザインを変更してみよう！」を参照ください。

 

学習に必要なレベル

ノーツクライアントアプリケーションをこれから学びたい方
フィールドの追加程度は行ったことがあるが、一からアプリケーションの開発を行ったことがない方

 

学習後にできること

掲示板アプリケーション程度の開発

 

学習時間

1日程度

 

 

1-2. ノーツアプリケーションのデザインを変更してみよう！（Version 1.1）

 

 

概要

ちょっとしたデザインの変更でもノーツクライアントアプリケーションのイメージは変わってきます。どのようなカスタマイズができるのか？様々な方法がありますが、その中で比較的簡単な例をまとめました。

変更元のアプリケーションは「1-1. ノーツ新任担当者向けアプリケーション開発講座（ノーツコンソーシアム：ブログ）」とほぼ同じですので、そのまま利用できます。（別途ダウンロードも可能）
 

学習に必要なレベル

ノーツクライアントアプリケーションの開発を行ったことがある方
「1-1. ノーツ新任担当者向けアプリケーション開発講座」を終えた方

 

学習後にできること

フォーム、ビュー、フレームセットのデザインの変更

 

学習時間

半日程度

 

 

2. ノーツクライアントアプリケーション開発 Hint & Tips 編

2-1. ノーツアプリケーション開発 Hint & tips 101連発

 

 

概要

ノーツアプリケーションで「よく利用する機能」かつ「比較的実装が簡単」なものをまとめました。

フォームやビューなど設計要素毎に開発のヒントになる機能を紹介しています。
「こんな使い方や実装方法もあるのか！」となればと思っています。

 

学習に必要なレベル

ノーツクライアントアプリケーションの開発を行ったことがある方
「1-1. ノーツ新任担当者向けアプリケーション開発講座」を終えた方

 

学習後にできること

既存アプリケーションの機能・デザインのアップ
一歩進んだアプリケーションの開発

 

学習時間

（ざっとタイトルに目を通しておいて、必要になった時に再度確認することを想定）

 

 

3. LotusScript 入門編

3-1. 今日から始める LotusScript - Domino クラスライブラリの使い方（Version 1.1）

 

 

概要

LotusScript の学習をこれから始めるにあたって取っ掛かりになるようにまとめました。

Notes/Domino の操作やデータアクセスのための Domino クラスライブラリに焦点をあてて「よく使用する」または「重要なもの」に厳選しています。

 

学習に必要なレベル

ノーツクライアントアプリケーションの開発を行ったことがある方
「1-1. ノーツ新任担当者向けアプリケーション開発講座」を終えた後にいくつかのアプリケーションを開発した方

 

学習後にできること

LotusScirpt を学習する上で最初に覚えるべきものを絞り込める
ヘルプを読むのが少し楽になったり、気持ちの敷居が下がる

 

学習時間

1日程度

 

 

4. XPages アプリケーション開発 入門編

4-1. 今日から始める XPages アプリケーション開発！（オープンセミナー 2016 ハンズオン XPagesDay 出張セッション)

 

 

概要

XPages の学習をこれから始めるにあたって取っ掛かりになるようにまとめました。

事前に用意したノーツアプリケーションを XPages 化します。

 

学習に必要なレベル

ノーツクライアントアプリケーションの開発を行ったことがある方

「1-1. ノーツ新任担当者向けアプリケーション開発講座」を終えた方

 

学習後にできること

掲示板アプリケーション程度の開発（XPages）

 

学習時間

1日程度

 

 

4-2. 一週間で学ぶ XPages 開発入門 (初級編)

概要

ノーツクライアントアプリケーション開発を行ったことがあるユーザーが初めて XPages を学習する想定で作成しています。

同じ入門編ということで他の資料と被る部分もありますが、こちらは画面構成に [アプリケーションレイアウト] コントロールを用いずに作成します。

 

また、面白いのはノーツクライアント（スタンダード版）を使って動作確認している点です。XPages はノーツクライアント（スタンダード版）でも動作するので、ノーツクライアントとブラウザの双方で使用可能なアプリケーションを開発することも可能です。この技術は、XPinC（XPages in Notes Client）といいます。但し、内部ブラウザの違いから双方で動作確認は必要ですのでご注意ください。

 

学習に必要なレベル

ノーツクライアントアプリケーションの開発を行ったことがある方

「1-1. ノーツ新任担当者向けアプリケーション開発講座」を終えた方

 

学習後にできること

掲示板アプリケーション程度の開発（XPages）

 

学習時間

1日程度

（タイトルが一週間となっているのは、1日数時間程度を7日間と想定しているため）

 

 

4-3. Notes 技術者のための はじめての XPages 講座 (XPagesDay 2015)

 

 

概要

「4-1. 今日から始める XPages アプリケーション開発！」の前年に行ったセッション資料です。
同じ入門編ということで他の資料と被る部分も多いですが、上記学習終了後に補足として読んでいただければと思います。

 

学習に必要なレベル

ノーツクライアントアプリケーションの開発を行ったことがある方

「1-1. ノーツ新任担当者向けアプリケーション開発講座」を終えた方
「4-1. 今日から始める XPages アプリケーション開発！」を終えた方

 

学習後にできること

掲示板アプリケーション程度の開発（XPages）

 

学習時間

（ざっとタイトルに目を通しておいて、必要になった時に再度確認することを想定）

 

 

 

更新履歴

2018/07/01 「1-2. ノーツアプリケーションのデザインを変更してみよう！（Version 1.1）」新バージョンへ変更

2018/06/16 「1-2. ノーツアプリケーションのデザインを変更してみよう！」の追加

2018/06/16 「3-1. 今日から始める LotusScript - Domino クラスライブラリの使い方（Version 1.1）」新バージョンへ変更

 

以上

 

連載していた「今日から始める LotusScript」をまとめて SlideShare に公開しました。

リンク先からダウンロードもできます。

また、アプリケーション（NSF）は、こちらからダウンロードできます。署名してお使いください。

 

 

 

2018/06/17 アプリケーション（NSF）を公開しました。

2018/06/16 ビューの文書の処理を中心に加筆・修正した Version 1.1 を公開しました。

 

前回「今日から始める LotusScript (7) - 文書の処理とエージェントの操作」の続きです。 

今回は、最後のまとめです。

 

 

行番号の表示方法

まとめに入る前に、Domino Designer のテキストエディタで行番号の表示方法を紹介しておきます。

 

メニューバー [ファイル] - [プリファレンス] から設定画面を開きます。

[一般] - [エディター] - [テキスト・エディター] の設定を開き、[行番号の表示] を有効にします。

 

 

ヘルプ

気になることや困ったらヘルプを見ましょう！特に掲載されている 例 は理解の手助けになります。

 

Domino Designer のメニューバー [ヘルプ] - [ヘルプ目次] から開きます。

• IBM Domino Designer Basic 版 ユーザーガイドおよびリファレンス
  • LotusScript 言語
  • LotusScript /COM/OLE クラス

 

IBM Web サイトでも閲覧できます。

• IBM Domino Designer 9.0.1 Social Edition 資料 - IBM Domino Designer Basic 版ユーザーガイドとリファレンス

 

ヘルプの以下の項目は、軽くでも目を通しておくと後々役立ちます。

 

その中でもお勧めの箇所を抜粋します。

<< >> の箇所は、量が多いのでざっと見ておいて、必要な時に再度確認しましょう。

 

• LotusScript 言語
  • スクリプトとステートメントの作成規則
    • 識別子の作成規則
    • ラベル
    • キーワード
    • 特殊文字
  • データ型、定数、変数
    • LotusScript のデータ型の概要
  • 式と演算子
    • 文字列演算子の一覧
  • スクリプトのフローの管理
    • ブロックステートメント
    • 分岐ステートメント
    • 繰り返しステートメント
    • 早期終了ステートメント
  • LotusScript 言語リファレンス
    • << 関数やステートメントの詳細はここで確認 >>
  • 言語とスクリプトの制限
    • 数値データの制限
    • 文字列データの制限
    • 配列変数の制限
  • ランタイムエラーメッセージ
    • << エラーの原因はここで確認 >>
• LotusScript /COM/OLE クラス
  • LotusScript: LotusScript のクラスの使用
    • << ケース別に利用可能なプロパティやメソッドがまとめられている >>
  • LotusScript クラス A-Z
    • << クラスの詳細はここで確認 >>
      

 

 

最後に

今回は、入門編として LotusScript の学習を始める上で最初に理解しておいた方がよい部分のみを厳選しました。それでもこの頁数になってしまいました。

LotusScript は奥が深く、まだまだ語り足りない部分がありますがそこが面白いところです。ノーツクライアントのみではなく、Excel や Word を操作することもでき、工夫次第で様々なアプリケーションが開発できます。

 

当資料が LotusScript の学習を始めた方のお役に立ててれば幸いです。

資料は、後ほどまとめて公開する予定です。

 

最後までご覧いただきありがとうございました。

 

 

 

 

前回「今日から始める LotusScript (6) - ビューと文書の処理」の続きです。 

今回は、文書の処理とエージェントの操作についてです。

 

 

文書の処理

文書の処理パターンは、多岐にわたります。当資料では簡単な処理を例として記述します。

• 文書の新規作成
• 文書の更新
• 文書の削除

上記以外にも編集モードで表示している文書の操作（NotesUIDocument クラス）、エージェントではなく、フォーム（PostOpen や QuerySave など）やボタン（Click）のイベントに記述する場合もあります。

 

文書に含まれるフィールドを LotusScript では、アイテム（Item）と呼びます。

フィールドを表すクラスは、NotesItem と NotesRichTextItem（リッチテキスト）クラスです。

フィールドを扱う方法は、以下になります。

1. 「拡張クラス」構文を使用
   • 参考資料：AppendItemValue - 「拡張クラス」構文
2. NotesDocument クラスの GetItemValue, AppendItemValue, ReplaceItemValue メソッドなどを使用
3. NotesItem クラスにアクセスして、各種プロパティやメソッドを使用

※ 1と2の方法では、NotesItem クラスにアクセスする必要はありません。

 

 

Step4-1:文書を新規作成する（NotesDatabase クラス/CreateDocument メソッド, NotesDocument クラス/Save メソッド）

 

7-10行目

変数 doc のフィールドに値を設定

“doc.(フィールド名) = (設定値)”で値を設定可能（「拡張クラス」構文）

フィールドが存在しない場合、新規にフィールドが作成される

但し、プロパティやメソッドなどの予約語と被るフィールドは作成不可

また、文字列や数値以外の読者や作成者フィールドとして設定する場合、上記方法ではなく NotesItem クラスを使った方法で作成/設定する必要あり

11行目

NotesDocument クラスの Save メソッドを使用して、変数 doc を保存

保存を忘れないようにすること

 

実行結果

 

Step4-2:文書を更新する（NotesDocument クラス）

[Step3-1:ビューの列の値を使用して文書を検索する] を一部修正。

[製品ID] が“L01”の文書の [価格] を2倍にする。

 

[価格（Price）]フィールドは複数値ではないが、フィールドのデータは複数値を考慮して配列で返ってくる

そのため、後に“(0)”を付けて“doc.Price(0)”として配列の最初の値を取得、2を掛けている

13行目

NotesDocument クラスの Save メソッドを使用して、変数 doc を保存

保存を忘れないようにすること

 

実行結果

 

Step4-3:文書を削除する（NotesDocument クラス/Remove メソッド）

[Step3-1:ビューの列の値を使用して文書を検索する] を一部修正。
[製品ID] が“C01”の文書を削除する。

 

第1引数に True を指定した場合、スクリプトが文書を開いた後に他のユーザーが文書を変更した場合でも削除

 

 

Step4-4:文書を新規作成する [作成者フィールドの追加] （NotesItem クラス）

 

12行目

第1引数はフィールドを作成する文書を設定（変数 doc）

第2引数は作成するフィールドの名前

第3引数は設定する値

第4引数はフィールドの種類

今回は作成者とするため“AUTHORS”を指定（名前の場合“NAMES”/読者の場合“READERS”）

13行目

NotesItem クラスの IsSummary プロパティを True に設定

ビューやフォルダにフィールドの値を表示する場合、IsSummary プロパティが True の必要があるが、NotesItem クラスから作成したフィールドの IsSummary プロパティは、デフォルトが False である。よって、明示的に True を設定

 

実行結果

 

 

エージェントの操作

エージェントを表すのは、NotesAgent クラスです。

様々なプロパティやメソッドがありますが、最初は以下のメソッドのみ覚えておけばよいでしょう。

• Run メソッド
  • エージェントを実行します。

注意事項

エージェントを再帰的に実行することはできません。（自分自身を呼び出すことはできません）

ユーザーは呼び出し先エージェントと直接対話することはできません。呼び出し先エージェント内で、Print ステートメントを使用した場合、クライアントのステータスバーには表示されず、クライアントの log.nsf に出力されます。

呼び出し先エージェントをデバッグすることはできません。

戻り値は、エージェントを呼び出せたかどうかの結果であり、呼び出し先エージェントがエラーが無く実行されたかどうかは関係ありません。

 

 

Step5-1:別のエージェントを実行する（NotesAgent）

 

6行目

NotesDatabase クラスの GetAgent メソッドからエージェント(*1)を取得、変数 agent に格納

7行目

NotesAgent クラスの Run メソッドを実行して、6行目で取得したエージェントを実行

結果をステータスバーに表示

 

*1 「Step2-1:ダイアログボックスを表示 NotesUIWorkspace クラス」で作成したエージェント

 

 

 

次回は、最後のまとめの予定です。

 

前回「今日から始める LotusScript (5) - スクリプトデバッガ」の続きです。 

今回は、ビューと文書の処理についてです。

 

 

ビューの文書の処理

ビューに表示されている文書を処理する機会は、とても多いです。

例）

• ビューに表示されている文書の [ステータス] フィールドの値をすべて“完了”にしたい
• ビューのデータを CSV に書き出したい
• キー（特定の値）に一致する文書のデータを取得したい

 

ビューからの文書の取得でよく使うのは以下の方法です。

• ビューの列の値を検索して、キーに一致する文書を取得する
  • GetDocumentByKey メソッド
  • GetAllDocumentsByKey メソッド
• ビューの最初の文書から順番に取得する
  • GetFirstDocument メソッド
  • GetNextDocument メソッド

 

 

Step3-1:ビューの列の値を使用して文書を検索する（NotesView クラス/GetDocumentByKey メソッド）

 

6,9行目

製品 ID を格納するための String クラス（文字列）の変数 key を宣言。初期値“L01”を設定

10行目

完全一致で検索する場合、第2引数には、True を指定

戻り値は NotesDocument オブジェクトであることに注意（複数の文書が一致する場合は最初の文書のみ）

11行目

変数 doc が Nothing かどうかで分岐

12行目

製品名を出力。[製品名（ProductName）]フィールドの値を取得したい場合、“doc.ProductName(0)”と記述

フィールド値の取り扱い・記述については、後述

 

実行結果

 

Step3-2:ビューの文書を順番にすべて取得する（NotesView クラス/GetFirstDocument, GetNextDocument メソッド）

 

 

実行結果

 

注意事項

今回の演習では、文書を変更していないためビューの表示に影響がありません。

しかし、文書を削除したり、値を変更する場合は注意が必要です。理由は、 文書の削除やビューの条件式によって、文書がビューに表示されなくなったりビューの表示順が変わってしまうためです。そうなると次の文書を返す GetNextDocument メソッドは期待する結果を返さない場合があります。処理途中のビューがどのような状態であるかを意識しながらプログラミングする必要があります。

 

ヘルプより抜粋

ループ内の文書を処理するときは、文書を削除しないでください。または、ビューに表示されなくなったり位置が変更されるような形で、文書を変更しないでください。次の文書であったはずの文書がビュー内の別の位置にあると、GetNextDocument メソッドは実用的な結果を返さない場合があります。この問題の最も一般的な症状は、文書をループしたときに文書がスキップされることです。

この問題に対処するには、文書を変更する前には常に GetNextDocument を呼び出すようにロジックを変更します。あるいは、NotesView.AutoUpdate (= False) を使用して、ビューの使用中にビューの索引が再作成されるのを防止します。

 

 

Step3-3:ビューの列の値を使用して文書を検索する [複数] （NotesView クラス/GetAllDocumentsByKey メソッド, NotesDocumentsCollection クラス）

[Step3-1:ビューの列の値を使用して文書を検索する] と [Step3-2:ビューの文書を順番にすべて取得する] を組み合わせて製品IDが [L] で始まる製品を検索します。

 

11行目

NotesView クラスの GetAllDocumentsByKey メソッドを使用して、ビューの左端ソート列（製品 ID の昇順でソート）と第1引数に指定した変数 key が一致する文書をすべて検索

部分一致（前方）で検索する場合、第2引数には、False を指定

戻り値は NotesDocumentCollection オブジェクトであることに注意（複数の文書のコレクション/一覧）

14,17行目

While ステートメントを使用して、変数 doc が Nothing になるまで 14～17行を繰り返す

11行目

NotesDocumentCollection クラスの GetNextDocument メソッドを使用して、変数 doc の次の文書を取得

 

実行結果

 

 

次回は、文書の処理についてです。

 

 

前回「今日から始める LotusScript (4) - フロントエンドクラス」の続きです。 

今回は、スクリプトデバッガについてです。

 

 

LotusScript のデバッグ（スクリプトデバッガ）

LotusScript には、デバッグを補助するツールとして、スクリプトデバッガがあります。
LotusScript をステップ（1行）単位で実行でき、変数の値を確認しながら動作確認/デバッグできるため、とても重宝します。
スクリプトデバッガは、メニューバー [ツール] – [LotusScript のデバッグ] から有効にします。
有効な状態で LotusScript を実行するとスクリプトデバッガが自動で表示されます。

 

下図はスクリプトデバッガを使用しているイメージです。

（GIF アニメーションになっており、繰り返し再生されます）

 

機能（ボタン）の説明

[ステップ イン] を使用して、デバッグを進めます。

[ステップ オーバー]、[ステップ アウト] は、初期の演習では Initialize のみで別のサブプログラム（Sub/Function）が無いため、後で必要になってから見直せばよいでしょう。

• 実行
  • エラーまたはブレークポイントまで実行
• ステップ イン [F8]キー
  • ステップ単位で実行
• ステップ オーバー [Shift] + [F8] キー
  • ステップ単位で実行
  • 別のサブプログラム（Sub/Function）を呼び出す処理の場合、呼び出し先のサブプログラムが一度に（裏で）実行され、次の行に処理が進む
• ステップ アウト [Ctrl] + [F8] キー
  • 現在のサブプログラムを最後まで実行
  • スタックされている次のサブプログラムに処理が移る
• 停止
  • 直ちに、デバッガを終了
• デバッガの終了
  • 直ちに、デバッガを終了
  • LotusScript のデバッグが無効になる

 

 

ブレークポイント

ステップ単位では無く、特定の行の前まで処理を一気に進めたい場合、ブレークポイントを設定して、[実行] ボタンをクリックします。

 

ブレークポイントは、対象の行を選択してダブルクリックして設定します。

もう1回ダブルクリックすると無効になります。無効の場合、停止しません。

 

更に1回ダブルクリックすると消去になります。

ダブルクリックする以外に、メニューバーのデバッグから各種選択する方法、[F9] キーで変更する方法があります。
ブレークポイントが設定できない行もあります。ご注意ください。（Dim ステートメントなどの変数宣言行）

 

 

[ブレークポイント] タブ

設定したブレークポイントは、[ブレークポイント] タブに一覧で表示されます。また、ダブルクリックすると設定した行が選択された状態になります。

 

 

[変数] タブ

[変数] タブで、現在の変数の状態を確認できます。目的のオブジェクトが取得できているのか？値の変更が行われているのか？などを確認できます。

下図の ① は、NotesDocument オブジェクトの変数 doc が持つ、フィールド（Item）の情報です。

 

 

 

[出力] タブ

Print ステートメントの出力は、[出力] タブに表示されます。

 

 

[コール] タブ

[コール] タブには、現在実行スタックにあるサブプログラムのリストが実行順に表示されます。このリストの一番上には現在実行中のサブプログラムが表示されます。
LotusScript の学習を進めていくと複数のサブプログラム（Sub/Function）をコールする（呼び出す）場合があります。現時点では、このようなタブがあることだけを覚えておけば良いでしょう。

 

 

 

次回は、ビューの文書の処理についてです。

 

 

前回「今日から始める LotusScript (3) - バックエンドクラス」の続きです。 

今回は、基本的なフロントエンドクラスについてです。

 

基本的なフロントエンドクラス

クライアントの状態（現在開いているデータベースやビュー、文書など）にアクセスするためのクラスです。

ユーザーがクライアントから直接実行しているスクリプトからのみ使用できます。スケジュールエージェントでは使用できません。（エラーになります）

ダイアログボックスを表示したり、ビューやフォームを閉じるなど UI に関する操作ができます。

• NotesUIWorkspace クラス
  • 現在のクライアントのワークスペースのウィンドウにアクセスするためのクラスです。
• NotesUIDatabase クラス
  • 現在、クライアントで開いているデータベースにアクセスするためのクラスです。
• NotesUIView クラス
  • 現在、クライアントで開いているビューにアクセスするためのクラスです。
• NotesUIDocument クラス
  • 現在、クライアントで開いている文書にアクセスするためのクラスです。

 

上記4つのフロントエンドクラスとオブジェクトの関係は下図のようになっています。

 

現在表示中のデータベースやビュー、文書へアクセスしたい場合、バックエンドクラスとは違い NotesUIWorkspace クラスから直接アクセスできます。

（他の方法もありますが、基本はこの形になります）

 

 

Step2-1:ダイアログボックスを表示（NotesUIWorkspace クラス）

 

2行目

3行目

ダイアログボックスでのユーザーの選択結果を格納する変数 askme を宣言（Integer 型）

4行目

NotesUIWorkspace クラスの Prompt メソッドを使用して、ダイアログボックスを表示

 

第1引数は、ダイアログボックスのタイプ（種類）の指定

今回は、はい/いいえ（Yes/No）ボタンがある PROMPT_YESNO タイプを指定

第2引数は、タイトルバーに表示する文字列を指定。第3引数は、表示する文字列を指定

ダイアログボックスでのユーザーの選択結果は、変数 askme へ格納

ユーザーがはい（Yes）を選択した場合、askme = 1、いいえ（No）を選択した場合、askme = 0

5行目

変数 askme によって、処理を分岐

 

※ 式言語の ＠Prompt に相当

※ ダイアログボックスを表示する方法は、この他に MessageBox 関数とステートメント、NotesUIWorkspace クラスの DialogBox メソッドがある

 

 

Step2-2:現在のデータベースを閉じる（NotesUIDatabase クラス）

 

3行目

NotesUIDatabase クラスの変数 uidb を宣言

 

 

 

Step2-3:現在のビューを印刷する（NotesUIView クラス）

 

 

 

 

Step2-4:文書を編集モードにする（NotesUIDocument クラス）

 

 

 

 

 

次回は、デバッガについて説明します。