Download free for 30 days
Sign in
Upload
Language (EN)
Support
Business
Mobile
Social Media
Marketing
Technology
Art & Photos
Career
Design
Education
Presentations & Public Speaking
Government & Nonprofit
Healthcare
Internet
Law
Leadership & Management
Automotive
Engineering
Software
Recruiting & HR
Retail
Sales
Services
Science
Small Business & Entrepreneurship
Food
Environment
Economy & Finance
Data & Analytics
Investor Relations
Sports
Spiritual
News & Politics
Travel
Self Improvement
Real Estate
Entertainment & Humor
Health & Medicine
Devices & Hardware
Lifestyle
Change Language
Language
English
Español
Português
Français
Deutsche
Cancel
Save
Submit search
EN
SJ
Uploaded by
Software Info HCL Japan
2,486 views
HCL Domino REST API 利用ガイド
HCL Domino サーバーには、データベースに対してREST API でアクセスできる機能を提供しています。その利用方法についてのガイドです。
Software
◦
Read more
0
Save
Share
Embed
Embed presentation
Download
Download to read offline
1
/ 42
2
/ 42
3
/ 42
4
/ 42
5
/ 42
6
/ 42
7
/ 42
8
/ 42
9
/ 42
Most read
10
/ 42
Most read
11
/ 42
12
/ 42
13
/ 42
14
/ 42
15
/ 42
16
/ 42
17
/ 42
18
/ 42
19
/ 42
20
/ 42
Most read
21
/ 42
22
/ 42
23
/ 42
24
/ 42
25
/ 42
26
/ 42
27
/ 42
28
/ 42
29
/ 42
30
/ 42
31
/ 42
32
/ 42
33
/ 42
34
/ 42
35
/ 42
36
/ 42
37
/ 42
38
/ 42
39
/ 42
40
/ 42
41
/ 42
42
/ 42
More Related Content
PDF
今日から始める LotusScript - Domino クラスライブラリの使い方(Version 1.1)
by
Takeshi Yoshida
PDF
ノーツアプリケーション開発 Hint & tips 101連発
by
Takeshi Yoshida
PPTX
Dominoアクセスサービスを使用したRESTサービスのプレイブック
by
Mitsuru Katoh
PDF
今日から始める LotusScript - Domino クラスライブラリの使い方
by
Takeshi Yoshida
PDF
Vacuum徹底解説
by
Masahiko Sawada
KEY
XPages 開発 Tips 百連発
by
Mitsuru Katoh
PDF
Domino Server Health - Monitoring and Managing
by
Gabriella Davis
PDF
HTTPを理解する
by
IIJ
今日から始める LotusScript - Domino クラスライブラリの使い方(Version 1.1)
by
Takeshi Yoshida
ノーツアプリケーション開発 Hint & tips 101連発
by
Takeshi Yoshida
Dominoアクセスサービスを使用したRESTサービスのプレイブック
by
Mitsuru Katoh
今日から始める LotusScript - Domino クラスライブラリの使い方
by
Takeshi Yoshida
Vacuum徹底解説
by
Masahiko Sawada
XPages 開発 Tips 百連発
by
Mitsuru Katoh
Domino Server Health - Monitoring and Managing
by
Gabriella Davis
HTTPを理解する
by
IIJ
What's hot
PDF
Notes/Domino アプリがそのまま Web ブラウザで動く HCL Nomad Web の簡単な導入と「仕掛け」
by
Software Info HCL Japan
PPTX
Notes/Domino のシステム管理プロセスとは?
by
toshihiro okamoto
PDF
Domino Adminblast
by
Gabriella Davis
PDF
Dockerの期待と現実~Docker都市伝説はなぜ生まれるのか~
by
Masahito Zembutsu
PDF
HCL Domino エージェントとトラブルシューティング
by
Software Info HCL Japan
PDF
Dynatrace が特別な7つの理由
by
Harry Hiyoshi
PPTX
Kubernetes環境に対する性能試験(Kubernetes Novice Tokyo #2 発表資料)
by
NTT DATA Technology & Innovation
PDF
OSSを活用したIaCの実現
by
Trainocate Japan, Ltd.
PDF
How to use the new Domino Query Language
by
Tim Davis
PPTX
クラウドでも非機能要求グレードは必要だよね
by
YoshioSawada
PDF
Dapr × Kubernetes ではじめるポータブルなマイクロサービス(CloudNative Days Tokyo 2020講演資料)
by
NTT DATA Technology & Innovation
PDF
Always on 可用性グループ 構築時のポイント
by
Masayuki Ozawa
PDF
RHEL7/CentOS7 NetworkManager徹底入門
by
Etsuji Nakai
PDF
Fluentdのお勧めシステム構成パターン
by
Kentaro Yoshida
PDF
今だからこそ知りたい Docker Compose/Swarm 入門
by
Masahito Zembutsu
PDF
DDDのモデリングとは何なのか、 そしてどうコードに落とすのか
by
Koichiro Matsuoka
PDF
svn 능력자를 위한 git 개념 가이드
by
Insub Lee
PDF
DevOps avec Ansible et Docker
by
Stephane Manciot
PPTX
DeClang 誕生!Clang ベースのハッキング対策コンパイラ【DeNA TechCon 2020 ライブ配信】
by
DeNA
PDF
Linux KVMではじめるカンタン仮想化入門
by
VirtualTech Japan Inc.
Notes/Domino アプリがそのまま Web ブラウザで動く HCL Nomad Web の簡単な導入と「仕掛け」
by
Software Info HCL Japan
Notes/Domino のシステム管理プロセスとは?
by
toshihiro okamoto
Domino Adminblast
by
Gabriella Davis
Dockerの期待と現実~Docker都市伝説はなぜ生まれるのか~
by
Masahito Zembutsu
HCL Domino エージェントとトラブルシューティング
by
Software Info HCL Japan
Dynatrace が特別な7つの理由
by
Harry Hiyoshi
Kubernetes環境に対する性能試験(Kubernetes Novice Tokyo #2 発表資料)
by
NTT DATA Technology & Innovation
OSSを活用したIaCの実現
by
Trainocate Japan, Ltd.
How to use the new Domino Query Language
by
Tim Davis
クラウドでも非機能要求グレードは必要だよね
by
YoshioSawada
Dapr × Kubernetes ではじめるポータブルなマイクロサービス(CloudNative Days Tokyo 2020講演資料)
by
NTT DATA Technology & Innovation
Always on 可用性グループ 構築時のポイント
by
Masayuki Ozawa
RHEL7/CentOS7 NetworkManager徹底入門
by
Etsuji Nakai
Fluentdのお勧めシステム構成パターン
by
Kentaro Yoshida
今だからこそ知りたい Docker Compose/Swarm 入門
by
Masahito Zembutsu
DDDのモデリングとは何なのか、 そしてどうコードに落とすのか
by
Koichiro Matsuoka
svn 능력자를 위한 git 개념 가이드
by
Insub Lee
DevOps avec Ansible et Docker
by
Stephane Manciot
DeClang 誕生!Clang ベースのハッキング対策コンパイラ【DeNA TechCon 2020 ライブ配信】
by
DeNA
Linux KVMではじめるカンタン仮想化入門
by
VirtualTech Japan Inc.
Similar to HCL Domino REST API 利用ガイド
PDF
XPagesでRESTを使ってみよう
by
Masahiko Miyo
PPTX
クラウドサービスとの連携で Notes/Domino の新しい活用方法を考えてみませんか
by
Takeshi Yoshida
PPTX
Domino & REST
by
賢次 海老原
PPTX
XPagesDay2014 [B-3] XPagesでRESTを使ってみたら、こんなんだったPartⅡ
by
Masahiko Miyo
PDF
HCL Domino ライセンスガイド (Ver. 1.7、2024年6月26日版)
by
Software Info HCL Japan
PDF
IBM Notes/Domino and IBM Bluemix
by
Atsushi Sato
PDF
XPagesDay 2015 RESTの総復習
by
Masahiko Miyo
PDF
XPagesでRESTを使ってみたら、こんなんだった
by
Masahiko Miyo
PPTX
Mobile Application Development by XPages
by
Atsushi Sato
PPTX
Domino Query Language (DQL)
by
Haruyuki Nakano
PPTX
20120822_dstn技術交流会_dstnのご紹介と最新技術情報
by
dstn
PDF
テクてく Lotus 技術者夜会 03/16 Lotus Notes/Domino Upgrade Pack とは
by
Hiroaki Komine
PPTX
ノンコーディング・超高速のApi 開発・運用基盤「cdata api server」のご紹介
by
CData Software Japan
PDF
XPages Day2015 実践 XPages on Bluemix
by
賢次 海老原
PDF
Why Don't You Start XPages Application Development?
by
Atsushi Sato
PPT
Apexコアデベロッパーセミナー070726 配布用
by
stomita
PDF
REST API マスターへの道 - Office 365 パワーユーザー向け
by
Hirofumi Ota
PDF
Spring12新機能webinar
by
Salesforce Developers Japan
PDF
What's new of XPages in 2015 and beyond
by
Atsushi Sato
PPTX
Salesforceのソースエンドポイントとしての利用
by
QlikPresalesJapan
XPagesでRESTを使ってみよう
by
Masahiko Miyo
クラウドサービスとの連携で Notes/Domino の新しい活用方法を考えてみませんか
by
Takeshi Yoshida
Domino & REST
by
賢次 海老原
XPagesDay2014 [B-3] XPagesでRESTを使ってみたら、こんなんだったPartⅡ
by
Masahiko Miyo
HCL Domino ライセンスガイド (Ver. 1.7、2024年6月26日版)
by
Software Info HCL Japan
IBM Notes/Domino and IBM Bluemix
by
Atsushi Sato
XPagesDay 2015 RESTの総復習
by
Masahiko Miyo
XPagesでRESTを使ってみたら、こんなんだった
by
Masahiko Miyo
Mobile Application Development by XPages
by
Atsushi Sato
Domino Query Language (DQL)
by
Haruyuki Nakano
20120822_dstn技術交流会_dstnのご紹介と最新技術情報
by
dstn
テクてく Lotus 技術者夜会 03/16 Lotus Notes/Domino Upgrade Pack とは
by
Hiroaki Komine
ノンコーディング・超高速のApi 開発・運用基盤「cdata api server」のご紹介
by
CData Software Japan
XPages Day2015 実践 XPages on Bluemix
by
賢次 海老原
Why Don't You Start XPages Application Development?
by
Atsushi Sato
Apexコアデベロッパーセミナー070726 配布用
by
stomita
REST API マスターへの道 - Office 365 パワーユーザー向け
by
Hirofumi Ota
Spring12新機能webinar
by
Salesforce Developers Japan
What's new of XPages in 2015 and beyond
by
Atsushi Sato
Salesforceのソースエンドポイントとしての利用
by
QlikPresalesJapan
More from Software Info HCL Japan
PDF
HCL Sametime V12 概要
by
Software Info HCL Japan
PDF
HCL Nomad Web Sandbox アプリケーション検証手順-20230727.pdf
by
Software Info HCL Japan
PDF
すぐわかる HCL Domino Leap
by
Software Info HCL Japan
PDF
HCL Domino Leap 概要
by
Software Info HCL Japan
PDF
すぐわかる HCL Nomad
by
Software Info HCL Japan
PDF
Notes/Domino V9.0, V10 ご利用中のお客様へ営業活動終了 & サポート終了予定のご案内と V12 および HCL Nomad のご紹介
by
Software Info HCL Japan
PDF
Sametimev12説明資料_20220518.pdf
by
Software Info HCL Japan
PDF
HCL Software 概要
by
Software Info HCL Japan
PDF
HCL Unica 製品カタログ
by
Software Info HCL Japan
PDF
BigFix とAppScan による組織全体でのLog4j 脆弱性問題への対応
by
Software Info HCL Japan
PDF
HCL Nomad Mobile のご紹介 (2022年2月)
by
Software Info HCL Japan
PDF
Notes/Domino CCB サブスクリプションでここまで使える!!
by
Software Info HCL Japan
PDF
HCL Connections: ビジネスの原動力は人であり、Connectionsは人に力を与えます
by
Software Info HCL Japan
PDF
HCL Connections: Connected, Committed and Collaborative: 従業員の積極的な参加が成功をもたらす方法
by
Software Info HCL Japan
PDF
HCL Nomad Mobile のご紹介
by
Software Info HCL Japan
PDF
HCL Software メインフレーム ソフトウェアのご提案
by
Software Info HCL Japan
PDF
Notes/Domino 9.0.x および V10 のサポートに関する更新情報について
by
Software Info HCL Japan
PDF
HCL AppScan 10 のご紹介
by
Software Info HCL Japan
PDF
iPhone のズーム機能による HCL Nomad 画面の拡大
by
Software Info HCL Japan
PDF
HCL Domino Volt - お得なアドオン・サブスクリプション
by
Software Info HCL Japan
HCL Sametime V12 概要
by
Software Info HCL Japan
HCL Nomad Web Sandbox アプリケーション検証手順-20230727.pdf
by
Software Info HCL Japan
すぐわかる HCL Domino Leap
by
Software Info HCL Japan
HCL Domino Leap 概要
by
Software Info HCL Japan
すぐわかる HCL Nomad
by
Software Info HCL Japan
Notes/Domino V9.0, V10 ご利用中のお客様へ営業活動終了 & サポート終了予定のご案内と V12 および HCL Nomad のご紹介
by
Software Info HCL Japan
Sametimev12説明資料_20220518.pdf
by
Software Info HCL Japan
HCL Software 概要
by
Software Info HCL Japan
HCL Unica 製品カタログ
by
Software Info HCL Japan
BigFix とAppScan による組織全体でのLog4j 脆弱性問題への対応
by
Software Info HCL Japan
HCL Nomad Mobile のご紹介 (2022年2月)
by
Software Info HCL Japan
Notes/Domino CCB サブスクリプションでここまで使える!!
by
Software Info HCL Japan
HCL Connections: ビジネスの原動力は人であり、Connectionsは人に力を与えます
by
Software Info HCL Japan
HCL Connections: Connected, Committed and Collaborative: 従業員の積極的な参加が成功をもたらす方法
by
Software Info HCL Japan
HCL Nomad Mobile のご紹介
by
Software Info HCL Japan
HCL Software メインフレーム ソフトウェアのご提案
by
Software Info HCL Japan
Notes/Domino 9.0.x および V10 のサポートに関する更新情報について
by
Software Info HCL Japan
HCL AppScan 10 のご紹介
by
Software Info HCL Japan
iPhone のズーム機能による HCL Nomad 画面の拡大
by
Software Info HCL Japan
HCL Domino Volt - お得なアドオン・サブスクリプション
by
Software Info HCL Japan
Recently uploaded
PDF
Gluesync:RDBMS、NoSQL,データレイク間のリアルタイム・データレプリケーション
by
株式会社クライム
PDF
Veeam&WasabiでトリプルV: クラウドへのランサムウエア対策の決定コンビ
by
株式会社クライム
PDF
20251122_OWASPNagoya_takei_ITU-T,X.1060,security
by
OWASP Nagoya
PPTX
JavaScript/TypeScript実力強化書 2章のアップデート Forkwell Library
by
Yoshiki Shibukawa
PDF
最高峰のストレージとバックアップ:ARTESCA+Veeam:統合型ソフトウェア
by
株式会社クライム
PDF
N2WS Backup & Recovery と Veeam Backup for AWS
by
株式会社クライム
Gluesync:RDBMS、NoSQL,データレイク間のリアルタイム・データレプリケーション
by
株式会社クライム
Veeam&WasabiでトリプルV: クラウドへのランサムウエア対策の決定コンビ
by
株式会社クライム
20251122_OWASPNagoya_takei_ITU-T,X.1060,security
by
OWASP Nagoya
JavaScript/TypeScript実力強化書 2章のアップデート Forkwell Library
by
Yoshiki Shibukawa
最高峰のストレージとバックアップ:ARTESCA+Veeam:統合型ソフトウェア
by
株式会社クライム
N2WS Backup & Recovery と Veeam Backup for AWS
by
株式会社クライム
HCL Domino REST API 利用ガイド
1.
Copyright © 2020
HCL Technologies Limited | www.hcltechsw.com HCL Domino - Domino REST API 利用ガイド Domino Access Service 利用ガイド 2020年 11月30日 株式会社エイチシーエル・ジャパン
2.
Copyright © 2020
HCL Technologies Limited | www.hcltechsw.com 2 当資料について 当資料の記載内容は、正式なHCL のテストやレビューを受けておりません。内容について、できる限り正 確を期すよう努めてはおりますが、いかなる明示または暗黙の保証も責任も負いかねます。本資料の情報 は、使用先の責任において使用されるべきものであること を、あらかじめご了承ください。 当資料は、資料作成時点で公開されている情報を元に作成しています。掲載情報は不定期 に変更されるこ ともあります。他のメディア等に無断で転載する事はご遠慮ください。
3.
Copyright © 2020
HCL Technologies Limited | www.hcltechsw.com 3 目次 1. Domino Access Services 概 要 2. Domino Access Services の構成 3. Domino Access Services の利用方法 参考情報
4.
1. Domino Access
services概要
5.
Copyright © 2020
HCL Technologies Limited | www.hcltechsw.com 5 REST API とは REST とは Representation State Transfer の略 Roy Thomas Fielding が提唱したソフトウェア・アーキテクチャー REST API とは REST に則った Web サービス API 大まかに以下の特徴を持ちます アドレス指定可能なURI でリソースにアクセスできる HTTP メソッドでアクセスする ステートレスである(セッションを保持しない)
6.
Copyright © 2020
HCL Technologies Limited | www.hcltechsw.com 6 Domino Access Services とは Domino Access Services(DAS) HCL Domino サーバー上のデータベースに対して REST API でのアクセスを提供する機能 以下の3つのサービスがある Domino Data Service JSON 形式でのデータベースへのアクセスを提供するサービス Domino Calendar Service JSON 形式と iCalendar 形式でのカレンダーデータへのアクセスを提供するサービス Domino Core Service Dominoサーバーでどの DAS サービスを提供しているか、パスワードの最終更新日などのデータベースに依 存しない情報を提供するサービス 9.0.1以降の Domino で利用可能 (Domino Data Service のみは Domino 8.5.3 Upgrade kit 1 以降で利用可能) HTTPタスクを実行する必要がある
7.
2. Domino Access
Servicesの構成
8.
Copyright © 2020
HCL Technologies Limited | www.hcltechsw.com 8 サーバーの設定 Domino Access ServicesはDominoサーバー文書で有効にします サーバー文書の[ インターネットプロトコル] - [ Domino Web Engine ] タブ(インターネットサイト文 書の場合は [ 設定 ]タブ)の一番下に「Dominoアクセスサービス」という項目があります 「有効なサービス」に Domino Data Service を有効にする場合は「データ」、DominoCalendar Service を有効にする場合は「カレンダー」、両方の場合は「データ、カレンダー」と入力します 設定変更後に HTTP タスクを再起動します
9.
Copyright © 2020
HCL Technologies Limited | www.hcltechsw.com 9 データベースの設定 実際にデータベースにアクセスするためには、各データベースに設定が必要です Notes クライアントでデータベースプロパティを開きます [ 詳細 ] タブ(一番右のタブ)の「Domino データサービスを許可」をビューと文書にアクセスしたい場合は 「ビューと文書」、ビューのみにアクセスする場合は「ビュー」に 変更します
10.
Copyright © 2020
HCL Technologies Limited | www.hcltechsw.com 10 ビュー の設定 ビューにアクセスするためには、各ビューに設定が必要です Domino Designer で Domino Data Service でアクセスしたいビューを開きます ビューのプロパティを開き、[ 詳細 ] タブの「Domino データサービスの操作を許可」にチェックして ビューを保存します 複数のビューを利用したい場合は、それぞれのビューで同様の操作を行います
11.
Copyright © 2020
HCL Technologies Limited | www.hcltechsw.com 11 Domino Calendar Service の設定 Domino Calendar Service を利用するためには、各メールデータベースに設定が必要です Domino Designer でメールデータベースのビュー「($CSAPIs)」を開きます。 ビューのプロパティを開き、[ 詳細 ] タブの「Domino データサービスの操作を許可」に チェックしてビューを保存します(前頁と手順は同じです) データベースプロパティ「IBMDomino データサービスを許可」の設定は不要です 多数のユーザーのメールデータベースで有効にする場合はメールテンプレートのビューの設計を変更 することをお勧めします Mail85.ntfにはビュー「($CSAPIs)」がないため、Domino 9.0.1 以降のサーバーで mail85.ntfを利用 している場合は、mail9.ntf など 9.0.1 以降のメールテンプレートからビューをコピーする必要があり ます
12.
3. Domino Access
Services の 使用方法
13.
Copyright © 2020
HCL Technologies Limited | www.hcltechsw.com 13 Domino Access Services の利用 この章ではDomino AccessServices のDomino Data Service と Domino Calendar Service で可能な代 表的な操作について説明します 利用可能なすべての操作やパラメーターなどについてはIBM Domino Access Services 9.0.1 のドキュ メントを参照してください https://ds- infolib.hcltechsw.com/ldd/ddwiki.nsf/xpAPIViewer.xsp?lookupName=IBM+Domino+Access+Services+9.0.1&a ction=openDocument&content=catcontent&ct=api 当資料ではテストツールとして cURL を利用した入出力サンプルを抜粋して掲載します Get メソッドは Web ブラウザからリクエストを発行できますが、通常は他のメソッドは Web ブラウ ザではリクエストを発行できないため、REST API のリクエストを発行するためには何らかのツール が必要です 具体的なツールはご紹介しませんが REST API のリクエストを発行できるGUI ベースのツ ールもあ ります
14.
Copyright © 2020
HCL Technologies Limited | www.hcltechsw.com 14 Domino Data Service の利用 Domino Data Service で利用可能な代表的な操作は以下のとおりです データベースコレクションに対する操作 サーバー上のデータベース一覧を取得する ビュー/フォルダーコレクションに対する操作 データベースのビュー/フォルダー一覧を取得する ビュー/フォルダーエントリに対する操作 ビュー/フォルダーのエントリを取得する 文書コレクションに対する操作 文書コレクションを取得する 文書を作成する 文書に対する操作 文書を取得する 文書を更新する 文書を削除する
15.
Copyright © 2020
HCL Technologies Limited | www.hcltechsw.com 15 Domino Data Service の利用 簡単な出力の読み方 Domino Data Service の出力結果には多くの場合以下のような情報が含まれます @Title データベースやビュー/フォルダーなどの名前 日本語は UTF-8 でエンコードされます @UNID ビュー/フォルダーや文書などの UNID @href データベースやビュー/フォルダーや文書などにDAS でアクセスするための URL 「/」は「¥」でエスケープされます
16.
Copyright © 2020
HCL Technologies Limited | www.hcltechsw.com 16 Domino Data Service の利用 サーバー上にあるデータベースを一覧する サーバー上にあるすべてのデータベースが JSON 形式で出力されます データベースプロパティの「Dominoアクセスサービスを許可」の設定によらずすべて のデータベースが結果に含まれます データベースへのアクセス権は不要ですがユーザー認証が必要です メソッド get /api/data 例: >curl -u ユーザー名:パスワード http://ホスト名/api/data 出力例: [ { "@title":"¥u30B7¥u30B9¥u30C6¥u30E0¥u7BA1¥u7406¥u8981¥u6C42", "@filepath":"admin4.nsf", "@replicaid":"492580A6031DA54D", “@template":"StdR4AdminRequests", "@href":"¥/admin4.nsf¥/api¥/data¥/collections" }, ~ 省 略 ~ ]
17.
Copyright © 2020
HCL Technologies Limited | www.hcltechsw.com 17 Domino Data Service の利用 データベースのビュー/フォルダーを一覧する データベースに存在するビュー/フォルダーの一覧が JSON 形式で出力されます 「Domino データサービスの操作を許可」を有効にしていないビュー/フォルダー も表示されます データベースへの適切なアクセス権が必要です メソッド get /ファイル名/api/data/collections 例: >curl -u ユーザー名:パスワード http://ホスト名/ファイル名/api/data/collections 出力例: [ { "@title":"¥u4F5C¥u6210¥u8005¥u5225", "@folder":false, "@private":false, "@modified":"2020-02-14T02:32:18Z", "@unid":"B86F19F9A1EED6794825751200200698", "@href":"¥/test1.nsf¥/api¥/data¥/collections¥/unid¥/B86F19F9A1EED6794825751200200698" }, ~ 省 略 ~ ]
18.
Copyright © 2020
HCL Technologies Limited | www.hcltechsw.com 18 Domino Data Service の利用 ビュー/フォルダーのエントリを取得する(1/2) 指定したビュー/フォルダーのエントリを JSON 形式で出力します 検索パラメーターを指定しない場合は最初の10エントリが出力されます 検索パラメーターの詳細についてはドキュメントの「View/folder entries GET」の項を 参照してくださ い https://ds_infolib.hcltechsw.com/ldd/ddwiki.nsf/xpAPIViewer.xsp?lookupName=IBM+Domino+Access+Servic es+9.0.1#action=openDocument&res_title=Viewfolder_entries_GET_dds10&content=apicontent 「search」キーワードを利用した検索を行うためにはデータベースに全文索引が作成されている必要が あります
19.
Copyright © 2020
HCL Technologies Limited | www.hcltechsw.com 19 Domino Data Service の利用 ビュー/フォルダーのエントリを取得する(2/2) メソッド get /api/data/collections/unid/ビューの UNID get /api/data/collections/name/ビュー名 検索パラメーターを指定する場合は get /api/data/collections/unid/ビューのUNID?start=1&count=3 のように「?」を付与します 例: >curl -u ユーザー名:パスワード http://ホスト名/api/data/collections/name/($All) 出力例: [ { "@href":"¥/test1.nsf¥/api¥/data¥/collections¥/name¥/($All)¥/unid¥/4C53DC3FB8FA9CED492581FB002576F3", "@link": { "rel":"document", "href":"¥/test1.nsf¥/api¥/data¥/documents¥/unid¥/4C53DC3FB8FA9CED492581FB002576F3" }, "@entryid":"1-4C53DC3FB8FA9CED492581FB002576F3", "@unid":"4C53DC3FB8FA9CED492581FB002576F3", ~ 省 略 ~ ]
20.
Copyright © 2020
HCL Technologies Limited | www.hcltechsw.com 20 Domino Data Service の利用 文書コレクションを取得する データベースに存在する文書のコレクションが JSON 形式で出力されます 検索パラメーターを指定しない場合データベースのすべての文書が出力されます 検索パラメーターは全文検索を行う「search」か更新日時を指定する「since」のどちら かが使用できます メソッド get /ファイル名/api/data/documents 例: >curl -u ユーザー名:パスワード http://ホスト名/ファイル名/api/data/documents 出力例: [ { "@modified":"2017-10-11T05:36:07Z", "@unid":"AD17CEEF1909941C492580C7000DF37D", "@href":"¥/test1.nsf¥/api¥/data¥/documents¥/unid¥/AD17CEEF1909941C492580C7000DF37D" }, ~ 省 略 ~ ]
21.
Copyright © 2020
HCL Technologies Limited | www.hcltechsw.com 21 Domino Data Service の利用 文書を作成する データベースに新規文書を作成します 新規文書のフィールド値は JSON 形式で指定します 「form=」パラメーターで文書が使用するフォームを指定できます 「computewithform=true」を指定することでフォームに基づいて計算を行うことができます 出力結果は HTTP ヘッダー「Location」の値として作成した新規文書にアクセスするため の URL が返ります メソッド post /ファイル名/api/data/documents 例: >curl -i -H “Content-type: application/json” -X POST -d “{¥”Subject¥“:¥”fromDDA¥“,¥”Body¥“:¥”Test¥“}” -u ユーザー名:パスワード http:// ホスト名/ファイル名/api/data/documents 出力例: HTTP/1.1 201 Created Server: Lotus-Domino Date: Mon, 15 Jan 2018 08:07:02 GMT Connection: close Set-Cookie: SessionID=87AB55482C49F3DEB545866D68204E8728F96AAD; path=/; HttpOnly Location: http://ホスト名/ファイル名/api/data/documents/unid/2EE6FAA0EBAA779149258216002C9639
22.
Copyright © 2020
HCL Technologies Limited | www.hcltechsw.com 22 Domino Data Service の利用 文書を取得する UNID で指定した文書をJSON 形式で出力します メソッド get /ファイル名/api/data/documents/unid/文書のUNID 例: >curl -u ユーザー名:パスワード http://ホスト名/ファイル名/api/data/documents/unid/34D1A45AB6AF2DBA4925820100215170 出力例: { "@href":"¥/test1.nsf¥/api¥/data¥/documents¥/unid¥/34D1A45AB6AF2DBA4925820100215170", "@unid":"34D1A45AB6AF2DBA4925820100215170", "@noteid":"91E", "@created":"2017-12-25T06:03:55Z", "@modified":"2017-12-25T06:03:55Z", ~ 省 略 ~ "ThreadId":"THAN-AUD95H", "MainID":"34D1A45AB6AF2DBA4925820100215170", "AbrFrom":"Admin", "NewsLetterSubject":"fromDDA", "Abstract":"Test", "Subject":"fromDDA" }
23.
Copyright © 2020
HCL Technologies Limited | www.hcltechsw.com 23 Domino Data Service の利用 文書を更新する UNID で指定した文書を更新します 更新するフィールドの値は JSON 形式で指定します PATCH メソッドでは JSON で指定したフィールドのみが変更され、指定しなかったフ ィールドの値は変更されません PUT メソッドでは JSON データですべてのフィールドが置き換えられます 「form=」パラメーターで文書が使用するフォームを指定できます 「computewithform=true」を指定することでフォームに基づいて計算を行うことができます メソッド patch /ファイル名/api/data/documents/unid/文書のUNID put /ファイル名/api/data/documents/unid/文書のUNID 例: >curl -i -H “Content-type: application/json” -X PATCH -d “{¥”Subject¥“:¥”fromDDA2¥“,¥”Body¥“:¥”Test2¥“}” -u ユーザー名:パスワード http://ホスト名/ファイル名 /api/data/documentsunid/2EE6FAA0EBAA779149258216002C9639 出力例: HTTP/1.1 200 OK Server: Lotus-Domino Date: Mon, 15 Jan 2018 08:43:16 GMT Connection: close Set-Cookie: SessionID=4CA5F917FC734282174ECBD8B3641334ABB5E1E2; path=/; HttpOnly Content-Type: application/json
24.
Copyright © 2020
HCL Technologies Limited | www.hcltechsw.com 24 Domino Data Service の利用 文書を削除する UNID で指定した文書を削除します メソッド delete /ファイル名/api/data/documents/unid/文書のUNID 例: >curl -i -H “Content-type: application/json” -X DELETE -u ユーザー名:パスワード http://ホスト名/ファイル名 /api/data/documentsunid/2EE6FAA0EBAA779149258216002C9639 出力例: HTTP/1.1 200 OK Server: Lotus-Domino Date: Mon, 15 Jan 2018 08:48:27 GMT Connection: close Set-Cookie: SessionID=C835204565533E3B7354D5A4BF4D9BDDA5BEE5F0; path=/; HttpOnly
25.
Copyright © 2020
HCL Technologies Limited | www.hcltechsw.com 25 Domino Data Service の利用 Domino Calendar Service で利用可能な代表的な操作は以下のとおりです Calendar に対する操作 ユーザーのカレンダーを取得する Calendar Event の一覧に対する操作 カレンダーイベントの一覧を取得する カレンダーイベントを追加する 個別のカレンダーイベントに対する操作 カレンダーイベントを取得する カレンダーイベントを更新する カレンダーイベントを削除する 会議召集に対する操作 新しい会議召集を取得する カレンダー通知に対する操作 カレンダー通知を取得する イベントに対する操作 イベントに返答する
26.
Copyright © 2020
HCL Technologies Limited | www.hcltechsw.com 26 Domino Calendar Service の利用 ユーザーのカレンダーを取得する(1/2) 認証ユーザーのカレンダーがJSON 形式で出力されます ユーザーのメール DB が返ります 出力結果には以下のような形式でそのユーザーのカレンダーイベントと会議召集にアクセスするための URL を含みます "links": [ { "rel":"events", “href”:“¥/mail¥/メールファイル名¥/api¥/calendar¥/events" }, { "rel":"invitations", “href”:“¥/mail¥/メールファイル名¥/api¥/calendar¥/invitations" } ]
27.
Copyright © 2020
HCL Technologies Limited | www.hcltechsw.com 27 Domino Calendar Service の利用 ユーザーのカレンダーを取得する(2/2) メソッド get /api/calendar 例: >curl –u ユーザー名:パスワード http://ホスト名/api/calendar 出力例: { "calendars":[ { "owner":{ "displayName":"Admin", ~省略~ }, "links": [ { "rel":"events", "href":"¥/mail¥/admin.nsf¥/api¥/calendar¥/events" }, { "rel":"invitations", "href":"¥/mail¥/admin.nsf¥/api¥/calendar¥/invitations" } ] } ] }
28.
Copyright © 2020
HCL Technologies Limited | www.hcltechsw.com 28 Domino Calendar Service の利用 カレンダーイベントの一覧を取得する(1/2) ユーザーのカレンダーイベントの一覧が JSON 形式か iCalendar 形式で出力されます iCalendar 形式で出力する場合はURL に「?format=icalendar」を付加します デフォルトではリクエストを発行した時間から1年後までのカレンダーイベントを最大50 個返します 詳細な検索パラメーターについては以下のドキュメントを参照してください https://www- 10.lotus.com/ldd/ddwiki.nsf/xpAPIViewer.xsp?lookupName=IBM+Domino+Access+Services+9.0. 1#action=openDocument&res_title=Calendar_events_GET&content=apicontent
29.
Copyright © 2020
HCL Technologies Limited | www.hcltechsw.com 29 Domino Calendar Service の利用 カレンダーイベントの一覧を取得する(2/2) メソッド get メールファイル名/api/calendar/events 例: >curl –u ユーザー名:パスワード http://ホスト名/メールファイル名/api/calendar 出力例: { "events": [ { "href":"¥/mail¥/admin.nsf¥/api¥/calendar¥/events¥/07569716C2C339B349258201002F3B48-Lotus_Notes_Generated", "id":"07569716C2C339B349258201002F3B48-Lotus_Notes_Generated", "summary":"Meeting1", "location":"¥u4F1A¥u8B70¥u5BA4", "start": { "date":"2017-12-26", "time":"08:45:00", "utc":true }, ~省略~ }
30.
Copyright © 2020
HCL Technologies Limited | www.hcltechsw.com 30 Domino Calendar Service の利用 カレンダーイベントを追加する(1/3) ユーザーのカレンダーに新しくカレンダーイベントを追加します イベントデータは JSON 形式か iCalendar 形式で送信します JSON 形式でデータを送信する場合は「Content-Type」ヘッダーに「application/json」を指定しま す iCalendar 形式でデータを送信する場合は「Content-Type」ヘッダーに「text/calendar」を指定しま す 出力として追加されたカレンダーイベントの情報が返ります HTTP ヘッダーの「Location」の値として追加したイベントにアクセスするためのURL が返ります
31.
Copyright © 2020
HCL Technologies Limited | www.hcltechsw.com 31 Domino Calendar Service の利用 カレンダーイベントを追加する(2/3) メソッド post メールファイル名/api/calendar/events 例: >curl -i -X POST -u ユーザー名:パスワード -H “Content-type: application/json” -d @calendar.txt http:/ホスト名/メールファイル/api/calendar/events 出力例: HTTP/1.1 201 Created Server: Lotus-Domino Date: Tue, 16 Jan 2018 04:53:23 GMT ~省略~ Content-Type: application/json Location: http://thanatos:80/mail/admin.nsf/api/calendar/events/040094F27E4944AE49258217001ADB8D-Lotus_Auto_Generated Content-Length: 701 { "events": [ { "href":"¥/mail¥/admin.nsf¥/api¥/calendar¥/events¥/040094F27E4944AE49258217001ADB8D-Lotus_Auto_Generated", "id":"040094F27E4944AE49258217001ADB8D-Lotus_Auto_Generated", ~省略~ ] }
32.
Copyright © 2020
HCL Technologies Limited | www.hcltechsw.com 32 Domino Calendar Service の利用 カレンダーイベントを追加する(3/3) ユーザーのカレンダーに新しくカレンダーイベントを追加します JSON 形式 JSON representation of an event https://www- 10.lotus.com/ldd/ddwiki.nsf/xpAPIViewer.xsp?lookupName=IBM+Domino+Access+Services+9.0.1#action=op enDocument&res_title=JSON_representation_of_an_event_das901&content=apicontentiCalendar iCalendar 形式 iCalendar representation of an event https://www- 10.lotus.com/ldd/ddwiki.nsf/xpAPIViewer.xsp?lookupName=IBM+Domino+Access+Services+9.0.1#action=op enDocument&res_title=iCalendar_representation_of_an_event_das901&content=apicontent
33.
Copyright © 2020
HCL Technologies Limited | www.hcltechsw.com 33 Domino Calendar Service の利用 カレンダーイベントを取得する(1/2) 指定した個別のカレンダーイベントがJSON 形式か iCalendar 形式で出力されます iCalendar 形式で出力する場合はURLに「?format=icalendar」を付加します イベントはイベントの一覧を取得した際などに“id” として出力される “07569716C2C339B349258201002F3B48-Lotus_Notes_Generated“ という形式で指定します
34.
Copyright © 2020
HCL Technologies Limited | www.hcltechsw.com 34 Domino Calendar Service の利用 カレンダーイベントを取得する(2/2) メソッド get メールファイル名/api/calendar/events/イベントのID 例: >curl –u ユーザー名:パスワード http://ホスト名/メールファイル名/api/calendar/events/07569716C2C339B349258201002F3B48- Lotus_Notes_Generated 出力例: { "timezones": [ { "tzid":"Tokyo Standard Time", "standard": { "start": { "date":"1950-01-01", "time":"02:00:00" }, "offsetFrom":"+0900", "offsetTo":"+0900" } } ], "events": [ { "href":"¥/mail¥/admin.nsf¥/api¥/calendar¥/events¥/354E3FBE73968E3D49258202001B37B5-Lotus_Notes_Generated", ~省略~
35.
Copyright © 2020
HCL Technologies Limited | www.hcltechsw.com 35 Domino Calendar Service の利用 カレンダーイベントを更新する(1/2) 指定した個別のカレンダーイベントを更新します イベントはイベントの一覧を取得した際などに“id” として出力される “07569716C2C339B349258201002F3B48-Lotus_Notes_Generated“ のような形式で指定します イベントデータは JSON 形式か iCalendar 形式で送信します JSON 形式でデータを送信する場合は「Content-Type」ヘッダーに「application/json」を指定しま す iCalendar 形式でデータを送信する場合は「Content-Type」ヘッダーに「text/calendar」を指定しま す カレンダーイベントの記述方法はP.32「カレンダーイベントを追加する(3/3)」と同様です
36.
Copyright © 2020
HCL Technologies Limited | www.hcltechsw.com 36 Domino Calendar Service の利用 カレンダーイベントを更新する(2/2) メソッド put メールファイル名/api/calendar/events/イベントのID 例: >curl -i -X PUT –u ユーザー名:パスワード -H “Content-type: application/json” -d@calendar2.txt http://ホスト名/メールファイル名 /api/calendar/events/040094F27E4944AE49258217001ADB8D-Lotus_Auto_Generated 出力例: HTTP/1.1 200 OK ~省略~ { "events": [ { "href":"¥/mail¥/admin.nsf¥/api¥/calendar¥/events¥/040094F27E4944AE49258217001ADB8D-Lotus_Auto_Generated", "id":"040094F27E4944AE49258217001ADB8D-Lotus_Auto_Generated", "summary":"Meeting2", "location":"Location2", "start": { "date":"2018-01-19", "time":"09:00:00", "utc":true }, "class":"public", ~省略~ ] }
37.
Copyright © 2020
HCL Technologies Limited | www.hcltechsw.com 37 Domino Calendar Service の利用 カレンダーイベントを削除する 指定した個別のカレンダーイベントを削除します イベントはイベントの一覧を取得した際などに“id” として出力される “07569716C2C339B349258201002F3B48-Lotus_Notes_Generated“ のような形式で指定します メソッド delete メールファイル名/api/calendar/events/イベントのID 例: >curl -i -X DELETE -u ユーザー名:パスワード http://ホスト名/メールファイル名 /api/calendar/events/040094F27E4944AE49258217001ADB8D-Lotus_Auto_Generated 出力例: HTTP/1.1 200 OK Server: Lotus-Domino Date: Tue, 16 Jan 2018 05:36:49 GMT Connection: close Set-Cookie: SessionID=4E712FC86F62D39F5FA1B75A0336D83C22BFC49A; path=/; HttpOnly
38.
Copyright © 2020
HCL Technologies Limited | www.hcltechsw.com 38 Domino Calendar Service の利用 新しい会議召集を取得する 返答していない会議召集の一覧を JSON 形式で出力します 検索パラメーターによって指定した日時以降に開催される会議や指定した日時以降に受 け取った会議招集を 出力することも可能です 出力には個々の会議召集にアクセスするためのURLを含みます メソッド get メールファイル名/api/calendar/invitations 例: >curl –u ユーザー名:パスワード http://ホスト名/メールファイル名/api/calendar/invitations 出力例: { "notices":[ { "summary":"¥u4F1A¥u8B702", "scheduleMethod":"request", "href":"¥/mail¥/admin.nsf¥/api¥/calendar¥/notices¥/354E3FBE73968E3D49258202001B37B5" } ] }
39.
Copyright © 2020
HCL Technologies Limited | www.hcltechsw.com 39 Domino Calendar Service の利用 カレンダー通知を取得する 指定したカレンダー通知の情報を JSON 形式または iCalendar 形式で出力します iCalendar 形式で出力する場合は URL に「?format=icalendar」を付加します カレンダー通知を指定するための ID は前ページの「新しい会議召集を取得する」ことで取得 できます メソッド get メールファイル名/api/calendar/notices/カレンダー通知のID 例: >curl –u ユーザー名:パスワード http://ホスト名/メールファイル名/api/calendar/notices/0EC6730258462ACB49258217001F3AF2 出力例: { “href”:“¥/メールファイル¥/api¥/calendar¥/notices¥/0EC6730258462ACB49258217001F3AF2", "scheduleMethod":"request", "timezones": [ { ~省略~ "events": [ { "id":"0EC6730258462ACB49258217001F3AF2-Lotus_Notes_Generated", "summary":"Meeting", "location":"Room1", ~省略~
40.
Copyright © 2020
HCL Technologies Limited | www.hcltechsw.com 40 Domino Calendar Service の利用 イベントに返答する 指定したイベント(会議召集など)に返答します 返答の内容は「?type=accept」のように検索パラメーターとして URL に付加します 「Content-Type」ヘッダーに「application/json」を指定する必要があります 「accept」などの返答をする場合はデータは不要ですが、日時の変更を提案する場合などは JSON形式でデータを送信し ます イベントを指定するための ID は前ページの「カレンダー通知を取得する」ことで取得できま す カレンダー通知の ID ではなく、取得した JSON に含まれる ”events” の ”id” を指定しま す メソッド put メールファイル名/api/calendar/notices/イベントのID/action 例: >curl -i -u ユーザー名:パスワード -X PUT http://ホスト名/メールファイル名/api/calendar/notices/0EC6730258462ACB49258217001F3AF2- Lotus_Notes_Generated/action?type=accept 出力例: HTTP/1.1 200 OK Server: Lotus-Domino Date: Tue, 16 Jan 2018 05:52:02 GMT Connection: close Set-Cookie: SessionID=D7D593CE8937BE9C84CD617157DC39980D24299D; path=/; HttpOnly
41.
参考情報
42.
Copyright © 2020
HCL Technologies Limited | www.hcltechsw.com 42 参考情報 IBM Domino Access Services 9.0.1のAPIドキュメント https://www- 10.lotus.com/ldd/ddwiki.nsf/xpAPIViewer.xsp?lookupName=IBM+Domino+Access+Services+9.0.1#action=openDocument&cont ent=catcontent&ct=ap のおつ -Notes/Dominoに関すること- https://guylocke.blogspot.com/2013/06/notesdomino-rest-api.html ITmedia https://www.atmarkit.co.jp/ait/articles/1304/22/news014.html まだプログラマーですが何か? http://dotnsf.blog.jp/archives/1023035172.html slideshare https://www.slideshare.net/kenjiebihara71/domino-rest
Download