#Domino #Volt ( #dominovolt )で 外部 #REST #API ( #restapi )を使う

 I recently posted about the prerequisites for using an external REST API with Domino Volt.

However, I thought that this was not enough, so I created a video in which I actually implemented an application that retrieves data from an external REST API in Domino Volt in a short time and with no code.

みなさま、こんにちは。

さて先日、

#Domino #Volt ( #dominovolt )で 外部 #REST #API ( #restapi )を使う前準備

という記事を掲載しましたが、設定だけを公開しても・・・ということで、今回は実際に外部のREST APIからデータを取得する手順を短い動画にしましたので、公開致します。

こちらも先日の掲示板に張り合い?
4分20秒で完成させたスピード作になります(笑

今回の例では、ホットペッパーグルメから公開されているAPIを利用して、キーワード検索を行い、結果をVoltに表示させるという単純なものです。

ホットペッパーグルメのAPIについては、こちらをご参照ください。
(※登録して、API Keyを取得する必要があります・・・すぐに発行して頂けました)

https://webservice.recruit.co.jp/index.html

こちらのAPIリファレンスに詳しく書かれていますが、必要な項目としては、

●リクエストURL
●検索クエリ(何を検索するのか・・・今回はkeywordを利用)
●レスポンスフィールド(どの項目を表示させるか・・・今回はname,Address,station_name,closeを利用)

となります。

リファレンス内には以下のようなサンプルがあり、リンクをクリックするとブラウザに結果が得られます。

ちなみに得られた結果はこちらになります。

・・・keyが設定されていないので、あたりまえですね。
では[APIキー]を取得したキーに差し替えてみます。

実際にはもっと長いデータになりますが、無事データを取得することができました。

それでは実際にDomino Voltに設定していきましょう。

先にも書きしましたが、今回はkeywordのみを指定して検索しますので、URLの例は以下となります。

http://webservice.recruit.co.jp/hotpepper/gourmet/v1/?key=[APIキー]&keyword=秋葉原

試しにブラウザで実行してみると、

このように結果が得れることを確認しました。

それではDomino Voltに設定していきます。

・・・いきなりですが、今回のフォームは以下となります。
詳細はお手数ですが、動画をご覧ください。

それではREST APIの設定を[検索]ボタンにサービスとして追加します。

以下のようにURLを指定します。

すると・・・

なんとエラーが出てしまいました。
応答にはデータが入ってそうです。

・・・よくよく内容を確認すると・・・
そう、APIのデフォルトがXML形式で戻ってきていたのです。

現状、VoltはJSON(のみ?)でのやり取りになるため、その設定を追加してやる必要があるということです。

APIリファレンスをよく読むと・・・

ありました。
URLに"format=json"を追加してやればいいようです。

ということで、まずは以下URLをブラウザで表示させてみます。

http://webservice.recruit.co.jp/hotpepper/gourmet/v1/?key=[APIキー]&keyword=秋葉原&format=json

ごちゃごちゃした表示が戻ってきました。
さすがにこの状態ではXMLのほうが見やすいとは思いますが、関係ありません。

ということで、このURLを使い、サービスを設定していくことで、無事結果が得られました。

こちらの詳細も申し訳ございませんが、動画にてご確認ください。
今回はまったくコードを書いておりませんので、ぜひその点にもご注目ください。

#Domino #Volt ( #dominovolt )で 外部 #REST #API ( #restapi )を使う前準備

 I will be publishing an article on the prerequisites for connecting to external REST APIs with Domino Volt.

Since there are not many articles in Japanese, I would be happy if you find this article useful.

みなさま、こんにちは。
さて今回も告知からです。

★ #HCLAmbassador ノミネーション受付中!!

我こそは!!
少しでも思いつく方は、遠慮することなくエントリーを!

★#DominoHub 2022

HCLアンバサダー主催のオンライン・オフラインイベント。
イベントの最後にはビアバッシュと大抽選会も!!
可能な方は、ぜひ現地でお会いしましょう。
もちろん難しい方は、オンラインでご視聴ください。

おまけ
12月8日はパブリックビューも開催されますので、こちらもお見逃しなく!!

さて本題です。
先にも触れましたがDomino Hub 2022で1コマ頂いており、現在その資料を作成しています。
いろいろと掘り返している中、Domino Volt のREST接続を久しぶりに実施したのですが、なんとうまくいかない・・・。

具体的にはAPIのURLを入力して進めようとすると、以下エラーが表示されるんです。

ホワイトリスト???

半日ほど調べたのですが、見つけられず。
今回もサポートを頼らせて頂きました。

特に急ぎでなかったので、"優先度：低"で送信したのですが、なんと1時間ほどで連絡が。

「Volt Configuraton Settings (VoltConfig.nsf) の以下の設定でサービスの Whitelist を設定します。」

すっかりこのDBのことを忘れてました。

実際には、以下コンフィグデータベースを開き、

以下、「servicesWhitelist.enabled」を編集します。

変更する場所は2か所

まず最初のラジオボタンを[Enable Setting]に切り替えます。

続いて、最下部の Setting Value を[false]に書き換えて保存します。

すると、先のエラーはなくなり、以下のようにサンプルの応答(JSON)に結果が表示されました。

今回はあらゆるサイトに対しての許可を与えることとなっていますが、接続可能な先も制御できるようです・・・さすがDomino!

サポートからの案内文は以下となりますので、参考まで・・・。

このあたりの情報も、なんとか日本語で検索できればいいのですが。

ということで、ここまでくれば、フィールドの割り当てなどを設定すれば、RESTで取得したデータをVoltアプリに取り込むことが可能になります。

しかもノーコードで!!

APIはいろいろと公開されていますので、社内で利用可能なものも手軽に作れるのではないでしょうか。

ということで、このような内容を12月8日に発表させて頂きますので、ぜひご視聴ください!!

14分で掲示板

 Recently, a variety of technical information is being distributed via video.

Although I am late I thought I would try my hand at sending out some information myself.

This time, I will show you a simple video of how to create a simple bulletin board from scratch using Notes/Domino.

Please take a look if you like.

みなさま、こんにちは。

ことしも残すところ2か月ほど。
早いですねー。

少し振り返ってみたのですが、今年は #ノーツコンソーシアム ( #notescons )の活動、がんばったかなと感じております。

●大阪研究会・・・悪だくみの会含め、いろんな情報交換ができました。新しい出会いも!!
●新教育講座・・・大阪研発。LotusScript入門講座。大成功とはいきませんでしたが、満足してよい結果になったと思います。
●ユーザー情報交換会・・・数年ぶりのオンサイト(浜松)開催。貴重な情報交換ができました。

さらにはこの12月に #HCLAmbassador 主催のイベントが企画されております。

DominoHub 2022

テーマは【Link to Domino】
システム間のつながりにフォーカスし、Notes/Dominoの役割、可能性を探る機会になればと思います。

さて今回は少し違う趣向で記事を書いてみました。

といいますのも、昨今さまざまな情報が動画配信され、その利便性の幅を広げています。

我々もその手を使うべきではとの思いから、まずは手始めとしてローコード開発ツールの老舗であるNotes/Dominoの簡単な開発画面を一発撮りでトライしてみました。

今回トライしたのはごく簡単な掲示板(タイトルとカテゴリと内容のみ)になります。
デザインも無視して、まずはノーツアプリの作成とはどんなものかというものを見て頂く機会になれば幸いです。

ちなみに目標15分と考えていましたが、ギリギリ14分を切って仕上げることができました!!

ぜひご覧ください。

※申し訳ありません、YouTubeのアカウントを変更しましたので、動画を貼り換えました(2022/11/04)

#OnTime なぜか特定ユーザーが常時表示される・・・

 This is another OnTime story.

I am happy to report that I have realized how faithfully OnTime Group Calendar reproduces Domino's calendar functionality.

みなさま、こんにちは。

今回もまずは告知から・・・

以前も案内しましたが、今年のユーザー情報交換会、改め「みんなで情報交歓会」まで約1カ月となりました。
会場宿泊の締め切りが今週になりますので、ぜひお早目にお申込みください。

今回もOnTimeで気づいたことを報告させて頂きます。

・・・決してメーカーの廻し者ではございませんので、悪しからず・・・

先日より本番で利用していたのですが、当初から利用していてずっと気になっていたことがあります。

というのは、私のカレンダーに特定のユーザーが常に表示されているんです。

こんな感じ・・・

こちらは会議室のみを選択した状態なのですが、2行目にそのユーザーのスケジュールが表示されているのです。

当初、同一部署のものは常時表示かと感じていたのですが、所属を別アプリから参照するよう変更したため、それは違うと判断しました。

ではこれはいったい・・・?

といったところでひとつ思い出しました。

ノーツのデフォルトカレンダーでこのユーザーのカレンダーをオーバーレイしていたのです。

やはり疑わしい・・・

ということでこのチェックを外して、OnTime Clientを更新してみました。

正解!!

無事消えました。

ちなみにほかにもオーバーレイしてあるカレンダーがありますが、外部のGoogleカレンダーなどは反映対象外でした。

Dominoディレクトリのみが対象となるようです。
(Office365も表示できるようになった?)

これで思う表示にすることができました。

こちらの機能を逆にうまく使うと、例えば秘書さんがご自身の担当者を常時表示するようなことが可能になるのかと思います。

奥深いですね。

ちなみに別件で、またサポートの方へご迷惑をお掛けしてしまいました(汗
こちらはWebexMeetingとの紐づけ作業になります。
Global Settingにわかりやすく[Online Meetings]という項目がありますので、ささっとこちらを登録して、

新規の会議で「オンライン会議」が追加されているのを確認して、[作成]をクリックします。

すると以下のような画面が表示され、

またこれとは別にブラウザが起動してWebexへのサインインが求められます。

すると・・・

うーん。
そのほかに設定項目を探しますが、まったく見つからずサポートへ。

そのスタート時に、「マニュアル読みましたか?」との質問。

あ゛っ

またやってしまいました。
FAQを検索はしたのですが、マニュアルを読んでない・・・orz

なんて初歩的な。

要はGlobal Settingに設定する値は、ログインの情報ではなく、Webex Appへの接続情報が必要でした。

・・・詳しくはマニュアルをご参照ください・・・
私が言える立場ではありませんが(大汗

ということで、無事接続でき、利用が可能になりました。

まだやりたいことがあるので、随時報告致します。

#年月日 で日付表示したい

In this article, I will describe the date display format specific to Japan.

English translation is not necessary.

みなさま、こんにちは。

あまり意識したことがなかったのですが、Notesの日付の表示形式について、今更気づいたことがありましたので、書き留めておきます。

・・・そんなこと知ってるよ・・・って言われる方もいらっしゃるとは思いますが、20年利用してきて初見でしたので・・・

さてNotesフィールドの日付の形式で準備されているものは、デフォルトでは以下となっています。

まあ、見慣れたダイアログですね。
選択できる形式としては、

となります。

上記で設定した場合の表示結果は、上から

2022 / 09 / 08 (木)

2022 / 09 / 08

09 / 08 (木)

2022 / 09 

09 / 08

2022

となります。

今回、はじめて表示形式を上の例ですと、"2022年09月08日"にしてほしいという案件が発生しました。

ちなみにExcelだと一部だけですが、以下となります。

どうすれば表示できるのでしょう?

先のダイアログを少しつつくと簡単に対応することができました。

まず上部の[ユーザープリファレンス]を[カスタム]に変更します。

・・・このユーザープリファレンスという言葉が少しわかりにくいと感じました・・・

するとダイアログの項目が以下のように、非表示であった項目が表示されました。

ここの[セパレータ]を利用することで実現可能となります。

実際に年月日表示とするには、

こうすることで、フィールドの結果は以下のようになります。

簡単ですね。
たとえば子供用にひらがなにもできるのでは・・・と試したところ、

怒られてしまいました。

1文字に限定されているようですね。

こんな表示はOKでした(笑

すいません、お茶を濁したようなネタになってしまいましたが、たまたま出くわした内容としてレポート致します。

既出でしたら申し訳ございません。

#OnTime 公開グループの設定および リソースの変更と #Domino #Directory の動きについて

 We are pleased to announce that the OnTime Group Calendar has been successfully adopted!

We will set up the public groups as soon as possible.

In the midst of all this, I had an unexpected problem, so here is my report.

みなさま、こんにちは。
さて先週テスト中と報告しましたOnTimeグループカレンダーですが、無事採用が決まりました!!

そこで社内正式リリースに向け、まずは公開グループの設定を進める必要があります。

弊社の場合、社員数も会議室もそれほど多くないことから、当初はStatic Groupで準備をしていました。
設定としては以下のように感じです。

Domino Directoryに登録されたグループをそのままOnTime のグループとして設定するイメージです。

これで十分かと考えていたのですが、サポートの方からはぜひDynamic Groupを利用して、管理工数を下げて欲しいとの提案を頂きました。

具体的には、DJXの部署で動的グループを作るというものです。

手順としては、以下マニュアルに加え、口頭で説明頂きながら設定を実施しました。

https://www2.ontimesuite.jp/djxdepartments/

追加後、メニューから[Admin - Groups Dynamic only]を実施すると、リストにグループが表示されます。

この状態でOnTime Clientを開くと(既に開いていた場合は、[Shift + F9]で更新)、以下のようにグループが反映され、利用可能になっています。

便利ですねー。
何が便利かというと、使い慣れたノーツ式で定義できる点にあります。

さてこちらで進めようかと考えていたのですが、どうも弊社内のDomino Directoryの階層や兼任部署の影響から、少し見にくいグループになってしまいました。
当初は思い切って全社員の所属階層を見直そうかと考えたのですが、その際に教えて頂いたのが、アドレス帳以外のノーツDBから動的をグループを作成するという手順です。

既にマニュアルも整備させておりました。

https://www2.ontimesuite.jp/usingotherdatabase/

たまたま弊社では今年度から「社員カード」というアプリの利用を開始しておりました。

社員カードアプリについて、ここでは詳しく触れませんが、ご興味ございましたら、ご連絡ください。
フォームの内容としては以下のようなものになります。
※この下にも個人の情報や人事情報を記載しており、読者権限で制御しています。

こちらを使えば、綺麗にグループ化されるのでは・・・ということで、こちらの改修について教えて頂きました。

具体的に修正すべき点としては、OnTimeがユニークキーとして判断する[Canonical Name]を追加するというものでした。

特に難しいものではありませんでしたので、ささっと修正して、OnTimeの設定です。
マニュアル通りなのですが、以下のような設定となりました。
※ビューは専用で参照するビューを追加しました。

[Admin - Groups Dynamic only]を実施すると、Listに一覧が表示され、

OnTime Clientにも綺麗に反映されました。

次に会議室とリソースです。
弊社ではひとつのサイトのみで運用しており、リソースの名前で拠点を示すような使い方をしていました。
もちろんそちらでも運用は可能ですが、今回導入した目的のひとつがリアルタイムの会議室の状況確認でした。

こちらもStaticで作ってしまうのもいいのですが、やはり先々のメンテナンスを考え、Dynamicを利用することとしました。

こちらもマニュアルが整っております。

https://www2.ontimesuite.jp/resourcesdb/

[Admin - Groups Dynamic only]を実行すると、Listが更新され、OnTime Clientに表示されました。

しかしながらサイトが一つですと、その中にすべての拠点の会議室やリソースまで混じって表示されてしまいます。

これではあまりに使いにくい・・・ということで、サイトを拠点別に分割し、さらに会議室とリソース(備品)を分けることとしました。

サイトを追加し、リソースの名前を変更します。
Dominoサーバーで adminpプロセスを実行することで、名前の変更が反映されます。

先のOnTime側の設定は変更不要のため、[Admin - Groups Dynamic only]を実施したところ、もともとあったサイト含め、すべて消えてしまいました!!

どういう事!!?

本現象は金曜の午後に発生したため、一度夜間のメンテナンスを待ってみようと翌朝まで待ったのですが、変化ありませんでした。

致し方なくサポートへメールしたところ、土曜日にも関わらず、早々にお返事が頂けました。

こちらはDomino側の問題との事で、参考資料として以下を紹介して頂きました。

https://www.docswell.com/s/okamomoba/KPX37Z-2022-05-12-151743

なんとなくわかったような・・・

ということで、まずはOnTimeのUsersにリストされているか確認しました。
すると・・・なんとすべて [Soft Deleted]になっています。
こちらは先日にも一度確認しており、対象のリソースがなくなった場合、一時的に削除されるようです。

次に疑ったのが、Domino ディレクトリでした。
メール受信データベースには正しくリストされています。

それではOnTime Usersグループは・・・

そう、ここに問題がありました。

システム管理要求でリソースの名前変更を実施したのですが、このグループ文書が更新されていませんでした。
つまり古いサイトの情報が残っていたのです。

古いリソースを削除し、新しいリソースを追加して、改めて[Admin - Groups Dynamic only]を実施したところ・・・。

表示が戻って参りました。
Soft Deletedからも消えています。

Dynamic Listも、OnTime Clientも思う結果が得られました。

以上で公開グループが思うように完成しました。

今回のトラブルは今後も意識する必要がありますが、基本的にはグループの更新は自動化され、メンテナンスフリーが実現できました。

ということで、今回の改善要求をIdeaサイトに投稿しましたので、ご賛同頂けます方は投票をお願いします!!

https://domino-ideas.hcltechsw.com/ideas/DOMINO-I-2200

つたない英文ですが、要はシステム管理要求の処理に、グループ文書も更新対象にしてほしいというだけのものです。

今後は、写真などメンテナンスして、さらに使いやすい環境にしていきたいと思います。

ノーツクライアント上での #OnTime グループカレンダーの挙動について

This time I have tested the OnTime group calendar.

I was annoyed by the iNotes login screen that was not supposed to appear...or rather, my own misconfiguration that caused confusion for the support staff.

みなさま、こんにちは。
さてまずは告知から・・・

●ノーツコンソーシアム　第三回大阪研究会

アジェンダ(予定)
・HCLタイム
・NOTES er が Basic Notes にムチ打って、無理させた件
・大阪研サーバーのメールセキュリティ対策
・ほんとにあった怖いNotesアプリの設計
・欲求の4タイプでわかるあなたと他人
・HCL Nomadアプリ開発(仮)

大阪研のカラーが満喫できる半日になるはず。
現地に関わらず、リモート参加も大歓迎です。
コンソーシアム会員にかかわらず、ゲスト参加も大歓迎です。ぜひタイトルリンクよりお申込みください。