コラボフローで申請後、承認された申請内容の連携
- 添付PDFをClimberCloudのファイル付きリストに登録します。
  ※他のフォルダには連携することができません（2021/2月時点）
  ※複数の申請フォームが連携可能となりました（2021/5月時点）
- 申請フォームの入力項目も連携することができます。
- コラボフロー側の申請フォームに紐づく固有情報も連携することができます。
希望に合わせた連携タイミングを下記の中から設定可能（連携タイミングは全申請フォーム統一）
- (1)　申請を承認者が受け取った(受信時)タイミング
- (2)　申請を最終承認者が承認した(経路完了時)タイミング
  ※連携時にエラーが発生した場合は再申請もしくはClimberCloudのアーカイブより登録ください
- (3)　(1)(2)の両方選択することも可能
  ※ClimberCloudへの登録数は2倍となります
連携フェーズを設定すると、連携失敗時、1つ前の承認済みフェーズに差し戻すか選択可能
- 連携失敗したフェーズの1つ前の承認済みフェーズに差し戻すことができます
- 連携フェーズを設定＆チェックを付けない場合は申請者に差し戻されます
複数ファイル・複数拡張子が連携可能（2023/9追加機能）
- 1帳票複数ファイル添付ある場合でも連携可能（1ファイル10MBまで）
  ※ClimberCloudのファイル容量上限40MBプランをご契約の場合、1ファイル40MBまで可能
  ※差し戻し設定を行っており、1ファイルでも連携エラーが発生した場合、全ファイルが差し戻し対象となります。
- 連携可能なファイル形式はPDF、PNG、JPG（JPEG）
  ※パスワード付きPDFは連携不可
- 連携される添付ファイル名が「invoice.pdf」からコラボフロー添付ファイル名に変更

●おすすめな方

コラボフローで申請・承認を行っている方
ClimberCloudへの登録作業を削減したい方

●利用にあたっての注意

利用可能な半角特殊文字は以下の通りです。記載以外の半角特殊文字は全角で利用ください。

!（ビックリマーク）
#（シャープ）
$（ドル）
%（パーセント）
&（アンド）
*（アスタリスク）
+（プラス）
-（マイナス）
=（イコール）
?（ハテナ）
@（アットマーク）
"（ダブルクォーテーション）
'（シングルクォーテーション）
(（カッコ）
)（カッコトジ）
,（カンマ）
.（ピリオド）
/（スラッシュ）
:（コロン）
;（セミコロン）
<（ショウナリ）
>（ダイナリ）
_（アンダースコア）
¥（円マーク）

※¥マークはClimberCloud上で新規作成時は[?](はてなマーク)、更新時は[\](バックスラッシュ)で表示されます。¥マークでは表示されませんのでご注意ください。
また、新規作成時と更新時で連携される値が変わりエラーとなるため、属性「セレクト」もしくは「取引先」では使用しないでください。

ClimberCloudの保存先はコンテンツ階層（ファイル付きリスト）のみ連携の対象
仕分先「あり」のコンテンツには連携できません
連携時におけるClimberCloud側の登録ユーザー情報は未指定で登録
→スキャナ保存した帳票を保存する場合は起票者情報が必要となるため
必ずコラボフロー側の申請者情報（申請者以外のケースもある場合はコラボフローフォーム内
に用意した起票者情報項目）を入力するカラムをClimberCloud側に設定してください
※コラボフローの文書ID項目を連携する場合は「コラボフロー文書ID」のように「文書ID」とは別名称で登録することを推奨いたします。
コラボフロー及びClimberCloudにIPアドレス制限を設定される場合、お問い合わせフォームよりその旨ご連絡をお願いします。
ファイル1にファイルが添付されていないとエラーとなります。ファイル1には必ずファイルを添付するように社内周知をお願いします。
予約キーワードのセットで作成された情報は連携されません。デフォルト値のキーワードを活用ください。
テーブルパーツは連携できません。

SaaStainerサイトページへ戻る

■アプリ設定方法/マニュアル

※マニュアル内の画像を拡大したい場合、右クリックで[新しいタブで画像を開く]からご確認ください

●0. SaaStainerアカウントに登録する

▼利用するにはSaaStainerのアカウントが必要です

　下記リンクからご登録ください

SaaStainerご登録方法

●0.1 連携アプリにログインする

連携アプリにアクセスする
SaaStainerのOAuthログイン画面でSaaStainerの情報を入力し、「ログイン」をクリックする

●1. プロダクトコードを入力する

発行された[プロダクトコード]を入力し保存をクリック
※プロダクトコードは購入した販売会社へお問い合わせください
お問い合わせの際にはSaaStainerの企業IDが必要です

●2. コラボフローのAPIキーを発行する

コラボフローの設定画面「システム管理エリア→環境設定→REST API→登録」からAPIキーを発行する

●2.1 コラボフローと連携する

連携アプリに戻り、コラボフロー設定で「ユーザーID/インスタンス」と先程発行した「APIキー」を入力したら、保存を押すを入力したら、保存をクリック

※ユーザーID：システム管理者権限を持つコラボフローユーザーのID（adminであることが多いです）

※インスタンス：コラボフローログインURL（https://cloud.collaboflow.com/***/login）の***部分
※URL内の赤色部分となります。

インスタンス.png

●3. ClimberCloudのAPIキーを発行する

ClimberCloudの設定画面「システム設定→その他管理→APIキー登録」から自動生成でAPIキーを発行する

●3.1 ClimberCloudと連携する

連携アプリに戻り、ClimberCloud設定で「テナント」と先程発行した「APIキー」を入力したら、保存をクリック

※テナント：ClimberCloudログインURL（https://climber-cloud.jp/***/login）の***部分

　※URL内の赤色部分となります。

テナント.png

●4. 連携する申請フォームを新規作成する

コラボフローの設定画面「アプリ設定→フォーム設定→新規作成」から必要項目を記入し、「通常フォーム作成」をクリック
※使用したい既存フォームがある場合はそちらをご利用いただくことが可能です
※Excelフォーム作成から作成したフォームも利用いただけます
パーツ追加からご希望の項目を追加

●5. 経路設定を新規作成する

コラボフローの設定画面「アプリ設定→経路設定→新規作成」から経路を作成する
フォームは先ほど作成した申請フォームを選択し、登録する
※使用したい既存経路がある場合はそちらをご利用いただくことが可能です

●6. 連携フェーズを設定する（ClimberCloudへの連携タイミングを設定）

希望する連携タイミングの段階名を「連携フェーズ設定」のフェーズ名に記載し保存する
※連携したいタイミングが複数ある場合は＋ボタンでフェーズを追加する
※複数の申請フォームを連携設定する事が出来ますが、連携フェーズは一律設定となります

●7. 申請フォームと格納先フォルダの
　マッピング設定をする（入力必要項目）

連携アプリ内で図の入力が必要の為、次頁に記載の確認方法で情報を確認する
※ClimberCloud側の情報はClimberCloudの画面を確認してコピーしてくる必要あり
※コラボフロー側の情報は基本的にこの画面で選択するのみ
※テーブルパーツは連携項目に指定不可
※予約キーワードのセットで作成された情報は連携不可。デフォルト値のキーワードを活用ください。
※コラボフロー側のフォーム内に設定したパーツ以外でマッピングできる情報は下記の通り
・文書ID
・文書番号
・文書タイトル
・申請者ID
・申請者名
・申請者メールアドレス
・申請部署名
・申請部署コード
マッピング設定から新規作成をクリック
※複数の申請フォームが設定できるようになった為、登録したい申請フォームを追加する場合は＋から追加する

●7.1 申請フォームと格納先フォルダの
　マッピング設定をする（フォームの指定）

「フォーム名」をクリックし、フォーム一覧から連携希望のフォームを選択

●7.2 申請フォームと格納先フォルダの
　マッピング設定をする（ClimberCloud分の設定）

ClimberCloudの設定画面「システム設定→マスタ管理→コンテンツ管理→ファイル付きリスト」から該当リストの「リストID」をコピーし、連携アプリ側に貼り付ける
※仕分ありのコンテンツには連携できません。
該当リストの「入力フォーマット」をクリックする

※項目を追加する場合は下記方法で入力フォーマットに設けたいカラムを登録する
連携後、ClimberCloud側の登録ユーザー情報は未指定で登録されます。
スキャナ保存した帳票を保存する場合は起票者情報が必要となるため、必ずコラボフロー側
　の申請者情報（申請者以外のケースもある場合はコラボフローフォーム内に用意した起票者
　情報項目）を入力するカラムを追加してください。
カラム名をコピーし、表示されたCSVカラム順に対応するように連携アプリ側に貼り付ける

●7.3 申請フォームと格納先フォルダの
　マッピング設定をする（コラボフロー分の設定）

連携するファイルの添付ファイルパーツを選択
コピーした「パーツID」を右に表示されているカラム名に対応するように連携アプリ側に貼り付ける

★任意：複数の添付ファイルを連携したい場合

- ファイル1の横にある[+]をクリック
- 表示されたファイル2で先ほどと同様に連携するファイルの添付ファイルパーツを選択し、ClimberCloudのカラム入力とコラボフローの項目を選択

★補足：各添付ファイルの取引先名/日付/金額/その他情報等がそれぞれ異なる場合

コラボフローのフォーム内に添付ファイルに対応するパーツを設定した上で本アプリのマッピング設定を行ってください。
7.3-3.png

全ての情報設定したら保存をクリック

●8. 連携したい経路のWebhookを設定する

マッピング設定したフォームをクリックし表示されている［WebhookのURLをコピー］をクリック
設定したフォームに対応する経路にWebhookを設定してください
複数フォームをマッピング設定した場合はそれぞれの設定が必要です

コラボフローの設定画面「アプリ設定→経路設定」から該当経路を選択し、Webhookタブから[Webhook名]、[通知先のWebhook URL]、[通知条件]を設定し、このWebhookを有効にするにチェックが入っていることを確認して保存する
- 通知条件に関して
  ※連携アプリで受信可能な通知条件は下記のみです。それ以外にチェックを付けても動作しませんので下記以外にチェックをつけないようにしてください。
  　「判定者・回覧者操作：受信時」※連携エラー時に差し戻しが可能
  　「経路終了時：申請書の経路終了時に通知する」※連携エラー時の差し戻し不可
  
  ※a,bどちらにチェックを付けることも可能ですが、2回連携処理が走る為、ClimberCloudへの登録ファイル数が2倍になります。
  どちらか1つにチェックをつけることをお勧めいたします。

連携フェーズに設定したフェーズ及びその直前のフェーズに『「申請者 = 判定者」の場合に判定をスキップする』を入れている場合は連携されませんのでご注意ください。
連携フェーズに設定したフェーズ及びその直前のフェーズに『同じ判定者が以前に承認していたら判定を自動承認する』を入れている場合も連携されませんのでご注意ください。

●8.1 連携設定案1（経路終了時に連携したい場合）

すべての承認が終了した段階（設定した経路がすべて終了）でClimberCloudに連携したい場合は
経路終了時にチェックを付けてください。
※終了時にチェックをつけている場合は連携フェーズにフェーズ名を登録しなくても連携されます。
※ClimberCloudに連携する段階で何らかのエラーが発生した場合、差し戻しされません。

●8.2 連携設定案2（最終承認者が承認した後に連携＆差し戻しは行いたい場合）

最終承認者が承認し登録内容が確定した時点で連携したい、ただしClimberCloudに連携する段階で何らかのエラーが発生した場合に差し戻しを行いたい場合、最終承認者の後に連携確認者フェーズを設け、連携フェーズに登録＆判定者・回覧者操作「受信時」にチェックを付けてください。
※「マッピング設定」で指定した連携項目は「連携フェーズ設定」で指定したフェーズが受信した段階でClimberCloudへの連携が実行されます。連携したフェーズ以降に入力された項目情報などは連携されません。

●9. 連携ログの説明

コラボフローで設定したフォームを使った申請を行い、承認されるとPDFが指定のリストに登録されます。
連携結果は連携ログに表示されます。
エラーが発生した場合は、指定のメールアドレスにエラー通知を送信することも可能です。
カンマで区切って複数のメールを入力することができます。
通知に関する設定を変更した場合は、必ず[保存]ボタンをクリックしてください。
（エラーを通知する／メールアドレスを変更する／エラー通知を解除する場合等）
連携ログのCSVファイルを出力したい場合は[CSV出力]ボタンをクリックしてください。
連携ログに表示されているログ分（1ヵ月以内で最大500件まで）が出力可能です。
ファイル名は(連携ログYYYYMMDDhhmm.csv)となります。

連携対象のマッピングが設定されていません
→マッピング設定を見直してください
プロダクトコードが未認証のため処理を終了します
→複数件分連続して発生する場合は下記情報とあわせて弊社までお問い合わせください。
- 連携ログ/詳細ログのスクリーンショット
不明なエラーが発生しました、管理者に問い合わせてください
→下記情報とあわせて弊社までお問い合わせください。
- 連携ログ/詳細ログのスクリーンショット

■FAQ

連携失敗時のメッセージについて

連携に失敗した原因に応じて、メッセージの内容は異なります。
【エラーメッセージ例】

- 取引先属性項目に存在しない取引先名が指定されています:カラム名[属性取引先]、入力値[テスト]
  - 原因：文書作成時に、ClimberCloudのカラム「取引先」で登録のない文言を入力してしまった。
  - 対処方法：コラボフローの入力値が、ClimberCloudの「システム設定」→「マスタ設定」→「web請求・受領」→「取引先」に登録ある取引先名と完全一致しているか確認してください。
- ファイル項目(fid＊＊)が設定されていません
  - 原因：文書作成時に、ファイルを添付していなかった。
  - 対処方法：添付ファイルパーツにファイルが添付されているか確認してください。
- 添付ファイルの形式はPDF、JPG（JPEG）、PNGのいずれかでなければなりません
  - 原因：添付ファイルの形式が対応していなかった。
  - 対処方法：添付ファイルの拡張子が、PDF、JPG（JPEG）、PNGのいずれかとなっているか確認してください。
- インデックスファイルの項目数が入力フォーマットで指定した項目数と一致しません
  - 原因：マッピング設定時に、連携先で設定してあるカラムの設定が不足している。
  - 対処方法：ClimberCloudのカラム数及びCSVカラム順を再度確認し、マッピング設定が同一のカラム数及びCSVカラム順となっているか確認してください。
- 先頭にダブルクォーテーションがある場合は、末尾にもダブルクォーテーションが必要です
  - 原因：文書のテキストエリアで改行が行われている。
  - 対処方法：改行を含む文字列を連携することはできません。下記いずれかの対応を実施してください。
    ・「テキストエリア」パーツから「テキスト(一行)」パーツに変更する
    ・「テキストエリア」パーツで改行を含む文字列を入力しない
- 文字列属性項目の取引先名は入力必須項目です
  - 原因：文書作成時に、入力必須項目が未入力だった。
  - 対処方法：文書の申請内容を確認してください。必須項目の確認方法はClimberCloudの「システム設定」→「マスタ設定」→「コンテンツ管理」→「ファイル付きリスト」→「対象のファイル付きリストの入力フォーマット」をクリック。 ※パーツ選択時に入力必須設定にすることをお勧めします。
- 指定された doc_id []は存在しません
  ※doc_id：ClimberCloudで採番される「文書ID」
  - 原因：該当文書がClimberCloud内で論理削除された後も連携処理が行われた場合、存在しないため更新不可となるため。
  - 対処方法：ClimberCloud内の保存状況を確認のいただき、再申請もしくはClimberCloudのアーカイブ機能から文書登録をお願いします。

その他

- プロダクトコードがわからない
  購入した販売会社にお問い合わせください。
  SaaStainer公式サイトより直接購入された方はSaaStainer問い合わせフォーム宛にお問い合わせください。
  尚、プロダクトコードについてお問い合わせいただく場合は、SaaStainerの企業IDが必要となります。
  FAQ|SaaStainerの企業ID確認方法

- 本連携アプリを利用してClimberCloudへ連携した際、下記データリクエストが発生する
  「リクエスト登録失敗（データファイルの形式と拡張子が一致しません）」
  ClimberCloudのセキュリティ強化の一環として、WebAPIからの登録時に拡張子及びファイルのマジックナンバーによるチェックが行われます。
  （例：PDFの先頭に改行コード（0D0A）がある→PDFファイルと判定されずにエラーが発生）
  →PDFファイル作成時のヘッダー設定を見直すか、「Microsoft Print to PDF」などのツールを利用してPDFを再生成してください。

- 承認しているはずなのに連携されず連携ログにも表示されない
  連携指定したコンテンツが「仕分先あり」の場合に発生することがあります。
  指定したコンテンツを仕分先なしに変更いただくか、マッピング設定で仕分先なしのコンテンツを指定して再設定してください。

- 連携アプリを利用した場合、ClimberCloudでPDFにタイムスタンプ付与する際に登録されるユーザーIDはどのユーザーになるのか
  ClimberCloudでは「文書を登録したユーザー情報」としてユーザーIDが付与されますが、タイムスタンプは登録文書に対し登録時刻等が付与されますが、ユーザー情報は付与されません。
  
  尚、本連携アプリはユーザー情報を識別していない為、連携アプリを利用して文書を登録したり更新した場合、Climbercloudではユーザーが空の状態（@system）で登録されます。

- ユーザー情報が空（@system）でもタイムスタンプが押されている事で、電子帳簿保存法には問題なく対応しているとの解釈で良いか
  電子取引の場合は◯
  スキャナ保存の場合は△ となります。
  
  電子取引の場合は、誰が登録を行ったかは要件として必須ではありませんが
  スキャナ保存の場合は情報が限定的なため誰が保存したのかを記録する必要があります。
  そのため、コラボフロー側でスキャナ保存した書類の申請時に起案者もしくは取得者情報を検索項目に持たせることで、ClimberCloud側に連携した際に保管した文書と合わせて対象者を確認することができ、対応している運用が可能です。

- - 電子取引とスキャナ保存の定義
    - スキャナ保存は、紙で受け取った書類やPCで作成して印刷した書類をスキャンし、データで保存すること。
    - 電子取引保存は、インターネットやシステムなどを通じて取引を行い、データで受取った情報を保存すること

▼SaaStainerへ戻る

SaaStainerサイトページ

▼本アプリに関する不明点は下記お問い合わせフォームからご連絡ください

お問い合わせフォーム

■アプリ概要

●アプリ機能