Flex Gateway新着情報
Governance新着情報
Monitoring API ManagerMicrosoft SharePoint 2013 Connector v2.3
Microsoft SharePoint 2013 用 Anypoint Connector (SharePoint 2013 Connector) は、コンテンツとドキュメントの管理、イントラネットポータル、コラボレーション、エクストラネット、Web サイト、およびエンタープライズ検索用の Web アプリケーションプラットフォームです。
このコネクタを使用すると、REST API を介した SharePoint 2013 とのインテグレーションが可能になります。
リリースノート: 『Microsoft SharePoint 2013 Connector リリースノート』
サンプル: sharepoint-connector-samples.zip
FAQ: [よくある質問]
リストおよびリスト項目の API:
リストおよびリスト項目の Create、Delete、Retrieve、Update
ファイルおよびフォルダーの API:
ファイル:
ファイルの Add、Retrieve content、Retrieve metadata、Delete、Check out、Undo checkout、Check in、Publish、Unpublish、Approve、Deny、Recycle、Copy
フォルダー:
フォルダーの Create、Delete、Retrieve
Microsoft SharePoint 2013
Microsoft SharePoint Online
SharePoint Online とやりとりする場合、FileQuery 操作と FolderQuery 操作はサポートされません。
Studio プロジェクトを Maven 化する場合、プロジェクトの pom.xml ファイルでこの情報を使用できます。
<dependency>
<groupId>org.mule.modules</groupId>
<artifactId>mule-module-sharepoint-2010</artifactId>
<version>x.x.x</version>
<classifier>mule-plugin</classifier>
</dependency>
xml
x.x.x
を使用しているコネクタに対応するバージョンに置き換えます。
最新の pom.xml
ファイル情報を取得するには、 Anypoint Exchange でコネクタにアクセスし、[Dependency Snippets (連動関係スニペット)] をクリックします。
SharePoint 2013 では、アクセスする Microsoft SharePoint に基づいて異なる認証スキームがサポートされます。
サポート対象のオンプレミスの Microsoft SharePoint 認証:
NTLM
Microsoft ADFS に対するクレームベース認証
Microsoft ADFS から取得したセキュリティトークン
サポート対象外の認証: Kerberos
サポート対象の Microsoft SharePoint Online 認証:
Microsoft Online (Office 365) 管理対象ユーザー
Microsoft ADFS に対する Microsoft Online (Office 365) 統合ユーザー
Microsoft Online から取得したセキュリティトークン
標準の SharePoint Online ユーザーログイン情報
クレームベース認証を使用するようにコネクタを設定するためには、認証で使用するセキュリティトークンサービス (STS) からの次の情報が必要です。
STS URL
ユーザーを認証するためのユーザー名とパスワードを受け入れて WS-Trust 1.3 プロトコルを理解する STS エンドポイント。STS が Microsoft の ADFS (Active Directory フェデレーションサービス) の場合、通常、この URL は次のようになります。
https://youradfs.com/adfs/services/trust/13/usernamemixed
。
STS アプリケーション識別子
STS 内の SharePoint サイトを識別する文字列。これは、依存パーティ ID、クライアント ID、スコープ、または領域とも呼ばれます。STS が Microsoft の ADFS の場合、この値を AD FS 管理コンソールの [AD FS] の下の [Trust Relationships (信頼関係)] > [Relying Party Trusts (証明書利用者信頼)] > (SharePoint サイトの証明書利用者プロパティ) > [Identifiers (識別子)] タブで見つけることができます。
STS アプリケーション識別子は、Web ブラウザーでサイト URL を開くことでアクセスする SharePoint サイトにログインして取得できます。サイトで複数の認証プロバイダーが設定されている場合、ドロップダウンメニューにいくつかのオプションが表示されます。STS のログインページにリダイレクトする、目的の STS を選択します。この時点で、Web ブラウザーのアドレスバーには、次のクエリパラメーターを含む URL が含まれます。
wa=wsignin1.0&wtrealm=uri%3amule%3asp80
パラメーター wa は、サインインが開始された場合に STS に伝えます。wtrealm には、STS アプリケーション識別子の URI エンコードされた値が含まれます。この例では、uri%3amule%3asp80
は uri:mule:sp80
です。エンコードされていない値は、コネクタの設定用のパラメーターです。
SAML セキュリティトークンを使用して、SharePoint にログインできます。POST 要求を介して XML 本文を提供することで、Studio の [Security Token (セキュリティトークン)] 項目に入力したセキュリティトークンを取得することができます。
セキュリティトークンを取得するには、次の XML 本文で https://login.microsoftonline.com/extSTS.srf
に POST 要求を実行します。
<s:Envelope xmlns:s="http://www.w3.org/2003/05/soap-envelope" xmlns:a="http://www.w3.org/2005/08/addressing" xmlns:u="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"> <s:Header> <a:Action s:mustUnderstand="1">http://schemas.xmlsoap.org/ws/2005/02/trust/RST/Issue</a:Action> <a:ReplyTo> <a:Address>http://www.w3.org/2005/08/addressing/anonymous</a:Address> </a:ReplyTo> <a:To s:mustUnderstand="1">https://login.microsoftonline.com/extSTS.srf</a:To> <o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"> <o:UsernameToken> <o:Username>[username]</o:Username> <o:Password>[password]</o:Password> </o:UsernameToken> </o:Security> </s:Header> <s:Body> <t:RequestSecurityToken xmlns:t="http://schemas.xmlsoap.org/ws/2005/02/trust"> <wsp:AppliesTo xmlns:wsp="http://schemas.xmlsoap.org/ws/2004/09/policy"> <a:EndpointReference> <a:Address>[endpoint]</a:Address> </a:EndpointReference> </wsp:AppliesTo> <t:KeyType>http://schemas.xmlsoap.org/ws/2005/05/identity/NoProofKey</t:KeyType> <t:RequestType>http://schemas.xmlsoap.org/ws/2005/02/trust/Issue</t:RequestType> <t:TokenType>urn:oasis:names:tc:SAML:1.0:assertion</t:TokenType> </t:RequestSecurityToken> </s:Body> </s:Envelope>
text
この要求の応答の <wsse:BinarySecurityToken> タグの間にセキュリティトークンが含まれます。
セキュリティトークンを取得したら、Studio でトークン値を指定します。
Security token (セキュリティトークン): 対応するセキュリティトークンを入力します。
Site URL (サイト URL): 対応するサイトの URL を入力します。
Anypoint Studio で、Studio タスクバーの Exchange アイコンをクリックします。
Anypoint Exchange で [Login (ログイン)] をクリックします。
コネクタを検索して [Install (インストール)] をクリックします。
画面の指示に従ってコネクタをインストールします。
Studio の更新がある場合、右下隅にメッセージが表示されます。メッセージをクリックすると、更新をインストールできます。
設定方法:
Anypoint Studio で、[File (ファイル)] > [New (新規)] > [Mule Project (Mule プロジェクト)] をクリックします。
[Project Name (プロジェクト名)] を指定して、[Finish (完了)] をクリックします。
[Global Elements (グローバル要素)] タブをクリックします。
[Create (作成)] をクリックします。
[Search (検索)] テキストボックスに「sharepont」と入力します。
[Microsoft SharePoint] をクリックして [OK] をクリックします。
設定するグローバル種別を選択します。
レガシー接続:
[Username (ユーザー名)]、[Password (パスワード)]、および [Site URL (サイト URL)] を入力します。
認証については、次のように設定します。
自己署名 SSL 証明書を使用する場合、[Disable SSL certificate validation (SSL 証明書検証の無効化)] チェックボックスをクリックします。
クレーム認証を使用して接続するには、STS URL (セキュリティトークンサービス) とスコープ (依存パーティ ID) を入力します。 STS URL は、認証ログイン情報としてユーザー名とパスワードを受け入れて WS-Trust 1.3 標準を理解する STS のエンドポイントを参照する必要があります。通常、ADFS ではエンドポイントは https://myadfs.com/adfs/services/trust/13/usernamemixed
になります。また、エンドポイントを ADFS で有効にする必要があります (デフォルトでは有効)。
NTLM 認証を使用して接続するには、[Domain (ドメイン)] を入力します。
SharePoint Online に接続するには、NTLM とクレームの入力を空のままにします。[Username (ユーザー名)]、[Password (パスワード)]、および [Site URL (サイト URL)] のみを入力します。
[Test Connection (接続をテスト)] をクリックして、正しく接続されることを確認します。
もう一方の接続種別にも同様の情報が必要です。
注意: [Pooling Profile (プーリングプロファイル)]、[Reconnection (再接続)]、および [Notes (メモ)] タブは無視できます。これらは Studio によって提供され、デフォルト情報を含みます。
Anypoint Studio フローを作成する手順は、次のとおりです。
Anypoint Studio で、[File (ファイル)] > [New (新規)] > [Mule Project (Mule プロジェクト)] をクリックします。
[Project Name (プロジェクト名)] を指定して、[Finish (完了)] をクリックします。
検索ボックスに「http」と入力し、HTTP Connector をキャンバスにドラッグします。
検索ボックスに「sharepoint」と入力し、Microsoft SharePoint Connector インスタンスを HTTP Connector の横にドラッグします。
検索ボックスに「json」と入力し、[Object to JSON] トランスフォーマーを Microsoft SharePoint Connector の横にドラッグします。
HTTP Connector をダブルクリックします。[Host (ホスト)] が「localhost」に設定され、[Port (ポート)] が「8081」に設定されていることを確認します。[Path (パス)] を [query (クエリ)] に設定します。[OK] をクリックします。
Microsoft SharePoint Connector をダブルクリックして、緑色のプラス記号をクリックします。
次の設定値を更新します。
[Connector Configuration (コネクタ設定)] リストで、以前に作成した Microsoft SharePoint 設定をクリックします。
[Operation (操作)] リストから、[List query (リストクエリ)] をクリックします。
注意: [List query (リストクエリ)] オプションは、SharePoint インスタンスに正常に接続された後にのみ [Operation (操作)] リストに表示されます。
[Language (言語)] リストから、[DataSense Query Language (DataSense クエリ言語)] を選択します。
クエリビルダーをクリックします。
[Types (種別)] のリストから、[Documents (ドキュメント)] をクリックします。
[Fields (項目)] のリストから、[ID] と [Title (タイトル)] をクリックします。
[Order By (並び替え基準)] から、[Title (タイトル)] をクリックします。
[Direction (方向)] から、[DESCENDING (降順)] をクリックします。
Package Explorer で [sharepoint2013-demo] を右クリックし、[Run As (別のユーザーとして実行)] > [Mule Application (Mule アプリケーション)] を選択します。
アプリケーションの起動時にコンソールを確認します。エラーが発生していない場合、次のメッセージが表示されます。
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + Started app 'sharepoint2013-demo' + ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
text
インターネットブラウザーを開いて http://localhost:8081/query にアクセスします。
ドキュメントのリストがタイトルの降順で並び替えられ、JSON 形式で返されます (結果は SharePoint 2013 インスタンスに応じて異なります)。
[{"__metadata":{"id":"Web/Lists(guid'2af685ae-5aec-4f60-b175- 54b21b6bd668')/Items(4)","uri":"https://ec2-54-200-49-206.us-west- 2.compute.amazonaws.com/_api/Web/Lists(guid'2af685ae-5aec-4f60-b175- 54b21b6bd668')/Items(4)","etag":"\"1\"","type":"SP.Data.Shared_x0020_Document sItem"},"Id":4,"ID":4,"Title":"folder"}]
text
リストおよびリスト項目の API を使用して、SharePoint リストおよびリスト項目を作成、取得、更新、削除します。
項目を作成または更新する場合、リスト ID を指定します。ID を指定すると、DataSense はリストのメタデータを取得し、入力可能な各項目がオブジェクトビルダーに表示されます。
<sharepoint-2013:list-create config-ref="SharePoint_2013" doc:name="SharePoint 2013" baseTemplate="GENERIC_LIST" title="Title">
<sharepoint-2013:list ref="#[payload]"/>
</sharepoint-2013:list-create>
xml
または、コネクタ自体で属性を定義します。
<sharepoint-2013:list-create config-ref="SharePoint_2013" doc:name="SharePoint 2013" baseTemplate="GENERIC_LIST" title="Title">
<sharepoint-2013:list contentTypesEnabled="true" description="Description"/>
</sharepoint-2013:list-create>
xml
リストの取得および削除には、リスト ID のみが必要です。
<sharepoint-2013:list-delete config-ref="SharePoint_2013" doc:name="SharePoint 2013" listId="8e306633-c600-40ab-80db-80f57968c0a1" />
xml
クエリビルダーを使用します。
左側のパネルには、非表示以外のすべてのリストが表示されます。右側のパネルには、選択したリストの項目が表示されます。項目が参照項目の場合、データ型は SharepointListReference
または SharepointListMultiValueReference
です。
このいずれかの項目をクエリで返すように選択している場合、[Retrieve full objects for reference fields (参照項目のすべてのオブジェクトを取得)] チェックボックスの値に応じて 2 つの種別の戻りオブジェクトを使用できます。
オフ:
参照オブジェクトの ID と参照オブジェクトリストの ID を含む概要オブジェクト。
{
"Title": "A title",
"LookupFieldId": {
"id": "1",
"lookupListId": "aaaa-1111-bbbb-2222"
},
"MultiValueLookupFieldId": {
"ids": [
1,
2,
3
],
"lookupListId": "cccc-3333-dddd-4444"
}
}
json
後でこのオブジェクトを別のコネクタで使用して、参照先のオブジェクトを for-each コンポーネントと共に取得できます。
オン:
完全なオブジェクトグラフを取得します。サイクルがある場合は、概要参照オブジェクトが表示されます。
{
"Title": "A title",
"LookupFieldId": {
"Title": "Another title",
"Id": "1",
"Property1": "A value"
},
"MultiValueLookupFieldId": [
{
"Title": "Another title",
"Id": "1",
"Property1": "A value"
},
{
"Title": "Another title",
"Id": "2",
"Property1": "A value"
}
]
}
json
クエリテキストの例:
注意: このオプションをオンにすると、多くの参照項目がある大きな項目リストの取得に時間がかかることがあります。
このコネクタのバージョン 2.1.10 以降、(以下のような他のリストの操作に加えて) DSQL クエリで内部項目名またはタイトル項目名を使用できます。
たとえば、前述のクエリは次のようになります。
SELECT AuthorId, Created, List3MultiId FROM 8e306633-c600-40ab-80db-80f57968c0a1
各タイトルが次の [Author (作成者)]、[Date Created (作成日)]、および [Details (詳細)] の場合、項目名を使用してクエリを記述できます。
SELECT Author, 'Date created', Details FROM Inventory
内部項目名とタイトル項目名を混在させることもできます。
SELECT AuthorId, 'Date created', List3MultiId FROM Inventory
内部項目名とタイトル項目名は、次の場合にのみ次のリスト操作で使用できます。
新しい項目をリストに追加する
リスト内の既存の項目を更新する
リスト内の項目を照会する
注意: DSQL 句で検索条件を指定する場合、日時データ型で絞り込むには、ISO-8601 形式を使用して値を記述します (例: [Created (作成日)] > 「2000-01-01T00:00:00-03:00」)。
ファイルとフォルダーの API を使用すると、ファイルとフォルダーの作成、取得、更新、削除のほか、ファイルのチェックイン、チェックアウト、パブリッシュ、承認、拒否、コピー、リサイクルをドキュメントリストから行うことができます。
フォルダー操作を使用する場合、サーバーの相対 URL は、フォルダーが存在する場所を参照します。URL の形式は、/site/docList/innerFolder または docList/innerFolder にすることができます。後者の場合、コネクタの設定のサイト URL パラメーターで指定されたサイトが使用されます。
ファイル操作を使用する場合、ファイルサーバーの相対 URL は、フォルダーサーバーの相対 URL とファイル名 (/site/docList/innerFolder/filename または docList/innerFolder/filename) を参照します。
フォルダーを作成または削除するには、サーバーの相対 URL (フォルダーが存在する場所、またはフォルダーを作成する予定の場所) を指定することができます。
結果のフローは次のようになります。
<sharepoint-2013:folder-create config-ref="SharePoint_2013"
url="/path/to/folder" doc:name="SharePoint 2013"/>
<sharepoint-2013:folder-delete config-ref="SharePoint_2013"
url="/path/to/folder" doc:name="SharePoint 2013"/>
xml
ファイルをアップロードするには、物理ファイルを選択するか、入力ストリームをコネクタに渡すことができます。これにより、指定されたサーバーの相対 URL にファイルがアップロードされます。たとえば、次の入力ストリームを File Connector と共に使用して、ファイルをリストにアップロードできます。
次の入力ストリームを使用します。
<sharepoint-2013:file-add config-ref="SharePoint_2013"
fileServerRelativeUrl="/path/to/folder/filename"
fileContentStream-ref="#[payload]" overwrite="true"
doc:name="SharePoint 2013"/>
xml
大きなファイルをアップロードするには、SharePoint サーバーと IIS サーバーを設定する必要があります。
サイトの SP 管理コンソールで [Maximum Upload Size (最大アップロードサイズ)] を 2047 MB (最大) に設定します。
IIS サイトの [Connection Timeout (接続タイムアウト)] を高い値に設定します。
(要求の絞り込みで) IIS アプリケーションの [Maximum Allowed Content Length (最大許容コンテンツ長)] を 2147483647 に設定します。
(コネクタが使用する) SharePoint REST API では、最大 2 GB のファイルのアップロードがサポートされます。大きなファイルを操作する場合は、ベストプラクティスとして、ファイルへのシステムのローカルパス (localFilePath パラメーターの値) を提供することをお勧めします。これは、コネクタを介してファイルをアップロードするための最も効果的な方法です。
ファイルのコンテンツがバイト配列として返されます。たとえば、次を File Connector の入力として使用して、リストからファイルをダウンロードできます。
<sharepoint-2013:file-get-content config-ref="SharePoint_2013"
doc:name="SharePoint 2013"
fileServerRelativeUrl="/path/to/folder/filename"/>
xml
この操作では、指定されたフォルダー以降で、指定された条件に一致するすべてのファイルとフォルダーが返されます。
クエリビルダーを使用します。
左側のパネルには、SharePoint インスタンスからのドキュメントリストが表示されます。選択したインスタンスを開始パスの一部として使用して、ファイルとフォルダーを照会します。
右側のパネルでは、すべてのドキュメントリストで同じ項目が表示されます。
また、フォルダーパスの入力で内部フォルダーを指定して、開始パスとして使用することができます。
再帰チェックボックスを選択すると、開始パスのすべてのフォルダーでファイルとフォルダーが再帰的に検索されます。
クエリビルダーのオプションを設定する方法は次のとおりです。
例:
sharepoint-2013:file-query config-ref="SharePoint_2013" query="dsql:SELECT Author,ModifiedBy,Name,ServerRelativeUrl FROM #[header:inbound:documentListName]" recursive="true" doc:name="SharePoint 2013"/> <sharepoint-2013:folder-query config-ref="SharePoint_2013" recursive="true" query="dsql:SELECT ItemCount,Name,ServerRelativeUrl FROM #[header:inbound:documentListName] WHERE ItemCount > 0" doc:name="SharePoint 2013"/>
text
Approve、Check In、Check Out、Deny、Publish、Undo Checkout、Unpublish の各操作の使用方法はほぼ同じです。ファイルの URL を指定します。また、操作によっては、追加のコメントをパラメーターとして渡します。
<sharepoint-2013:file-publish config-ref="SharePoint_2013"
doc:name="SharePoint 2013" fileServerRelativeUrl="" comment=""/>
xml
Update List Item 操作を使用してドキュメントライブラリにアップロードしたファイルのメタデータを取得および設定できます。
リスト内のファイルのプロパティを設定するには、[List Item Id (リスト項目 ID)] を認識する必要があります。これは、遅延 ListItemAllFields プロパティを使用して取得できます。
次のフローは、File Add を Update List Item 操作に直接連結してリストにファイルをアップロードし、その直後にメタデータを設定する方法を示しています。
<flow name="sharepoint_demo_fileAddWithMetadata"
doc:name="sharepoint_demo_fileAddWithMetadata">
<http:inbound-endpoint exchange-pattern="request-response" host="localhost"
port="8081" path="upload" doc:name="HTTP"/>
<sharepoint:file-add config-ref="SharePoint"
fileServerRelativeUrl="/Shared Documents/myfile.txt"
overwrite="true"
doc:name="Add file"/>
<sharepoint:resolve-object config-ref="SharePoint"
doc:name="Get ListItemId of File"
url="#[payload.listItemAllFields.__deferred.uri]"/>
<sharepoint:list-item-update config-ref="SharePoint" itemId="#[payload.Id]"
listId="ccbfaf65-b53e-48ac-be19-adf45192ecc3" doc:name="Set file properties">
<sharepoint:updated-properties>
<sharepoint:updated-property key="Title">Test title</sharepoint:updated-property>
</sharepoint:updated-properties>
</sharepoint:list-item-update>
<set-payload value="OK" doc:name="Set Payload"/>
</flow>
xml
パフォーマンス上の理由で、多くの SharePoint 操作がエンティティの基本データセットとともに、1 つ以上の遅延プロパティ参照を返します。この遅延プロパティ参照を使用して追加の詳細や関連オブジェクトを取得できます。
汎用の Resolve object 操作または Resolve collection 操作を使用して、遅延プロパティセットを 1 つの Map<string,object>
または List<Map<string,object>>
に解決し、その情報にフローでアクセスできます。
たとえば、次の方法を使用して、SharePoint ファイルオブジェクトの項目の完全セットを取得します。
<sharepoint:resolve-object config-ref="SharePoint"
url="#[payload.listItemAllFields.__deferred.url]"
doc:name="Microsoft SharePoint" >
</sharepoint:resolve-object>
xml
Mule デバッガーまたは Logger コンポーネントを使用してペイロードを記録すると、_deferred
URL プロパティでプロパティを識別できます。
リスト項目にファイルを添付するには、次の例のように ResolveObject 操作を使用します。
<flow name="sp-testFlow2">
<http:listener config-ref="HTTP_Listener_Configuration" path="/at" doc:name="HTTP"/>
<set-variable variableName="FileNameToAttach" value="CHANGELOG.md" doc:name="Set FileNameToAttach"/>
<sharepoint:list-item-query config-ref="Microsoft_SharePoint__NTLM_Connection" query="dsql:SELECT ID,Title FROM 82b2a455-3faf-4162-8276-63a1093fcc7e WHERE Title = 'test-list-item-1'" doc:name="Read List Item"/>
<set-variable variableName="ListItemUrl" value="#[payload.next() .__metadata.uri]" doc:name="SetListItemUri from list item query result"/>
<set-payload value="#[groovy:new FileInputStream('C:\\temp\\' + flowVars.FileNameToAttach)]" doc:name="Set file to attach as inputstream in payload"/>
<sharepoint:resolve-object config-ref="Microsoft_SharePoint__NTLM_Connection" url="#[flowVars.ListItemUrl]/AttachmentFiles/add(FileName='#[flowVars.FileNameToAttach]')" resolveRequestType="Create" doc:name="create attachment"/>
<json:object-to-json-transformer doc:name="Object to JSON"/>
</flow>
xml
このフローは次の方法を示しています。
SharePoint からリスト項目の URL を読み取って取得します。同じフロー内で作成されているリスト項目がすでにある場合、その項目を使用できます。
ファイルを入力ストリームに読み込みます。ここでは、入力ストリームは c:\temp にあります (フロー内のこのパスを見つけて置き換えてください)。
ファイルへのリスト項目の添付ファイルを作成します。
SharePoint REST API では、Resolve object および Resolve collection アクションを介してアクセスできる多くのコマンドを使用できます。これらの操作は、指定された URL への認証済みコールを提供し、それぞれ Map および List<Map>
に解決されます。
Resolve object 操作はすべての HTTP 動詞 (GET、POST、PUT/MERGE、DELETE) を受け入れます。また、この操作ではリクエストボディを API に送信できます。本文のデフォルト値は Mule メッセージのペイロードです。
本文は、JSON を受け入れる API エンドポイント用とすることができます。
JSON 文字列に変換される Map<String, Object>
。
JSON を含む String
。この文字列はそのまま送信されます。
ファイルを受け入れる API エンドポイント:
ファイルを含む InputStream
。ストリームは使用後に閉じられます。
ファイルを含む byte[]
。このバイト配列はそのまま送信されます。
複数の値を許可するように Choice 列型を設定できます。複数の値を受け入れる列のメタデータは Studio で次のように表示されます。
SharePoint 内の対象リストに Title プロパティと、"one"
、"two"
、"three"
の値を受け入れる複数選択列 (ChoiceMultiSelect) があるとします。次の Groovy スクリプトは、選択肢を "one", "three"
に設定するペイロードを作成します。
[Title: "foo", ChoiceMultiSelect: [results: ["one", "three"]]]
複数選択列の結果プロパティの List<string>
を作成できるどの言語を使用しても、同様の効果が得られます。
次の疑似コードのブロックは、ChoiceMultiSelect 列の値として Choice #1 と Choice #2 を設定する方法を示しています。
values = new List<String> values.add("Choice #1") values.add("Choice #2") multiValuesMap = new Map<String, Object> multiValuesMap["results"] = values List-item["ChoiceMultiSelect"] = multiValuesMap
text
何らかの理由でコネクタが SharePoint インスタンスへの接続に失敗した場合、ConnectionException 種別の例外がスローされます。
例外メッセージは、例外の原因をデバッグするのに役立ちます。
操作の実行時にエラーが発生した場合、エラーに関するメッセージと共に SharepointException がスローされます。
SharePoint Connector は、SharePoint 2013 オンプレミスバージョンと SharePoint オンラインバージョンをサポートします。
オンプレミスの SharePoint インスタンスに対する認証のオプションには、クレーム認証 (ADFS) と NTLM があります。SharePoint Online では、標準の SharePoint Online ユーザーログイン情報を使用した認証がサポートされます。
ファイルおよびフォルダー、リスト、リスト項目、および添付ファイルに対する特定のサポートが提供されます。さらに、SharePoint API の他のすべてのエンティティには、ResolveObject 操作と ResolveCollection 操作を介して JSON 形式でアクセスできます。
はい。サポートされるすべてのエンティティとエンティティ属性はコネクタによって Studio に提供され、DataSense で使用できます。
リストおよびリスト項目の API では、Create、Retrieve、Update、および Delete の各操作がサポートされます。ファイルおよびフォルダーでは、Add、Retrieve content、Retrieve metadata、Delete、Check out、Undo check out、Check in、Publish、Unpublish、Approve、Deny、Recycle、および Copy の各操作がサポートされます。
はい、sharepoint-connector-samples.zip では、Anypoint Studio のサンプルプロジェクトを無料で利用できます。
このコネクタは、CloudHub インテグレーション PaaS など、あらゆるビットのあらゆるオペレーティングシステムで動作しているすべての Enterprise Edition Anypoint プラットフォームでサポートされます。