CopyDocument
ドキュメントをSharePoint 内の指定された宛先にコピーします。コンテンツの複製やアーカイブに役立ちます。
実行
NewDocumentName パラメータが指定されていない場合、DocumentName で指定された値が同期先のパスとして使用されます。NewDocumentLibrary パラメータが指定されていない場合、DocumentLibrary で指定された値が新しいライブラリとして使用されます。いずれにせよ、これら2つのパラメータのうち少なくとも1つは指定する必要があります(両方同時に指定しないことはできません)。一方で、DocumentLibrary およびDocumentName パラメータは常に必須です。以下のクエリ例を参照してください:
EXEC CopyDocument DocumentLibrary = 'Documents', DocumentName = 'Source Folder/Subfolder/Source Document.txt', NewDocumentName = 'Destination Document.txt'; EXEC CopyDocument DocumentLibrary = 'Documents', DocumentName = 'Source Document.txt', NewDocumentLibrary = 'Destination Library'; EXEC CopyDocument DocumentLibrary = 'Documents', DocumentName = 'Source Folder/Subfolder/Source Document.txt', NewDocumentLibrary = 'Destination Library', NewDocumentName = 'Destination Document.txt';NewDocumentName パラメータがフォルダ(末尾が '/')の場合、DocumentName のドキュメント名が新しいファイル名として代わりに使用されます。以下のクエリ例を参照してください:
EXEC CopyDocument DocumentLibrary = 'Documents', DocumentName = 'Source Folder/Subfolder/Source Document.txt', NewDocumentLibrary = 'Destination Library', NewDocumentName = 'Destination Folder/Subfolder/';
さらに、完全なURL を指定すると、SharePoint インスタンスの別のサイトにドキュメントをコピーできます。このシナリオでは、NewDocumentLibrary が必須です。以下のクエリ例を参照してください:
EXEC CopyDocument DocumentLibrary = 'Documents', DocumentName = '/Source Folder/Subfolder/Source Document.txt', NewDocumentLibrary = 'Destination Library', NewDocumentName = 'https://mysite.sharepoint.com/sites/Destination%20Site/Destination%20Library/Destination%20Folder/Subfolder/Destination%20Document.txt';
Input
| Name | Type | Required | Description |
| DocumentName | String | True | ドキュメントライブラリ内のコピー元のドキュメントの相対パス。例:'Folder1/OriginalFile.docx'。 |
| DocumentLibrary | String | True | コピー元のドキュメントが保存されているSharePoint ドキュメントライブラリの表示名。例:'Shared Documents'。 |
| NewDocumentLibrary | String | False | コピーされたドキュメントが保存される対象ドキュメントライブラリの表示名。空白のままにすると、ドキュメントは元のドキュメントと同じライブラリに残ります。 |
| NewDocumentName | String | False | 新しいライブラリ内のコピーされたドキュメントの相対パスとファイル名。空白のままにすると、ドキュメントは元の名前を保持します。 |
Result Set Columns
| Name | Type | Description |
| Success | Boolean | ドキュメントのコピー操作が成功したかどうかを示します。成功した場合は'true' を、失敗した場合は'false' を返します。 |
| Id | String | コピー完了後、コピーされたドキュメントに割り当てられるの一意の識別子。 |
| DocumentId | String | コピーされたファイルに割り当てられるドキュメントID。 |
| DocumentIdUrl | String | コピーされたドキュメントにドキュメントID を使用してアクセスできるURL。 |
| FileRef | String | コピーされたドキュメントのSharePoint ファイル参照パス。 |