--- 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 --- # NowAttachmentService クラス : iOS # NowAttachmentService クラス : iOS {#ariaid-title1} * リリースバージョン: Australia * * 更新日 2026年03月12日 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：63分 NowAttachmentService クラスは、ServiceNow インスタンスのテーブル内のレコードに関連付けられている添付ファイルをアップロードしてクエリできるようにする関数を提供します。 要求ごとに 1 つのファイルをアップロードまたは取得できます。NowAttachmentService は、最大ファイルサイズや許可される添付ファイルの種類など、アップロードされたファイルに関するシステム制限に従います。これらの設定は、インスタンスプロパティ com.glide.attachment.max_size、デフォルトで 1024MB、および glide.attachment.extensions を使用して制御できます。 注: NowAttachmentService は、すべての Content-Type 値 (/) を受け入れます。添付ファイルをアップロードするときのファイルコンテンツタイプを指定します。コンテンツタイプはファイルメタデータとともに保存されるため、他のツールはファイルを正しく識別して解析できます。 {#NowAttachmentServiceiOSAPI__table_vx2_klw_5pb__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | 構成 | [NowServiceConfiguration](https://servicenow-prod.fluidtopics.net/uTGNTZYlh7StSnwaCDzTxQ#NowServiceConfigurationiOSStruct "NowServiceConfiguration 構造体は、フィーチャ サービスの構成情報を定義します。") | サービスの初期化時に提供された構成設定。 | [表 : 1. プロパティ] {#NowAttachmentServiceiOSAPI__table_vx2_klw_5pb} ## NowAttachmentService:attachment(sysId の場合:文字列、validateAttachment:ブール) 非同期スロー {#ariaid-title2} 指定されたsys_idの添付ファイルを取得し、添付ファイルの計算されたハッシュを予想される SHA256 チェックサムと比較して、添付ファイルを検証します。 注: 添付ファイルを検証すると、パフォーマンスが影響を受ける可能性があります。validateAttachmentパラメーターを `false` に設定することで、検証ステップをスキップできます。必要に応じて、 Attachment.validate() 関数を呼び出して、後のステージで添付ファイルを検証できます。 {#NAttServiOS-attachment-async_S_B_O__table_dqr_hmx_spb__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | sysId 用 | 文字列 | 取得する添付ファイルのSys_id。 | | validateAttachment | ブーリアン | 添付ファイルを検証するかどうかを示すフラグ。 有効な値： * true:添付ファイルを検証します。 * false:添付ファイルを検証しません。 デフォルト：true | [表 : 2. パラメーター] {#NAttServiOS-attachment-async_S_B_O__table_dqr_hmx_spb} {#NAttServiOS-attachment-async_S_B_O__table_eqr_hmx_spb__entry__2} | タイプ | 説明 | |-|-| | Now 添付ファイル | メソッドが成功した場合に返されます。指定された添付ファイル。 | | Now データエラー | メソッドが失敗したときにスローされます。 * `アクセストークン (AccessTokenProviderError)` * AccessTokenProviderError:アクセストークンプロバイダーのエラーコードまたはメッセージ。 * アクセストークンの取得に失敗しました * userSessionError(_ error: Error) アクセストークンにエラーがある場合にスローされます。 * `attachmentValidation` 添付ファイルの検証に失敗したときにスローされます。 * `badResponse(statusCode:HTTPStatusCode)` * HTTPStatusCode:インスタンスから受信したステータスコード。 要求から予期しない応答が返されたときにスローされる * `cannotDecodeModel(DecodingError)` * DecodingError:デコードエラーが検出されました。 コード可能モデルを JSON からデコードできない場合にスローされます。 * `cannotDecodeProperty(type: Any, from: String)` * type:文字列からデコードするラップされた型。 * from:指定されたタイプにデコードする文字列。 文字列でラップされた値を JSON からデコードできない場合にスローされます。 * `cannotEncodeModel(EncodingError)` * EncodingError:エンコードエラーが検出されました。 コード可能モデルを JSON にエンコードできない場合にスローされます。 * `cannotParseResponse` インスタンスからの応答を想定される形式に解析できない場合にスローされます。 * `無効なURL` URL を形成できない場合にスローされます。たとえば、文字列に URL で無効な文字が含まれている場合や空の文字列である場合などです。 * `missingAttachmentMetadata` 添付ファイルのメタデータヘッダーがない場合にスローされます。 * `missingServiceConfiguration` 予期されたサービス構成がない場合にスローされます。 * `欠落している SysID` 予期されたsys_idパラメーターが欠落している場合にスローされます。 * `ネットワーク (NetworkServiceError)` * genericError(文字列) * operationCanceled * サービス無効 * serverError (エラー) * systemError (エラー) ネットワークサービスでエラーが発生したときにスローされます。 {#NAttServiOS-attachment-async_S_B_O__NowDataErroriOS-ul-enum} | [表 : 3. 返される内容] {#NAttServiOS-attachment-async_S_B_O__table_eqr_hmx_spb} 次のコード例は、このメソッドを呼び出す方法を示しています。 func downloadAttachment(sysId: String) async throws -> NowAttachment { do { let nowAttachment = try await attachmentService.attachment(for: sysId, validateAttachment: false) return nowAttachment } catch { // Handle NowDataError throw error } } ## NowAttachmentService:attachment(sysId:文字列、validateAttachment:ブール、補完:@escaping (Result\)) {#ariaid-title3} 指定されたsys_idの添付ファイルを取得し、添付ファイルの計算されたハッシュを予想される SHA256 チェックサムと比較して、添付ファイルを検証します。完了すると、渡された補完ハンドラーを実行します。 注: 添付ファイルを検証すると、パフォーマンスが影響を受ける可能性があります。validateAttachmentパラメーターを `false` に設定することで、検証ステップをスキップできます。必要に応じて、 Attachment.validate() 関数を呼び出して、後のステージで添付ファイルを検証できます。 {#NAttServiOS-attachment_S_B_O__table_dqr_hmx_spb__entry__3}{#NAttServiOS-attachment_S_B_O__mobilesdkiOS-completion_data_dataerror-row} | 名前 | タイプ | 説明 | |-|-|-| | sysId 用 | 文字列 | 取得する添付ファイルのSys_id。 | | validateAttachment | ブーリアン | 添付ファイルを検証するかどうかを示すフラグ。 有効な値： * true:添付ファイルを検証します。 * false:添付ファイルを検証しません。 {#NAttServiOS-attachment_S_B_O__ul_ftq_1q5_4pb} デフォルト：true | | 完了 | @escaping (Result\<[NowAttachment](https://servicenow-prod.fluidtopics.net/y073ae_iOH8Bucur3mmDXw#NowAttachmentiOSStructure "NowAttachment 構造体には、計算されたハッシュを比較して添付ファイルを検証できる関数が用意されています。"), NowDataError\>) | 添付ファイルを取得した後に実行する補完ハンドラー。 補完ハンドラーの戻り値: * 成功: [NowAttachment](https://servicenow-prod.fluidtopics.net/y073ae_iOH8Bucur3mmDXw#NowAttachmentiOSStructure "NowAttachment 構造体には、計算されたハッシュを比較して添付ファイルを検証できる関数が用意されています。") :要求された添付ファイル * 失敗:NowDataError * `アクセストークン (AccessTokenProviderError)` * AccessTokenProviderError:アクセストークンプロバイダーのエラーコードまたはメッセージ。 * アクセストークンの取得に失敗しました * userSessionError(_ error: Error) アクセストークンにエラーがある場合にスローされます。 * `attachmentValidation` 添付ファイルの検証に失敗したときにスローされます。 * `badResponse(statusCode:HTTPStatusCode)` * HTTPStatusCode:インスタンスから受信したステータスコード。 要求から予期しない応答が返されたときにスローされる * `cannotDecodeModel(DecodingError)` * DecodingError:デコードエラーが検出されました。 コード可能モデルを JSON からデコードできない場合にスローされます。 * `cannotDecodeProperty(type: Any, from: String)` * type:文字列からデコードするラップされた型。 * from:指定されたタイプにデコードする文字列。 文字列でラップされた値を JSON からデコードできない場合にスローされます。 * `cannotEncodeModel(EncodingError)` * EncodingError:エンコードエラーが検出されました。 コード可能モデルを JSON にエンコードできない場合にスローされます。 * `cannotParseResponse` インスタンスからの応答を想定される形式に解析できない場合にスローされます。 * `無効なURL` URL を形成できない場合にスローされます。たとえば、文字列に URL で無効な文字が含まれている場合や空の文字列である場合などです。 * `missingAttachmentMetadata` 添付ファイルのメタデータヘッダーがない場合にスローされます。 * `missingServiceConfiguration` 予期されたサービス構成がない場合にスローされます。 * `欠落している SysID` 予期されたsys_idパラメーターが欠落している場合にスローされます。 * `ネットワーク (NetworkServiceError)` * genericError(文字列) * operationCanceled * サービス無効 * serverError (エラー) * systemError (エラー) ネットワークサービスでエラーが発生したときにスローされます。 {#NAttServiOS-attachment_S_B_O__NowDataErroriOS-ul-enum} {#NAttServiOS-attachment_S_B_O__ul_uzx_thj_ppb} | [表 : 4. パラメーター] {#NAttServiOS-attachment_S_B_O__table_dqr_hmx_spb} {#NAttServiOS-attachment_S_B_O__table_eqr_hmx_spb__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 5. 返される内容] {#NAttServiOS-attachment_S_B_O__table_eqr_hmx_spb} 次のコード例は、この関数を呼び出す方法を示しています。 let sysId = UUID().uuidString // UUID for the attachment private func downloadAttachment(sysId: String) { attachmentService.attachment(for: sysId, validateAttachment: false) { (result) in switch result { case .success(let attachment): // Attachment retrieved successful, return attachment case .failure(let error): // Attachment retrieved failed, return NowDataError } } } ## NowAttachmentService:attachment(sysId の場合:文字列、validateAttachment:ブール) {#ariaid-title4} 指定されたsys_idの添付ファイルを取得し、添付ファイルの計算されたハッシュを想定されるハッシュと比較して、添付ファイルを検証します。 注: 添付ファイルを検証すると、パフォーマンスが影響を受ける可能性があります。validateAttachmentパラメーターを `false` に設定することで、検証ステップをスキップできます。必要に応じて、 後で Attachment.validate() 関数を呼び出して添付ファイルを検証できます。 注: このメソッドは廃止されました。代わりに、メソッドの async/await 実装を使用する必要があります。 {#NAttServiOS-attachment_S_B__table_w4s_d3s_spb__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | sysId 用 | 文字列 | 取得する添付ファイルのSys_id。 | | validateAttachment | ブーリアン | 添付ファイルを検証するかどうかを示すフラグ。 有効な値： * true:添付ファイルを検証します。 * false:添付ファイルを検証しません。 {#NAttServiOS-attachment_S_B__ul_ftq_1q5_4pb} デフォルト：true | [表 : 6. パラメーター] {#NAttServiOS-attachment_S_B__table_w4s_d3s_spb} {#NAttServiOS-attachment_S_B__table_x4s_d3s_spb__entry__2} | タイプ | 説明 | |-|-| | AnyPublisher\<[NowAttachment](https://servicenow-prod.fluidtopics.net/y073ae_iOH8Bucur3mmDXw#NowAttachmentiOSStructure "NowAttachment 構造体には、計算されたハッシュを比較して添付ファイルを検証できる関数が用意されています。")、NowDataError\> | 成功: [NowAttachment](https://servicenow-prod.fluidtopics.net/y073ae_iOH8Bucur3mmDXw#NowAttachmentiOSStructure "NowAttachment 構造体には、計算されたハッシュを比較して添付ファイルを検証できる関数が用意されています。") :指定された添付ファイルが含まれます。 失敗:NowDataError * `アクセストークン (AccessTokenProviderError)` * AccessTokenProviderError:アクセストークンプロバイダーのエラーコードまたはメッセージ。 * アクセストークンの取得に失敗しました * userSessionError(_ error: Error) アクセストークンにエラーがある場合にスローされます。 * `attachmentValidation` 添付ファイルの検証に失敗したときにスローされます。 * `badResponse(statusCode:HTTPStatusCode)` * HTTPStatusCode:インスタンスから受信したステータスコード。 要求から予期しない応答が返されたときにスローされる * `cannotDecodeModel(DecodingError)` * DecodingError:デコードエラーが検出されました。 コード可能モデルを JSON からデコードできない場合にスローされます。 * `cannotDecodeProperty(type: Any, from: String)` * type:文字列からデコードするラップされた型。 * from:指定されたタイプにデコードする文字列。 文字列でラップされた値を JSON からデコードできない場合にスローされます。 * `cannotEncodeModel(EncodingError)` * EncodingError:エンコードエラーが検出されました。 コード可能モデルを JSON にエンコードできない場合にスローされます。 * `cannotParseResponse` インスタンスからの応答を想定される形式に解析できない場合にスローされます。 * `無効なURL` URL を形成できない場合にスローされます。たとえば、文字列に URL で無効な文字が含まれている場合や空の文字列である場合などです。 * `missingAttachmentMetadata` 添付ファイルのメタデータヘッダーがない場合にスローされます。 * `missingServiceConfiguration` 予期されたサービス構成がない場合にスローされます。 * `欠落している SysID` 予期されたsys_idパラメーターが欠落している場合にスローされます。 * `ネットワーク (NetworkServiceError)` * genericError(文字列) * operationCanceled * サービス無効 * serverError (エラー) * systemError (エラー) ネットワークサービスでエラーが発生したときにスローされます。 {#NAttServiOS-attachment_S_B__NowDataErroriOS-ul-enum} | [表 : 7. 返される内容] {#NAttServiOS-attachment_S_B__table_x4s_d3s_spb} 次のコード例は、この関数を呼び出す方法を示しています。 let sysId = UUID().uuidString // UUID for the attachment private func downloadAttachment(sysId: String) { let publisher = self.attachmentService.attachment(for: sysId, validateAttachment: false) publisher .receive(on: DispatchQueue.main) .sink { [weak self] completion in if case let .failure(error) = completion { // Attachment retrieved failed, return NowDataError } } receiveValue: { [weak self] (attachment) in // Attachment retrieved successful, return attachment } .store(in: &subscriptions) } ## NowAttachmentService - attachmentMetadata(filter: Filter, limit: Int) 非同期スロー {#ariaid-title5} 指定された基準を満たすすべての添付ファイルのメタデータを取得します。 {#NAttServiOS-attachMeta-async_S_I_O__table_tcn_cfs_spb__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | フィルター | [フィルター](https://servicenow-prod.fluidtopics.net/Y11sjNmmftd5yve~jvgx2g#FilteriOSStructure "フィルター構造では、REST エンドポイントクエリの戻り結果で返すデータを定義するフィルターを構成できます。") | オプション。メタデータを返す添付ファイルをフィルタリングするために使用するクエリ文字列。 デフォルト値:nil - 利用可能なすべての添付ファイルのメタデータを返します。limitパラメーターを考慮します。 | | limit | 整数 | オプション。返す添付ファイルのメタデータの最大数。 デフォルト:nil - filter パラメーターの仕様を満たすすべてのメタデータを返します。 | [表 : 8. パラメーター] {#NAttServiOS-attachMeta-async_S_I_O__table_tcn_cfs_spb} {#NAttServiOS-attachMeta-async_S_I_O__table_ucn_cfs_spb__entry__2} | タイプ | 説明 | |-|-| | \[NowAttachmentMetadata\] | メソッドが成功した場合に返されます。一致する添付ファイルのメタデータを含むアレイ。 | | Now データエラー | メソッドが失敗したときにスローされます。 * `アクセストークン (AccessTokenProviderError)` * AccessTokenProviderError:アクセストークンプロバイダーのエラーコードまたはメッセージ。 * アクセストークンの取得に失敗しました * userSessionError(_ error: Error) アクセストークンにエラーがある場合にスローされます。 * `attachmentValidation` 添付ファイルの検証に失敗したときにスローされます。 * `badResponse(statusCode:HTTPStatusCode)` * HTTPStatusCode:インスタンスから受信したステータスコード。 要求から予期しない応答が返されたときにスローされる * `cannotDecodeModel(DecodingError)` * DecodingError:デコードエラーが検出されました。 コード可能モデルを JSON からデコードできない場合にスローされます。 * `cannotDecodeProperty(type: Any, from: String)` * type:文字列からデコードするラップされた型。 * from:指定されたタイプにデコードする文字列。 文字列でラップされた値を JSON からデコードできない場合にスローされます。 * `cannotEncodeModel(EncodingError)` * EncodingError:エンコードエラーが検出されました。 コード可能モデルを JSON にエンコードできない場合にスローされます。 * `cannotParseResponse` インスタンスからの応答を想定される形式に解析できない場合にスローされます。 * `無効なURL` URL を形成できない場合にスローされます。たとえば、文字列に URL で無効な文字が含まれている場合や空の文字列である場合などです。 * `missingAttachmentMetadata` 添付ファイルのメタデータヘッダーがない場合にスローされます。 * `missingServiceConfiguration` 予期されたサービス構成がない場合にスローされます。 * `欠落している SysID` 予期されたsys_idパラメーターが欠落している場合にスローされます。 * `ネットワーク (NetworkServiceError)` * genericError(文字列) * operationCanceled * サービス無効 * serverError (エラー) * systemError (エラー) ネットワークサービスでエラーが発生したときにスローされます。 {#NAttServiOS-attachMeta-async_S_I_O__NowDataErroriOS-ul-enum} | [表 : 9. 返される内容] {#NAttServiOS-attachMeta-async_S_I_O__table_ucn_cfs_spb} 次のコード例は、このメソッドを呼び出す方法を示しています。 let filter = Filter(criteria: [], sortBy: [.desc("created")], queryCategory: nil) do { let metadata = try await attachmentService.attachmentMetadata(filter: filter, limit: 10) // Metadata retrieval successful } catch { // Metadata retrieval failed, NowDataError thrown } ## NowAttachmentService - attachmentMetadata(filter: フィルター、制限: Int、補完: @escaping (Result\<\[NowAttachmentMetadata\], NowDataError\>)) {#ariaid-title6} 指定された基準を満たすすべての添付ファイルのメタデータを取得します。 {#NAttServiOS-attachMetadata_S_I_O__table_tcn_cfs_spb__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | フィルター | [フィルター](https://servicenow-prod.fluidtopics.net/Y11sjNmmftd5yve~jvgx2g#FilteriOSStructure "フィルター構造では、REST エンドポイントクエリの戻り結果で返すデータを定義するフィルターを構成できます。") | オプション。メタデータを返す添付ファイルをフィルタリングするために使用するクエリ文字列。 デフォルト値:nil - 利用可能なすべての添付ファイルのメタデータを返します。limitパラメーターを考慮します。 | | limit | 整数 | オプション。返す添付ファイルのメタデータの最大数。 デフォルト:nil - filter パラメーターの仕様を満たすすべてのメタデータを返します。 | | 完了 | @escaping (結果\<\[[NowAttachmentMetadata](https://servicenow-prod.fluidtopics.net/ZE5enzrU7MWTS0Zvc1MFNw#NowAttachmentMetadataiOSStructure "NowAttachmentMetadata 構造体は、添付ファイルのメタデータをエンコードおよび管理できる関数を提供します。")\], NowDataError\>) | メタデータを取得した後に実行する補完ハンドラー。 補完ハンドラーの戻り値: * 成功:NowAttachmentMetadata - 要求されたメタデータを含むオブジェクト。 * エラー:NowDataError * `アクセストークン (AccessTokenProviderError)` * AccessTokenProviderError:アクセストークンプロバイダーのエラーコードまたはメッセージ。 * アクセストークンの取得に失敗しました * userSessionError(_ error: Error) アクセストークンにエラーがある場合にスローされます。 * `attachmentValidation` 添付ファイルの検証に失敗したときにスローされます。 * `badResponse(statusCode:HTTPStatusCode)` * HTTPStatusCode:インスタンスから受信したステータスコード。 要求から予期しない応答が返されたときにスローされる * `cannotDecodeModel(DecodingError)` * DecodingError:デコードエラーが検出されました。 コード可能モデルを JSON からデコードできない場合にスローされます。 * `cannotDecodeProperty(type: Any, from: String)` * type:文字列からデコードするラップされた型。 * from:指定されたタイプにデコードする文字列。 文字列でラップされた値を JSON からデコードできない場合にスローされます。 * `cannotEncodeModel(EncodingError)` * EncodingError:エンコードエラーが検出されました。 コード可能モデルを JSON にエンコードできない場合にスローされます。 * `cannotParseResponse` インスタンスからの応答を想定される形式に解析できない場合にスローされます。 * `無効なURL` URL を形成できない場合にスローされます。たとえば、文字列に URL で無効な文字が含まれている場合や空の文字列である場合などです。 * `missingAttachmentMetadata` 添付ファイルのメタデータヘッダーがない場合にスローされます。 * `missingServiceConfiguration` 予期されたサービス構成がない場合にスローされます。 * `欠落している SysID` 予期されたsys_idパラメーターが欠落している場合にスローされます。 * `ネットワーク (NetworkServiceError)` * genericError(文字列) * operationCanceled * サービス無効 * serverError (エラー) * systemError (エラー) ネットワークサービスでエラーが発生したときにスローされます。 {#NAttServiOS-attachMetadata_S_I_O__NowDataErroriOS-ul-enum} {#NAttServiOS-attachMetadata_S_I_O__ul_uzx_thj_ppb} | [表 : 10. パラメーター] {#NAttServiOS-attachMetadata_S_I_O__table_tcn_cfs_spb} {#NAttServiOS-attachMetadata_S_I_O__table_ucn_cfs_spb__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 11. 返される内容] {#NAttServiOS-attachMetadata_S_I_O__table_ucn_cfs_spb} 次のコード例は、この関数を呼び出す方法を示しています。 let query = "active=true^short_descriptionLIKEbroken" let filter = Filter(query: query) attachmentService.attachmentMetadata(filter: filter, limit: limit) { (result) in DispatchQueue.main.async { [weak self] in switch result { case .success(let response): do { let data = try JSONEncoder().encode(response) // Retrieve metadata successfully, return data } catch { // Retrieve metadata failed, return error } case .failure(let error): // Retrieve metadata failed, return NowDataError } } } ## NowAttachmentService - attachmentMetadata(フィルター: フィルター, 制限: 整数) {#ariaid-title7} 指定された基準を満たすすべての添付ファイルのメタデータを取得します。 注: このメソッドは廃止されました。代わりに、メソッドの async/await 実装を使用する必要があります。 {#NAttServiOS-attachMetadata_S_I__table_ahv_32s_spb__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | フィルター | [フィルター](https://servicenow-prod.fluidtopics.net/Y11sjNmmftd5yve~jvgx2g#FilteriOSStructure "フィルター構造では、REST エンドポイントクエリの戻り結果で返すデータを定義するフィルターを構成できます。") | オプション。メタデータを返す添付ファイルをフィルタリングするために使用するクエリ文字列。 デフォルト値:nil - 利用可能なすべての添付ファイルのメタデータを返します。limitパラメーターを考慮します。 | | limit | 整数 | オプション。返す添付ファイルのメタデータの最大数。 デフォルト:nil - filter パラメーターの仕様を満たすすべてのメタデータを返します。 | [表 : 12. パラメーター] {#NAttServiOS-attachMetadata_S_I__table_ahv_32s_spb} {#NAttServiOS-attachMetadata_S_I__table_bhv_32s_spb__entry__2} | タイプ | 説明 | |-|-| | AnyPublisher\<\[[NowAttachmentMetadata](https://servicenow-prod.fluidtopics.net/ZE5enzrU7MWTS0Zvc1MFNw#NowAttachmentMetadataiOSStructure "NowAttachmentMetadata 構造体は、添付ファイルのメタデータをエンコードおよび管理できる関数を提供します。")\]、NowDataError\> | 成功:NowAttachmentMetadata - 一致する添付ファイルのメタデータを含むオブジェクト。 失敗:NowDataError * `アクセストークン (AccessTokenProviderError)` * AccessTokenProviderError:アクセストークンプロバイダーのエラーコードまたはメッセージ。 * アクセストークンの取得に失敗しました * userSessionError(_ error: Error) アクセストークンにエラーがある場合にスローされます。 * `attachmentValidation` 添付ファイルの検証に失敗したときにスローされます。 * `badResponse(statusCode:HTTPStatusCode)` * HTTPStatusCode:インスタンスから受信したステータスコード。 要求から予期しない応答が返されたときにスローされる * `cannotDecodeModel(DecodingError)` * DecodingError:デコードエラーが検出されました。 コード可能モデルを JSON からデコードできない場合にスローされます。 * `cannotDecodeProperty(type: Any, from: String)` * type:文字列からデコードするラップされた型。 * from:指定されたタイプにデコードする文字列。 文字列でラップされた値を JSON からデコードできない場合にスローされます。 * `cannotEncodeModel(EncodingError)` * EncodingError:エンコードエラーが検出されました。 コード可能モデルを JSON にエンコードできない場合にスローされます。 * `cannotParseResponse` インスタンスからの応答を想定される形式に解析できない場合にスローされます。 * `無効なURL` URL を形成できない場合にスローされます。たとえば、文字列に URL で無効な文字が含まれている場合や空の文字列である場合などです。 * `missingAttachmentMetadata` 添付ファイルのメタデータヘッダーがない場合にスローされます。 * `missingServiceConfiguration` 予期されたサービス構成がない場合にスローされます。 * `欠落している SysID` 予期されたsys_idパラメーターが欠落している場合にスローされます。 * `ネットワーク (NetworkServiceError)` * genericError(文字列) * operationCanceled * サービス無効 * serverError (エラー) * systemError (エラー) ネットワークサービスでエラーが発生したときにスローされます。 {#NAttServiOS-attachMetadata_S_I__NowDataErroriOS-ul-enum} | [表 : 13. 返される内容] {#NAttServiOS-attachMetadata_S_I__table_bhv_32s_spb} 次のコード例は、この関数を呼び出す方法を示しています。 let query = "active=true^short_descriptionLIKEbroken" let filter = Filter(query: query) let publisher = self.attachmentService.attachmentMetadata(filter: filter) publisher .receive(on: DispatchQueue.main) .encode(encoder: JSONEncoder()) .sink { [weak self] completion in if case let .failure(error) = completion { // Retrieve metadata failed, return NowDataError } receiveValue: { [weak self] (data) in // Retrieve metadata successfully, return data } .store(in: &subscriptions ## NowAttachmentService:attachmentMetadata(sysId の場合:文字列) 非同期スロー {#ariaid-title8} 指定されたsys_idに関連付けられた添付ファイルのメタデータを取得します。 {#NAttServiOS-attachMeta-async_S_O__table_ldt_3hs_spb__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | sysId 用 | 文字列 | メタデータを取得する添付ファイルのSys_id。 | [表 : 14. パラメーター] {#NAttServiOS-attachMeta-async_S_O__table_ldt_3hs_spb} {#NAttServiOS-attachMeta-async_S_O__table_mdt_3hs_spb__entry__2} | タイプ | 説明 | |-|-| | Now 添付メタデータ | メソッドが成功した場合に返されます。要求された添付ファイルのメタデータ。 | | Now データエラー | メソッドが失敗したときにスローされます。 * `アクセストークン (AccessTokenProviderError)` * AccessTokenProviderError:アクセストークンプロバイダーのエラーコードまたはメッセージ。 * アクセストークンの取得に失敗しました * userSessionError(_ error: Error) アクセストークンにエラーがある場合にスローされます。 * `attachmentValidation` 添付ファイルの検証に失敗したときにスローされます。 * `badResponse(statusCode:HTTPStatusCode)` * HTTPStatusCode:インスタンスから受信したステータスコード。 要求から予期しない応答が返されたときにスローされる * `cannotDecodeModel(DecodingError)` * DecodingError:デコードエラーが検出されました。 コード可能モデルを JSON からデコードできない場合にスローされます。 * `cannotDecodeProperty(type: Any, from: String)` * type:文字列からデコードするラップされた型。 * from:指定されたタイプにデコードする文字列。 文字列でラップされた値を JSON からデコードできない場合にスローされます。 * `cannotEncodeModel(EncodingError)` * EncodingError:エンコードエラーが検出されました。 コード可能モデルを JSON にエンコードできない場合にスローされます。 * `cannotParseResponse` インスタンスからの応答を想定される形式に解析できない場合にスローされます。 * `無効なURL` URL を形成できない場合にスローされます。たとえば、文字列に URL で無効な文字が含まれている場合や空の文字列である場合などです。 * `missingAttachmentMetadata` 添付ファイルのメタデータヘッダーがない場合にスローされます。 * `missingServiceConfiguration` 予期されたサービス構成がない場合にスローされます。 * `欠落している SysID` 予期されたsys_idパラメーターが欠落している場合にスローされます。 * `ネットワーク (NetworkServiceError)` * genericError(文字列) * operationCanceled * サービス無効 * serverError (エラー) * systemError (エラー) ネットワークサービスでエラーが発生したときにスローされます。 {#NAttServiOS-attachMeta-async_S_O__NowDataErroriOS-ul-enum} | [表 : 15. 返される内容] {#NAttServiOS-attachMeta-async_S_O__table_mdt_3hs_spb} 次のコード例は、このメソッドを呼び出す方法を示しています。 do { let metadata = try await attachmentService.attachmentMetadata(for: sysId) // Metadata retrieval successful } catch { // Metadata retrieval failed, NowDataError thrown } ## NowAttachmentService - attachmentMetadata (sysId の場合:文字列、完了:@escaping (結果\)) {#ariaid-title9} 指定されたsys_idに関連付けられた添付ファイルのメタデータを取得し、メタデータが取得された後に補完ハンドラーを実行します。 {#NAttServiOS-attachMetadata_S_O__table_ldt_3hs_spb__entry__3}{#NAttServiOS-attachMetadata_S_O__mobilesdkiOS-completion_data_dataerror-row} | 名前 | タイプ | 説明 | |-|-|-| | sysId 用 | 文字列 | メタデータを取得する添付ファイルのSys_id。 | | 完了 | @escaping (Result\<[NowAttachmentMetadata](https://servicenow-prod.fluidtopics.net/ZE5enzrU7MWTS0Zvc1MFNw#NowAttachmentMetadataiOSStructure "NowAttachmentMetadata 構造体は、添付ファイルのメタデータをエンコードおよび管理できる関数を提供します。"), NowDataError\>) | メタデータを取得した後に実行する補完ハンドラー。 補完ハンドラーの戻り値: * 成功: [NowAttachmentMetadata](https://servicenow-prod.fluidtopics.net/ZE5enzrU7MWTS0Zvc1MFNw#NowAttachmentMetadataiOSStructure "NowAttachmentMetadata 構造体は、添付ファイルのメタデータをエンコードおよび管理できる関数を提供します。") :要求されたメタデータ * 失敗:NowDataError * `アクセストークン (AccessTokenProviderError)` * AccessTokenProviderError:アクセストークンプロバイダーのエラーコードまたはメッセージ。 * アクセストークンの取得に失敗しました * userSessionError(_ error: Error) アクセストークンにエラーがある場合にスローされます。 * `attachmentValidation` 添付ファイルの検証に失敗したときにスローされます。 * `badResponse(statusCode:HTTPStatusCode)` * HTTPStatusCode:インスタンスから受信したステータスコード。 要求から予期しない応答が返されたときにスローされる * `cannotDecodeModel(DecodingError)` * DecodingError:デコードエラーが検出されました。 コード可能モデルを JSON からデコードできない場合にスローされます。 * `cannotDecodeProperty(type: Any, from: String)` * type:文字列からデコードするラップされた型。 * from:指定されたタイプにデコードする文字列。 文字列でラップされた値を JSON からデコードできない場合にスローされます。 * `cannotEncodeModel(EncodingError)` * EncodingError:エンコードエラーが検出されました。 コード可能モデルを JSON にエンコードできない場合にスローされます。 * `cannotParseResponse` インスタンスからの応答を想定される形式に解析できない場合にスローされます。 * `無効なURL` URL を形成できない場合にスローされます。たとえば、文字列に URL で無効な文字が含まれている場合や空の文字列である場合などです。 * `missingAttachmentMetadata` 添付ファイルのメタデータヘッダーがない場合にスローされます。 * `missingServiceConfiguration` 予期されたサービス構成がない場合にスローされます。 * `欠落している SysID` 予期されたsys_idパラメーターが欠落している場合にスローされます。 * `ネットワーク (NetworkServiceError)` * genericError(文字列) * operationCanceled * サービス無効 * serverError (エラー) * systemError (エラー) ネットワークサービスでエラーが発生したときにスローされます。 {#NAttServiOS-attachMetadata_S_O__NowDataErroriOS-ul-enum} {#NAttServiOS-attachMetadata_S_O__ul_uzx_thj_ppb} | [表 : 16. パラメーター] {#NAttServiOS-attachMetadata_S_O__table_ldt_3hs_spb} {#NAttServiOS-attachMetadata_S_O__table_mdt_3hs_spb__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 17. 返される内容] {#NAttServiOS-attachMetadata_S_O__table_mdt_3hs_spb} 次のコード例は、この関数を呼び出す方法を示しています。 let sysId = UUID().uuidString // UUID for the attachment attachmentService.attachmentMetadata(for: sysId) { (result) in DispatchQueue.main.async { [weak self] in switch result { case .success(let response): do { let data = try JSONEncoder().encode(response) // Retrieve metadata successfully, return data } catch { // Retrieve metadata failed, return error } case .failure(let error): // Retrieve metadata failed, return NowDataError } } } ## NowAttachmentService:attachmentMetadata (sysId の場合:文字列) {#ariaid-title10} 指定されたsys_idに関連付けられた添付ファイルのメタデータを取得します。 注: このメソッドは廃止されました。代わりに、メソッドの async/await 実装を使用する必要があります。 {#NAttServiOS-attachMetadata_S__table_shc_ngs_spb__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | sysId 用 | 文字列 | メタデータを取得する添付ファイルのSys_id。 | [表 : 18. パラメーター] {#NAttServiOS-attachMetadata_S__table_shc_ngs_spb} {#NAttServiOS-attachMetadata_S__table_thc_ngs_spb__entry__2} | タイプ | 説明 | |-|-| | AnyPublisher\<\[[NowAttachmentMetadata](https://servicenow-prod.fluidtopics.net/ZE5enzrU7MWTS0Zvc1MFNw#NowAttachmentMetadataiOSStructure "NowAttachmentMetadata 構造体は、添付ファイルのメタデータをエンコードおよび管理できる関数を提供します。")\]、NowDataError\> | 成功:NowAttachmentMetadata - 要求された添付ファイルのメタデータを含むオブジェクト。 失敗:NowDataError * `アクセストークン (AccessTokenProviderError)` * AccessTokenProviderError:アクセストークンプロバイダーのエラーコードまたはメッセージ。 * アクセストークンの取得に失敗しました * userSessionError(_ error: Error) アクセストークンにエラーがある場合にスローされます。 * `attachmentValidation` 添付ファイルの検証に失敗したときにスローされます。 * `badResponse(statusCode:HTTPStatusCode)` * HTTPStatusCode:インスタンスから受信したステータスコード。 要求から予期しない応答が返されたときにスローされる * `cannotDecodeModel(DecodingError)` * DecodingError:デコードエラーが検出されました。 コード可能モデルを JSON からデコードできない場合にスローされます。 * `cannotDecodeProperty(type: Any, from: String)` * type:文字列からデコードするラップされた型。 * from:指定されたタイプにデコードする文字列。 文字列でラップされた値を JSON からデコードできない場合にスローされます。 * `cannotEncodeModel(EncodingError)` * EncodingError:エンコードエラーが検出されました。 コード可能モデルを JSON にエンコードできない場合にスローされます。 * `cannotParseResponse` インスタンスからの応答を想定される形式に解析できない場合にスローされます。 * `無効なURL` URL を形成できない場合にスローされます。たとえば、文字列に URL で無効な文字が含まれている場合や空の文字列である場合などです。 * `missingAttachmentMetadata` 添付ファイルのメタデータヘッダーがない場合にスローされます。 * `missingServiceConfiguration` 予期されたサービス構成がない場合にスローされます。 * `欠落している SysID` 予期されたsys_idパラメーターが欠落している場合にスローされます。 * `ネットワーク (NetworkServiceError)` * genericError(文字列) * operationCanceled * サービス無効 * serverError (エラー) * systemError (エラー) ネットワークサービスでエラーが発生したときにスローされます。 {#NAttServiOS-attachMetadata_S__NowDataErroriOS-ul-enum} | [表 : 19. 返される内容] {#NAttServiOS-attachMetadata_S__table_thc_ngs_spb} 次のコード例は、この関数を呼び出す方法を示しています。 let sysId = UUID().uuidString // UUID for the attachment let publisher = self.attachmentService.attachmentMetadata(for: sysId) publisher .receive(on: DispatchQueue.main) .encode(encoder: JSONEncoder()) .sink { [weak self] completion in if case let .failure(error) = completion { // Retrieve metadata failed, return NowDataError } } receiveValue: { [weak self] (data) in // Retrieve metadata successfully, return data } .store(in: &subscriptions) ## NowAttachmentService - attachmentMetadataPaginator(filter: フィルター, 制限: Int) {#ariaid-title11} 指定された基準を満たすすべての添付ファイルのメタデータを取得し、返されたメタデータのページを反復処理するための Paginator オブジェクトを返します。 {#NAttServiOS-attachMetadataPag_S_I__table_tqh_dcs_spb__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | フィルター | [フィルター](https://servicenow-prod.fluidtopics.net/Y11sjNmmftd5yve~jvgx2g#FilteriOSStructure "フィルター構造では、REST エンドポイントクエリの戻り結果で返すデータを定義するフィルターを構成できます。") | オプション。メタデータを返す添付ファイルをフィルタリングするために使用するクエリ文字列。 デフォルト値:nil - 利用可能なすべての添付ファイルのメタデータを返します。limitパラメーターを考慮します。 | | limit | 整数 | オプション。返す添付ファイルのメタデータの最大数。 デフォルト:nil - filter パラメーターの仕様を満たすすべてのメタデータを返します。 | [表 : 20. パラメーター] {#NAttServiOS-attachMetadataPag_S_I__table_tqh_dcs_spb} {#NAttServiOS-attachMetadataPag_S_I__table_uqh_dcs_spb__entry__2} | タイプ | 説明 | |-|-| | [Paginator](https://servicenow-prod.fluidtopics.net/6~3XhicniRmWRz~NtBwGNw#PaginatorIOSAPI "Paginator クラスは、NowTableService を介したServiceNow テーブル API の呼び出しによって返されたレコードセットを反復処理するためのメソッドを提供します。これは、NowTableService paginator() メソッドによって返されるオブジェクトです。その環境の外部でこのメソッドを呼び出さないでください。")\<\[[NowAttachmentMetadata](https://servicenow-prod.fluidtopics.net/ZE5enzrU7MWTS0Zvc1MFNw#NowAttachmentMetadataiOSStructure "NowAttachmentMetadata 構造体は、添付ファイルのメタデータをエンコードおよび管理できる関数を提供します。")\]\> | 成功:NowAttachmentMetadata オブジェクトのアレイ。 エラー:NowDataError オブジェクト。 * `アクセストークン (AccessTokenProviderError)` * AccessTokenProviderError:アクセストークンプロバイダーのエラーコードまたはメッセージ。 * アクセストークンの取得に失敗しました * userSessionError(_ error: Error) アクセストークンにエラーがある場合にスローされます。 * `attachmentValidation` 添付ファイルの検証に失敗したときにスローされます。 * `badResponse(statusCode:HTTPStatusCode)` * HTTPStatusCode:インスタンスから受信したステータスコード。 要求から予期しない応答が返されたときにスローされる * `cannotDecodeModel(DecodingError)` * DecodingError:デコードエラーが検出されました。 コード可能モデルを JSON からデコードできない場合にスローされます。 * `cannotDecodeProperty(type: Any, from: String)` * type:文字列からデコードするラップされた型。 * from:指定されたタイプにデコードする文字列。 文字列でラップされた値を JSON からデコードできない場合にスローされます。 * `cannotEncodeModel(EncodingError)` * EncodingError:エンコードエラーが検出されました。 コード可能モデルを JSON にエンコードできない場合にスローされます。 * `cannotParseResponse` インスタンスからの応答を想定される形式に解析できない場合にスローされます。 * `無効なURL` URL を形成できない場合にスローされます。たとえば、文字列に URL で無効な文字が含まれている場合や空の文字列である場合などです。 * `missingAttachmentMetadata` 添付ファイルのメタデータヘッダーがない場合にスローされます。 * `missingServiceConfiguration` 予期されたサービス構成がない場合にスローされます。 * `欠落している SysID` 予期されたsys_idパラメーターが欠落している場合にスローされます。 * `ネットワーク (NetworkServiceError)` * genericError(文字列) * operationCanceled * サービス無効 * serverError (エラー) * systemError (エラー) ネットワークサービスでエラーが発生したときにスローされます。 {#NAttServiOS-attachMetadataPag_S_I__NowDataErroriOS-ul-enum} | [表 : 21. 返される内容] {#NAttServiOS-attachMetadataPag_S_I__table_uqh_dcs_spb} 次のコード例は、この関数を呼び出す方法を示しています。 let paginator: Paginator = makePaginator(query: query, fetchLimit: 1) func makePaginator(query: String, fetchLimit: Int?) -> Paginator<[NowAttachmentMetadata]> { attachmentsService.attachmentMetadataPaginator(filter: Filter(query: query), limit: fetchLimit) } ## NowAttachmentService:delete(sysId:文字列) 非同期スロー {#ariaid-title12} 指定されたsys_idの添付ファイルを削除します。 {#NAttServiOS-delete-async_S_O__table_e5b_zqx_spb__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | sysId | 文字列 | 削除する添付ファイルのSys_id。 | [表 : 22. パラメーター] {#NAttServiOS-delete-async_S_O__table_e5b_zqx_spb} {#NAttServiOS-delete-async_S_O__table_f5b_zqx_spb__entry__2} | タイプ | 説明 | |-|-| | なし | メソッドが成功した場合、何も返されません。 | | Now データエラー | メソッドが失敗したときにスローされます。 * `アクセストークン (AccessTokenProviderError)` * AccessTokenProviderError:アクセストークンプロバイダーのエラーコードまたはメッセージ。 * アクセストークンの取得に失敗しました * userSessionError(_ error: Error) アクセストークンにエラーがある場合にスローされます。 * `attachmentValidation` 添付ファイルの検証に失敗したときにスローされます。 * `badResponse(statusCode:HTTPStatusCode)` * HTTPStatusCode:インスタンスから受信したステータスコード。 要求から予期しない応答が返されたときにスローされる * `cannotDecodeModel(DecodingError)` * DecodingError:デコードエラーが検出されました。 コード可能モデルを JSON からデコードできない場合にスローされます。 * `cannotDecodeProperty(type: Any, from: String)` * type:文字列からデコードするラップされた型。 * from:指定されたタイプにデコードする文字列。 文字列でラップされた値を JSON からデコードできない場合にスローされます。 * `cannotEncodeModel(EncodingError)` * EncodingError:エンコードエラーが検出されました。 コード可能モデルを JSON にエンコードできない場合にスローされます。 * `cannotParseResponse` インスタンスからの応答を想定される形式に解析できない場合にスローされます。 * `無効なURL` URL を形成できない場合にスローされます。たとえば、文字列に URL で無効な文字が含まれている場合や空の文字列である場合などです。 * `missingAttachmentMetadata` 添付ファイルのメタデータヘッダーがない場合にスローされます。 * `missingServiceConfiguration` 予期されたサービス構成がない場合にスローされます。 * `欠落している SysID` 予期されたsys_idパラメーターが欠落している場合にスローされます。 * `ネットワーク (NetworkServiceError)` * genericError(文字列) * operationCanceled * サービス無効 * serverError (エラー) * systemError (エラー) ネットワークサービスでエラーが発生したときにスローされます。 {#NAttServiOS-delete-async_S_O__NowDataErroriOS-ul-enum} | [表 : 23. 返される内容] {#NAttServiOS-delete-async_S_O__table_f5b_zqx_spb} 次のコード例は、このメソッドを呼び出す方法を示しています。 do { try await attachmentService.delete(sysId: sysId) // Deletion successful } catch { // Deletion failed, NowDataError thrown } ## NowAttachmentService - delete(sysId: String, completion: @escaping (Result\)) {#ariaid-title13} 指定されたsys_idの添付ファイルを削除し、添付ファイルが削除された後に渡された補完ハンドラーを実行します。 {#NAttServiOS-delete_S_O__table_e5b_zqx_spb__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | sysId | 文字列 | 削除する添付ファイルのSys_id。 | | 完了 | @escaping (Result\) | 添付ファイルが削除された後に実行する補完ハンドラー。 補完ハンドラーの戻り値: * 成功:無効 * エラー:NowDataError * `アクセストークン (AccessTokenProviderError)` * AccessTokenProviderError:アクセストークンプロバイダーのエラーコードまたはメッセージ。 * アクセストークンの取得に失敗しました * userSessionError(_ error: Error) アクセストークンにエラーがある場合にスローされます。 * `attachmentValidation` 添付ファイルの検証に失敗したときにスローされます。 * `badResponse(statusCode:HTTPStatusCode)` * HTTPStatusCode:インスタンスから受信したステータスコード。 要求から予期しない応答が返されたときにスローされる * `cannotDecodeModel(DecodingError)` * DecodingError:デコードエラーが検出されました。 コード可能モデルを JSON からデコードできない場合にスローされます。 * `cannotDecodeProperty(type: Any, from: String)` * type:文字列からデコードするラップされた型。 * from:指定されたタイプにデコードする文字列。 文字列でラップされた値を JSON からデコードできない場合にスローされます。 * `cannotEncodeModel(EncodingError)` * EncodingError:エンコードエラーが検出されました。 コード可能モデルを JSON にエンコードできない場合にスローされます。 * `cannotParseResponse` インスタンスからの応答を想定される形式に解析できない場合にスローされます。 * `無効なURL` URL を形成できない場合にスローされます。たとえば、文字列に URL で無効な文字が含まれている場合や空の文字列である場合などです。 * `missingAttachmentMetadata` 添付ファイルのメタデータヘッダーがない場合にスローされます。 * `missingServiceConfiguration` 予期されたサービス構成がない場合にスローされます。 * `欠落している SysID` 予期されたsys_idパラメーターが欠落している場合にスローされます。 * `ネットワーク (NetworkServiceError)` * genericError(文字列) * operationCanceled * サービス無効 * serverError (エラー) * systemError (エラー) ネットワークサービスでエラーが発生したときにスローされます。 {#NAttServiOS-delete_S_O__NowDataErroriOS-ul-enum} | [表 : 24. パラメーター] {#NAttServiOS-delete_S_O__table_e5b_zqx_spb} {#NAttServiOS-delete_S_O__table_f5b_zqx_spb__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 25. 返される内容] {#NAttServiOS-delete_S_O__table_f5b_zqx_spb} 次のコード例は、この関数を呼び出す方法を示しています。 let sysId = UUID().uuidString // UUID for the attachment attachmentService.delete(sysId: sysId) { (result) in DispatchQueue.main.async { [weak self] in switch result { case .success: // Attachment with sysId is deleted case .failure(let error): // Failed to delete, with NowDataError } } } ## NowAttachmentService:削除 (sysId: 文字列) {#ariaid-title14} 指定されたsys_idの添付ファイルを削除します。 注: このメソッドは廃止されました。代わりに、メソッドの async/await 実装を使用する必要があります。 {#NAttServiOS-delete_S__table_svp_2qx_spb__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | sysId | 文字列 | 削除する添付ファイルのSys_id。 | [表 : 26. パラメーター] {#NAttServiOS-delete_S__table_svp_2qx_spb} {#NAttServiOS-delete_S__table_tvp_2qx_spb__entry__2} | タイプ | 説明 | |-|-| | AnyPublisher\ | 成功:何も返されませんでした 失敗:NowDataError * `アクセストークン (AccessTokenProviderError)` * AccessTokenProviderError:アクセストークンプロバイダーのエラーコードまたはメッセージ。 * アクセストークンの取得に失敗しました * userSessionError(_ error: Error) アクセストークンにエラーがある場合にスローされます。 * `attachmentValidation` 添付ファイルの検証に失敗したときにスローされます。 * `badResponse(statusCode:HTTPStatusCode)` * HTTPStatusCode:インスタンスから受信したステータスコード。 要求から予期しない応答が返されたときにスローされる * `cannotDecodeModel(DecodingError)` * DecodingError:デコードエラーが検出されました。 コード可能モデルを JSON からデコードできない場合にスローされます。 * `cannotDecodeProperty(type: Any, from: String)` * type:文字列からデコードするラップされた型。 * from:指定されたタイプにデコードする文字列。 文字列でラップされた値を JSON からデコードできない場合にスローされます。 * `cannotEncodeModel(EncodingError)` * EncodingError:エンコードエラーが検出されました。 コード可能モデルを JSON にエンコードできない場合にスローされます。 * `cannotParseResponse` インスタンスからの応答を想定される形式に解析できない場合にスローされます。 * `無効なURL` URL を形成できない場合にスローされます。たとえば、文字列に URL で無効な文字が含まれている場合や空の文字列である場合などです。 * `missingAttachmentMetadata` 添付ファイルのメタデータヘッダーがない場合にスローされます。 * `missingServiceConfiguration` 予期されたサービス構成がない場合にスローされます。 * `欠落している SysID` 予期されたsys_idパラメーターが欠落している場合にスローされます。 * `ネットワーク (NetworkServiceError)` * genericError(文字列) * operationCanceled * サービス無効 * serverError (エラー) * systemError (エラー) ネットワークサービスでエラーが発生したときにスローされます。 {#NAttServiOS-delete_S__NowDataErroriOS-ul-enum} | [表 : 27. 返される内容] {#NAttServiOS-delete_S__table_tvp_2qx_spb} 次のコード例は、この関数を呼び出す方法を示しています。 let publisher = attachmentService.delete(sysId: sysId) publisher .receive(on: DispatchQueue.main) .sink { [weak self] completion in switch completion { case .finished: // Attachment with sysId is deleted case .failure(let error): // Failed to delete, with NowDataError } } receiveValue: { } .store(in: &subscriptions) ## NowAttachmentService - init(configuration: NowServiceConfiguration, coreServiceProvider: NowCoreServiceProviding) {#ariaid-title15} 新しい NowAttachmentService インスタンスを初期化します。 {#NAttServiOS-init_O_O__table_hfm_ry2_tpb__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | 構成 | [NowServiceConfiguration](https://servicenow-prod.fluidtopics.net/uTGNTZYlh7StSnwaCDzTxQ#NowServiceConfigurationiOSStruct "NowServiceConfiguration 構造体は、フィーチャ サービスの構成情報を定義します。") | サービスを適切に初期化するために必要な構成情報。 | | コアサービスプロバイダー | NowCoreServiceProviding | オプション。NowCoreServiceProviding プロトコルを実装するオブジェクト。 デフォルト:nil | [表 : 28. パラメーター] {#NAttServiOS-init_O_O__table_hfm_ry2_tpb} 次のコード例は、この関数を呼び出す方法を示しています。 guard let coreService = NowSDK.core() else { // Error with NowServiceError.sdkNotConfigured return } guard let instanceUrl = URL(string: "http://sample.service-now.com"), let serviceConfig = NowSDK.makeServiceConfiguration(for: instanceUrl) else { // Could not create service -- // NowServiceError.serviceConfigurationInvalid return } let attachmentService = NowAttachmentService(configuration: serviceConfig, coreServiceProvider: coreService) ## NowAttachmentService - upload(data: Data, configuration: NowAttachmentUploadConfiguration, progressUpdate: @escaping ProgressUpdate) 非同期スロー {#ariaid-title16} 添付ファイルデータをアップロードし、アップロード構成で指定されたテーブル内のレコードに添付します。 ProgressUpdate コールバックは、UI フィードバックを提供するために使用できるアップロードの進行状況情報を提供します。 {#NAttServiOS-upload-async_O_O_O_O__table_n5z_mpx_spb__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | データ | データ | アップロードする添付ファイル。 | | 構成 | [NowAttachmentUpload 構成](https://servicenow-prod.fluidtopics.net/mEQjVJDDHgIevZ7KRbWJ5w#NowAttachUploadConfigiOSStruct "NowAttachmentUploadConfiguration 構造を使用すると、ServiceNowインスタンスにアップロードする添付ファイルの構成情報を定義できます。") | 添付ファイルのアップロードパラメーターを定義する次のような構成情報。 * ファイルを添付するテーブルとレコード * 添付ファイル名 * 添付ファイルのタイプ * ファイルが暗号化されているかどうか | | progressUpdate | @escaping ProgressUpdate | 添付ファイルを取得した後に実行する補完ハンドラー。これは、アップロードプロセスが完了するまで複数回呼び出されます。 補完ハンドラーの戻り値: ProgressUpdate:アップロードの現在の進行状況を返します。 `ProgressUpdate = (_bytesWritten: Int64, _totalBytesWritten: Int64, _totalBytesExpectedToWrite: Int64) -> Void` | [表 : 29. パラメーター] {#NAttServiOS-upload-async_O_O_O_O__table_n5z_mpx_spb} {#NAttServiOS-upload-async_O_O_O_O__table_o5z_mpx_spb__entry__2} | タイプ | 説明 | |-|-| | Now 添付メタデータ | メソッドが成功した場合に返されます。アップロードされたメタデータを含むオブジェクト。 | | Now データエラー | メソッドが失敗したときにスローされます。 * `アクセストークン (AccessTokenProviderError)` * AccessTokenProviderError:アクセストークンプロバイダーのエラーコードまたはメッセージ。 * アクセストークンの取得に失敗しました * userSessionError(_ error: Error) アクセストークンにエラーがある場合にスローされます。 * `attachmentValidation` 添付ファイルの検証に失敗したときにスローされます。 * `badResponse(statusCode:HTTPStatusCode)` * HTTPStatusCode:インスタンスから受信したステータスコード。 要求から予期しない応答が返されたときにスローされる * `cannotDecodeModel(DecodingError)` * DecodingError:デコードエラーが検出されました。 コード可能モデルを JSON からデコードできない場合にスローされます。 * `cannotDecodeProperty(type: Any, from: String)` * type:文字列からデコードするラップされた型。 * from:指定されたタイプにデコードする文字列。 文字列でラップされた値を JSON からデコードできない場合にスローされます。 * `cannotEncodeModel(EncodingError)` * EncodingError:エンコードエラーが検出されました。 コード可能モデルを JSON にエンコードできない場合にスローされます。 * `cannotParseResponse` インスタンスからの応答を想定される形式に解析できない場合にスローされます。 * `無効なURL` URL を形成できない場合にスローされます。たとえば、文字列に URL で無効な文字が含まれている場合や空の文字列である場合などです。 * `missingAttachmentMetadata` 添付ファイルのメタデータヘッダーがない場合にスローされます。 * `missingServiceConfiguration` 予期されたサービス構成がない場合にスローされます。 * `欠落している SysID` 予期されたsys_idパラメーターが欠落している場合にスローされます。 * `ネットワーク (NetworkServiceError)` * genericError(文字列) * operationCanceled * サービス無効 * serverError (エラー) * systemError (エラー) ネットワークサービスでエラーが発生したときにスローされます。 {#NAttServiOS-upload-async_O_O_O_O__NowDataErroriOS-ul-enum} | [表 : 30. 返される内容] {#NAttServiOS-upload-async_O_O_O_O__table_o5z_mpx_spb} 次のコード例は、このメソッドを呼び出す方法を示しています。 func uploadFile(for tableName: String, sysId: String, mimeType: String, encryptionContext: String?, data: Data, filename: String) async throws -> NowAttachmentMetadata { let mimeType = MediaUtilities.mimeType(forFileName: filename) let uploadConfig = NowAttachmentUploadConfiguration(tableName: tableName, recordSysId: sysId, fileName: filename, contentType: mimeType, encryptionContext: encryptionContext) do { let attachmentMetadata = try await attachmentService.upload(data: data, configuration: uploadConfig) { (_, _, _) in } return attachmentMetadata } catch { // Handle NowDataError throw error } } ## NowAttachmentService - upload(data: Data, configuration: NowAttachmentUploadConfiguration, progressUpdate: @escaping ProgressUpdate, completion: @escaping (Result\)) {#ariaid-title17} 添付ファイルデータをアップロードし、アップロード構成で指定されたテーブル内のレコードに添付します。 ProgressUpdate コールバックは、UI フィードバックを提供するために使用できるアップロードの進行状況情報を提供します。 {#NAttServiOS-upload_O_O_O_O__table_n5z_mpx_spb__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | データ | データ | アップロードする添付ファイル。 | | 構成 | [NowAttachmentUpload 構成](https://servicenow-prod.fluidtopics.net/mEQjVJDDHgIevZ7KRbWJ5w#NowAttachUploadConfigiOSStruct "NowAttachmentUploadConfiguration 構造を使用すると、ServiceNowインスタンスにアップロードする添付ファイルの構成情報を定義できます。") | 添付ファイルのアップロードパラメーターを定義する次のような構成情報。 * ファイルを添付するテーブルとレコード * 添付ファイル名 * 添付ファイルのタイプ * ファイルが暗号化されているかどうか | | progressUpdate | @escaping ProgressUpdate | 添付ファイルを取得した後に実行する補完ハンドラー。これは、アップロードプロセスが完了するまで複数回呼び出されます。 補完ハンドラーの戻り値: ProgressUpdate:アップロードの現在の進行状況を返します。 `ProgressUpdate = (_bytesWritten: Int64, _totalBytesWritten: Int64, _totalBytesExpectedToWrite: Int64) -> Void` | | 完了 | @escaping (Result\<[NowAttachmentMetadata](https://servicenow-prod.fluidtopics.net/ZE5enzrU7MWTS0Zvc1MFNw#NowAttachmentMetadataiOSStructure "NowAttachmentMetadata 構造体は、添付ファイルのメタデータをエンコードおよび管理できる関数を提供します。")、NowDataError\>) | メタデータのアップロード後に実行する補完ハンドラー。 補完ハンドラーの戻り値: * 成功: [NowAttachmentMetadata](https://servicenow-prod.fluidtopics.net/ZE5enzrU7MWTS0Zvc1MFNw#NowAttachmentMetadataiOSStructure "NowAttachmentMetadata 構造体は、添付ファイルのメタデータをエンコードおよび管理できる関数を提供します。") - アップロードされた添付ファイルのメタデータを含むオブジェクト。 * エラー:NowDataError * `アクセストークン (AccessTokenProviderError)` * AccessTokenProviderError:アクセストークンプロバイダーのエラーコードまたはメッセージ。 * アクセストークンの取得に失敗しました * userSessionError(_ error: Error) アクセストークンにエラーがある場合にスローされます。 * `attachmentValidation` 添付ファイルの検証に失敗したときにスローされます。 * `badResponse(statusCode:HTTPStatusCode)` * HTTPStatusCode:インスタンスから受信したステータスコード。 要求から予期しない応答が返されたときにスローされる * `cannotDecodeModel(DecodingError)` * DecodingError:デコードエラーが検出されました。 コード可能モデルを JSON からデコードできない場合にスローされます。 * `cannotDecodeProperty(type: Any, from: String)` * type:文字列からデコードするラップされた型。 * from:指定されたタイプにデコードする文字列。 文字列でラップされた値を JSON からデコードできない場合にスローされます。 * `cannotEncodeModel(EncodingError)` * EncodingError:エンコードエラーが検出されました。 コード可能モデルを JSON にエンコードできない場合にスローされます。 * `cannotParseResponse` インスタンスからの応答を想定される形式に解析できない場合にスローされます。 * `無効なURL` URL を形成できない場合にスローされます。たとえば、文字列に URL で無効な文字が含まれている場合や空の文字列である場合などです。 * `missingAttachmentMetadata` 添付ファイルのメタデータヘッダーがない場合にスローされます。 * `missingServiceConfiguration` 予期されたサービス構成がない場合にスローされます。 * `欠落している SysID` 予期されたsys_idパラメーターが欠落している場合にスローされます。 * `ネットワーク (NetworkServiceError)` * genericError(文字列) * operationCanceled * サービス無効 * serverError (エラー) * systemError (エラー) ネットワークサービスでエラーが発生したときにスローされます。 {#NAttServiOS-upload_O_O_O_O__NowDataErroriOS-ul-enum} | [表 : 31. パラメーター] {#NAttServiOS-upload_O_O_O_O__table_n5z_mpx_spb} {#NAttServiOS-upload_O_O_O_O__table_o5z_mpx_spb__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 32. 返される内容] {#NAttServiOS-upload_O_O_O_O__table_o5z_mpx_spb} 次のコード例は、この関数を呼び出す方法を示しています。 typealias ProgressUpdate = (_ bytesWritten: Int64, _ totalBytesWritten: Int64, _ totalBytesExpectedToWrite: Int64) -> Void let image = UIImage(named: "photo.png") let data = image.pngData() let recordSysId = "" // Sys_id of the record on the SN instance let config = NowAttachmentUploadConfiguration( tableName: "tableName", recordSysId: recordSysId, fileName: "photo.png", contentType: "image/png", encryptionContext: nil) private func uploadFile( data: Data, config: NowAttachmentUploadConfiguration, progress: @escaping ProgressUpdate) { attachmentService.upload(data: data, configuration: config, progressUpdate: progress) { (result) in DispatchQueue.main.async { [weak self] in switch result { case .success(let response) do { let data = try JSONEncoder().encode(response) // Upload file successfully, return data } catch // Upload file decode failed, return error } case .failure(let error): // Upload file failed, return NowDataError } } } ## NowAttachmentService - upload(data: Data, configuration: NowAttachmentUploadConfiguration, progressUpdate: @escaping ProgressUpdate) {#ariaid-title18} 添付ファイルデータをアップロードし、アップロード構成で指定されたテーブル内のレコードに添付します。 ProgressUpdate コールバックは、UI フィードバックを提供するために使用できるアップロードの進行状況情報を提供します。 注: このメソッドは廃止されました。代わりに、メソッドの async/await 実装を使用する必要があります。 {#NAttServiOS-upload_O_O_O__table_ptn_lnx_spb__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | データ | データ | アップロードする添付ファイル。アップロードできる添付ファイルのデータサイズとタイプは、 ServiceNow インスタンスによって制御されます。 | | 構成 | [NowAttachmentUploadConfiguration](https://servicenow-prod.fluidtopics.net/mEQjVJDDHgIevZ7KRbWJ5w#NowAttachUploadConfigiOSStruct "NowAttachmentUploadConfiguration 構造を使用すると、ServiceNowインスタンスにアップロードする添付ファイルの構成情報を定義できます。") | 添付ファイルのアップロードパラメーターを定義する次のような構成情報。 * ファイルを添付するテーブルとレコード * 添付ファイル名 * 添付ファイルのタイプ * ファイルが暗号化されているかどうか | | progressUpdate | @escaping ProgressUpdate | 添付ファイルを取得した後に実行する補完ハンドラー。 補完ハンドラーの戻り値: ProgressUpdate:アップロードの現在の進行状況を返します。これは、アップロードプロセスが完了するまで複数回呼び出されます。 `ProgressUpdate = (_bytesWritten: Int64, _totalBytesWritten: Int64, _totalBytesExpectedToWrite: Int64) -> Void` | [表 : 33. パラメーター] {#NAttServiOS-upload_O_O_O__table_ptn_lnx_spb} {#NAttServiOS-upload_O_O_O__table_qtn_lnx_spb__entry__2} | タイプ | 説明 | |-|-| | AnyPublisher\<[NowAttachmentMetadata](https://servicenow-prod.fluidtopics.net/ZE5enzrU7MWTS0Zvc1MFNw#NowAttachmentMetadataiOSStructure "NowAttachmentMetadata 構造体は、添付ファイルのメタデータをエンコードおよび管理できる関数を提供します。")、NowDataError\> | 成功: [NowAttachmentMetadata](https://servicenow-prod.fluidtopics.net/ZE5enzrU7MWTS0Zvc1MFNw#NowAttachmentMetadataiOSStructure "NowAttachmentMetadata 構造体は、添付ファイルのメタデータをエンコードおよび管理できる関数を提供します。") - 要求された添付ファイルのメタデータを含むオブジェクト。 失敗:NowDataError * `アクセストークン (AccessTokenProviderError)` * AccessTokenProviderError:アクセストークンプロバイダーのエラーコードまたはメッセージ。 * アクセストークンの取得に失敗しました * userSessionError(_ error: Error) アクセストークンにエラーがある場合にスローされます。 * `attachmentValidation` 添付ファイルの検証に失敗したときにスローされます。 * `badResponse(statusCode:HTTPStatusCode)` * HTTPStatusCode:インスタンスから受信したステータスコード。 要求から予期しない応答が返されたときにスローされる * `cannotDecodeModel(DecodingError)` * DecodingError:デコードエラーが検出されました。 コード可能モデルを JSON からデコードできない場合にスローされます。 * `cannotDecodeProperty(type: Any, from: String)` * type:文字列からデコードするラップされた型。 * from:指定されたタイプにデコードする文字列。 文字列でラップされた値を JSON からデコードできない場合にスローされます。 * `cannotEncodeModel(EncodingError)` * EncodingError:エンコードエラーが検出されました。 コード可能モデルを JSON にエンコードできない場合にスローされます。 * `cannotParseResponse` インスタンスからの応答を想定される形式に解析できない場合にスローされます。 * `無効なURL` URL を形成できない場合にスローされます。たとえば、文字列に URL で無効な文字が含まれている場合や空の文字列である場合などです。 * `missingAttachmentMetadata` 添付ファイルのメタデータヘッダーがない場合にスローされます。 * `missingServiceConfiguration` 予期されたサービス構成がない場合にスローされます。 * `欠落している SysID` 予期されたsys_idパラメーターが欠落している場合にスローされます。 * `ネットワーク (NetworkServiceError)` * genericError(文字列) * operationCanceled * サービス無効 * serverError (エラー) * systemError (エラー) ネットワークサービスでエラーが発生したときにスローされます。 {#NAttServiOS-upload_O_O_O__NowDataErroriOS-ul-enum} | [表 : 34. 返される内容] {#NAttServiOS-upload_O_O_O__table_qtn_lnx_spb} 次のコード例は、この関数を呼び出す方法を示しています。 typealias ProgressUpdate = (_ bytesWritten: Int64, _ totalBytesWritten: Int64, _ totalBytesExpectedToWrite: Int64) -> Void let image = UIImage(named: "photo.png") let data = image.pngData() let recordSysId = "" // Sys_id of the record on the SN instance let config = NowAttachmentUploadConfiguration( tableName: "tableName", recordSysId: recordSysId, fileName: "photo.png", contentType: "image/png", encryptionContext: nil) private func uploadFile(data: Data, config: NowAttachmentUploadConfiguration, progress: @escaping ProgressUpdate) { let publisher = attachmentService.upload(data: data, configuration: config, progressUpdate: progress) publisher .receive(on: DispatchQueue.main) .encode(encoder: JSONEncoder()) .sink { [weak self] completion in if case let .failure(error) = completion { // Upload file failed, return NowDataError } } receiveValue: { [weak self] (data) in // Upload file successfully, return data } .store(in: &subscriptions) }