--- sourceDocument: オーストラリア API リファレンス sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/api-reference Release : - australia ft:locale : - ja-JP ft:publication_title : - オーストラリア API リファレンス ft:clusterId : - crapiref bundleId : - crapiref workflow : - Creator --- # 添付ファイルと添付ファイルのメタデータを取得 # 添付ファイルと添付ファイルのメタデータを取得 {#ariaid-title1} * リリースバージョン: Australia * * 更新日 2026年03月12日 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：4分 NowAttachmentService API を使用すると、添付ファイルに対して CRUD 操作を実行し、ServiceNow インスタンスから添付ファイルのメタデータを取得できます。 この API を使用すると、次のことができます。 * 添付ファイルを ServiceNow インスタンスにアップロードし、特定のレコードに関連付けます。 * 1 つ以上の添付ファイルをダウンロードします。 * 添付ファイルを削除します。 * 添付ファイルの計算されたハッシュと想定されるハッシュを比較して、添付ファイルを検証します。 * 添付ファイルのメタデータをダウンロードします。このメタデータは、添付ファイルがアップロードされたときに ServiceNow インスタンスによって生成されます。 {#mobsdk-ios-retrieve_attach_metadata__ul_l5y_qjw_3qb} 添付ファイルの操作の詳細については、「 [添付ファイル API](https://servicenow-prod.fluidtopics.net/1H5ZQbcRxmGejfjCqt80xA#c_AttachmentAPI "添付ファイル API は、添付ファイルをアップロードしてクエリできるようにするエンドポイントを提供します。")」を参照してください。 すべての [NowAttachmentService](https://servicenow-prod.fluidtopics.net/BEEtmHq_25U19NNpIYo9Bw#NowAttachmentServiceiOSAPI "NowAttachmentService クラスは、ServiceNow インスタンスのテーブル内のレコードに関連付けられている添付ファイルをアップロードしてクエリできるようにする関数を提供します。") メソッドには、結果データを返すための 3 つの実装が用意されています。1 つは結果を返す補完ハンドラーを呼び出し、もう 1 つは非同期/await を実行、もう 1 つは [Combine パ](https://developer.apple.com/documentation/combine) ブリッシャー (非推奨) を返します。たとえば、 各 upload() メソッドは、指定された添付ファイルをアップロードし、指定されたレコードに関連付けます。ただし、 [NowAttachmentService - upload(data: Data, configuration: NowAttachmentUploadConfiguration, progressUpdate: @escaping ProgressUpdate, completion: @escaping (Result))](https://servicenow-prod.fluidtopics.net/BEEtmHq_25U19NNpIYo9Bw#NAttServiOS-upload_O_O_O_O "添付ファイルデータをアップロードし、アップロード構成で指定されたテーブル内のレコードに添付します。") メソッドは結果を返す補完ハンドラーを呼び出し、 [NowAttachmentService - upload(data: Data, configuration: NowAttachmentUploadConfiguration, progressUpdate: @escaping ProgressUpdate) 非同期スロー](https://servicenow-prod.fluidtopics.net/BEEtmHq_25U19NNpIYo9Bw#NAttServiOS-upload-async_O_O_O_O "添付ファイルデータをアップロードし、アップロード構成で指定されたテーブル内のレコードに添付します。") メソッドは async/await を実行し、 [NowAttachmentService - upload(data: Data, configuration: NowAttachmentUploadConfiguration, progressUpdate: @escaping ProgressUpdate)](https://servicenow-prod.fluidtopics.net/BEEtmHq_25U19NNpIYo9Bw#NAttServiOS-upload_O_O_O "添付ファイルデータをアップロードし、アップロード構成で指定されたテーブル内のレコードに添付します。") メソッドは Combine パブリッシャーを返します。 NowAttachmentService API を使用する前に、NowData をインポートしてから NowAttachmentService オブジェクトを初期化する必要があります。 // Import the NowData framework import NowData func makeAttachmentService(instanceUrl: URL, completion: @escaping ((Result) → Void)) ## 添付ファイルのメタデータのページネーション {#mobsdk-ios-retrieve_attach_metadata__section_stt_34w_3qb} NowAttachmentService メソッドを使用して、1 つ以上の添付ファイルの添付ファイルメタデータをダウンロードできます。複数の添付ファイルからメタデータをダウンロードする場合は、返される可能性のある大量のデータを簡単に反復処理できる [Paginator](https://servicenow-prod.fluidtopics.net/6~3XhicniRmWRz~NtBwGNw#PaginatorIOSAPI "Paginator クラスは、NowTableService を介したServiceNow テーブル API の呼び出しによって返されたレコードセットを反復処理するためのメソッドを提供します。これは、NowTableService paginator() メソッドによって返されるオブジェクトです。その環境の外部でこのメソッドを呼び出さないでください。") オブジェクトを返す [NowAttachmentService - attachmentMetadataPaginator(filter: フィルター, 制限: Int)](https://servicenow-prod.fluidtopics.net/BEEtmHq_25U19NNpIYo9Bw#NAttServiOS-attachMetadataPag_S_I "指定された基準を満たすすべての添付ファイルのメタデータを取得し、返されたメタデータのページを反復処理するための Paginator オブジェクトを返します。") メソッドを使用することをお勧めします。通常、ページネーションされた戻り結果を使用して、UITableView、UICollectionView (UIKit)、またはリスト (SwiftUI) 内に表示されるデータに無限スクロール機能を提供したり、結果のページの反復全般を単純化したりします。 Paginator オブジェクトを取得したら、そのパブリッシャーに登録してデータの受信を開始します。 paginator.publisher .subscribe(on: DispatchQueue.global()) .receive(on: DispatchQueue.main) .sink { ... } .store(in: &subscriptions) 返された Paginator オブジェクトは、返されたレコードをページングできるようにする次のメソッドを提供します。 * first() * last() * 次へ() * previous() * リセット() {#mobsdk-ios-retrieve_attach_metadata__ul_pyb_2w3_3qb} 注: 一部の Paginator メソッドでは、フェッチするページがなくなった場合など、例外がスローされる場合があります。 さらに、Paginator オブジェクトは、ページネーションされたデータに関するインサイトを取得できるようにするプロパティを提供します。これらのプロパティと使用可能なメソッドの詳細については、「 [ページネーター API : iOS](https://servicenow-prod.fluidtopics.net/6~3XhicniRmWRz~NtBwGNw#PaginatorIOSAPI "Paginator クラスは、NowTableService を介したServiceNow テーブル API の呼び出しによって返されたレコードセットを反復処理するためのメソッドを提供します。これは、NowTableService paginator() メソッドによって返されるオブジェクトです。その環境の外部でこのメソッドを呼び出さないでください。")」を参照してください。