コラボフローの全ユーザー分の申請書情報やステータスを取得できるようになりました！

こんにちは、テクニカルサポートの宮本です。

API Profile という形でコラボフローからデータを取得できるコネクタを提供していますが、ETL/ELT ツールの CDataSync でコラボフローコネクタを利用されているユーザーさまから「全ユーザーの申請書情報やステータス情報を取得したいんだけどどう指定したらよいか？」と問合せを受け、実はリストで全員分の申請情報を取得できる API がなかったのですが（2022年1月時点）それらの情報を一気に取得できる機能をこの度 CData API Profile に追加しました！

ではさっそく見ていきましょう。

追加したビュー

今回の対応ではビューを３つ追加しました。

前提として、上記ビューにアクセスする際はコラボフローのAPIKeyを使用しますので予めご準備ください。

それでは各々のビューについて解説していきます。

AllStatus ビュー

これまでは MyStatus ビューにて自分のステータス情報のみ取得できたのですが、追加した AllStatus ビューは Users ビューをもとに全メンバーのユーザーIDを取得し、その結果をもとに Status 情報を取得するような動きになっています。

登録されているユーザー情報です。

この全ユーザーが申請している書類を取得する場合は、AllStatus をただ全検索するだけになり、

select * from AllStatus

このように複数メンバーの申請書ステータス情報を取得できるようなりました。

なお、何人かのユーザーを限定して取得したい場合は、変則的ですが以下のような条件文で指定することで取得可能です。

select * from AllStatus where userids ='cdata-sales,cdata1' 

指定方法は、
userids ='ユーザーID,xxxxxx'
という形式になります。

ちなみに userids という項目は、検索条件指定時のみに使用できる隠し項目ですので実行結果には表示されません。

AllDocumentOverview ビュー

申請書の概要もこれまでは DocumentOverview で取得できたものの、ユーザー縛りという制約がありましたが、AllDocumentOverview で全メンバー分の申請書概要情報を取得できるようなりました。

select * from AllDocumentOverview

これで全ユーザーの申請書の概要情報を取得できるようになっています。

なお、申請書類の指定も可能です。

select * from AllDocumentOverview where DocumentId IN ('2','4')

AllDocumentContents ビュー

取得するデータは申請書の詳細情報になりますが、こちらも AllDocumentOverview と同じ動きになります。

select * from AllDocumentContents

これで、全ユーザーの申請書詳細情報を取得できます。

ドキュメントIDを指定することも可能です。

select * from AllDocumentContents where DocumentId  IN ('2','4')

以上、追加ビューの紹介でした！

最新版のコラボフローコネクタ

CData の Webサイトからはまだ最新ビルドは取得できないので、お試しされたい方は CData テクニカルサポートにお問合せください。
CData Software Japan - Technical Support

おわりに

いかがでしたでしょうか。これで1回1回ユーザー情報を変更して API リクエストする必要もなく、ワンアクションでメンバーの申請情報を一気に取得したり、外部DBに連携することが可能となりました。
コラボフローコネクタ（ドライバー）は JDBC をはじめ、ODBC、ADO、 CDataSync、APIServer など色々な製品でご利用いただけます。
どちらも 30 日間無償トライアルが可能ですので、是非お試しください。

www.cdata.com

関連コンテンツ