AKATSUKA x HANEMAN TECH

My diary of cloud computing, Community, working strategy.

Claude Desktopからコラボフローの購入稟議を作成

前回の記事では、Claude Desktopからコラボフロー上の申請情報を集計・可視化・分析してみました。
今回はさらに進んでClaude Desktopとコラボフローを連携し、kintoneに登録した商品マスタから購入稟議を作成してみます。

コラボフローは誰にで使いやすいUIが魅力ですが、Claude DesktopのようなAIエージェントをUIに使用した場合にどのような体験が得られるでしょうか。

今回の構成

CData Connect AIはCopilot Studio、Gemini Enterpriseなどとも連携が可能そうですので、今回試したClaude DesktopだけでなくMicrosoft製品やGoogle製品で社内システムを構築している企業の方にも役立ちそうです。

Difyとは

Dify「/ˈdiːfiː/(ディフィー)」はノーコードで高度なAI/ML機能を駆使したAIエージェントの開発ができるAgentic AI開発プラットフォームです。
バージョン1.6からMCPサーバーの機能が統合され、さらに非エンジニアの方にとってAI活用のハードルが下がりました。

Difyの基本的な使用方法について知りたいときにはクレカ不要で登録可能な無料プラン初心者向けのチュートリアルも用意されていますので、気軽に試すこともできます。

その他今回の構成に含まれるClaude DesktopCData Connect AIの概要については過去の記事にまとまっています。こちらもぜひご参照ください。

手順

以下が今回実施した手順です。
細かく手順を分けてしまいましたが、やってみたら意外と簡単でしたので順を追ってみていきましょう。

  1. コラボフローREST APIの認証情報と稟議申請のJSONデータを用意する
  2. Dify上にコラボフローに稟議申請を追加する処理を追加
  3. 作成したDifyのワークフローを公開してMCPサーバーを有効化
  4. Claude DesktopからDifyの処理を呼び出せるように設定を追加
  5. CData Connect AIにコラボフローへの接続情報を追加
  6. CData Connect AIにkintoneへの接続情報を追加
  7. CData Connect AIとClaude Desktopを接続
  8. Claude Desktopに全体の手順を登録
  9. Claude Desktopからコラボフローに稟議申請を追加

始める前に

始める前に下準備としてkintoneのサンプルアプリにある「商品リスト」を追加して商品マスターを作成しておきましょう。

1 コラボフローREST APIの認証情報と稟議申請のJSONデータを用意する

 過去の記事を参考にコラボフローREST APIに送信する稟議申請の情報をJSON形式で作成します。

参考

{
  "processes_id": 35,
  "request_userid": "test",
  "request_group_code": "eigyouka",
  "action": "draft",
  "app_cd": 1,
  "title": "Difyからの稟議書",
  "document": {
    "fid1": "サンプル文字列",
    "fid2": "A",
    "fid3": "あああああああああああ",
    "fid4": "2026-01-01",
    "fid5": "2026-01-20",
    "fid6": 30000,
    "fid8": "特記事項特記事項特記事項特記事項"
  }
}

つぎにコラボフローREST APIに関する認証情報の取得と接続確認を用意します。
REST APIクイックスタート」をご参照いただき、ご自身の環境に合わせたJSONデータを作成したら、「REST APIの実行!」までできることを確認しておきましょう。

2 Dify上にコラボフローに稟議申請を追加する処理となる「ワークフロー」を追加

つぎにDifyからコラボフローに稟議申請を行う処理を作成します。
Difyのアカウントを持っていない方は「無料で始める」からサインアップしておきましょう。

今回作成するワークフロー

ワークフローは非常にシンプルです。
HTTPリクエストの設定内容は過去の記事「コラボフロー REST API でPostmanから稟議申請!」も参考になります。

2-1 トップページの「アプリを作成する」メニューで「最初から作成」をクリックして「ワークフロー」を選択

2-2 アプリのアイコンと名前を選択

  • アプリ名:MyWorkflow
  • アイコン:好きなものを選択

2-3 ノードの作成

始点となるスタートノードの設定

「ユーザー入力」を追加

「入力フィールド」の設定で入力された値を受け取る変数を指定します。

  • フィールドタイプ:段落
  • 変数名:request_data
  • ラベル名:request_data

コラボフローREST APIにリクエストを行うHTTP リクエストノードの設定

始点のノードで取得したJSONデータをコラボフローREST API側にPOSTする処理を設定します。

  • API:POST
  • ヘッダー:事前に確認した認証情報
  • ボディ:JSON
  • ユーザー入力 / (x)request_data
    ここではリクエストBodyに変数を指定していますが、試しに直接JSONデータを入力してこのノード単体で正しく登録できるかテストしておくと確実です。

終点となる出力ノードの設定

最後にワークフローの終点となるノードを設定します。

  • 出力変数:body HTTP リクエスト / (x)body String
    最後にPOSTリクエストのレスポンスを受け取る設定をしておきます。

ワークフローができたら各ノードをつなぎ、テスト実行でコラボフロー側に稟議申請の下書きが追加できることを確認しておきましょう。
設定に問題がある場合は実行できませんので、画面右上の通知マークでエラー内容を確認して修正します。

3 作成したDifyのワークフローを公開してMCPサーバーを有効化

右上の「公開する」をクリックしたら左上のアイコンから設定画面を開く


MCPサーバーを有効化

以上でDify側の設定は完了です。

同じ画面の上の方にある「Web App」のURLをコピーしてブラウザに張り付けて実行し、コラボフローに稟議申請の下書きが作成されることを確認してもよいでしょう。

4 Claude DesktopからDifyの処理を呼び出せるように設定を追加

Claude DesktopからDifyのワークフローを呼び出せるように、Claude Desktop側にMCPの接続情報を追加します。

プロンプトの入力画面にある「+」をクリックし、「コネクタ」、「コネクタを管理」を選択

コネクタの管理画面で「+」をクリックし、「カスタムコネクタを追加」を選択
※無料版ではカスタムコネクタを1つ追加できます。

先ほどDify側で確認したMCPサーバーのURLを登録したらClaude Desktopを再起動します。Windowsの方はタスクトレイ内のClaudeも終了させましょう。

Claude Desktopが起動したらコネクタにDifyが追加されていることを確認します。

5 CData Connect AIにコラボフローへの接続情報を追加

CData Connect AIのアカウントをお持ちでない場合は事前にサインアップしておきましょう。
こちらは過去の記事を参考に設定します。

6 CData Connect AIにkintoneへの接続情報を追加

同様にCData Connect AI上で「Souces」→「Add Connection」から「kintoneコネクター」を検索して接続情報を追加します。

今回kintoneへの接続はCData Connect AI を使用しましたが、手元で動作を確認したいだけならkintoneが公式に公開しているローカルMCPサーバーを使用してもよいかもしれません。

7 CData Connect AIとClaude Desktopを接続

過去の記事を参考にCData Connect AIの画面左のメインメニュー内にある「Integration」から設定しましょう。
「Integrations」メニュー内、「AI」のセクションにある「Claude AI」のタイルで「Connect」をクリック指示に従って設定を行います。
設定が完了したらClaude Desktopを再起動してコネクターが追加されていることを確認しましょう。

8 Claude Desktopのプロジェクト(Projects)に全体の手順を登録

Claudeのプロジェクト機能は、AIに特定の業務や目的を遂行させるための手順や設定などをまとめてAI側にインプットしておくための共有スペースです。
今回のような処理はプロンプトが複雑で長くなりがちですが、共通の事前情報をまとめてプロジェクトに登録しておくことでClaude側でコンテキストを理解したうで処理を実施しますし、チーム内でも共有できるので便利です

手順の例

今回は申請ごとに異なるタイトルや日付などの情報を確認するため、ポイントポイントで選択肢を提示して申請者に選択してもらうようにしています。

JSONフォーマットに従って出力してください。action は必ず "draft" を指定し、日付は YYYY-MM-DD 形式、金額(fid6)は整数で指定してください。fid7は使用しません。

[手順]
- タイトルを質問
- 開始日と終了日を質問(直近一週間で選択肢を提示)
- 申請区分コードを質問(A or B or Cで選択肢を提示)
- CData Connect Cloude のkintoneコネクタを使用してkintoneの「商品リスト」の一覧を取得からどの商品を選ぶか質問
- 質問の回答に基づき kintoneの「商品リスト」のレコードを取得
- JSONフォーマットに従って正確なJSONを出力
- 内容に問題がないか確認
- DifyにJSONを送って稟議の下書きを作成
-稟議の下書きが完了したらコラボフローへのリンクを表示

[出力するjsonの値]

・processes_id :35
・request_userid : "test"
・request_group_code: "eigyouka"
・action : "draft"
・app_cd : 1
・title : "Difyからの稟議書"+現在の日時,
・fid1:「Difyからの稟議書:」+「kintoneから取得した商品名」を指定
・fid2:確認した選択肢 A or B or C
・fid3:「kintoneから取得した商品名」 の申請
・fid4:確認した開始日
・fid5:確認した終了日
・fid6:「kintoneから取得した商品の金額」
・fid8:「kintoneから取得した商品の特記事項」

「ファイル」にサンプルデータからClaudeに作ってもらったJSONの定義を追加(ざっとなので要確認です)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "稟議申請リクエスト",
  "type": "object",
  "required": ["processes_id", "request_userid", "request_group_code", "action", "app_cd", "title", "document"],
  "properties": {
    "processes_id": {
      "type": "integer",
      "description": "プロセス定義ID(正の整数)",
      "minimum": 1
    },
    "request_userid": {
      "type": "string",
      "description": "申請者ユーザーID"
    },
    "request_group_code": {
      "type": "string",
      "description": "申請者所属グループコード"
    },
    "action": {
      "type": "string",
      "const": "draft",
      "description": "常に draft(下書き保存)固定"
    },
    "app_cd": {
      "type": "integer",
      "description": "申請書種別コード",
      "minimum": 1
    },
    "title": {
      "type": "string",
      "description": "稟議タイトル",
      "maxLength": 255
    },
    "document": {
      "type": "object",
      "required": ["fid1", "fid2", "fid3", "fid4", "fid5", "fid6"],
      "properties": {
        "fid1": { "type": "string", "description": "件名" },
        "fid2": { "type": "string", "description": "申請区分コード" },
        "fid3": { "type": "string", "description": "申請内容・目的" },
        "fid4": { "type": "string", "format": "date", "description": "開始日 (YYYY-MM-DD)" },
        "fid5": { "type": "string", "format": "date", "description": "終了日 (YYYY-MM-DD)" },
        "fid6": { "type": "integer", "description": "金額(円)", "minimum": 0 },
        "fid8": { "type": "string", "description": "特記事項(任意)" }
      }
    }
  }
}

Claude Desktopからコラボフローに稟議申請を追加

いよいよClaude Desktopにプロンプトを入力して稟議申請を作成していきます。

実際には以下のような選択肢が表示され、クリックすると処理が進んでいきます。

日付の選択

商品の選択

申請する内容を確認して作成を指示すると、無事に稟議申請の下書きができました!

作成された申請書へのリンクが表示されましたので、コラボフローの画面でチェック後、申請を送信できたら完了です。

まとめ

以上、今回の構成のメリットは以下の通りです。

  • ノーコードですぐに作成・編集できる
    全体としてはCData Connect AIやDify、コラボフローはすべてSaaSなので環境構築の手間もなく即試せるのがいいですね。DifyによるMCP Server機能のアップデートにより、今回の検証に必要な処理がノーコードで作成できました。
    また、承認フローにコラボフローを用いることで多段での承認や申請金額などに応じた条件分岐など複雑な申請ルールを自社で手軽に作成・編集して運用できる点は重要です。
  • MCP Serverの設定をチームで共有できる
    CData Connect AIやDifyはリモートMCPサーバーを提供しているため、個人ごとのPCにMCPサーバーをインストールする必要がない点は、技術者以外の方がAIをチーム間で共有して活用していくうえで大事なポイントです。
  • セキュリティやガバナンス対応が可能
    AIの全社利用を推進しつつ、権限や設定をしっかり集中管理できる点と、監査で必要になる証跡が残る点がこの構成のメリットです。
    コラボフロー側では過去の申請情報を検索可能ですし、CData Connect AIやDify側にもGUIでログが確認できるため問題の特定が容易です。

注意する点としては、今回はシンプルな例ですが、プロジェクトの指示内容や参照データの要約が荒いなどAIへのインプットに問題があると検索に失敗したりレスポンスがおかしくなったりする原因にもなりがちです。
より安全に処理を実行するには、必要なポイントでチェックができる設計にしておくと良いかもしれませんね。

どんなことに役立ちそうか

AIエージェントを活用したワークフローは、PCを使用しない現場のスタッフによるモバイルやインカムからの音声入力やIoTとの連携など、様々な可能性がありそうです。

  • A2A (Agent2Agent) を活用した未来のワークスタイルの実現
  • 医療・介護・工場などの現場でインカムを使った音声入力をもとに申請やレポートを作成
  • 自動車の走行データをもとに配送やタクシー業務などの業務用車両に関する正確な報告書を作成
  • 災害発生時に道路・水道管・建物などインフラの破損状況をスマホ端末やドローンから位置情報を添えて報告→緊急度に応じて修繕等の対応を実施

皆さんもどんなことに活用できそうかぜひ検討してみてください!

Claude Desktopでコラボフローの申請情報を分析してみた

企業のAI活用が加速する中で、社内に蓄積したデータを分析した業務効率化や生産性向上につなげたいと考える方も多くいらっしゃると思います。
今回は一例として、Claude Desktopからコラボフローの申請情報を分析・可視化してみたいと思います。

AIによるデータ分析は、これまで必要だったデータ分析基盤やBIツールの専門スキルがなくても実現可能なため、データ分析の民主化を実現する手段ともいえそうです!

今回の構成

Claude Desktop - CData Connect AI (リモートMCP) - コラボフロー


Claude Desktopとは

Anthropic社が開発・提供している生成AI「Claude」の公式デスクトップアプリです。同じくAnthropic社が提唱するMCP(Model Context Protocol)により、外部のシステムやデータソースとシームレスな連携が行える点が特徴です。

CData Connect AIとは

CData Connect AIは、 CData Software社が開発・提供を行っているフルマネージドなリモートMCPプラットフォームです。
ClaudeやChatGPTなどの生成AIアシスタントやAIエージェントからSalesforce、kintone、SAP、Google Sheetsなど数百種類のビジネスデータに、ノーコード・セキュア・リアルタイムなアクセスを実現でき、エンタープライズ企業のAI活用にとって不可欠ともいえる強力なツールです。

設定手順

Claude Desktopからコラボフローの申請情報を分析・可視化する手順は以下の通りです。

  1. コラボフローに接続するための認証情報を用意する
  2. CData Connect AIからコラボフローに接続
  3. CData Connect AIでコラボフローの接続情報を取得するための設定を追
  4. CData Connect AIとClaude Desktopを接続

1 コラボフローに接続するための認証情報を用意する

こちらは過去の記事にまとまっていますので「REST APIクイックスタート」の部分を参考に「REST APIの実行!」までできることを確認しましょう。

また、今回はClaude Desktopからコラボフローに登録されたすべての申請情報を検索できるように、ログインに使用するユーザーを「監査グループ」に追加します。

監査グループへの追加方法
  • コラボフローにシステム管理者権限を持つユーザーでログインしたのち、画面右上の歯車マークをクリックして「システム管理エリア」を選択
  • 「組織管理」画面で該当のユーザーをクリックして表示される「ユーザー編集」画面の「グループ・役職」タブにて追加

 

ユーザーを「監査グループ」に追加したら、コラボフローから一度ログアウトして再ログイン後、検索画面にてログインユーザ以外のすべてのユーザーの申請情報が検索できれば設定はOKです。

※監査グループはコラボフローに登録しているすべての社員の申請情報が閲覧可能な非常に強力な権限を持つ特殊なグループですので、本番環境で設定する場合は必要に応じて検索できる範囲を特定の部署やグループに絞るようにしましょう

2 CData Connect AIからコラボフローに接続

CData Connect AI を使用するために2週間の無料トライアルにサインアップします。

CData Connect AIにログインしたら、コラボフローを接続するにはAPIコネクターを使用します。

  • 画面左のメインメニュー内にある「Data」セクションの「Sources」を選択して右上の「Add Connection」をクリック

  • 「API」コネクターを選択

  • 「Global Settings」のタブで以下を設定

    • Connection Name : CollaboflowAPI
    • Authentication : No Auth
    • Headers : 
      Name : X-Collaboflow-Authorization
      Value :「 1 コラボフローに接続するための認証情報を用意する」で作成した情報
      例)Basic dGFyby9hcGlrZXk6cVF6RUM2Y1VBWmZWMDNSdmJBQlltNDBMNW1DNnFVRm4=

3 コラボフローの申請情報を取得するための設定を追加

続いて「Tables」タブにてREST APIのエンドポイントに対するリクエスト情報を設定します。

  • Tableセクションの設定

    • Name : documents_search
    • Request URL : https://****/***/api/index.cfm/v1/documents/search
    • Response Type : JSON
    • Body : {"app_cd":1, "offset":[_input.offset], "limit": [_input.limit]}

  • Table Dataセクションの「Pseudo Columns」タブ


    • limit:Integer
    • offset:Integer
  • 画面右下の「Configure」をクリックし、画面の流れに従ってテーブルのカラム等を設定
    1 offset とlimit を設定したら「Next」をクリック

    2でプレビューを確認したら、3で「Records」にチェック


    4 ですべてのカラムにチェックし、5でプレビューしたらデータソースの設定は完了

  • Explorer の画面でDerived Viewを登録


    • 先ほど登録した「CollaboflowAPI」を選択してSQLが入力されている箇所に以下を設定

      SELECT * FROM [CollaboflowAPI].[REST].[documents_search] WHERE [limit] = 200 and [offset] = 0

    • 「Execute」をクリックしてコラボフローに登録している申請情報が取得できることを確認
    • 右上の「Save」をクリック、「Save as Derived View」で保存
      Name:all_requests
      Query:
      SELECT * FROM [CollaboflowAPI].[REST].[documents_search] WHERE [limit] = 200 and [offset] = 0
      ※ CData Connect AIはコラボフローREST APIへのリクエストを標準SQLに変換するため、Claudeからコラボフローを見ると一般的なデータベースに見えています。接続先ごとのAPIの違いをCData Connect AI側で吸収してくれるため、シンプルな連携が可能な点が非常にAIフレンドリーです。

  • 念のため、Derived Viewの画面にてExuteをクリックしてコラボフローの申請情報の一覧が取得できたらOKです

4 CData Connect AIとClaude Desktopを接続

CData Connect AI側での接続設定

CData Connect AIの画面左のメインメニュー内にある「Integration」を選択
「Integrations」メニュー内、「AI」のセクションにある「Claude AI」のタイルで「Connect」をクリック指示に従って設定を行います。

 

Claude Desktop側での設定

  • Claude Desktopを起動して入力窓の左下にある「+」をクリック
  • 「コネクタ」の中で「CData Connect AI」を有効化

  • Claude Desktop を再起動します。Windowsの場合はタスクトレイ内のアプリも終了しましょう
  • Claude Desktopが起動したら試しにコラボフローに登録されている申請情報の件数を確認してみましょう。

    プロンプト:Connect AI のDerived Viewを参照してコラボフローに登録している申請情報の件数をおしえてください。

    以下のように想定した件数が得られたら設定は完了です。

Claude Desktopからコラボフローの申請情報を分析・可視化

いよいよClaude Desktopを使ってコラボフローの申請情報を集計してみます。

申請内容ごとの集計

ワークフロー内の問題点を分析

以上でコラボフロー内の申請情報の集計や分析・可視化がClaude Desktopから可能になりました!

Claude Desktopの「Project」にコラボフローの申請情報を検索するための手順を設定しておくと、特定の手順による利用をチーム内で共有したりとさらに便利に利用できます。

例:

使用するコネクター:CData Connect AI
参照するデータ:CData カタログの DerivedViews スキーマ内の all_requests 

まとめ

AIエージェントからコラボフローに接続するうえでCData Connect AIを活用するメリットは大きく3つです。

設定の簡単さ

世の中には様々なMCP Serverが公開されていますが、GitHubからソースコードをダウンロードして環境構築が必要になるなどITスキルを要するケースが多く、一般の方には難易度が高くなりがちです。

しかし、CData Connect AIはご覧いただいたようにノーコードで設定できるため、専門知識のあるスタッフがいない企業でも容易に導入が可能です。

さらに、一般的にPCごとにインストールや設定が必要なローカルMCP Serverとは異なり、フルマネージドなCData Connect AIは各種SaaSに接続するためのコネクターやユーザーごとの読み取り専用・書き込み権限などの設定をCData Connect AI上で集中管理できるため、AIエージェントの導入が手離れよく素早く実現可能です。

多彩な連携先

SalesforceやHubSpot、SAPなどグローバルな接続先だけでなく、kintone、PCA、Sansan、Backlogなど国産SaaSのビジネスデータにも接続可能なため、自社のシステム構成に合わせて柔軟な活用が可能です。
また専用のコネクターがない場合も、今回のように汎用的なAPIコネクターを使った接続も可能です。

セキュリティとガバナンス

MCP Serverは便利なツールとして急速に拡大しましたが、中にはセキュリティ対策の不備や悪意のある開発元による漏洩のリスクも報告されています。
CData Connect AIはAnthropic社からClaudeの連携製品として公式に認定・登録されており、Claudeで業務データを扱ううえで重要な選択肢といえます。

以上、コラボフローのようなワークフローシステムに蓄積された情報の解析は、業務改善のための重要なインサイトを得る手段となるかもしれません。
企業のペーパーレス・デジタル化の次の一手としてぜひトライしてみてください!

Claude Desktopでコラボフローに登録した部署やユーザー情報を可視化・分析

前回の記事ではClaude Desktopを使ってコラボフローの申請情報を集計・分析することができました。

今回はコラボフローの部署やユーザーに関する組織の情報についても集計・分析してみましょう。

コラボフローの組織情報

まずはコラボフロー内の組織情報がどのように管理されているか確認してみます。

組織の情報はコラボフローにシステム管理者権限を持つユーザーでログインし、画面右上の歯車マークをクリックして「システム管理エリア」を選択、「組織管理」の画面で確認できます。

コラボフローにはこのような形で部門やユーザー情報をわかりやすく管理する仕組みがあり、ワークフローを柔軟に設計・運用することが可能です。

これらの情報にClaude Desktopからアクセスすると、どんなことが可能になるでしょうか。

Claude Desktop からコラボフローの組織情報にアクセス

前回同様Claude Desktop からコラボフローの組織情報にアクセスするためにCData Connect AIを使います。


CData Connect AIを活用するポイントは何といってもフルマネージドなリモートMCPプラットフォームな点です。
ローカルMCPサーバーのように個々のPCにインストールする煩雑な手間が不要な点に加え、企業がAIを活用するうえでセキュリティやガバナンスを集中管理できるのも魅力です。
詳しいメリットは前回の記事にもまとまっていますのでぜひご覧ください。

設定手順

Claude Desktopからコラボフローの申請情報を分析・可視化する手順は以下の通りです。

  1. コラボフローに接続するための認証情報を用意する
  2. CData Connect AIにコラボフローへの接続情報を追加
  3. CData Connect AIからコラボフローのグループとユーザー情報に接続
  4. CData Connect AIとClaude Desktopを接続

1 コラボフローに接続するための認証情報を用意する

こちらは過去の記事内の「 REST APIクイックスタート」を参考に「REST APIの実行!」までできることを確認しましょう。

また、今回はClaude Desktopからコラボフローの組織情報にアクセスできるように、ユーザー情報の編集画面で「システム管理者フラグ」が「ON」になっていることを確認しておきます。

ユーザー情報の編集画面は先ほど確認した「組織管理」の画面で該当のユーザーをクリックすると確認できます。

2 CData Connect AIにコラボフローへの接続情報を追加

CData Connect AI のアカウントをお持ちでない場合は2週間の無料トライアルにサインアップします。

CData Connect AIにログインしたら、コラボフローを接続するにはAPIコネクターを使用します。

画面左のメニュー内にある「Data」セクションの「Sources」を選択

「API」コネクターを選択

「Global Settings」タブにて以下を設定

まずはGlobal Settingsタブでデータソースの接続に必要な基本情報を設定します。

  • Connection Name : CollaboflowAPI
  • Authentication : No Auth
    Headers :
    • Name : X-Collaboflow-Authorization
    • Value :「 1 コラボフローに接続するための認証情報を用意する」で作成した情報
      例)Basic dGFyby9hcGlrZXk6cVF6RUM2Y1VBWmZWMDNSdmJBQlltNDBMNW1DNnFVRm4=

Paginationの項目

  • Type : Offset
  • Offset Param : offset
  • Offset Starting Number : 0
  • Page Size Param : limit
  • Page Size : 200

3 CData Connect AIからコラボフローのグループとユーザー情報に接続

次に、「Tables」タブに移動して「+Add」をクリックしたらコラボフロー内のグループ情報に対する接続情報を設定します。

画面右下の「Configure」をクリックし、1-5の流れに従ってテーブルのカラム等を設定しましょう。
必要なカラムなどを選択して5の画面でコラボフローのグループ情報がプレビューできたら接続完了です。


続いてコラボフローのユーザー情報を取得するための設定を追加します。

グループ情報の設定と同様に「Tables」タブに設定を追加します。

4 CData Connect AIとClaude Desktopを接続

CData Connect AIはAnthropic社からClaudeの連携製品として公式に認定・登録されているため接続が驚くほど簡単です。
具体的な設定方法前回の記事内「4 CData Connect AIとClaude Desktopを接続」をご参照ください。

Claude Desktopからコラボフローの組織情報を分析・可視化

それではClaude Desktopからコラボフローのデータを使ってみましょう。

まずはグループ情報への接続を確認します。

グループ情報が確認できましたので次はこの情報をツリー構造で表現してみます。

うまくいきました。
次は組織とユーザーの情報を紐づけて表示してみましょう。

Claude側で組織ツリーとユーザーの関係を紐づけてうまく表現できました。

コラボフローが公開しているREST APIがAIにも理解しやすくメタデータを提供しているため、Claudeと連携した際にハルシネーションを起こしにくい形になっています。
最後にユーザーごとに設定している権限ベースで集計を行ってみます。

いいかんじですが、このままでは確認しづらいので所属グループで絞り込みができるようにしてみます。

グループの絞り込みが追加されましたが、一つのグループしか選択できないようなので複数選択できるようにしてみます。

グループの複数選択が可能になりました!
ステータス内で「要PW変更」などの情報が見えるので、さらに踏み込んでユーザー情報が適切に設定できているかなどのリスク分析にも使えそうですね。

まとめ

グループやユーザー情報をCSVでダウンロードしてExcelでがんばれば似たようなことができそうですが、API経由でデータを取得すればCSVでダウンロードする必要がないためデータを複製しなくてよい点や、エクセルの式や設定ズレによるミスを防げるなどのメリットがあります。

なお、プロンプトで指定していた「CData Connect AI のコネクターで取得できます」などの手順はClaude Desktopの「Project」にコラボフローの申請情報を検索するための基本情報や手順を設定しておくと、毎回指定する必要がなくなりますし、特定の手順による利用をチーム内で共有したりとさらに便利に利用できます。


皆さんも実際の業務でどのように活用できそうか検討してみてください。

コラボフロー REST API でPostmanから稟議申請!

 前回の記事では、Postmanからコラボフロー REST APIに接続してコラボフロー内で部門などの組織を管理するグループ情報を取得する方法を試してみました。
今回は一歩進んで稟議申請の申請の下書きを保存するリクエストを試してみたいと思います。

大まかな手順

  1. コラボフローにて稟議申請用のフォームと経路を作成しておく
  2. コラボフロー REST APIに接続するための認証情報を用意する
  3. コラボフロー REST APIから稟議申請を行うための情報を作成する
  4. Postmanからコラボフロー REST APIに対してリクエストを送る

ではさっそくやってみましょう!

1コラボフローにて稟議申請用のフォームと経路を作成しておく

こちらは無料トライアルでサンプルの申請書を利用するのが一番簡単です。
詳細は前回のブログ内「 コラボフローにサインアップ」に記載していますので是非ご参照ください。

今回申請する稟議の申請書

2 コラボフロー REST APIに接続するための認証情報を用意する

こちらも前回の記事にまとまっていますので「REST APIクイックスタート」の部分を参考に「REST APIの実行!」までできることを確認しましょう。

3 コラボフロー REST APIから稟議申請を行うための情報を作成する

REST APIにリクエストを送るために稟議書の情報をjson形式で作成します。

{
  "processes_id": 35,
  "request_userid": "test",
  "request_group_code": "eigyouka",
  "action": "draft",
  "app_cd": 1,
  "title": "APIからの稟議書",
  "document": {
    "fid1": "サンプル文字列",
    "fid2": "A",
    "fid3": "あああああああああああ",
    "fid4": "2026-01-01",
    "fid5": "2026-01-20",
    "fid6": 30000,
    "fid8": "特記事項特記事項特記事項特記事項"
  }
}

例にあるjson内の「processes_id」は申請を行いたい申請文書を特定するための情報です。

確認方法は、コラボフローにシステム管理者権限を持つユーザーでログインしたのち、画面右上の歯車マークをクリックして「経路設定」を選択後、経路の一覧の中から該当する経路の「経路ID」を選択します(今回の経路IDは35)。

歯車マークをクリックし「経路設定」を選択

経路の一覧の中から該当する経路の「経路ID」を選択

 

「request_userid」の項目は今回申請を行うユーザーを特定する情報です。

確認方法は、コラボフローの画面右上の歯車マークをクリックし「システム管理エリア」を選択後、「組織管理」メニューで表示されるユーザの一覧から該当するユーザーの「ユーザーID」を選択します(今回のユーザーIDはtest)。

コラボフローの画面右上の歯車マークをクリックし「システム管理エリア」を選択

「組織管理」メニューで表示されるユーザの一覧から該当するユーザーの「ユーザーID」を選択

フォームの各項目は「document」配下でフォーム上の入力項目を特定する情報を「fid1」などIDの形式で指定します。IDの確認方法は、コラボフローの画面右上の歯車マークをクリックし「フォーム設定」を選択後、該当のフォームの編集画面にて、項目にマウスポインタを合わせるとわかりやすいです。

コラボフローの画面右上の歯車マークをクリックし「フォーム設定」を選択

該当のフォーム内の項目にマウスポインタを合わせる

そのほか、各項目への設定方法に関する詳細は 公式ドキュメント内「/v1/documents」の「Request body」をご参照ください。

4 Postmanからコラボフロー REST API に対してリクエストを送る

Postmanからコラボフロー REST APIにリクエストを送信する方法の詳細は前回の記事内「Postman でもやってみる!」をご参照ください。

注意する点としては今回はPOSTメソッドでのリクエストになりますので、jsonデータはリクエストBody内に設定します。

それでは実際にPostmanからPOSTリクエストを送ってみましょう!

画面下のボディ部分に「201 Created」が表示されればOKです。

コラボフローの画面上でも稟議書の下書きが作成されていることが確認できました。

AIエージェントやIPaaS製品、チャットツールなどとの連携の可能性も

今回の内容をアレンジすると、AIエージェントやIPaaS製品、チャットツールなどを連携して以下のような業務も自動化できるかもしれませんね!

  • kintoneに保存したマスター情報かららAIエージェント経由でコラボフローの見積申請の下書きを登録、担当者が目視で内容を確認してから申請
  • 出張予定をGaroonのカレンダーで仮押さえ、AIエージェント経由でコラボフローの出張伺い申請を作成、決済が下りたらカレンダーの予定を自動で確定に変更、さらにコラボフロー側で出張後の報告書と経費申請のタスクも自動作成
  • 営業部の日報を取りまとめて月次レポートの申請を作成

他にも様々なシナリオが考えられそうですね、ぜひみなさんもどんな業務に活用できそうかアイデアを膨らませてみてください!

コラボフロー REST API をPostmanから使ってみた!

コラボフローは、あらゆる社内申請に対応した誰にでも使いやすいワークフローシステムですが、実はREST API「コラボフロー REST API」を活用してSFAやCRMと直接連携したり、IPaaS経由で様々なシステムと連携するなど高度な拡張も可能です。

今回はそんなディープな連携を実現できるコラボフロー REST APIに、APIプラットフォームのPostmanから接続してみる手順をご紹介いたします。

コラボフロー REST APIについて

コラボフロー REST APIは、コラボフローのデータを外部システムから取得したり、コラボフローへのデータ登録・更新を行うための汎用的な仕組みとして公開されています。
グローバルスタンダードなOpenAPI仕様に基づいた設計で、Swaggerドキュメントも公開されているため、開発者がブラウザ上での仕様確認から各種ツールを使ったコードの自動生成までを素早く行うことができる点が大きなメリットです。

どんな時に使うのか

コラボフローではkintoneやLINE WORKSをはじめとした様々なサービスとノーコードで連携可能なオプションやサードパーティ製品が多数存在公開されているため、外部連携の際にはまず対応しているものがないかを確認し、その他のケースにコラボフロー REST APIの利用を検討します。

コラボフロー REST APIを使ってみよう!

コラボフローにサインアップ

まだコラボフローのアカウントがない場合はコラボフローウェブサイトに右上にある「無料で試してみる」から「コラボフローお試し申し込み」のページを開いて申し込みます。

無料トライアル環境はサンプル付きを選択すると、稟議・経費申請・出張精算・購入伺いなどさまざまな申請のサンプルがあらかじめセット済みのトライアル環境が利用可能です。
「コラボフローお試し申し込み」画面にて、「お試し環境へのサンプルデータの有無」の項目で「サンプルデータあり【オススメ】」がデフォルトで選択されていますので、特に理由がない限りそのままお申込みを完了させます。

トライアル環境で詳しい設定方法を知りたい場合はユーザーガイドが便利です。

REST API クイックスタート

無料トライアル環境の準備ができたら、さっそくサポートドキュメントの「REST API クイックスタート」内「事前準備」の項目から進めていきます。

気を付ける点としては、APIキーの発行はシステム管理エリアで行うため、システム管理者の権限を持つユーザーでログインします。
システム管理エリアが表示されない場合はご利用のユーザー情報をご確認ください。

APIキーが取得できたら、REST APIを実行するユーザーIDとAPIキーを組み合せた文字列「{ユーザーID}/apikey:{APIキー}」を、BASE64に変換し認証キーを取得します。

PowerShell でBASE64に変換を行う例

PowerShell 7.6.2
PS C:\Windows\System32> [Convert]::ToBase64String([Text.Encoding]::UTF8.GetBytes("taro/apikey:qQzEC6cUAZfV03RvbABYm40L5mC6qUFn"))
dGFyby9hcGlrZXk6cVF6RUM2Y1VBWmZWMDNSdmJBQlltNDBMNW1DNnFVRm4=

REST APIの実行!

認証キーが取得できたら「REST API クイックスタート」内「REST APIの実行」を参考に、REST APIを実行してみましょう。

Windowsのコマンドプロンプトで実行した例

curl -X GET "https://****/***/api/index.cfm/v1/groups" -H "X-Collaboflow-Authorization:Basic dGFyby9hcGlrZXk6cVF6RUM2Y1VBWmZWMDNSdmJBQlltNDBMNW1DNnFVRm4="

無事にステータスコード「HTTP/1.1 200」が返り、JSON形式でグループの一覧が取得できればOKです。

Postman でもやってみる!

コラボフロー REST APIの検証はここまででもOKですが、Postmanを活用すると視覚的なUIでAPIのテスト・自動化・チーム共有など圧倒的な効率化が可能です。
それではさっそくPostmanを使って同様のリクエストを実行してみましょう。

Postmanにサインアップ

Topページ右上の「無料で登録」からサインアップしたら、今回はクイックにブラウザ版を使用してみましょう。

ワークスペースに移動

Home画面左上の「ワークスペース」からデフォルトで用意されているワークスペースを開きます。


先ほど実行したCurlコマンドをインポート

ワークスペース左上の「...」をクリックして「インポート」を選択

確認画面が表示されるのでそのままインポートを実行

インポートしたGETリクエストを実行して実行結果を確認

送信をクリックしてレスポンボディー部分に先ほど実行したコマンドと同様の結果が出力されていることが確認できました。

これだけでPostman を使ったコラボフロー REST APIのテストができてしまいました。
Postmanの基本については公式のスライドに分かりやすくまとまっていますのでぜひご覧ください。
やさしいPostman API入門

それでは!

使ってる?Shifter の便利な CDN 転送量オプションについて

こちらは「デジタルキューブ & ヘプタゴン Advent Calendar 2022」6日目の記事です。

今回はデジタルキューブが開発、提供している Shifter (シフター) についての Tips をご紹介します。

Shifter は 以下のように一般的な WordPress 用ホスティングとは異なる特徴を持った便利なホスティングサービスです。

Shifter の特徴

  • WordPress のインストールやアップデートが自動化されており、サーバーの契約やデータベースの設定などを気にせずすぐに WordPress が使える
  • CMS としての WordPress と、公開されるサイトの領域が分離されており、安全かつ高速なサイトを構築できる
  • WordPress は普段停止した状態で、サイトの編集が必要なときだけ起動する仕組みのため、WordPress への不正アクセスのリスクが極めて低い

今回ご紹介する Tips は、そんな便利な Shifter をさらに便利にできる機能についてです。

CDN 転送量の従量課金オプション

Shifter ではプランごとに月間の転送量の上限がありますが、CDN 転送量の上限を超過した際に必要な容量が自動で追加される、従量課金オプションが提供されています。
このオプションを有効にすると、CDN転送量が不足した際に、必要な分だけ自動で転送量が追加されるようになりますので、事前に細かくキャパシティを見積もる必要がなく、サイトへの突発的なアクセスの増加があっても、深夜や早朝・年末年始などのお休み中に会社に呼び出されたりする心配もなく安心して過ごせます。

 

以上が Shifter をさらに便利にするオプションのご紹介でした。

CDN転送量の従量課金オプション」の有効化の方法については以下のサポートドキュメントをご参照ください。

「CDN転送量の従量課金オプション」の有効化 - Shifter

 

Shifter について興味がある方は無料トライアルも提供されていますのでぜひ一度お試しください。

 

明日はデジタルキューブつのださんの記事です。お楽しみに!

Calendar for デジタルキューブ & ヘプタゴン | Advent Calendar 2022 - Qiita

 

ウクライナにEMSで支援物資を送る方法について調べてみた

こちらは「デジタルキューブ & ヘプタゴン Advent Calendar 2022」2日目の記事です。

先日EMS(国際スピード郵便)を使ってウクライナに荷物を送る機会があり、調べた内容をこちらで共有いたします。
支援物資以外でも、海外に住む友人や家族にプレゼントを贈る場合にも参考にしていただけると幸いです。

なお、内容はこの記事の公開時点の情報ですので、実際に送る場合は必ず最新の情報をEMSのサイトや郵便局の窓口・支援物資の受付窓口でご確認ください。

支援物資を送る流れ

1 送り先を確認する
ページの下の方に支援物資の受け付け窓口を記載しましたので「送り先の一例」ご覧ください。

2 支援物資として送ろうとしている物が差し出し可能か確認する

3 荷物のサイズや重さが制限を超えていないかEMSの項目を確認する

国・地域別情報(国際郵便条件表) - 日本郵便

4 支援物資の配送料金がいくらかかるか確認する

料金表(EMS:取り扱い国すべて) - 日本郵便

5 ラベル(送り状)を作成して最寄りの郵便局に持ち込む

ヨーロッパ宛の荷物は手書きのラベルでは差し出せないため、以下のサービスを使用して作成します。

ラベルの作成 | 日本郵便株式会社

スマホで登録する場合、送られてきたQRコードを郵便局の読み取り機にかざすだけでラベル印刷までしてくれるのでおすすめです。

送り先の一例 

ボグダンさんはウクライナ在住のYouTuberで、ウクライナで特に必要とされている物資・日本から送らなくてもウクライナ国内で入手可能なもの・ウクライナの方が馴染みやすい食品などについて共有されています。

youtu.be

ウクライナで直接調達できる場合、EMSで時間と送料をかけて送るよりも、寄付金を送った方が必要なものを早く入手できますし、現地のビジネスにも貢献できそうです。


その他調べたこと

ランタンなど電池を必要とする物を送る場合

ウクライナでは長時間の停電が続いているためランタンなどが必要とされているようですが、日本から送る場合は事前に電池の個数やワット数などのスペックを確認する必要があります。


また現地では乾電池の値段がかなり高騰しているそうで、使い捨ての乾電池を使わず、電源プラグの形状の考慮が不要なUSBで充電できるタイプのライトや、手回し式のライトが良さそうです。
充電式の場合は「国際郵便によるリチウム電池の郵送条件」にある制約を確認します。
https://www.post.japanpost.jp/int/use/restriction/restriction02.pdf
バッテリーや電池にもよりますが、一度に送れる目安は2-4つぐらいです。

 

使い捨てカイロを送る場合

国際郵便による郵送が可能な使いすてカイロを販売する事業者一覧で郵送可能かを確認します。
また以下の情報も役に立ちます。

カイロを海外に送りたいのですが、航空便で送れますか? | お客様相談室 | 製品サイト | エステー株式会社

現地ではペットボトルにお湯を入れて湯たんぽ代わりにしているそうですが、お湯を沸かす電気やガスが不足しているため、日本のカイロは喜ばれているようです。
 注意する点として、日本では通販サイトなどで100個以上のパックも安価に購入できますが、重量もあり送料が高くなる可能性があります。郵便局の窓口でびっくりしないように、事前に送料を確認しましょう。

日本から支援物資を送る以外の方法

日本から支援物資を送る以外にも、現地のコーヒーショップと連携した支援を行っている方もいらっしゃいますので、他にもこのような活動が行われていないか調べてみるといいかもしれません。
【ウクライナ支援】キエフのコーヒーショップと温かいコーヒーを届ける(完了済)

現地にあるコーヒーショップのECサイトもありますので、サイトに記載されている支払い方法での購入が可能な方はこちらでオーダーしても良いかもしれません。

https://3champsroastery.com.ua/en/

最後に

今回はウクライナに支援物資を送る方法にフォーカスしましたが、国内外には支援を必要としている方々がたくさんいらっしゃいます。募金や支援物資を送る以外にも、ウォーキングイベントに参加して歩いた歩数が寄付になるサービスもありますので、通勤・通学やお散歩の時間を使って歩きながら世界の平和や医療支援に想いを寄せてみてはいかがでしょうか。

 

ウォーキングが寄付につながる minpo|minpo公式サイト

 

直近で行われるチャリティウォークイベント(複数参加も可能です)

多くの参加者が集まれば数千万歩分の寄付が集まります。
一人でできることは少なくても、何か行動を起こすきっかけになるかもしれません。


明日はヘプタゴン立花さんの記事です。お楽しみに!

https://qiita.com/advent-calendar/2022/digitalcube-heptagon