Jinba FlowでSharePointのファイルとサイトを管理

SharePoint ツールでは、サイト一覧の取得、サイト情報の取得、ドキュメントライブラリ/OneDrive の参照、ファイル検索、ファイルアップロード、ファイルダウンロードを Microsoft Graph 経由で行えます。

SHAREPOINT_LIST_SITES
- SharePoint サイトを検索・一覧取得。
SHAREPOINT_GET_SITE_INFORMATION
- サイト URL からサイトのメタ情報（ID、名前、URL）を取得。
SHAREPOINT_LIST_DOCUMENTS
- SharePoint ドキュメントライブラリまたは OneDrive のファイル/フォルダ一覧を取得。
SHAREPOINT_SEARCH_FILES
- SharePoint ドキュメントライブラリまたは OneDrive のファイル/フォルダをファイル名やキーワードで検索。ファイル/フォルダのみに絞り込むフィルタも指定可能。
SHAREPOINT_UPLOAD_FILE_V2
- SharePoint または OneDrive にファイルをアップロード（最大 30 MB）。前のステップの出力ファイル、base64 文字列、データ URL、任意の HTTP(S) URL を受け付け、4 MB 超のファイルはチャンクアップロードセッションを自動的に使用します。SHAREPOINT_UPLOAD_FILE の後継ツールで、新規フローではこちらの利用を推奨します。
SHAREPOINT_UPLOAD_FILE
- SharePoint または OneDrive にファイルをアップロード（シンプルアップロード、最大 4MB）。既存フロー向けに残されています。新規フローでは SHAREPOINT_UPLOAD_FILE_V2 を使用してください。
SHAREPOINT_DOWNLOAD_FILE
- SharePoint または OneDrive からファイルをダウンロード。署名付きダウンロード URL または base64 エンコードされたコンテンツ（最大 4MB）を返します。

Microsoft Graphで接続する

Microsoft Graph OAuth トークンが必要です。 Jinba のシークレット設定で Microsoft アカウント（SharePoint/OneDrive）を連携し、発行されたトークンをツールの config に指定してください。Microsoft のサインインが Need admin approval で止まる場合は、組織の管理者による同意を参照してください。

サイトを一覧してファイルを管理する

generate_report はフロー内の前段のステップを表します。その結果はアップロードするレポートファイルである想定です。

- id: list_sites
  name: list_sites
  tool: SHAREPOINT_LIST_SITES
  config:
    - name: token
      value: "{{secrets.MICROSOFT_GRAPH_SHAREPOINT.access_token}}"
  input:
    - name: search
      value: "engineering"

- id: get_site
  name: get_site
  tool: SHAREPOINT_GET_SITE_INFORMATION
  config:
    - name: token
      value: "{{secrets.MICROSOFT_GRAPH_SHAREPOINT.access_token}}"
  input:
    - name: site_url
      value: "https://contoso.sharepoint.com/sites/Engineering"

- id: list_documents
  name: list_documents
  tool: SHAREPOINT_LIST_DOCUMENTS
  config:
    - name: token
      value: "{{secrets.MICROSOFT_GRAPH_SHAREPOINT.access_token}}"
  input:
    # drive_id を省略すると OneDrive（me/drive）を一覧取得します
    # SharePoint のドキュメントライブラリを指定する場合は drive_id にライブラリの Drive ID を指定してください
    - name: top
      value: 10

- id: list_sharepoint_documents
  name: list_sharepoint_documents
  tool: SHAREPOINT_LIST_DOCUMENTS
  config:
    - name: token
      value: "{{secrets.MICROSOFT_GRAPH_SHAREPOINT.access_token}}"
  input:
    - name: drive_id
      value: "YOUR_SHAREPOINT_DRIVE_ID"
    - name: top
      value: 10

- id: search_files
  name: search_files
  tool: SHAREPOINT_SEARCH_FILES
  config:
    - name: token
      value: "{{secrets.MICROSOFT_GRAPH_SHAREPOINT.access_token}}"
  input:
    # drive_id を省略すると OneDrive（me/drive）を検索します
    - name: query
      value: "quarterly report"
    - name: top
      value: 25
    # "all"（デフォルト）、"files"、"folders" のいずれか
    - name: filter
      value: "files"

- id: upload_file
  name: upload_file
  tool: SHAREPOINT_UPLOAD_FILE_V2
  config:
    - name: token
      value: "{{secrets.MICROSOFT_GRAPH_SHAREPOINT.access_token}}"
  input:
    # drive_id を省略すると OneDrive（me/drive）にアップロードします
    # file には前のステップの出力ファイル、base64、データ URL、HTTP(S) URL を指定できます
    - name: file
      value: "{{steps.generate_report.result}}"
    - name: filename
      value: "report.pdf"
    - name: conflict_behavior
      value: "rename"

- id: download_file
  name: download_file
  tool: SHAREPOINT_DOWNLOAD_FILE
  needs: [list_documents]
  config:
    - name: token
      value: "{{secrets.MICROSOFT_GRAPH_SHAREPOINT.access_token}}"
  input:
    # item_id は SHAREPOINT_LIST_DOCUMENTS の結果から取得します
    - name: item_id
      value: "{{steps.list_documents.result.items[0].id}}"
    # "url"（デフォルト）は署名付きダウンロード URL を返します
    # "base64" はファイル内容を base64 で返します（最大 4MB）
    - name: output_format
      value: "url"

​Microsoft Graphで接続する

​サイトを一覧してファイルを管理する

Microsoft Graphで接続する

サイトを一覧してファイルを管理する