Microsoft SharePoint の App Connect 使用方法

対応製品およびAPIバージョン

このコネクタがサポートする製品およびAPIのバージョンについては、 IBM サポートページの 「詳細なシステム要件 」を参照してください。

最初に考慮すべきこと

Microsoft SharePoint で App Connect Designer を使用する前に、以下の点に注意してください：

• SAML による認証を使用して SharePoint Onlineへの接続を認証する場合、 App Connect は二要素認証に対応していません。 Microsoft SharePoint アカウントで App Connect をご利用になる前に、そのアカウントの二段階認証が無効になっていることを確認してください。
• Microsoft SharePoint コネクタは、個人用サイト コレクションへのアクセスに使用できません。 個人サイト コレクションを操作するには、 Microsoft OneDrive for Business コネクタを使用できます。

Microsoft SharePoint への接続

App Connect Designer の 「Connect > Applications and APIs 」ページ（ 旧カタログページ） またはフローエディタに表示される接続フィールドを完了してください。 必要であれば、 Microsoft SharePoint の管理者と協力して、これらの値を取得してください。

App Connect から Microsoft SharePoint アカウントへの接続を作成するには、以下の手順を実行します。

1. 以下のいずれかのオプションを使用して、 Microsoft Sharepointへの接続ダイアログボックスを開きます：
   • Microsoft SharePoint に初めて接続する場合は、[ 接続]をクリックします。
   • 別の Microsoft SharePoint 接続を追加するには、[Accounts]リストを展開し、[ Add new account ]をクリックします。
2. 「Microsoft SharePoint に接続」 ダイアログ ボックスで、接続する適切なタイプを選択します。
   • Microsoft SharePoint クラウドベースのサービスに接続するには、 SharePoint Online を選択します。
   • 構内の Microsoft SharePoint Serverに接続するには、 SharePoint Softwareを選択する。
3. SharePoint Onlineを選択した場合は、 認証方法を選択します：

   認証方法	接続フィールド	説明
   基本的なOAUTH	アプリケーションクライアントID	Microsoft Azure アプリ登録後に生成される一意の識別子。リクエストを特定のプロジェクトに関連付けるために使用される
   	アプリケーション・クライアント・シークレット	特定のプロジェクト用に作成された固有のアプリケーションクライアントIDのアプリケーションクライアントシークレット
   	OAuth アクセス トークン	アプリケーションクライアントIDとアプリケーションクライアントシークレットから生成されるアクセス トークン
   	OAuth リフレッシュトークン	アプリケーションクライアントIDとアプリケーションクライアントシークレットから生成されるリフレッシュトークン
   	SharePoint オンライン URL	SharePoint オンライン URL は、Microsoft SharePoint サービスへの直接サインインを提供します。例えば、 https://anyorganization.sharepoint.com ヒント: 同じブラウザウィンドウで Microsoft SharePoint にログインしている場合、 App Connect は自動的に接続 App Connect できます。
   ご注意： Microsoft SharePoint コネクタでは、 SAML ベースの認証は非推奨となっています。 コネクタを引き続き使用するには、サポートされている認証タイプのいずれかを設定してください。 SAML 制限事項：SAML による認証を使用して SharePoint Onlineへの接続を認証する場合、 App Connect では二要素認証はサポートされていません。 Microsoft SharePoint アカウントで App Connect をご利用になる前に、そのアカウントの二段階認証が無効になっていることを確認するか、「 Web サイトを使用する ( OAuth2 ) 」オプションを選択してください。	SharePoint オンライン URL	SharePoint オンライン URL は、Microsoft SharePoint サービスへの直接サインインを提供します。例えば、 https://anyorganization.sharepoint.com ヒント: 同じブラウザウィンドウで Microsoft SharePoint に既にログインしている場合、 App Connect は自動的に接続 App Connect できます。
   	サイトコレクションのパス	サイト コレクション URL は、 SharePoint URL に対して相対的な SharePoint です。例えば、 /TeamSite または /sites/mysitecollection
   	ユーザー名	Microsoft SharePoint アカウントのユーザー名
   	パスワード	Microsoft SharePoint アカウントのパスワード
   oauth 2.0 認証コード	SharePoint オンライン URL	SharePoint オンライン URL は、Microsoft SharePoint サービスへの直接サインインを提供します。例えば、 https://anyorganization.sharepoint.com ヒント: 同じブラウザウィンドウで Microsoft SharePoint に既にログインしている場合、 App Connect は自動的に接続 App Connect できます。

4. SharePoint ソフトウェアを選択した場合は、 バージョンを選択し、 認証方法を選択します。

   認証方法	接続フィールド	説明
   基本	SharePoint 構内ホストとポート	SharePoint オンプレミスWebアプリケーション URL は、Microsoft SharePoint サービスへの直接サインインを提供します。例えば、 https://mysharepointhost:8443
   	サイトコレクションのパス	サイト コレクション URL は、 SharePoint URL に対して相対的な SharePoint です。例えば、 /TeamSite または /sites/mysitecollection
   	ユーザー名	Microsoft SharePoint アカウントのユーザー名
   	パスワード	Microsoft SharePoint アカウントのパスワード
   	プライベート・ネットワーク接続	プライベート・ネットワークに接続するために App Connect を選択します。 このリストには、 プライベートネットワークページで作成されたプライベートネットワークエージェントの名前が入力されます。 詳しくは、 プライベートネットワークへの接続をご覧ください。
   注意コンテナ環境では、NTLM ベースの認証の使用は推奨されません。 エヌティーエルエム v1	SharePoint 構内ホストとポート	SharePoint オンプレミスWebアプリケーション URL は、Microsoft SharePoint サービスへの直接サインインを提供します。例えば、 https://mysharepointhost:8443
   	サイトコレクションのパス	サイト コレクション URL は、 SharePoint URL に対して相対的な SharePoint です。例えば、 /TeamSite または /sites/mysitecollection
   	ユーザー名	Microsoft SharePoint アカウントのユーザー名
   	パスワード	Microsoft SharePoint アカウントのパスワード
   	ドメイン	オンプレミスの SharePoint アカウントにログインする際に使用するドメイン
   	ワークステーション	SharePoint がインストールされているワークステーションまたはサーバー名
   	プライベート・ネットワーク接続	プライベート・ネットワークに接続するために App Connect を選択します。 このリストには、 プライベートネットワークページで作成されたプライベートネットワークエージェントの名前が入力されます。 詳しくは、 プライベートネットワークへの接続をご覧ください。

5. 「続行」をクリックしてください。

Microsoft SharePoint の接続値を取得するには、 Microsoft SharePoint の接続値の取得を参照してください。

App Connect Designer Applications and APIs ページから Microsoft SharePoint エンドポイントに初めて接続するには、 Microsoft SharePoint を展開し、 Connect をクリックします。 詳細については、 アカウントの管理を参照してください。

一般的な考慮事項

Microsoft SharePoint で App Connect Designer を使用する前に、以下の一般的な考慮事項に注意してください：

• (一般的な考察) App Connect Designerの Applications and APIs ページで利用可能なトリガーイベントとアクションのリストを見ることができます。

  アプリケーションによっては、イベントとアクションは環境と、コネクタが設定可能なイベントとアクションの動的検出をサポートしているかどうかに依存する。 アプリケーションが設定可能なイベントをサポートしている場合、イベント・リストの下に Show more configurable events リンクが表示されます。 アプリケーションがアクションのダイナミックディスカバリーをサポートしている場合、アクションリストの下に Show more リンクが表示されます。

• (一般的な考慮事項）アプリケーションに複数のアカウントを使用している場合、そのアプリケーションのアクションを選択したときに表示されるフィールドのセットは、アカウントによって異なる可能性があります。 フローエディターでは、アプリケーションによっては、常にアクションのための静的フィールドのキュレーションセットを提供します。 他のアプリケーションは、接続先のインスタンスで設定されているフィールドのセットを取得するために、ダイナミック・ディスカバリーを使用します。 例えば、あるアプリケーションの2つのインスタンスに2つのアカウントがある場合、最初のアカウントはすぐに使える設定を使うかもしれません。 しかし、2つ目のアカウントには余分なカスタムフィールドが設定されている可能性があります。

ポスト接続に関する考慮事項

出来事と行動

マイクロソフト SharePoint イベント

これらのイベントは、フロー内のアクションを完了するためにフローを開始するトリガーとなる、このアプリケーションの変更に対するものである。

より多くの設定可能なイベントを表示します：デフォルトで表示されるイベントは、最適化された接続を使用して事前に設定されています。 新しいオブジェクトや更新されたオブジェクトについてこのアプリケーションをポーリングしてフローをトリガーできるイベントを設定すると、さらに多くの項目が利用できるようになります。

あなたのフローは、このアプリケーション上でこれらのアクションを完了します。