DocSpace用Pipedrive

主な機能

• Pipedrive取引内でのDocSpaceルームの作成。
• Pipedrive取引内のDocSpaceルームでの文書、スプレッドシート、プレゼンテーション、PDFフォームの作成と編集。

対応フォーマット

• 作成、編集、表示用: DOCX, PPTX, XLSX。
• フォーム入力用: PDF。
• 表示用: CSV, DJVU, DOC, DOCM, DOT, DOTM, DOTX, EPUB, FB2, FODP, FODS, FODT, HTM, HTML, MHT, ODP, ODS, ODT, OTP, OTS, OTT, OXPS, PDF, POT, POTM, POTX, PPS, PPSM, PPSX, PPT, PPTM, RTF, TXT, XLS, XLSM, XLT, XLTM, XLTX, XML, XPS。

バージョン1.1.0の新機能

追加

• 作成時にルームタイプを選択する機能
• @onlyoffice/docspace-sdk-jsの使用

変更

• DocSpace 3.0のサポート
• システムユーザーの代わりにDocSpace APIキーの使用
• 取引に紐付けられたルームに「コンテンツクリエーター」権限で「共有グループ」を招待
• 取引に紐付けられたルームに「コンテンツクリエーター」権限で取引フォロワーを招待
• タグ付きルームの作成にAPIを使用
• デフォルトでパブリックルームを作成

完全な変更ログはこちらで確認できます。

要件

• Pipedriveアカウント。
• ONLYOFFICE DocSpaceのSaaSまたはサーバーバージョン。
• Pipedrive用ONLYOFFICE DocSpaceアプリ。

Pipedrive用ONLYOFFICE DocSpaceアプリのインストールと設定

ONLYOFFICE DocSpaceアプリはPipedriveマーケットプレイスからインストールできます。

Pipedriveの管理者は、Pipedrive内のマーケットプレイスアプリセクションを通じてアプリを設定できます：ツールとアプリ -> マーケットプレイスアプリ -> ONLYOFFICE DocSpaceアプリ。

DocSpaceの設定

1. 左下隅のメニューを使用し、設定オプションを選択します。
2. 開発者ツール -> APIキーセクションに切り替えます。
3. 新しい秘密鍵を作成ボタンをクリックします。
   APIキーはDocSpace管理者の役割を持つユーザーによって作成される必要があります。
4. フォームに入力します：
   • 名前 - 秘密鍵の名前を指定します。
   • 権限 - 権限をすべてに設定するか、制限付きオプションを選択して独自の権限を設定できます。
     • すべて - すべてのセクションに対する読み取りおよび書き込み権限を有効にします。
     • 制限付き - 特定のセクションに対する読み取りまたは書き込み権限を有効にします。必要なオプションの横にある読み取りまたは書き込みボックスをチェックします。APIキーの最小権限：ルーム - 書き込み、プロファイル - 読み取り、連絡先 - 書き込み。
   
5. 生成ボタンをクリックします。
6. 新しいウィンドウで生成されたキーをコピーし、完了をクリックします。

Pipedriveの設定

ONLYOFFICE DocSpaceアプリケーションをインストールするには：

1. マーケットプレイスセクションを開きます。
2. ページ上部の検索バーを使用してONLYOFFICE DocSpaceをアプリセクションで見つけます。
3. 開いたウィンドウで認証ボタンをクリックします。
4. アプリに付与する権限に同意する場合は、許可してインストールボタンをクリックします。
5. 「ONLYOFFICE DocSpaceの使用方法」の手順が表示されます。その後、接続設定が開きます。
6. DocSpaceサービスアドレスフィールドに、インストールされたONLYOFFICE DocSpaceのURLまたはONLYOFFICE DocSpace Cloudのアドレスを指定し、矢印ボタンを押します。
7. ONLYOFFICE DocSpace APIキーフィールドに、生成した秘密鍵を指定します。
8. 接続ボタンをクリックします。

接続が成功すると、このページに2つのボタンが表示されます：

• 変更: 別のDocSpaceに接続する機能。現在のDocSpaceのデータは削除されません。
• 切断: アプリを完全に無効にします（ユーザー認証とフックをクリア）。この場合、PipedriveユーザーグループとPipedriveの接続が削除されます。このオプションは、DocSpaceアプリのデータを完全にクリアする必要がある場合にのみ使用することをお勧めします。

認証設定

このセクションは、接続設定が構成された後に利用可能です。

ここで、DocSpaceの認証情報（メールアドレスとパスワード）を入力し、ログインをクリックします。

認証が成功すると、コネクタの使用に関する指示が表示されます。

指示を確認した後（スキップまたは完了ボタンを押した場合）、認証ページに認証ステータスとログアウトボタンが表示されます。また、必要なPipedriveセクションに切り替えるための取引に移動ボタンも利用可能です。ガイドを開くボタンを使用すると、コネクタの使用に関する指示を再度開くことができます。

アプリの使用

Pipedriveの取引セクションを通じてONLYOFFICE DocSpaceアプリにアクセスできます：該当する取引に移動し、DocSpaceフレームを見つけます。

各取引に対して、取引参加者がオフィス文書を共同で作業できる別のDocSpaceルームを作成できます。ルームを作成するには、ルームを作成ボタンをクリックします。DocSpaceでパブリックルームが作成されます。

別のルームタイプが必要な場合は、ルームを作成ボタンの横にある矢印をクリックし、適切なオプションを選択します：

• パブリックルーム - 外部ユーザーやクライアントとファイルを共有するため
• コラボレーションルーム - チームと文書を共同編集するため
• VDR - 高度なファイル保護を提供するため
• フォーム入力ルーム - PDFフォームでデータを収集するため
• カスタムルーム - 目的に応じて作業するため

新しいウィンドウでルーム作成を確認します。ルームタイプについて詳細はこちらをご覧ください。

ルームはPipedrive - 会社名 - 取引名のルールに従って命名されます。また、「Pipedrive Integration」というタグが付けられ、識別と整理が容易になります。

DocSpaceフレーム内では、取引参加者はアクセス権に応じて作業できます。

アクセス権

DocSpaceアプリにログインしたすべてのPipedriveユーザーは、Pipedriveユーザー（会社名）グループに追加されます。ユーザーがDocSpaceからログアウトすると、グループから削除されます。

取引内のルームへのアクセス権は、対応する取引に対するPipedriveのアクセス権によって決まります。

• すべてのユーザー: ルームはPipedriveユーザーグループに加え、名前で招待されたフォロワーにも利用可能になります（DocSpaceアプリをインストールし、認証を受けたユーザーのみ）。
• アイテムオーナー: ルームは取引のオーナーと名前で招待されたフォロワーにのみアクセス可能です。この場合、取引のオーナーとフォロワーはDocSpaceアプリをインストールし、認証を受ける必要があります。
• アイテムオーナーの可視性グループ: フォロワーのみが同期されます（Pipedriveの有料版で利用可能）。
• アイテムオーナーの可視性グループとサブグループ: フォロワーのみが同期されます（Pipedriveの有料版で利用可能）。

重要事項

1. ユーザーがDocSpaceでPipedriveユーザーグループを手動で削除した場合、最初のアクセス時に自動的に復元されます。
2. ユーザーがDocSpaceでPipedriveの取引にリンクされたルームを手動で削除した場合、アプリケーションフレーム内のルームを作成ボタンをクリックして再度ルームを作成できます。
3. Pipedriveユーザーが取引内のルームにアクセスできない場合、対応するボタンをクリックしてアクセスをリクエストできます。この操作により、ユーザーがルームにアクセスできるかどうかが確認されます。アクセスできる場合、ユーザーはアクセス権に基づいてルームに追加されます。アクセスできない場合、対応する通知が表示されます。
4. APIキーが無効になった場合（有効期限切れや権限の変更による）、アプリケーションはブロックされます。設定に移動ボタンをクリックしてAPIキーを確認してください（Pipedriveの設定サブセクションを参照）。
5. Webhookが設定されていない場合、対応するボタンをクリックしてプラグインを再インストールする必要があります。