SharePoint 統合の設定

IMPORTANT
新しい SharePoint 統合は、22.3 リリース(2022年7月)で実稼動環境にリリースされました。ユーザーは引き続き、従来の SharePoint 統合を通じてリンクされたドキュメントにアクセスできますが、SharePoint からドキュメントをリンクするには、新しい SharePoint 統合を使用する必要があります。
  • 新しい SharePoint 統合は管理者による設定を必要せず、個々のユーザーで設定できる場合があります。ただし、新しい SharePoint 統合にスムーズに移行できるように、Workfront 管理者は、Workfront の設定領域で設定を小規模に変更する必要があります。

    詳細と手順については、本記事のドキュメントに引き続きアクセスするための従来の SharePoint 統合の設定を参照してください。

  • 従来の SharePoint 統合を通じて現在リンクされているドキュメントを、新しい統合を通じてリンクすることをお勧めします。

    ドキュメントをリンクする手順については、外部アプリケーションからドキュメントをリンクを参照してください。

Workfront を SharePoint Online と統合して、ユーザーが Workfront 内で SharePoint ドキュメントに移動し、リンクし、追加できるようにします。提供される機能は他の Workfront 統合(Google Drive、Box、Dropbox など)の機能と似ています。

編集オプションは、SharePoint Online とのみ互換性があります。SharePoint のオンプレミスインスタンス はサポートされていません。

アクセス要件

展開すると、この記事の機能のアクセス要件が表示されます。

この記事の手順を実行するには、以下を保有している必要があります。

table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
Adobe Workfront プラン* 任意
Adobe Workfront ライセンス

新規:標準

または

現在:プラン

アクセスレベル設定* Workfront 管理者であることが必要です。

この表の情報について詳しくは、Workfront ドキュメントのアクセス要件を参照してください。

前提条件

SharePoint の統合を変更または設定するには、SharePoint でのアクセス権または権限が必要です。

新しい SharePoint 統合によるドキュメントのリンク

個々のユーザーは、新しい SharePoint 統合を通してドキュメントをリンクできます。統合には管理者設定は必要ありません。代わりに、ユーザーはドキュメントをリンクするときに Microsoft アカウントにログインします。これにより、統合はユーザーの SharePoint で利用可能なドキュメントにアクセスできるようになります。

ユーザーが Workfront SharePoint 統合を自分の SharePoint アカウントに初めて接続すると、Workfront が自分の SharePoint アカウントとやり取りをするときに使用するすべての権限が表示され、それに同意するか、Microsoft 管理者にアクセス許可を要求できるようになります。読み取り権限により、Workfront は SharePoint 上のファイルの表示とアクセスを行えるようになり、書き込み権限により、ユーザーは SharePoint にファイルをアップロードできるようになります。

SharePoint の権限

新しい SharePoint 統合を通じてドキュメントをリンクする手順については、「外部ドキュメントを Workfront にリンクする」を参照してください。

NOTE
  • 組織の Microsoft 設定によっては、「権限が必要」なページではなく、「承認が必要」なページがユーザーに表示される場合があります。その場合、ユーザーはこのページを使用して、組織の Microsoft 管理者に SharePoint 統合に対する権限の付与を要求できます。

  • SharePoint 統合は、単一の SharePoint インスタンスに接続できます。したがって、ユーザーは 1 つの SharePoint に対して統合を設定できますが、2 番目の SharePoint に対する権限とドキュメントがある場合でも、2 番目の SharePoint への統合を設定することはできません。

  • ユーザーは、Workfront SharePoint の統合を通じて、SharePoint アカウントと同じサイト、コレクション、フォルダー、サブフォルダー、ファイルにアクセスできます。

SharePoint からのドキュメントのリンク

新しい SharePoint 統合を通して SharePoint からドキュメントをリンクする手順について詳しくは、外部ドキュメントの Workfront へのリンクを参照してください。

SharePoint へのドキュメントの送信

ドキュメントを SharePoint に送信するには、次の手順に従います。

  1. 送信 ​アイコン 送信 をクリックし、「SharePoint(Graph API)」を選択します。

  2. (オプション)検索バーで、ドキュメントを送信する先のサイトまたはフォルダーを検索します。

  3. リストからサイトまたはフォルダーを選択します。

    • サイトは サイトアイコン が付きます。

    • フォルダーには、 フォルダーアイコン が付きます。

    • ファイルにアイコンは付きません。

  4. 保存」をクリックします。

SharePoint 統合のセキュリティ、アクセス、および認証情報

認証と承認

Workfront は OAuth2 を使用して、アクセストークンと更新トークンを取得します。このアクセストークンは、すべての SharePoint エリアの認証に使用されます。

アクセスと権限

SharePoint から Workfront にユーザーが初めてドキュメントを追加した場合は、権限を要求するページに移動し、SharePoint 統合に対する権限を付与できます。

NOTE
組織の Microsoft 設定によっては、「権限が必要」なページではなく、「承認が必要」なページがユーザーに表示される場合があります。その場合、ユーザーはこのページを使用して、組織の Microsoft 管理者に SharePoint 統合に対する権限の付与を要求できます。

次の権限が要求されます。

アクセス
理由
ファイルへのフルアクセス権を持っている
ユーザーのファイルに Workfront がアクセスすることを許可し、アセットをリンクできるようにします。ドキュメントが Workfront から SharePoint に送信される場合、Workfront はアセットを作成するためのアクセス権を必要とします。
すべてのサイトコレクションの項目を読み取る
Workfront がアセットを読み取ってユーザーナビゲーションを可能にすることを許可します。
すべてのサイトコレクションの項目を編集または削除する
サイトおよびサイトコレクションで Workfront がアセットを作成できるようにします。「削除」は、リンクの試行に失敗した後にクリーンアップする場合にのみ使用します。
アクセス権を付与したデータへのアクセスを維持する
Workfront に更新トークンの生成を許可します。
ログインとユーザープロファイルの読み取り
Workfront が OAuth2 ログインフローを通じて、アクセストークンを使用して、ユーザーの代理として振る舞えるようにします。
  • このアクセス権は、ユーザーが初めて統合を使用する際にユーザーから付与され、いつでも取り消すことができます。
  • この統合で必要な権限は、委任された ​権限です。
  • Workfront は、統合で操作を実行するのに最低限必要なアクセス権を要求します。
  • SharePoint にリンクされている Adobe Workfront ドキュメントを表示、編集または削除するためのアクセス権は、Workfront でのユーザーのアクセス権に基づいています。ただし、SharePoint のファイルまたはフォルダーの移動、ダウンロードまたは編集には SharePoint へのアクセス権が必要であり、これらの操作へのアクセス権は SharePoint で制御されます。
  • ユーザーは、SharePoint にログインしなくても、SharePoint から提供されるサムネールやプレビュー画像を表示したり、SharePoint 内のファイル名やフォルダー名を確認したりできます。
  • ユーザーのアクセストークンが使用されるのは、ユーザーがオフラインで、Workfront にリンクされているフォルダーの内容を別のユーザーが表示する場合のみです。アクセストークンは、フォルダー内のドキュメントが追加、削除または編集されたかどうかを検出するために使用されます。

セキュリティ

Workfront と SharePoint 間のすべての通信は、情報が暗号化される HTTPS で行われます。

Workfront では、SharePoint からのデータを保存、コピーまたは複製しません。唯一の例外は、Workfront が SharePoint からのサムネールを保存して、リストビューとプレビューに表示することです。

アセットが最初に Workfront にアップロードされ、その後 SharePoint に送信された場合、Workfront には最初のファイルのデータが保持されます。ユーザーが Workfront ドキュメントの以前のバージョンをダウンロードできるからです。ドキュメントが SharePoint で作成された場合、Workfront はそのファイルデータを保存しません。

ドキュメントに継続的にアクセスできるように従来の SharePoint 統合を設定

従来の SharePoint 統合を通じて Workfront にリンクされたドキュメントにユーザーが引き続きアクセスできるようにするには、従来の SharePoint 統合へのアクセス権を再設定し、SharePoint クライアントシークレットを最新の状態に保つ必要があります。

従来の SharePoint 統合へのアクセス権を再設定

従来の SharePoint 統合を再設定することで、ユーザーが従来の SharePoint 統合からリンクされたドキュメントにアクセスできるようにする一方で、その統合から新しいドキュメントをリンクできないようにする必要があります。

NOTE
  • 従来の SharePoint 統合には「SharePoint」というラベルが付きます。
  • 新しい SharePoint 統合には「SharePoint (Graph API)」というラベルが付きます。
  1. Adobe Workfront の右上隅にある​ メインメニュー ​アイコン メインメニュー をクリックするか、または(使用可能な場合)左上隅にある​ メインメニュー ​アイコン メインメニュー 、「設定 設定アイコン の順にクリックします。
  2. 左側のナビゲーションで​ ドキュメント ​を選択したあと、クラウド プロバイダー ​を選択します。
  3. SharePoint ​オプションと​ SharePoint (Graph API) ​オプションが両方とも有効になっていることを確認します。
  4. 保存 ​をクリックします。
  5. 左側のナビゲーションで​ ドキュメント ​を選択したあと、SharePoint統合 ​を選択します。
  6. 既存のすべての統合のリストの左側にあるチェックマークを選択したあと、「無効にする」を選択します。

従来の SharePoint 統合に継続的にアクセスできるようにクライアントシークレットを設定

お使いの SharePoint クライアントシークレットは 1 年で有効期限が切れます。従来の SharePoint 統合でドキュメントに継続的にアクセスできるようにするには、その SharePoint クライアントシークレットを最新の状態に保つ必要があります。

IMPORTANT
SharePoint クライアントシークレットは Microsoft で処理されるので、クライアントシークレットの機能と手順は、Microsoft による SharePoint の更新に応じて変更される可能性があります。SharePoint の手順と機能の最新情報については、常に Microsoft のドキュメントを参照してください。
  1. SharePoint アドインで期限が切れたクライアントシークレットの置換の説明に従って、新しいクライアントシークレットを生成します。
  2. このクライアントシークレットを安全な場所にコピーします。
  3. Workfront に管理者としてログインします。
  4. Workfront で、Adobe Workfront の右上隅にある​ メインメニュー ​アイコン メインメニュー をクリックするか、(利用可能であれば)左上隅にある​ メインメニュー ​アイコン メインメニュー をクリックして、セットアップ セットアップ をクリックします。
  5. 左パネルで、ドキュメントSharePoint統合 ​をクリックします。
  6. 更新する SharePoint 統合をクリックしたあと、「編集」をクリックします。
  7. 編集中のウィンドウの「接続情報」セクションに移動し、新しいクライアントシークレットを「SharePoint クライアント機密」フィールドに入力します。
  8. 保存 ​をクリックします。

トラブルシューティング

問題:SharePoint 統合を使用すると、ユーザーに認証ベースのエラーが発生します。 problem-users-experience-authentication-based-errors-when-using-the-sharepoint-integration

解決策:

ユーザーは、SharePoint サイトに対する適切な権限を持っている必要があります。

フルコントロールのアクセス権を持つユーザーは、SharePoint 統合に必要なすべての権限を持っています。ユーザーにフルコントロールアクセス権を付与したくない場合は、次の権限を付与する必要があります。

Design
表示、追加、更新、削除、承認、カスタマイズが可能
Edit
リストの追加、編集、削除が可能。リスト項目とドキュメントの表示、追加、更新、削除が可能
Contribute
リスト項目とドキュメントの表示、追加、更新、削除が可能
View only
ページ、リスト項目、ドキュメントの表示が可能(サーバーサイドのファイルハンドラーを持つドキュメントタイプは、ブラウザーで表示可能でダウンロード不可)

権限レベルの作成および編集手順について詳しくは、Microsoft ドキュメントの権限レベルの作成および編集方法を参照してください。

問題:Workfront 内の SharePoint ファイルを参照しようとすると、サイトコレクションの一部またはすべてが表示されません。 problem-when-attempting-to-browse-sharepoint-files-in-workfront-i-do-not-see-any-or-all-of-my-site-collections

解決策:

Workfront でサイトコレクションを表示するには、次の条件を満たす必要があります。

  • ユーザーは、SharePoint のサイトコレクションに対するビューアクセス権を持っている必要があります。

    SharePoint でこれを検証するには、SharePoint でサイトコレクションの権限を確認します。

問題:SharePoint で以前にリンクされたフォルダーやドキュメントにアクセスできません。 problem-i-cannot-access-previously-linked-folders-and-documents-in-sharepoint

解決策:

SharePoint フォルダーをリンクしたユーザーが認証できなくなった場合、Workfront はフォルダーのコンテンツにアクセスできなくなります。この問題は、例えば、フォルダーを最初にリンクしたユーザーが退職した場合に発生する可能性があります。

引き続きアクセスできるように、フォルダーへのアクセス権を持つユーザーは、フォルダーを再リンクする必要があります。

外部プロバイダーからのフォルダーのリンクについて詳しくは、外部アプリケーションからのドキュメントのリンクを参照してください。

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43