---
sourceDocument: Xanadu API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - ja-JP

ft:publication_title :

    - Xanadu API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# NowTableService クラス - iOS

# NowTableService クラス - iOS {#ariaid-title1}

* リリースバージョン: Xanadu
* 
* 更新日 2024年08月01日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：144分

NowTableService クラスは、既存のServiceNowテーブルのレコードに対して作成、読み取り、更新、および削除操作を実行できる関数を提供します。
{#NowTableServiceiOSAPI__table_vx2_klw_5pb__entry__3}

| 名前 | タイプ | Description (説明) |
|-|-|-|
| 構成 | [NowServiceConfiguration](https://servicenow-prod.fluidtopics.net/stoU_DsvecOSpmkh8Wo3FA#NowServiceConfigurationiOSStruct "NowServiceConfiguration 構造体は、フィーチャ サービスの構成情報を定義します。") | サービスが初期化されたときに指定された構成設定。 |
[表 : 1. プロパティ]

{#NowTableServiceiOSAPI__table_vx2_klw_5pb}

## NowTableService - create\<Model: SysIdentifiableModel\>(_ model: Model, in tableName: String, coder: coder, writeOptions: FieldWriteOptions, configuration: FetchConfiguration) async throws {#ariaid-title2}

指定されたコード化可能モデルを指定されたテーブルに挿入します。
モデル別に新しいレコードを作成するには、モデルが `SysIdentifiableModel` プロトコルに準拠している必要があります。通常、各テーブルには独自のモデルがあります。

sysIdはServiceNowプラットフォームによって生成されるため、モデルのsys_Idパラメーターは作成時に無視されます。ServiceNowプラットフォームで生成されたsys_Idは、completionハンドラー`の結果`モデルに返されます。
{#NTblServ-create-async_S_S_S_O_O__table_tqk_gsk_spb__entry__3}

| 名前 | タイプ | Description (説明) |
|-|-|-|
| モデル | SysIdentifiableModel | テーブルに挿入するフィールドのモデル定義。 |
| tableName 内 | 文字列 | レコードを書き込むテーブルの名前 ( インシデントなど)。 |
| コーダー | コーダー | オプション。ServiceNow インスタンスとの間で送受信されるデータのエンコードまたはデコードに使用する`コーダー`。 可能な値： * default: 既定のエンコーダーは、デバイスの`ロケール`と`タイム ゾーン`を使用して、`yyy-MM-dd HH:mm:ss` 形式を使用して日付を書式設定します。 * custom(JSONEncoder, JSONDecoder): `カスタム` コーダーを使用して、JSON のデコード/エンコードをよりきめ細かく制御します。 この列挙は、特別な日付形式、タイムゾーン、またはロケールを使用する場合など、独自の `JSONEncoder` と `JSONDecoder`を指定する場合にのみ使用してください。 let myEncoder = JSONEncoder() myEncoder.dateFormat = ... let myDecoder = JSONDecoder() myDecoder.dateFormat = ... let coder: Coder = .custom(myEncoder, myDecoder) {#NTblServ-create-async_S_S_S_O_O__ul_nx3_wrd_sqb} デフォルト:.default |
| 書き込みオプション | [フィールド書き込みオプション](https://servicenow-prod.fluidtopics.net/a7rJUASi8wEa4P_XFxtitg#FieldWriteOptionsiOSStruct "FieldWriteOptions クラスは、ServiceNow インスタンス上のレコードのフィールドを更新または作成するためのオプションを設定する関数を提供します。") | オプション。レコードに書き込まれるデータに適用する構成オプション。 デフォルト:nil |
| 構成 | [FetchConfiguration](https://servicenow-prod.fluidtopics.net/s4pcOrhOcnm~4lgw1mUrfQ#FetchConfigiOSStructure "FetchConfiguration 構造体には、ServiceNow インスタンスからレコードをフェッチするための構成を定義する機能が用意されています。") | オプション。返されるレコード、ページネーションページのサイズ制限、取得するフィールド、フィールドに含めるものを定義するフィルターなど、取得したレコードに適用する構成。 デフォルト:nil - すべてのレコードが返されます。 |
[表 : 2. パラメーター]

{#NTblServ-create-async_S_S_S_O_O__table_tqk_gsk_spb} {#NTblServ-create-async_S_S_S_O_O__table_uqk_gsk_spb__entry__2}

| タイプ | Description (説明) |
|-|-|
| モデル | メソッドが成功したときに返されます。指定されたテーブルに挿入されたコード化可能モデル (sys_Idを含む)。このsys_idを使用して、今後のメソッド呼び出しでこのレコードを参照します。 |
| NowDataError | メソッドが失敗したときにスローされます。 * `accessToken(アクセストークンプロバイダーエラー)` * AccessTokenProviderError:アクセストークンプロバイダーのエラーコードまたはメッセージ。 * アクセストークン取得に失敗しました * userSessionError(_エラー:エラー) アクセストークンにエラーがある場合にスローされます。 * `attachmentValidation` 添付ファイルが検証に失敗したときにスローされます。 * `badResponse(statusCode: HTTPStatusCode)` * HTTPStatusCode:インスタンスから受信したステータスコード。 要求が予期しない応答を返した場合にスローされます * `cannotDecodeModel(デコードエラー)` * DecodingError:デコードエラーが検出されました。 Codable モデルを JSON からデコードできない場合にスローされます。 * `cannotDecodeProperty(タイプ:任意、差出人:文字列)` * type:文字列からデコードするラップされた型。 * from:指定されたタイプにデコードする文字列。 文字列でラップされた値を JSON からデコードできない場合にスローされます。 * `cannotEncodeModel(エンコーディングエラー)` * EncodingError:エンコードエラーが検出されました。 Codable モデルを JSON にエンコードできない場合にスローされます。 * `cannotParseResponse` インスタンスからの応答を予期される形式に解析できない場合にスローされます。 * `無効な URL` URL を形成できない場合にスローされます。たとえば、文字列に URL で無効な文字が含まれているか、空の文字列である場合などです。 * `missingAttachmentMetadata` 添付ファイルのメタデータヘッダーがない場合にスローされます。 * `missingServiceConfiguration` 予期されるサービス構成がない場合にスローされます。 * `missingSysID` 予期されるsys_idパラメーターがない場合にスローされます。 * `network(NetworkServiceError)` * genericError(文字列) * operationCanceled * serviceDisabled * serverError(エラー) * systemError(エラー) ネットワークサービスでエラーが発生した場合にスローされます。 {#NTblServ-create-async_S_S_S_O_O__NowDataErroriOS-ul-enum} |
[表 : 3. 返される内容]

{#NTblServ-create-async_S_S_S_O_O__table_uqk_gsk_spb}  
次のコード例は、このメソッドを呼び出す方法を示しています。

    struct User: SysIdentifiableModel {
        var sysId: String = ""
        var name: String
    }

    let service: NowTableService = ...
    let user = User(name: "Ash Williams")
    do {
        let result = try await service.create(user, in: "sys_user")
    } catch {
        ...
    }

## NowTableService - create\<Model: SysIdentifiableModel\>(_ model: Model, in tableName: String, coder: Coder, writeOptions: FieldWriteOptions, configuration: FetchConfiguration, completion: @escaping (Result\<Model, NowDataError\>)) {#ariaid-title3}

指定された Codable モデルを指定されたテーブルに挿入し、 completion ハンドラーを実行します。
モデル別に新しいレコードを作成するには、モデルが `SysIdentifiableModel` プロトコルに準拠している必要があります。通常、各テーブルには独自のモデルがあります。例：

    struct User: SysIdentifiableModel {
      var sysId: String = ""
      var name: String
    }

    let service: NowTableService = ...
    let user = User(name: "Ash Williams")
    service.create(Incident(fields: fields), in: tableName, writeOptions: writeOptions, configuration: fetchConfiguration) { [weak self] result in
      switch result {
      case .success(let newUser):
        /// 'newUser' contains the platform assigned 'sys_id', use in subsequent 'update' or 'delete' calls.
      case .failure(let error):
          ...
      }
    }

sysIdはServiceNowプラットフォームによって生成されるため、モデルのsys_Idパラメーターは作成時に無視されます。ServiceNowプラットフォームで生成されたsys_Idは、completionハンドラー`の結果`モデルに返されます。
{#NTblServ-create_S_S_S_O_O_O__table_tqk_gsk_spb__entry__3}

| 名前 | タイプ | Description (説明) |
|-|-|-|
| モデル | SysIdentifiableModel | テーブルに挿入するフィールドのモデル定義。 |
| tableName 内 | 文字列 | レコードを書き込むテーブルの名前 ( インシデントなど)。 |
| コーダー | コーダー | オプション。ServiceNow インスタンスとの間で送受信されるデータのエンコードまたはデコードに使用する`コーダー`。 可能な値： * default: 既定のエンコーダーは、デバイスの`ロケール`と`タイム ゾーン`を使用して、`yyy-MM-dd HH:mm:ss` 形式を使用して日付を書式設定します。 * custom(JSONEncoder, JSONDecoder): `カスタム` コーダーを使用して、JSON のデコード/エンコードをよりきめ細かく制御します。 この列挙は、特別な日付形式、タイムゾーン、またはロケールを使用する場合など、独自の `JSONEncoder` と `JSONDecoder`を指定する場合にのみ使用してください。 let myEncoder = JSONEncoder() myEncoder.dateFormat = ... let myDecoder = JSONDecoder() myDecoder.dateFormat = ... let coder: Coder = .custom(myEncoder, myDecoder) {#NTblServ-create_S_S_S_O_O_O__ul_nx3_wrd_sqb} デフォルト:.default |
| 書き込みオプション | [フィールド書き込みオプション](https://servicenow-prod.fluidtopics.net/a7rJUASi8wEa4P_XFxtitg#FieldWriteOptionsiOSStruct "FieldWriteOptions クラスは、ServiceNow インスタンス上のレコードのフィールドを更新または作成するためのオプションを設定する関数を提供します。") | オプション。レコードに書き込まれるデータに適用する構成オプション。 デフォルト:nil |
| 構成 | [FetchConfiguration](https://servicenow-prod.fluidtopics.net/s4pcOrhOcnm~4lgw1mUrfQ#FetchConfigiOSStructure "FetchConfiguration 構造体には、ServiceNow インスタンスからレコードをフェッチするための構成を定義する機能が用意されています。") | オプション。返されるレコード、ページネーションページのサイズ制限、取得するフィールド、フィールドに含めるものを定義するフィルターなど、取得したレコードに適用する構成。 デフォルト:nil - すべてのレコードが返されます。 |
| 完了 | @escaping (Result\<Model, NowDataError\>) | 指定された復号可能モデルの作成後に実行する完了ハンドラー。 完了ハンドラーの戻り値: * 成功:モデル:作成されたモデルタイプのデータ。 * 失敗:NowDataError * `accessToken(アクセストークンプロバイダーエラー)` * AccessTokenProviderError:アクセストークンプロバイダーのエラーコードまたはメッセージ。 * アクセストークン取得に失敗しました * userSessionError(_エラー:エラー) アクセストークンにエラーがある場合にスローされます。 * `attachmentValidation` 添付ファイルが検証に失敗したときにスローされます。 * `badResponse(statusCode: HTTPStatusCode)` * HTTPStatusCode:インスタンスから受信したステータスコード。 要求が予期しない応答を返した場合にスローされます * `cannotDecodeModel(デコードエラー)` * DecodingError:デコードエラーが検出されました。 Codable モデルを JSON からデコードできない場合にスローされます。 * `cannotDecodeProperty(タイプ:任意、差出人:文字列)` * type:文字列からデコードするラップされた型。 * from:指定されたタイプにデコードする文字列。 文字列でラップされた値を JSON からデコードできない場合にスローされます。 * `cannotEncodeModel(エンコーディングエラー)` * EncodingError:エンコードエラーが検出されました。 Codable モデルを JSON にエンコードできない場合にスローされます。 * `cannotParseResponse` インスタンスからの応答を予期される形式に解析できない場合にスローされます。 * `無効な URL` URL を形成できない場合にスローされます。たとえば、文字列に URL で無効な文字が含まれているか、空の文字列である場合などです。 * `missingAttachmentMetadata` 添付ファイルのメタデータヘッダーがない場合にスローされます。 * `missingServiceConfiguration` 予期されるサービス構成がない場合にスローされます。 * `missingSysID` 予期されるsys_idパラメーターがない場合にスローされます。 * `network(NetworkServiceError)` * genericError(文字列) * operationCanceled * serviceDisabled * serverError(エラー) * systemError(エラー) ネットワークサービスでエラーが発生した場合にスローされます。 {#NTblServ-create_S_S_S_O_O_O__NowDataErroriOS-ul-enum} {#NTblServ-create_S_S_S_O_O_O__ul_dpx_jvk_spb} |
[表 : 4. パラメーター]

{#NTblServ-create_S_S_S_O_O_O__table_tqk_gsk_spb} {#NTblServ-create_S_S_S_O_O_O__table_uqk_gsk_spb__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 5. 返される内容]

{#NTblServ-create_S_S_S_O_O_O__table_uqk_gsk_spb}  
<br />

    struct User: SysIdentifiableModel {
      var sysId: String = ""
      var name: String
    }

    let service: NowTableService = ...
    let user = User(name: "Ash Williams")
    service.create(Incident(fields: fields), in: tableName, writeOptions: writeOptions, configuration: fetchConfiguration) { [weak self] result in
      switch result {
      case .success(let newUser):
        /// 'newUser' contains the platform assigned 'sys_id' to use in subsequent update or delete calls.
      case .failure(let error):
       ...
      }
    }

## NowTableService - create\<Model: SysIdentifiableModel\>(model: Model, in tableName: String, path: String = Constants.resultPath, coder: coder = .default, writeOptions: FieldWriteOptions? = nil, configuration: FetchConfiguration = nil) {#ariaid-title4}

指定されたテーブルに 1 つのコード化可能モデルを挿入します。
注:  
このメソッドは廃止されました。代わりに、メソッドの async/await 実装を使用する必要があります。  
モデル別に新しいレコードを作成するには、モデルが `SysIdentifiableModel` プロトコルに準拠している必要があります。通常、各テーブルには独自のモデルがあります。例：

    struct User: SysIdentifiableModel {
      var sysId: String = ""
      var name: String
    }

    let service: NowTableService = ...
    let user = User(name: "Ash Williams")
    service.create(Incident(fields: fields), in: tableName, writeOptions: writeOptions, configuration: fetchConfiguration) { [weak self] result in
      switch result {
      case .success(let newUser):
        /// 'newUser' contains the platform assigned 'sys_id', use in subsequent 'update' or 'delete' calls.
      case .failure(let error):
          ...
      }
    }

注:  
モデルの sys_Id パラメータは作成時に無視されます。sysIdはServiceNowプラットフォームによって割り当てられます。ServiceNowプラットフォームで生成されたsys_Idは、パブリッシャの`receiveValue`コールバックモデルで返されます。
{#NTblServ-create_S_S_S_S_O_O__table_pnc_xkk_spb__entry__3}

| 名前 | タイプ | Description (説明) |
|-|-|-|
| モデル | SysIdentifiableModel | テーブルに挿入する `SysIdentifiableModel` モデル。 |
| tableName 内 | 文字列 | レコードを書き込むテーブルの名前 ( インシデントなど)。 |
| path | 文字列 | オプション。ネストされた型のドット区切りパス。たとえば、 `より` 深い入れ子の場合は `result または foo.bar.baz` です。 デフォルト: `Constants.resultPath` |
| コーダー | コーダー | オプション。ServiceNow インスタンスとの間で送受信されるデータのエンコードまたはデコードに使用する`コーダー`。 可能な値： * default: 既定のエンコーダーは、デバイスの`ロケール`と`タイム ゾーン`を使用して、`yyy-MM-dd HH:mm:ss` 形式を使用して日付を書式設定します。 * custom(JSONEncoder, JSONDecoder): `カスタム` コーダーを使用して、JSON のデコード/エンコードをよりきめ細かく制御します。 この列挙は、特別な日付形式、タイムゾーン、またはロケールを使用する場合など、独自の `JSONEncoder` と `JSONDecoder`を指定する場合にのみ使用してください。 let myEncoder = JSONEncoder() myEncoder.dateFormat = ... let myDecoder = JSONDecoder() myDecoder.dateFormat = ... let coder: Coder = .custom(myEncoder, myDecoder) {#NTblServ-create_S_S_S_S_O_O__ul_nx3_wrd_sqb} デフォルト:.default |
| 書き込みオプション | [フィールド書き込みオプション](https://servicenow-prod.fluidtopics.net/a7rJUASi8wEa4P_XFxtitg#FieldWriteOptionsiOSStruct "FieldWriteOptions クラスは、ServiceNow インスタンス上のレコードのフィールドを更新または作成するためのオプションを設定する関数を提供します。") | オプション。レコードに書き込まれるデータに適用する構成オプション。 デフォルト:nil |
| 構成 | [FetchConfiguration](https://servicenow-prod.fluidtopics.net/s4pcOrhOcnm~4lgw1mUrfQ#FetchConfigiOSStructure "FetchConfiguration 構造体には、ServiceNow インスタンスからレコードをフェッチするための構成を定義する機能が用意されています。") | オプション。返されるレコード、ページネーションページのサイズ制限、取得するフィールド、フィールドに含めるものを定義するフィルターなど、取得したレコードに適用する構成。 デフォルト:nil - すべてのレコードが返されます。 |
[表 : 6. パラメーター]

{#NTblServ-create_S_S_S_S_O_O__table_pnc_xkk_spb} {#NTblServ-create_S_S_S_S_O_O__table_qnc_xkk_spb__entry__2}

| タイプ | Description (説明) |
|-|-|
| AnyPublisher\<Model,NowDataError\> | 成功:指定されたテーブルに挿入されたコード化可能モデル ( sys_Idを含む)。このsys_idを使用して、今後のメソッド呼び出しでこのレコードを参照します。 失敗:NowDataError @escaping (Result\<Model, NowDataError\>) |
[表 : 7. 返される内容]

{#NTblServ-create_S_S_S_S_O_O__table_qnc_xkk_spb}  
ユーザー \[sys_user\] テーブルに単一のレコードを挿入する方法を示します。

    struct User: SysIdentifiableModel {
      var sysId: String = ""
      var name: String
    }

    let service: NowTableService = ...
    let user = User(name: "Ash Williams")
    let publisher: AnyPublisher<User, NowDataError> = service.create(user, in: "sys_user")
    publisher
      .subscribe(on: DispatchQueue.global())
      .receive(on: DispatchQueue.main)
      .sink { [weak self] completion in
        ...
      } receiveValue: { [weak self] newUser in
          /// 'newUser' contains the ServiceNow platform assigned 'sys_id' to use in subsequent update and delete calls.
         ...
      }
      .store(in: &subscriptions)

## NowTableService - createRecord(with fields: \[FieldName: FieldValue\], in tableName: String, writeOptions: FieldWriteOptions? = nil, configuration: FieldReadConfiguration? = nil) 非同期スロー {#ariaid-title5}

指定されたフィールドを含む指定されたテーブルにレコードを挿入します。
publisher は、カスタム [Codable モデル](https://developer.apple.com/documentation/foundation/archives_and_serialization/encoding_and_decoding_custom_types)にデコードできるデータを出力するか、 [NowTableService - paginator\<Model: Decodable\>(from tableName: String, path: String = Constants.resultPath, coder: coder = .default, configuration: FetchConfiguration? = nil)](https://servicenow-prod.fluidtopics.net/oOte0XsLyXvzQxPHCgteyw#NTblServ-paginator_S_S_S_O "ネストを処理するデコードされたモデルのページの反復を可能にするページネータを作成します。") 関数を使用することもできます。 または、便利な関数 convertToRecords() を使用して、データを NowRecord オブジェクトに変換することもできます。NowRecords を出力するように発行元を変換する方法を次に示します。。

    let dataPublisher: AnyPublisher<Data, NowDataError> = ...
    let recordsPublisher: AnyPublisher<[NowRecord], NowDataError> = myPublisher.convertToRecords()

注:  
レコード内のすべてのフィールドは更新できない場合があります。たとえば、プリフィックスが `sys_` のフィールドは、通常、自動的に生成され、更新できないシステムパラメーターです。指定されておらず、システムによって自動生成されていないフィールドは、関連するデータタイプの NULL 値に設定されます。
{#NTblServ-createRecord-async_S_O_O__table_lww_l4j_ppb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| フィールドあり | \[FieldName:FieldValue\] | レコードに含めるフィールドの名前と値のペア。 |
| tableName 内 | 文字列 | レコードを書き込むテーブルの名前 ( インシデントなど)。 |
| 書き込みオプション | [フィールド書き込みオプション](https://servicenow-prod.fluidtopics.net/a7rJUASi8wEa4P_XFxtitg#FieldWriteOptionsiOSStruct "FieldWriteOptions クラスは、ServiceNow インスタンス上のレコードのフィールドを更新または作成するためのオプションを設定する関数を提供します。") | オプション。レコードに書き込まれるデータに適用する構成オプション。 デフォルト:nil |
| 構成 | [FetchConfiguration](https://servicenow-prod.fluidtopics.net/s4pcOrhOcnm~4lgw1mUrfQ#FetchConfigiOSStructure "FetchConfiguration 構造体には、ServiceNow インスタンスからレコードをフェッチするための構成を定義する機能が用意されています。") | オプション。返されるレコード、ページネーションページのサイズ制限、取得するフィールド、フィールドに含めるものを定義するフィルターなど、取得したレコードに適用する構成。 デフォルト:nil - すべてのレコードが返されます。 |
[表 : 8. パラメーター]

{#NTblServ-createRecord-async_S_O_O__table_lww_l4j_ppb} {#NTblServ-createRecord-async_S_O_O__table_mww_l4j_ppb__entry__2}

| タイプ | 説明 |
|-|-|
| Data (データ) | メソッドが成功したときに返されます。新規レコードを含むデータオブジェクト。 |
| NowDataError | メソッドが失敗したときにスローされます。 * `accessToken(アクセストークンプロバイダーエラー)` * AccessTokenProviderError:アクセストークンプロバイダーのエラーコードまたはメッセージ。 * アクセストークン取得に失敗しました * userSessionError(_エラー:エラー) アクセストークンにエラーがある場合にスローされます。 * `attachmentValidation` 添付ファイルが検証に失敗したときにスローされます。 * `badResponse(statusCode: HTTPStatusCode)` * HTTPStatusCode:インスタンスから受信したステータスコード。 要求が予期しない応答を返した場合にスローされます * `cannotDecodeModel(デコードエラー)` * DecodingError:デコードエラーが検出されました。 Codable モデルを JSON からデコードできない場合にスローされます。 * `cannotDecodeProperty(タイプ:任意、差出人:文字列)` * type:文字列からデコードするラップされた型。 * from:指定されたタイプにデコードする文字列。 文字列でラップされた値を JSON からデコードできない場合にスローされます。 * `cannotEncodeModel(エンコーディングエラー)` * EncodingError:エンコードエラーが検出されました。 Codable モデルを JSON にエンコードできない場合にスローされます。 * `cannotParseResponse` インスタンスからの応答を予期される形式に解析できない場合にスローされます。 * `無効な URL` URL を形成できない場合にスローされます。たとえば、文字列に URL で無効な文字が含まれているか、空の文字列である場合などです。 * `missingAttachmentMetadata` 添付ファイルのメタデータヘッダーがない場合にスローされます。 * `missingServiceConfiguration` 予期されるサービス構成がない場合にスローされます。 * `missingSysID` 予期されるsys_idパラメーターがない場合にスローされます。 * `network(NetworkServiceError)` * genericError(文字列) * operationCanceled * serviceDisabled * serverError(エラー) * systemError(エラー) ネットワークサービスでエラーが発生した場合にスローされます。 {#NTblServ-createRecord-async_S_O_O__NowDataErroriOS-ul-enum} |
[表 : 9. 返される内容]

{#NTblServ-createRecord-async_S_O_O__table_mww_l4j_ppb}  
次のコード例は、このメソッドを呼び出す方法を示しています。

    do {
        let dataResult: Data = try await tableService.createRecord(with: fields, in: tableName, writeOptions: writeOptions, configuration: configuration)
        let recordResult: NowRecord = dataResult.convertToRecord()
    } catch {
        print("Record creation failed with NowDataError: \(error)")
    }

## NowTableService - createRecord(with fields: \[FieldName: FieldValue\], in tableName: String, writeOptions: FieldWriteOptions, configuration: FieldReadConfiguration, completion: @escaping (Result\<Data, NowDataError\>) {#ariaid-title6}

指定されたテーブルに指定されたレコードを挿入し、レコードが保存された後に completion ハンドラーを実行します。
必要に応じて、戻り値をカスタム Codable モデルにデコードするか、代わりに関数 [NowTableService - paginator\<Model: Decodable\>(from tableName: String, path: String = Constants.resultPath, coder: coder = .default, configuration: FetchConfiguration? = nil)](https://servicenow-prod.fluidtopics.net/oOte0XsLyXvzQxPHCgteyw#NTblServ-paginator_S_S_S_O "ネストを処理するデコードされたモデルのページの反復を可能にするページネータを作成します。") を使用できます。 または、便利な関数 convertToRecords() を使用して、データを NowRecord オブジェクトに変換することもできます。NowRecords を出力するように発行元を変換する方法を次に示します。

    let dataPublisher: AnyPublisher<Data, NowDataError> = ...
    let recordsPublisher: AnyPublisher<[NowRecord], NowDataError> = myResult.convertToRecords()

注:  
レコード内のすべてのフィールドは更新できない場合があります。たとえば、プリフィックスが `sys_` のフィールドは、通常、自動的に生成され、更新できないシステムパラメーターです。指定されておらず、システムによって自動生成されていないフィールドは、関連するデータタイプの NULL 値に設定されます。
{#NTblServ-createRecord_S_O_O_O__table_vk3_yqj_ppb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| フィールドあり | \[FieldName:FieldValue\] | レコードに含めるフィールドの名前と値のペア。 |
| tableName 内 | 文字列 | レコードを書き込むテーブルの名前 ( インシデントなど)。 |
| 書き込みオプション | [フィールド書き込みオプション](https://servicenow-prod.fluidtopics.net/a7rJUASi8wEa4P_XFxtitg#FieldWriteOptionsiOSStruct "FieldWriteOptions クラスは、ServiceNow インスタンス上のレコードのフィールドを更新または作成するためのオプションを設定する関数を提供します。") | オプション。レコードに書き込まれるデータに適用する構成オプション。 デフォルト:nil |
| 構成 | [FieldReadConfiguration](https://servicenow-prod.fluidtopics.net/9eXGuz1UzagXWZLM8mffZw#FieldReadConfigurationiOSStruct "FieldReadConfiguration 構造体を使用すると、ServiceNowインスタンステーブルからフェッチするフィールドとその形式を構成できます。") | オプション。返すフィールドとフィールドに含める内容を指定する構成オプション。 デフォルト:nil |
| 完了 | @escaping (結果\<データ、NowDataError\>) | レコードを取得した後に実行する完了ハンドラー。 戻り値: * 成功:データ:要求されたレコード * エラー:NowDataError * `accessToken(アクセストークンプロバイダーエラー)` * AccessTokenProviderError:アクセストークンプロバイダーのエラーコードまたはメッセージ。 * アクセストークン取得に失敗しました * userSessionError(_エラー:エラー) アクセストークンにエラーがある場合にスローされます。 * `attachmentValidation` 添付ファイルが検証に失敗したときにスローされます。 * `badResponse(statusCode: HTTPStatusCode)` * HTTPStatusCode:インスタンスから受信したステータスコード。 要求が予期しない応答を返した場合にスローされます * `cannotDecodeModel(デコードエラー)` * DecodingError:デコードエラーが検出されました。 Codable モデルを JSON からデコードできない場合にスローされます。 * `cannotDecodeProperty(タイプ:任意、差出人:文字列)` * type:文字列からデコードするラップされた型。 * from:指定されたタイプにデコードする文字列。 文字列でラップされた値を JSON からデコードできない場合にスローされます。 * `cannotEncodeModel(エンコーディングエラー)` * EncodingError:エンコードエラーが検出されました。 Codable モデルを JSON にエンコードできない場合にスローされます。 * `cannotParseResponse` インスタンスからの応答を予期される形式に解析できない場合にスローされます。 * `無効な URL` URL を形成できない場合にスローされます。たとえば、文字列に URL で無効な文字が含まれているか、空の文字列である場合などです。 * `missingAttachmentMetadata` 添付ファイルのメタデータヘッダーがない場合にスローされます。 * `missingServiceConfiguration` 予期されるサービス構成がない場合にスローされます。 * `missingSysID` 予期されるsys_idパラメーターがない場合にスローされます。 * `network(NetworkServiceError)` * genericError(文字列) * operationCanceled * serviceDisabled * serverError(エラー) * systemError(エラー) ネットワークサービスでエラーが発生した場合にスローされます。 {#NTblServ-createRecord_S_O_O_O__NowDataErroriOS-ul-enum} {#NTblServ-createRecord_S_O_O_O__ul_uzx_thj_ppb} |
[表 : 10. パラメーター]

{#NTblServ-createRecord_S_O_O_O__table_vk3_yqj_ppb} {#NTblServ-createRecord_S_O_O_O__table_wk3_yqj_ppb__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 11. 返される内容]

{#NTblServ-createRecord_S_O_O_O__table_wk3_yqj_ppb}  
次のコード例は、この関数を呼び出す方法を示しています。

    let fields = ["short_description" : "test description"]
    let writeOptions: FieldWriteOptions = [.suppressAutoSysField, .treatInputValuesAsDisplayValues]
    let readConfiguration = FieldReadConfiguration(includeFields: ["number", "short_description"])

    tableService.createRecord(with: fields, in: tableName, writeOptions: writeOptions, configuration: readConfiguration) { [weak self] result in
      switch result {
        case .success(let dataResult):
          let recordResult: NowRecord = dataResult.convertToRecord()
        case .failure(let error):
           print("Record creation failed with NowDataError: \(error)")
      }
    }

## NowTableService - createRecord(with fields: \[FieldName: FieldValue\], in tableName: String, writeOptions: FieldWriteOptions? = nil, configuration: FieldReadConfiguration? = nil) {#ariaid-title7}

指定されたフィールドを含む指定されたテーブルにレコードを挿入します。
注:  
このメソッドは廃止されました。代わりに、メソッドの async/await 実装を使用する必要があります。  
publisher は、カスタム [Codable モデル](https://developer.apple.com/documentation/foundation/archives_and_serialization/encoding_and_decoding_custom_types)にデコードできるデータを出力するか、 [NowTableService - paginator\<Model: Decodable\>(from tableName: String, path: String = Constants.resultPath, coder: coder = .default, configuration: FetchConfiguration? = nil)](https://servicenow-prod.fluidtopics.net/oOte0XsLyXvzQxPHCgteyw#NTblServ-paginator_S_S_S_O "ネストを処理するデコードされたモデルのページの反復を可能にするページネータを作成します。") 関数を使用することもできます。 または、便利な関数 convertToRecords() を使用して、データを NowRecord オブジェクトに変換することもできます。NowRecords を出力するように発行元を変換する方法を次に示します。。

    let dataPublisher: AnyPublisher<Data, NowDataError> = ...
    let recordsPublisher: AnyPublisher<[NowRecord], NowDataError> = myPublisher.convertToRecords()

注:  
レコード内のすべてのフィールドは更新できない場合があります。たとえば、プリフィックスが `sys_` のフィールドは、通常、自動的に生成され、更新できないシステムパラメーターです。指定されておらず、システムによって自動生成されていないフィールドは、関連するデータタイプの NULL 値に設定されます。
{#NTblServ-createRecord_S_O_O__table_lww_l4j_ppb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| フィールドあり | \[FieldName:FieldValue\] | レコードに含めるフィールドの名前と値のペア。 |
| tableName 内 | 文字列 | レコードを書き込むテーブルの名前 ( インシデントなど)。 |
| 書き込みオプション | [フィールド書き込みオプション](https://servicenow-prod.fluidtopics.net/a7rJUASi8wEa4P_XFxtitg#FieldWriteOptionsiOSStruct "FieldWriteOptions クラスは、ServiceNow インスタンス上のレコードのフィールドを更新または作成するためのオプションを設定する関数を提供します。") | オプション。レコードに書き込まれるデータに適用する構成オプション。 デフォルト:nil |
| 構成 | [FetchConfiguration](https://servicenow-prod.fluidtopics.net/s4pcOrhOcnm~4lgw1mUrfQ#FetchConfigiOSStructure "FetchConfiguration 構造体には、ServiceNow インスタンスからレコードをフェッチするための構成を定義する機能が用意されています。") | オプション。返されるレコード、ページネーションページのサイズ制限、取得するフィールド、フィールドに含めるものを定義するフィルターなど、取得したレコードに適用する構成。 デフォルト:nil - すべてのレコードが返されます。 |
[表 : 12. パラメーター]

{#NTblServ-createRecord_S_O_O__table_lww_l4j_ppb} {#NTblServ-createRecord_S_O_O__table_mww_l4j_ppb__entry__2}

| タイプ | Description (説明) |
|-|-|
| AnyPublisher\<Data、NowDataError\> | 成功:更新されたレコードを含むデータオブジェクト。 失敗:NowDataError * `accessToken(アクセストークンプロバイダーエラー)` * AccessTokenProviderError:アクセストークンプロバイダーのエラーコードまたはメッセージ。 * アクセストークン取得に失敗しました * userSessionError(_エラー:エラー) アクセストークンにエラーがある場合にスローされます。 * `attachmentValidation` 添付ファイルが検証に失敗したときにスローされます。 * `badResponse(statusCode: HTTPStatusCode)` * HTTPStatusCode:インスタンスから受信したステータスコード。 要求が予期しない応答を返した場合にスローされます * `cannotDecodeModel(デコードエラー)` * DecodingError:デコードエラーが検出されました。 Codable モデルを JSON からデコードできない場合にスローされます。 * `cannotDecodeProperty(タイプ:任意、差出人:文字列)` * type:文字列からデコードするラップされた型。 * from:指定されたタイプにデコードする文字列。 文字列でラップされた値を JSON からデコードできない場合にスローされます。 * `cannotEncodeModel(エンコーディングエラー)` * EncodingError:エンコードエラーが検出されました。 Codable モデルを JSON にエンコードできない場合にスローされます。 * `cannotParseResponse` インスタンスからの応答を予期される形式に解析できない場合にスローされます。 * `無効な URL` URL を形成できない場合にスローされます。たとえば、文字列に URL で無効な文字が含まれているか、空の文字列である場合などです。 * `missingAttachmentMetadata` 添付ファイルのメタデータヘッダーがない場合にスローされます。 * `missingServiceConfiguration` 予期されるサービス構成がない場合にスローされます。 * `missingSysID` 予期されるsys_idパラメーターがない場合にスローされます。 * `network(NetworkServiceError)` * genericError(文字列) * operationCanceled * serviceDisabled * serverError(エラー) * systemError(エラー) ネットワークサービスでエラーが発生した場合にスローされます。 {#NTblServ-createRecord_S_O_O__NowDataErroriOS-ul-enum} |
[表 : 13. 返される内容]

{#NTblServ-createRecord_S_O_O__table_mww_l4j_ppb}  
この例では、指定されたテーブルに指定されたフィールドを使用してレコードを挿入する関数を作成する方法を示します。呼び出しの出力は ByteArray で、データを任意のモデルに変換できます。

    tableService.createRecord(with: fields, in: tableName, writeOptions: writeOptions, configuration: readConfiguration)
        .subscribe(on: DispatchQueue.global())
        .receive(on: DispatchQueue.main)
        .convertToRecord()
        .sink { completion in
            if case let .failure(error) = completion {
                print("Record creation failed with NowDataError: \(error)")
            }
        } receiveValue: { record in
            print("Created NowRecord: \(record)")
        }
        .store(in: &subscriptions)

## NowTableService - delete(_ model: Model, from tableName: String) async throws {#ariaid-title8}

指定されたコード化可能モデルを指定されたテーブルから削除します。
{#NTblServ-delete-async_S_S__table_qvl_lzk_spb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| モデル | モデル | テーブルから削除する `SysIdentifiableModel`。削除するレコードのsys_idが含まれている必要があります。 |
| テーブル名から | 文字列 | incident などの情報の削除元のテーブルの名前。 |
[表 : 14. パラメーター]

{#NTblServ-delete-async_S_S__table_qvl_lzk_spb} {#NTblServ-delete-async_S_S__table_rvl_lzk_spb__entry__2}

| タイプ | 説明 |
|-|-|
| なし | メソッドが成功したときには何も返されません。 |
| NowDataError | メソッドが失敗したときにスローされます。 * `accessToken(アクセストークンプロバイダーエラー)` * AccessTokenProviderError:アクセストークンプロバイダーのエラーコードまたはメッセージ。 * アクセストークン取得に失敗しました * userSessionError(_エラー:エラー) アクセストークンにエラーがある場合にスローされます。 * `attachmentValidation` 添付ファイルが検証に失敗したときにスローされます。 * `badResponse(statusCode: HTTPStatusCode)` * HTTPStatusCode:インスタンスから受信したステータスコード。 要求が予期しない応答を返した場合にスローされます * `cannotDecodeModel(デコードエラー)` * DecodingError:デコードエラーが検出されました。 Codable モデルを JSON からデコードできない場合にスローされます。 * `cannotDecodeProperty(タイプ:任意、差出人:文字列)` * type:文字列からデコードするラップされた型。 * from:指定されたタイプにデコードする文字列。 文字列でラップされた値を JSON からデコードできない場合にスローされます。 * `cannotEncodeModel(エンコーディングエラー)` * EncodingError:エンコードエラーが検出されました。 Codable モデルを JSON にエンコードできない場合にスローされます。 * `cannotParseResponse` インスタンスからの応答を予期される形式に解析できない場合にスローされます。 * `無効な URL` URL を形成できない場合にスローされます。たとえば、文字列に URL で無効な文字が含まれているか、空の文字列である場合などです。 * `missingAttachmentMetadata` 添付ファイルのメタデータヘッダーがない場合にスローされます。 * `missingServiceConfiguration` 予期されるサービス構成がない場合にスローされます。 * `missingSysID` 予期されるsys_idパラメーターがない場合にスローされます。 * `network(NetworkServiceError)` * genericError(文字列) * operationCanceled * serviceDisabled * serverError(エラー) * systemError(エラー) ネットワークサービスでエラーが発生した場合にスローされます。 {#NTblServ-delete-async_S_S__NowDataErroriOS-ul-enum} |
[表 : 15. 返される内容]

{#NTblServ-delete-async_S_S__table_rvl_lzk_spb}  
次のコード例は、このメソッドを呼び出す方法を示しています。

    do { 
        try await tableService.delete(model, from: tableName)
        print("Deletion successful.")
    } catch {
        print("Deletion failed with NowDataError: \(error)")
    }

## NowTableService - delete(_ model: Model, from tableName: String, completion: @escaping (Result\<Void, NowDataError\>)) {#ariaid-title9}

指定されたテーブルから指定された Codable モデルを削除し、適切な completion ハンドラーを実行します。
{#NTblServ-delete_S_S_O__table_zss_k1l_spb__entry__3}

| 名前 | タイプ | Description (説明) |
|-|-|-|
| モデル | モデル | テーブルから削除する `SysIdentifiableModel`。削除するレコードのsys_idが含まれている必要があります。 |
| テーブル名から | 文字列 | incident などの情報の削除元のテーブルの名前。 |
| 完了 | @escaping (結果\<無効、NowDataError\>) | 指定されたコード化可能モデルを削除した後に実行する完了ハンドラー。 戻り値: * 成功:何も返されませんでした * 失敗:NowDataError * `accessToken(アクセストークンプロバイダーエラー)` * AccessTokenProviderError:アクセストークンプロバイダーのエラーコードまたはメッセージ。 * アクセストークン取得に失敗しました * userSessionError(_エラー:エラー) アクセストークンにエラーがある場合にスローされます。 * `attachmentValidation` 添付ファイルが検証に失敗したときにスローされます。 * `badResponse(statusCode: HTTPStatusCode)` * HTTPStatusCode:インスタンスから受信したステータスコード。 要求が予期しない応答を返した場合にスローされます * `cannotDecodeModel(デコードエラー)` * DecodingError:デコードエラーが検出されました。 Codable モデルを JSON からデコードできない場合にスローされます。 * `cannotDecodeProperty(タイプ:任意、差出人:文字列)` * type:文字列からデコードするラップされた型。 * from:指定されたタイプにデコードする文字列。 文字列でラップされた値を JSON からデコードできない場合にスローされます。 * `cannotEncodeModel(エンコーディングエラー)` * EncodingError:エンコードエラーが検出されました。 Codable モデルを JSON にエンコードできない場合にスローされます。 * `cannotParseResponse` インスタンスからの応答を予期される形式に解析できない場合にスローされます。 * `無効な URL` URL を形成できない場合にスローされます。たとえば、文字列に URL で無効な文字が含まれているか、空の文字列である場合などです。 * `missingAttachmentMetadata` 添付ファイルのメタデータヘッダーがない場合にスローされます。 * `missingServiceConfiguration` 予期されるサービス構成がない場合にスローされます。 * `missingSysID` 予期されるsys_idパラメーターがない場合にスローされます。 * `network(NetworkServiceError)` * genericError(文字列) * operationCanceled * serviceDisabled * serverError(エラー) * systemError(エラー) ネットワークサービスでエラーが発生した場合にスローされます。 {#NTblServ-delete_S_S_O__NowDataErroriOS-ul-enum} {#NTblServ-delete_S_S_O__ul_dpx_jvk_spb} |
[表 : 16. パラメーター]

{#NTblServ-delete_S_S_O__table_zss_k1l_spb} {#NTblServ-delete_S_S_O__table_ats_k1l_spb__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 17. 返される内容]

{#NTblServ-delete_S_S_O__table_ats_k1l_spb}  
次のコード例は、この関数を呼び出す方法を示しています。

    tableService.delete(Incident(sysId: sysId), from: tableName) { [weak self] result in
      switch result {
        case .success:
          // Delete successfully
        case .failure(let error):
          // Failed to delete with NowDataError
      }
    }

## NowTableService - delete(_ model: Model, from tableName: String) {#ariaid-title10}

指定されたコード化可能モデルを指定されたテーブルから削除します。
注:  
このメソッドは廃止されました。代わりに、メソッドの async/await 実装を使用する必要があります。
{#NTblServ-delete_S_S__table_qvl_lzk_spb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| モデル | モデル | テーブルから削除する `SysIdentifiableModel`。削除するレコードのsys_idが含まれている必要があります。 |
| テーブル名から | 文字列 | incident などの情報の削除元のテーブルの名前。 |
[表 : 18. パラメーター]

{#NTblServ-delete_S_S__table_qvl_lzk_spb} {#NTblServ-delete_S_S__table_rvl_lzk_spb__entry__2}

| タイプ | Description (説明) |
|-|-|
| AnyPublisher\<Void、NowDataError\> | 成功:何も返されませんでした 失敗:NowDataError * `accessToken(アクセストークンプロバイダーエラー)` * AccessTokenProviderError:アクセストークンプロバイダーのエラーコードまたはメッセージ。 * アクセストークン取得に失敗しました * userSessionError(_エラー:エラー) アクセストークンにエラーがある場合にスローされます。 * `attachmentValidation` 添付ファイルが検証に失敗したときにスローされます。 * `badResponse(statusCode: HTTPStatusCode)` * HTTPStatusCode:インスタンスから受信したステータスコード。 要求が予期しない応答を返した場合にスローされます * `cannotDecodeModel(デコードエラー)` * DecodingError:デコードエラーが検出されました。 Codable モデルを JSON からデコードできない場合にスローされます。 * `cannotDecodeProperty(タイプ:任意、差出人:文字列)` * type:文字列からデコードするラップされた型。 * from:指定されたタイプにデコードする文字列。 文字列でラップされた値を JSON からデコードできない場合にスローされます。 * `cannotEncodeModel(エンコーディングエラー)` * EncodingError:エンコードエラーが検出されました。 Codable モデルを JSON にエンコードできない場合にスローされます。 * `cannotParseResponse` インスタンスからの応答を予期される形式に解析できない場合にスローされます。 * `無効な URL` URL を形成できない場合にスローされます。たとえば、文字列に URL で無効な文字が含まれているか、空の文字列である場合などです。 * `missingAttachmentMetadata` 添付ファイルのメタデータヘッダーがない場合にスローされます。 * `missingServiceConfiguration` 予期されるサービス構成がない場合にスローされます。 * `missingSysID` 予期されるsys_idパラメーターがない場合にスローされます。 * `network(NetworkServiceError)` * genericError(文字列) * operationCanceled * serviceDisabled * serverError(エラー) * systemError(エラー) ネットワークサービスでエラーが発生した場合にスローされます。 {#NTblServ-delete_S_S__NowDataErroriOS-ul-enum} |
[表 : 19. 返される内容]

{#NTblServ-delete_S_S__table_rvl_lzk_spb}  
次のコード例は、この関数を呼び出す方法を示しています。

    tableService.delete(Incident(sysId: sysId), from: tableName)
      .subscribe(on: DispatchQueue.global())
      .receive(on: DispatchQueue.main)
      .sink { [weak self] completion in
        switch completion {
          case .finished:
            // Delete successfully
          case .failure(let error):
            // Failed to delete with NowDataError
        }
      } receiveValue: { _ in
      }
      .store(in: &subscriptions)

## NowTableService - deleteRecord(sysId: SysID, from tableName: String) async throws {#ariaid-title11}

指定されたテーブルから指定されたレコードを削除します。
{#NTblServ-deleteRecord-async_S_S__table_nvk_2vj_ppb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| sysId | 文字列 | 削除するレコードの sys_id。 |
| テーブル名から | 文字列 | incident などの情報の削除元のテーブルの名前。 |
[表 : 20. パラメーター]

{#NTblServ-deleteRecord-async_S_S__table_nvk_2vj_ppb} {#NTblServ-deleteRecord-async_S_S__table_ovk_2vj_ppb__entry__2}

| タイプ | 説明 |
|-|-|
| なし | メソッドが成功したときには何も返されません。 |
| NowDataError | メソッドが失敗したときにスローされます。 * `accessToken(アクセストークンプロバイダーエラー)` * AccessTokenProviderError:アクセストークンプロバイダーのエラーコードまたはメッセージ。 * アクセストークン取得に失敗しました * userSessionError(_エラー:エラー) アクセストークンにエラーがある場合にスローされます。 * `attachmentValidation` 添付ファイルが検証に失敗したときにスローされます。 * `badResponse(statusCode: HTTPStatusCode)` * HTTPStatusCode:インスタンスから受信したステータスコード。 要求が予期しない応答を返した場合にスローされます * `cannotDecodeModel(デコードエラー)` * DecodingError:デコードエラーが検出されました。 Codable モデルを JSON からデコードできない場合にスローされます。 * `cannotDecodeProperty(タイプ:任意、差出人:文字列)` * type:文字列からデコードするラップされた型。 * from:指定されたタイプにデコードする文字列。 文字列でラップされた値を JSON からデコードできない場合にスローされます。 * `cannotEncodeModel(エンコーディングエラー)` * EncodingError:エンコードエラーが検出されました。 Codable モデルを JSON にエンコードできない場合にスローされます。 * `cannotParseResponse` インスタンスからの応答を予期される形式に解析できない場合にスローされます。 * `無効な URL` URL を形成できない場合にスローされます。たとえば、文字列に URL で無効な文字が含まれているか、空の文字列である場合などです。 * `missingAttachmentMetadata` 添付ファイルのメタデータヘッダーがない場合にスローされます。 * `missingServiceConfiguration` 予期されるサービス構成がない場合にスローされます。 * `missingSysID` 予期されるsys_idパラメーターがない場合にスローされます。 * `network(NetworkServiceError)` * genericError(文字列) * operationCanceled * serviceDisabled * serverError(エラー) * systemError(エラー) ネットワークサービスでエラーが発生した場合にスローされます。 {#NTblServ-deleteRecord-async_S_S__NowDataErroriOS-ul-enum} |
[表 : 21. 返される内容]

{#NTblServ-deleteRecord-async_S_S__table_ovk_2vj_ppb}  
次のコード例は、このメソッドを呼び出す方法を示しています。

    do {
        try await tableService.deleteRecord(sysId: sysId, from: tableName)
        print("Deletion successful.")
    } catch {
        print("Deletion failed with NowDataError: \(error)")
    }

## NowTableService - deleteRecord(sysId: SysID, from tableName: String, completion: @escaping (Result\<Void, NowDataError\>)) {#ariaid-title12}

指定されたテーブルから指定されたレコードを削除し、レコードが削除された後に completion オブジェクトを実行します。
{#NTblServ-deleteRecord_S_S_O__table_krx_yvj_ppb__entry__3}

| 名前 | タイプ | Description (説明) |
|-|-|-|
| sysId | 文字列 | 削除するレコードの sys_id。 |
| テーブル名から | 文字列 | incident などの情報の削除元のテーブルの名前。 |
| 完了 | @escaping (結果\<無効、NowDataError\>) | 成功:何も返されません。 失敗:NowDataError * `accessToken(アクセストークンプロバイダーエラー)` * AccessTokenProviderError:アクセストークンプロバイダーのエラーコードまたはメッセージ。 * アクセストークン取得に失敗しました * userSessionError(_エラー:エラー) アクセストークンにエラーがある場合にスローされます。 * `attachmentValidation` 添付ファイルが検証に失敗したときにスローされます。 * `badResponse(statusCode: HTTPStatusCode)` * HTTPStatusCode:インスタンスから受信したステータスコード。 要求が予期しない応答を返した場合にスローされます * `cannotDecodeModel(デコードエラー)` * DecodingError:デコードエラーが検出されました。 Codable モデルを JSON からデコードできない場合にスローされます。 * `cannotDecodeProperty(タイプ:任意、差出人:文字列)` * type:文字列からデコードするラップされた型。 * from:指定されたタイプにデコードする文字列。 文字列でラップされた値を JSON からデコードできない場合にスローされます。 * `cannotEncodeModel(エンコーディングエラー)` * EncodingError:エンコードエラーが検出されました。 Codable モデルを JSON にエンコードできない場合にスローされます。 * `cannotParseResponse` インスタンスからの応答を予期される形式に解析できない場合にスローされます。 * `無効な URL` URL を形成できない場合にスローされます。たとえば、文字列に URL で無効な文字が含まれているか、空の文字列である場合などです。 * `missingAttachmentMetadata` 添付ファイルのメタデータヘッダーがない場合にスローされます。 * `missingServiceConfiguration` 予期されるサービス構成がない場合にスローされます。 * `missingSysID` 予期されるsys_idパラメーターがない場合にスローされます。 * `network(NetworkServiceError)` * genericError(文字列) * operationCanceled * serviceDisabled * serverError(エラー) * systemError(エラー) ネットワークサービスでエラーが発生した場合にスローされます。 {#NTblServ-deleteRecord_S_S_O__NowDataErroriOS-ul-enum} |
[表 : 22. パラメーター]

{#NTblServ-deleteRecord_S_S_O__table_krx_yvj_ppb} {#NTblServ-deleteRecord_S_S_O__table_lrx_yvj_ppb__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 23. 返される内容]

{#NTblServ-deleteRecord_S_S_O__table_lrx_yvj_ppb}  
次のコード例は、この関数を呼び出す方法を示しています。

    tableService.deleteRecord(sysId: sysId, from: tableName) { [weak self] result in
      switch result {
        case .success:
          // Delete successfully
        case .failure(let error):
          // Failed to delete with NowDataError
      }
    }

## NowTableService - deleteRecord(sysId: SysID, from tableName: String) {#ariaid-title13}

指定されたテーブルから指定されたレコードを削除します。
注:  
このメソッドは廃止されました。代わりに、メソッドの async/await 実装を使用する必要があります。
{#NTblServ-deleteRecord_S_S__table_nvk_2vj_ppb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| sysId | 文字列 | 削除するレコードの sys_id。 |
| テーブル名から | 文字列 | incident などの情報の削除元のテーブルの名前。 |
[表 : 24. パラメーター]

{#NTblServ-deleteRecord_S_S__table_nvk_2vj_ppb} {#NTblServ-deleteRecord_S_S__table_ovk_2vj_ppb__entry__2}

| タイプ | Description (説明) |
|-|-|
| AnyPublisher\<Void、NowDataError\> | 成功:何も返されませんでした 失敗:NowDataError * `accessToken(アクセストークンプロバイダーエラー)` * AccessTokenProviderError:アクセストークンプロバイダーのエラーコードまたはメッセージ。 * アクセストークン取得に失敗しました * userSessionError(_エラー:エラー) アクセストークンにエラーがある場合にスローされます。 * `attachmentValidation` 添付ファイルが検証に失敗したときにスローされます。 * `badResponse(statusCode: HTTPStatusCode)` * HTTPStatusCode:インスタンスから受信したステータスコード。 要求が予期しない応答を返した場合にスローされます * `cannotDecodeModel(デコードエラー)` * DecodingError:デコードエラーが検出されました。 Codable モデルを JSON からデコードできない場合にスローされます。 * `cannotDecodeProperty(タイプ:任意、差出人:文字列)` * type:文字列からデコードするラップされた型。 * from:指定されたタイプにデコードする文字列。 文字列でラップされた値を JSON からデコードできない場合にスローされます。 * `cannotEncodeModel(エンコーディングエラー)` * EncodingError:エンコードエラーが検出されました。 Codable モデルを JSON にエンコードできない場合にスローされます。 * `cannotParseResponse` インスタンスからの応答を予期される形式に解析できない場合にスローされます。 * `無効な URL` URL を形成できない場合にスローされます。たとえば、文字列に URL で無効な文字が含まれているか、空の文字列である場合などです。 * `missingAttachmentMetadata` 添付ファイルのメタデータヘッダーがない場合にスローされます。 * `missingServiceConfiguration` 予期されるサービス構成がない場合にスローされます。 * `missingSysID` 予期されるsys_idパラメーターがない場合にスローされます。 * `network(NetworkServiceError)` * genericError(文字列) * operationCanceled * serviceDisabled * serverError(エラー) * systemError(エラー) ネットワークサービスでエラーが発生した場合にスローされます。 {#NTblServ-deleteRecord_S_S__NowDataErroriOS-ul-enum} |
[表 : 25. 返される内容]

{#NTblServ-deleteRecord_S_S__table_ovk_2vj_ppb}  
この例では、指定したテーブルのレコードを削除する関数を作成する方法を示します。

    tableService.deleteRecord(sysId: sysId, from: tableName) 
        .subscribe(on: DispatchQueue.global())
        .receive(on: DispatchQueue.main)
        .sink { completion in
            switch completion {
            case .finished:
                print("Record deleted.")
            case .failure(let error):
                print("Deletion failed with NowDataError: \(error)")
            }
        } receiveValue: { _ in }
        .store(in: &subscriptions)

## NowServiceTable - init(configuration: NowServiceConfiguration, coreServiceProvider: NowCoreServiceProviding? = nil) {#ariaid-title14}

NowTableService オブジェクトを作成します。
{#NTblServ-init_S_S__table_djd_fv3_ppb__entry__3}

| 名前 | タイプ | Description (説明) |
|-|-|-|
| 構成 | [NowServiceConfiguration](https://servicenow-prod.fluidtopics.net/stoU_DsvecOSpmkh8Wo3FA#NowServiceConfigurationiOSStruct "NowServiceConfiguration 構造体は、フィーチャ サービスの構成情報を定義します。") | サービスの作成時に使用する設定パラメーター。 |
| coreServiceProvider | NowCoreServiceOffering | オプション。NowTableService に関連付けるサービスプロバイダー。 デフォルト:nil |
[表 : 26. パラメーター]

{#NTblServ-init_S_S__table_djd_fv3_ppb}  
次のコード例は、この関数を呼び出す方法を示しています。

    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 tableService = NowTableService (configuration: serviceConfig, coreServiceProvider: coreService)

## NowTableService - model\<Model: Decodable\>(with sysId: SysID? = nil, from tableName: String, path: String = Constants.resultPath, coder: coder = .default, configuration: FetchConfiguration? = nil) 非同期スロー {#ariaid-title15}

指定されたテーブルから復号化可能なモデルを取得できるようにします。
テーブル API 応答は、次のような result パラメーター内にネストされます。

    {
      "result": [
        { "name": "Ash Williams" },
        { "name": "Lionel Cosgrove" },
        { "name": "Laurie Strode" }
      ]
    }

結果セットが大きい場合は、ページネーションされたモデルをフェッチするために、 [NowTableService - paginator(from tableName: String, configuration: FetchConfiguration? = nil)](https://servicenow-prod.fluidtopics.net/oOte0XsLyXvzQxPHCgteyw#NTblServ-paginator_S_O "レコードのページを反復処理できるページネーターを作成します。") または [NowTableService - paginator\<Model: Decodable\>(from tableName: String, path: String = Constants.resultPath, coder: coder = .default, configuration: FetchConfiguration? = nil)](https://servicenow-prod.fluidtopics.net/oOte0XsLyXvzQxPHCgteyw#NTblServ-paginator_S_S_S_O "ネストを処理するデコードされたモデルのページの反復を可能にするページネータを作成します。") のいずれかのページネーター関数を使用します。
{#NTblServ-model-async_S_S_S_S_O__table_nbq_yyj_spb__entry__3}{#NTblServ-model-async_S_S_S_S_O__mobilesdkiOS-tableName-entry}

| 名前 | タイプ | Description (説明) |
|-|-|-|
| sysId あり | SysID | オプション。返されるレコードの sys_id。特定のレコードを取得する場合は、sys_idを入力します。 デフォルト:nil |
| テーブル名から | 文字列 | レコードの取得元となるテーブルの名前 ( incident など)。 |
| path | 文字列 | ネストされた型のドット区切りパス。たとえば、 `より` 深い入れ子の場合は `result または foo.bar.baz` です。 デフォルト: `result` |
| コーダー | コーダー | オプション。ServiceNow インスタンスとの間で送受信されるデータのエンコードまたはデコードに使用する`コーダー`。 可能な値： * default: 既定のエンコーダーは、デバイスの`ロケール`と`タイム ゾーン`を使用して、`yyy-MM-dd HH:mm:ss` 形式を使用して日付を書式設定します。 * custom(JSONEncoder, JSONDecoder): `カスタム` コーダーを使用して、JSON のデコード/エンコードをよりきめ細かく制御します。 この列挙は、特別な日付形式、タイムゾーン、またはロケールを使用する場合など、独自の `JSONEncoder` と `JSONDecoder`を指定する場合にのみ使用してください。 let myEncoder = JSONEncoder() myEncoder.dateFormat = ... let myDecoder = JSONDecoder() myDecoder.dateFormat = ... let coder: Coder = .custom(myEncoder, myDecoder) {#NTblServ-model-async_S_S_S_S_O__ul_nx3_wrd_sqb} デフォルト:.default |
| 構成 | [FetchConfiguration](https://servicenow-prod.fluidtopics.net/s4pcOrhOcnm~4lgw1mUrfQ#FetchConfigiOSStructure "FetchConfiguration 構造体には、ServiceNow インスタンスからレコードをフェッチするための構成を定義する機能が用意されています。") | オプション。返されるレコード、ページネーションページのサイズ制限、取得するフィールド、フィールドに含めるものを定義するフィルターなど、取得したレコードに適用する構成。 デフォルト:nil - すべてのレコードが返されます。 |
[表 : 27. パラメーター]

{#NTblServ-model-async_S_S_S_S_O__table_nbq_yyj_spb} {#NTblServ-model-async_S_S_S_S_O__table_obq_yyj_spb__entry__2}

| タイプ | Description (説明) |
|-|-|
| モデル | メソッドが成功したときに返されます。復号化可能なモデル。 |
| NowDataError | メソッドが失敗したときにスローされます。 * `accessToken(アクセストークンプロバイダーエラー)` * AccessTokenProviderError:アクセストークンプロバイダーのエラーコードまたはメッセージ。 * アクセストークン取得に失敗しました * userSessionError(_エラー:エラー) アクセストークンにエラーがある場合にスローされます。 * `attachmentValidation` 添付ファイルが検証に失敗したときにスローされます。 * `badResponse(statusCode: HTTPStatusCode)` * HTTPStatusCode:インスタンスから受信したステータスコード。 要求が予期しない応答を返した場合にスローされます * `cannotDecodeModel(デコードエラー)` * DecodingError:デコードエラーが検出されました。 Codable モデルを JSON からデコードできない場合にスローされます。 * `cannotDecodeProperty(タイプ:任意、差出人:文字列)` * type:文字列からデコードするラップされた型。 * from:指定されたタイプにデコードする文字列。 文字列でラップされた値を JSON からデコードできない場合にスローされます。 * `cannotEncodeModel(エンコーディングエラー)` * EncodingError:エンコードエラーが検出されました。 Codable モデルを JSON にエンコードできない場合にスローされます。 * `cannotParseResponse` インスタンスからの応答を予期される形式に解析できない場合にスローされます。 * `無効な URL` URL を形成できない場合にスローされます。たとえば、文字列に URL で無効な文字が含まれているか、空の文字列である場合などです。 * `missingAttachmentMetadata` 添付ファイルのメタデータヘッダーがない場合にスローされます。 * `missingServiceConfiguration` 予期されるサービス構成がない場合にスローされます。 * `missingSysID` 予期されるsys_idパラメーターがない場合にスローされます。 * `network(NetworkServiceError)` * genericError(文字列) * operationCanceled * serviceDisabled * serverError(エラー) * systemError(エラー) ネットワークサービスでエラーが発生した場合にスローされます。 {#NTblServ-model-async_S_S_S_S_O__NowDataErroriOS-ul-enum} |
[表 : 28. 返される内容]

{#NTblServ-model-async_S_S_S_S_O__table_obq_yyj_spb}  
次のコード例は、このメソッドを呼び出す方法を示しています。

    struct User: Codable { 
        var name: String
    } 

    let service: NowTableService = ... 
    do {
        let result = try await service.model([User].self, from: "sys_user", path: "result")
        print("Fetched \(users.count) users")
    } catch {
        dump(error) 
    }

次のコード例は、1 つの復号化可能なモデルを sys_id でフェッチする方法を示しています。`[User].self` ではなく `User.self` など、単一のモデルタイプを使用します。

    let result = try await service.model(User.self, with: "5137153cc611227c000bbd1bd8cd2005", from: "sys_user", path: "result") 

## NowTableService - model\<Model: Decodable\>(_ type: Model.Type, with sysId: SysID? = nil, from tableName: String, path: String = Constants.resultPath, coder: Coder = .default, configuration: FetchConfiguration? = nil, completion: @escaping (Result\<Model, NowDataError\>)) {#ariaid-title16}

指定されたテーブルから復号化可能なモデルを取得します。
テーブル API 応答は、次のような result パラメーター内にネストされます。

    {
      "result": [
        { "name": "Ash Williams" },
        { "name": "Lionel Cosgrove" },
        { "name": "Laurie Strode" }
      ]
    }

この関数を使用して、入れ子になった出力の代わりに復号化可能なモデルを取得します。
{#NTblServ-model_S_S_S_S_S_O_O__table_trc_vfk_spb__entry__3}{#NTblServ-model_S_S_S_S_S_O_O__mobilesdkiOS-tableName-entry}

| 名前 | タイプ | 説明 |
|-|-|-|
| type | Model.Type | デコードする値のタイプ。 |
| sysId あり | 文字列 | オプション。返されるレコードの sys_id。 デフォルト: configuration 設定に従って返されるすべてのレコード。 |
| テーブル名から | 文字列 | レコードの取得元となるテーブルの名前 ( incident など)。 |
| path | 文字列 | オプション。ネストされた型のドット区切りパス。たとえば、 `より` 深い入れ子の場合は `result または foo.bar.baz` です。 デフォルト: `Constants.resultPath` |
| コーダー | コーダー | オプション。ServiceNow インスタンスとの間で送受信されるデータのエンコードまたはデコードに使用する`コーダー`。 デフォルト: `.default` |
| 構成 | [FetchConfiguration](https://servicenow-prod.fluidtopics.net/s4pcOrhOcnm~4lgw1mUrfQ#FetchConfigiOSStructure "FetchConfiguration 構造体には、ServiceNow インスタンスからレコードをフェッチするための構成を定義する機能が用意されています。") | オプション。返されるレコード、ページネーションページのサイズ制限、取得するフィールド、フィールドに含めるものを定義するフィルターなど、取得したレコードに適用する構成。 デフォルト:nil - すべてのレコードが返されます。 |
| 完了 | @escaping (Result\<Model, NowDataError\>) | 指定された復号可能モデルを取得した後に実行する完了ハンドラー。 完了ハンドラーの戻り値: * 成功:要求されたモデルタイプのデータ。 * 失敗:NowDataError * `accessToken(アクセストークンプロバイダーエラー)` * AccessTokenProviderError:アクセストークンプロバイダーのエラーコードまたはメッセージ。 * アクセストークン取得に失敗しました * userSessionError(_エラー:エラー) アクセストークンにエラーがある場合にスローされます。 * `attachmentValidation` 添付ファイルが検証に失敗したときにスローされます。 * `badResponse(statusCode: HTTPStatusCode)` * HTTPStatusCode:インスタンスから受信したステータスコード。 要求が予期しない応答を返した場合にスローされます * `cannotDecodeModel(デコードエラー)` * DecodingError:デコードエラーが検出されました。 Codable モデルを JSON からデコードできない場合にスローされます。 * `cannotDecodeProperty(タイプ:任意、差出人:文字列)` * type:文字列からデコードするラップされた型。 * from:指定されたタイプにデコードする文字列。 文字列でラップされた値を JSON からデコードできない場合にスローされます。 * `cannotEncodeModel(エンコーディングエラー)` * EncodingError:エンコードエラーが検出されました。 Codable モデルを JSON にエンコードできない場合にスローされます。 * `cannotParseResponse` インスタンスからの応答を予期される形式に解析できない場合にスローされます。 * `無効な URL` URL を形成できない場合にスローされます。たとえば、文字列に URL で無効な文字が含まれているか、空の文字列である場合などです。 * `missingAttachmentMetadata` 添付ファイルのメタデータヘッダーがない場合にスローされます。 * `missingServiceConfiguration` 予期されるサービス構成がない場合にスローされます。 * `missingSysID` 予期されるsys_idパラメーターがない場合にスローされます。 * `network(NetworkServiceError)` * genericError(文字列) * operationCanceled * serviceDisabled * serverError(エラー) * systemError(エラー) ネットワークサービスでエラーが発生した場合にスローされます。 {#NTblServ-model_S_S_S_S_S_O_O__NowDataErroriOS-ul-enum} |
[表 : 29. パラメーター]

{#NTblServ-model_S_S_S_S_S_O_O__table_trc_vfk_spb} {#NTblServ-model_S_S_S_S_S_O_O__table_urc_vfk_spb__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 30. 返される内容]

{#NTblServ-model_S_S_S_S_S_O_O__table_urc_vfk_spb}  
デコードされた User モデルのコレクションを取得します。

    struct User: SysIdentifiableModel {
        var sysId: String = ""
        var name: String
    }
    let service: NowTableService = ...
    let user = User(name: "Ash Williams")
    service.create(Incident(fields: fields), in: tableName, writeOptions: writeOptions, configuration: fetchConfiguration) { [weak self] result in
      switch result {
      case .success(let newUser):
        /// 'newUser' contains the platform assigned 'sys_id', use in subsequent 'update' or 'delete' calls.
      case .failure(let error):
       ...
     }
    }

単一の復号化可能モデルをsys_idでフェッチするには、\[`User].self` ではなく `User.self` などの単一のモデルタイプを使用します。

    service.model(User.self, with: "5137153cc611227c000bbd1bd8cd2005", from: "sys_user", path: "result") { resultin ... }

## NowTableService - model\<Model: Decodable\>(with sysId: SysID? = nil, from tableName: String, path: String = Constants.resultPath, coder: coder = .default, configuration: FetchConfiguration? = nil) {#ariaid-title17}

指定されたテーブルから復号化可能なモデルを取得できるパブリッシャーを作成します。
注:  
このメソッドは廃止されました。代わりに、メソッドの async/await 実装を使用する必要があります。  
テーブル API 応答は、次のような result パラメーター内にネストされます。

    {
      "result": [
        { "name": "Ash Williams" },
        { "name": "Lionel Cosgrove" },
        { "name": "Laurie Strode" }
      ]
    }

結果セットが大きい場合は、ページネーションされたモデルをフェッチするために、 [NowTableService - paginator(from tableName: String, configuration: FetchConfiguration? = nil)](https://servicenow-prod.fluidtopics.net/oOte0XsLyXvzQxPHCgteyw#NTblServ-paginator_S_O "レコードのページを反復処理できるページネーターを作成します。") または [NowTableService - paginator\<Model: Decodable\>(from tableName: String, path: String = Constants.resultPath, coder: coder = .default, configuration: FetchConfiguration? = nil)](https://servicenow-prod.fluidtopics.net/oOte0XsLyXvzQxPHCgteyw#NTblServ-paginator_S_S_S_O "ネストを処理するデコードされたモデルのページの反復を可能にするページネータを作成します。") のいずれかのページネーター関数を使用します。
{#NTblServ-model_S_S_S_S_O__table_nbq_yyj_spb__entry__3}{#NTblServ-model_S_S_S_S_O__mobilesdkiOS-tableName-entry}

| 名前 | タイプ | Description (説明) |
|-|-|-|
| sysId あり | SysID | オプション。返されるレコードの sys_id。特定のレコードを取得する場合は、sys_idを入力します。 デフォルト:nil |
| テーブル名から | 文字列 | レコードの取得元となるテーブルの名前 ( incident など)。 |
| path | 文字列 | ネストされた型のドット区切りパス。たとえば、 `より` 深い入れ子の場合は `result または foo.bar.baz` です。 デフォルト: `result` |
| コーダー | コーダー | オプション。ServiceNow インスタンスとの間で送受信されるデータのエンコードまたはデコードに使用する`コーダー`。 可能な値： * default: 既定のエンコーダーは、デバイスの`ロケール`と`タイム ゾーン`を使用して、`yyy-MM-dd HH:mm:ss` 形式を使用して日付を書式設定します。 * custom(JSONEncoder, JSONDecoder): `カスタム` コーダーを使用して、JSON のデコード/エンコードをよりきめ細かく制御します。 この列挙は、特別な日付形式、タイムゾーン、またはロケールを使用する場合など、独自の `JSONEncoder` と `JSONDecoder`を指定する場合にのみ使用してください。 let myEncoder = JSONEncoder() myEncoder.dateFormat = ... let myDecoder = JSONDecoder() myDecoder.dateFormat = ... let coder: Coder = .custom(myEncoder, myDecoder) {#NTblServ-model_S_S_S_S_O__ul_nx3_wrd_sqb} デフォルト:.default |
| 構成 | [FetchConfiguration](https://servicenow-prod.fluidtopics.net/s4pcOrhOcnm~4lgw1mUrfQ#FetchConfigiOSStructure "FetchConfiguration 構造体には、ServiceNow インスタンスからレコードをフェッチするための構成を定義する機能が用意されています。") | オプション。返されるレコード、ページネーションページのサイズ制限、取得するフィールド、フィールドに含めるものを定義するフィルターなど、取得したレコードに適用する構成。 デフォルト:nil - すべてのレコードが返されます。 |
[表 : 31. パラメーター]

{#NTblServ-model_S_S_S_S_O__table_nbq_yyj_spb} {#NTblServ-model_S_S_S_S_O__table_obq_yyj_spb__entry__2}

| タイプ | Description (説明) |
|-|-|
| AnyPublisher\<Model、NowDataError\> | 成功:パブリッシャーがデコード可能なモデルを返します。 失敗:NowDataError * `accessToken(アクセストークンプロバイダーエラー)` * AccessTokenProviderError:アクセストークンプロバイダーのエラーコードまたはメッセージ。 * アクセストークン取得に失敗しました * userSessionError(_エラー:エラー) アクセストークンにエラーがある場合にスローされます。 * `attachmentValidation` 添付ファイルが検証に失敗したときにスローされます。 * `badResponse(statusCode: HTTPStatusCode)` * HTTPStatusCode:インスタンスから受信したステータスコード。 要求が予期しない応答を返した場合にスローされます * `cannotDecodeModel(デコードエラー)` * DecodingError:デコードエラーが検出されました。 Codable モデルを JSON からデコードできない場合にスローされます。 * `cannotDecodeProperty(タイプ:任意、差出人:文字列)` * type:文字列からデコードするラップされた型。 * from:指定されたタイプにデコードする文字列。 文字列でラップされた値を JSON からデコードできない場合にスローされます。 * `cannotEncodeModel(エンコーディングエラー)` * EncodingError:エンコードエラーが検出されました。 Codable モデルを JSON にエンコードできない場合にスローされます。 * `cannotParseResponse` インスタンスからの応答を予期される形式に解析できない場合にスローされます。 * `無効な URL` URL を形成できない場合にスローされます。たとえば、文字列に URL で無効な文字が含まれているか、空の文字列である場合などです。 * `missingAttachmentMetadata` 添付ファイルのメタデータヘッダーがない場合にスローされます。 * `missingServiceConfiguration` 予期されるサービス構成がない場合にスローされます。 * `missingSysID` 予期されるsys_idパラメーターがない場合にスローされます。 * `network(NetworkServiceError)` * genericError(文字列) * operationCanceled * serviceDisabled * serverError(エラー) * systemError(エラー) ネットワークサービスでエラーが発生した場合にスローされます。 {#NTblServ-model_S_S_S_S_O__NowDataErroriOS-ul-enum} |
[表 : 32. 返される内容]

{#NTblServ-model_S_S_S_S_O__table_obq_yyj_spb}  
`[Users].self` など、デコードされたユーザー モデルを型別に提供するパブリッシャーを取得するには、ドット区切りのパスを指定してモデルをフェッチします。

    struct User: Codable {
      varname: String
    }

    let service: NowTableService = ...
    let publisher: AnyPublisher<[User], NowDataError> = service.model(from: "sys_user", path: "user.photos.gps_location")
     
単一の復号可能モデルをsys_idでフェッチするには、\[`User].self` ではなく単一の `User.self` モデルタイプを使用します。

    let publisher: AnyPublisher<User, NowDataError> = service.model(with: "5137153cc611227c000bbd1bd8cd2005", from: "sys_user", path: "result")

## NowTableService - paginator(from tableName: String, configuration: FetchConfiguration? = nil) {#ariaid-title18}

レコードのページを反復処理できるページネーターを作成します。
ページネーターの publisher は、カスタム [Codable モデル](https://developer.apple.com/documentation/foundation/archives_and_serialization/encoding_and_decoding_custom_types)にデコードできるデータを出力するか、 [NowTableService - paginator\<Model: Decodable\>(from tableName: String, path: String = Constants.resultPath, coder: coder = .default, configuration: FetchConfiguration? = nil)](https://servicenow-prod.fluidtopics.net/oOte0XsLyXvzQxPHCgteyw#NTblServ-paginator_S_S_S_O "ネストを処理するデコードされたモデルのページの反復を可能にするページネータを作成します。") 関数を使用することもできます。 または、便利な関数 convertToRecords() を使用して、データを NowRecord オブジェクトに変換することもできます。NowRecords を出力するように発行元を変換する方法を次に示します。

    let dataPublisher: AnyPublisher<Data, NowDataError> = ...
    let recordsPublisher: AnyPublisher<[NowRecord], NowDataError> = myPublisher.convertToRecords()

注:  
configuration パラメーターでオーバーライドされない限り、ページネーターはページごとに 20 個のアイテムを返します。ACL 評価によっては、ページでフェッチされるアイテムの実際の数がデフォルト値または構成値よりも少なくなる場合があります。
{#NTblServ-paginator_S_O__id_fpc_pcj_ppb__entry__3}{#NTblServ-paginator_S_O__mobilesdkiOS-tableName-row}

| 名前 | タイプ | 説明 |
|-|-|-|
| tableName | 文字列 | レコードの取得元となるテーブルの名前 ( incident など)。 |
| 構成 | [FetchConfiguration](https://servicenow-prod.fluidtopics.net/s4pcOrhOcnm~4lgw1mUrfQ#FetchConfigiOSStructure "FetchConfiguration 構造体には、ServiceNow インスタンスからレコードをフェッチするための構成を定義する機能が用意されています。") | オプション。返されるレコード、ページネーションページのサイズ制限、取得するフィールド、フィールドに含めるものを定義するフィルターなど、取得したレコードに適用する構成。 デフォルト:nil - すべてのレコードが返されます。 |
[表 : 33. パラメーター]

{#NTblServ-paginator_S_O__id_fpc_pcj_ppb} {#NTblServ-paginator_S_O__table_uwv_wv3_ppb__entry__2}

| タイプ | Description (説明) |
|-|-|
| paginator\<data\> | 成功:指定されたレコードを含むページネーターオブジェクト。 失敗:NowDataError * `accessToken(アクセストークンプロバイダーエラー)` * AccessTokenProviderError:アクセストークンプロバイダーのエラーコードまたはメッセージ。 * アクセストークン取得に失敗しました * userSessionError(_エラー:エラー) アクセストークンにエラーがある場合にスローされます。 * `attachmentValidation` 添付ファイルが検証に失敗したときにスローされます。 * `badResponse(statusCode: HTTPStatusCode)` * HTTPStatusCode:インスタンスから受信したステータスコード。 要求が予期しない応答を返した場合にスローされます * `cannotDecodeModel(デコードエラー)` * DecodingError:デコードエラーが検出されました。 Codable モデルを JSON からデコードできない場合にスローされます。 * `cannotDecodeProperty(タイプ:任意、差出人:文字列)` * type:文字列からデコードするラップされた型。 * from:指定されたタイプにデコードする文字列。 文字列でラップされた値を JSON からデコードできない場合にスローされます。 * `cannotEncodeModel(エンコーディングエラー)` * EncodingError:エンコードエラーが検出されました。 Codable モデルを JSON にエンコードできない場合にスローされます。 * `cannotParseResponse` インスタンスからの応答を予期される形式に解析できない場合にスローされます。 * `無効な URL` URL を形成できない場合にスローされます。たとえば、文字列に URL で無効な文字が含まれているか、空の文字列である場合などです。 * `missingAttachmentMetadata` 添付ファイルのメタデータヘッダーがない場合にスローされます。 * `missingServiceConfiguration` 予期されるサービス構成がない場合にスローされます。 * `missingSysID` 予期されるsys_idパラメーターがない場合にスローされます。 * `network(NetworkServiceError)` * genericError(文字列) * operationCanceled * serviceDisabled * serverError(エラー) * systemError(エラー) ネットワークサービスでエラーが発生した場合にスローされます。 {#NTblServ-paginator_S_O__NowDataErroriOS-ul-enum} |
[表 : 34. 返される内容]

{#NTblServ-paginator_S_O__table_uwv_wv3_ppb}  

    private var tableService: NowTableService?
    // Paginator creation uses type inference to determine the response type.
    private var paginator: Paginator<[CustomerServiceCase]>?

    func initializeTableService(for instanceUrl: URL) {
      makeTableService(instanceUrl: instanceUrl) { [weak self] result in
        guard let self = self else { return }
                
        switch result {
        case .success(let tableService):
          self.tableService = tableService
          // Create a paginator that iterates over pages of customer support cases. The paginator's response type is
          // inferred from the paginator's type definition (e.g. `Paginator<[CustomerServiceCase]>`).
          self.paginator = tableService.paginator(from: Self.tableName, configuration: self.fetchConfiguration)
          // Subscribe to the paginator's publisher so you are able to receive paged results.
          self.subscribeToPaginatorPublisher()
          // Ready to start fetching data, inform the view controller.
          self.onReady(self)
        case .failure(let error):
          debugPrint("Creating table service failed with error: \(error.localizedDescription)")
          self.tableService = nil
          self.paginator = nil
        }
      }
    }

## NowTableService - paginator\<Model: Decodable\>(from tableName: String, path: String = Constants.resultPath, coder: coder = .default, configuration: FetchConfiguration? = nil) {#ariaid-title19}

ネストを処理するデコードされたモデルのページの反復を可能にするページネータを作成します。
ServiceNow REST Table API 応答は、次のような result プロパティ内にネストされます。

    {
      "result": [
        { "name": "Ash Williams" },
        { "name": "Lionel Cosgrove" },
        { "name": "Laurie Strode" }
      ]
    }

デコードされたUserモデルを提供するペジネータを取得するには、ドットで区切られたパスを指定してペジネータをフェッチします。この場合は resultです。

    struct User: Codable {
      varname: String
    }

    let service: NowTableService = ...
    let paginator: Paginator<[User]> = service.paginator(from: "sys_user", path: "result")

注:  
configuration パラメーターでオーバーライドされない限り、ページネーターはページごとに 20 個のアイテムを返します。ACL 評価によっては、ページでフェッチされるアイテムの実際の数がデフォルト値または構成値よりも少なくなる場合があります。  
Paginatorオブジェクトを取得したら、そのCombine Publisherをサブスクライブしてデータの受信を開始します。

    paginator.publisher
      .subscribe(on: DispatchQueue.global())
      .receive(on: DispatchQueue.main)
      .sink { ... }
      .store(in: &subscriptions)

注:  
すべての Combine サブスクリプションと同様に、予期しない結果を避けるために、サブスクリプションは必ず保持してください。
{#NTblServ-paginator_S_S_S_O__table_vds_gtj_spb__entry__3}{#NTblServ-paginator_S_S_S_O__mobilesdkiOS-tableName-entry}

| 名前 | タイプ | 説明 |
|-|-|-|
| テーブル名から | 文字列 | レコードの取得元となるテーブルの名前 ( incident など)。 |
| path | 文字列 | ネストされた型のドット区切りパス。たとえば、より深いネストの場合は `result` や `result.user.photos` などです。カスタムパスを指定すると、ネストされたデータをフェッチまたは反復処理できます*。* デフォルト: `result` |
| コーダー | コーダー | オプション。ServiceNow インスタンスとの間で送受信されるデータのエンコードまたはデコードに使用する`コーダー`。 可能な値： * default: 既定のエンコーダーは、デバイスの`ロケール`と`タイム ゾーン`を使用して、`yyy-MM-dd HH:mm:ss` 形式を使用して日付を書式設定します。 * custom(JSONEncoder, JSONDecoder): `カスタム` コーダーを使用して、JSON のデコード/エンコードをよりきめ細かく制御します。 この列挙は、特別な日付形式、タイムゾーン、またはロケールを使用する場合など、独自の `JSONEncoder` と `JSONDecoder`を指定する場合にのみ使用してください。 let myEncoder = JSONEncoder() myEncoder.dateFormat = ... let myDecoder = JSONDecoder() myDecoder.dateFormat = ... let coder: Coder = .custom(myEncoder, myDecoder) {#NTblServ-paginator_S_S_S_O__ul_nx3_wrd_sqb} デフォルト:.default |
| 構成 | [FetchConfiguration](https://servicenow-prod.fluidtopics.net/s4pcOrhOcnm~4lgw1mUrfQ#FetchConfigiOSStructure "FetchConfiguration 構造体には、ServiceNow インスタンスからレコードをフェッチするための構成を定義する機能が用意されています。") | オプション。返されるレコード、ページネーションページのサイズ制限、取得するフィールド、フィールドに含めるものを定義するフィルターなど、取得したレコードに適用する構成。 デフォルト:nil - すべてのレコードが返されます。 |
[表 : 35. パラメーター]

{#NTblServ-paginator_S_S_S_O__table_vds_gtj_spb} {#NTblServ-paginator_S_S_S_O__table_wds_gtj_spb__entry__2}

| タイプ | Description (説明) |
|-|-|
| paginator\<data\> | 成功:ページングされた `デコナブル` モデルを含むページネータオブジェクト。 失敗:NowDataError * `accessToken(アクセストークンプロバイダーエラー)` * AccessTokenProviderError:アクセストークンプロバイダーのエラーコードまたはメッセージ。 * アクセストークン取得に失敗しました * userSessionError(_エラー:エラー) アクセストークンにエラーがある場合にスローされます。 * `attachmentValidation` 添付ファイルが検証に失敗したときにスローされます。 * `badResponse(statusCode: HTTPStatusCode)` * HTTPStatusCode:インスタンスから受信したステータスコード。 要求が予期しない応答を返した場合にスローされます * `cannotDecodeModel(デコードエラー)` * DecodingError:デコードエラーが検出されました。 Codable モデルを JSON からデコードできない場合にスローされます。 * `cannotDecodeProperty(タイプ:任意、差出人:文字列)` * type:文字列からデコードするラップされた型。 * from:指定されたタイプにデコードする文字列。 文字列でラップされた値を JSON からデコードできない場合にスローされます。 * `cannotEncodeModel(エンコーディングエラー)` * EncodingError:エンコードエラーが検出されました。 Codable モデルを JSON にエンコードできない場合にスローされます。 * `cannotParseResponse` インスタンスからの応答を予期される形式に解析できない場合にスローされます。 * `無効な URL` URL を形成できない場合にスローされます。たとえば、文字列に URL で無効な文字が含まれているか、空の文字列である場合などです。 * `missingAttachmentMetadata` 添付ファイルのメタデータヘッダーがない場合にスローされます。 * `missingServiceConfiguration` 予期されるサービス構成がない場合にスローされます。 * `missingSysID` 予期されるsys_idパラメーターがない場合にスローされます。 * `network(NetworkServiceError)` * genericError(文字列) * operationCanceled * serviceDisabled * serverError(エラー) * systemError(エラー) ネットワークサービスでエラーが発生した場合にスローされます。 {#NTblServ-paginator_S_S_S_O__NowDataErroriOS-ul-enum} |
[表 : 36. 返される内容]

{#NTblServ-paginator_S_S_S_O__table_wds_gtj_spb}  
この例では、デコードされた User モデルを提供する Paginator オブジェクトを取得する方法を示します。目的のPaginatorオブジェクトを取得するには、Userモデル(\[User\])のコレクションを返すようにコンパイラにヒントを与え、ユーザーが結果パスの下にネストされていることをPaginatorオブジェクトに通知します。

    struct User: Codable {
      var name: String
    }

    let service: NowTableService = ...
    let paginator: Paginator<[User]> = service.paginator(from: "sys_user", path: "result")

注:  
Table API は常に結果パスの下に入れ子になった結果を返すため、pathパラメーターを安全に削除できます。

## NowTableService - record(with sysId: SysID, from tableName: String, configuration: FieldReadConfiguration? = nil) async throws {#ariaid-title20}

ServiceNowインスタンスの指定されたテーブルから指定されたレコードを取得します。
publisher は、カスタム [Codable モデル](https://developer.apple.com/documentation/foundation/archives_and_serialization/encoding_and_decoding_custom_types)にデコードできるデータを出力するか、 [NowTableService - paginator\<Model: Decodable\>(from tableName: String, path: String = Constants.resultPath, coder: coder = .default, configuration: FetchConfiguration? = nil)](https://servicenow-prod.fluidtopics.net/oOte0XsLyXvzQxPHCgteyw#NTblServ-paginator_S_S_S_O "ネストを処理するデコードされたモデルのページの反復を可能にするページネータを作成します。") 関数を使用することもできます。 または、便利な関数 convertToRecords() を使用して、データを NowRecord オブジェクトに変換することもできます。NowRecords を出力するように発行元を変換する方法を次に示します。。

    let dataPublisher: AnyPublisher<Data, NowDataError> = ...
    let recordsPublisher: AnyPublisher<[NowRecord], NowDataError> = myPublisher.convertToRecords()

{#NTblServ-record-async_S_S_O__table_fsr_23j_ppb__entry__3}{#NTblServ-record-async_S_S_O__mobilesdkiOS-tableName-entry}

| 名前 | タイプ | 説明 |
|-|-|-|
| sysId | 文字列 | ServiceNowインスタンスから返されるレコードのSys_id。 |
| テーブル名から | 文字列 | レコードの取得元となるテーブルの名前 ( incident など)。 |
| 構成 | [FetchConfiguration](https://servicenow-prod.fluidtopics.net/s4pcOrhOcnm~4lgw1mUrfQ#FetchConfigiOSStructure "FetchConfiguration 構造体には、ServiceNow インスタンスからレコードをフェッチするための構成を定義する機能が用意されています。") | オプション。返されるレコード、ページネーションページのサイズ制限、取得するフィールド、フィールドに含めるものを定義するフィルターなど、取得したレコードに適用する構成。 デフォルト:nil - すべてのレコードが返されます。 |
[表 : 37. パラメーター]

{#NTblServ-record-async_S_S_O__table_fsr_23j_ppb}{#NTblServ-record-async_S_S_O__table_gsr_23j_ppb__entry__2}

| タイプ | 説明 |
|-|-|
| Data (データ) | メソッドが成功したときに返されます。指定されたレコードを含むデータオブジェクト。 |
| NowDataError | メソッドが失敗したときにスローされます。 * `accessToken(アクセストークンプロバイダーエラー)` * AccessTokenProviderError:アクセストークンプロバイダーのエラーコードまたはメッセージ。 * アクセストークン取得に失敗しました * userSessionError(_エラー:エラー) アクセストークンにエラーがある場合にスローされます。 * `attachmentValidation` 添付ファイルが検証に失敗したときにスローされます。 * `badResponse(statusCode: HTTPStatusCode)` * HTTPStatusCode:インスタンスから受信したステータスコード。 要求が予期しない応答を返した場合にスローされます * `cannotDecodeModel(デコードエラー)` * DecodingError:デコードエラーが検出されました。 Codable モデルを JSON からデコードできない場合にスローされます。 * `cannotDecodeProperty(タイプ:任意、差出人:文字列)` * type:文字列からデコードするラップされた型。 * from:指定されたタイプにデコードする文字列。 文字列でラップされた値を JSON からデコードできない場合にスローされます。 * `cannotEncodeModel(エンコーディングエラー)` * EncodingError:エンコードエラーが検出されました。 Codable モデルを JSON にエンコードできない場合にスローされます。 * `cannotParseResponse` インスタンスからの応答を予期される形式に解析できない場合にスローされます。 * `無効な URL` URL を形成できない場合にスローされます。たとえば、文字列に URL で無効な文字が含まれているか、空の文字列である場合などです。 * `missingAttachmentMetadata` 添付ファイルのメタデータヘッダーがない場合にスローされます。 * `missingServiceConfiguration` 予期されるサービス構成がない場合にスローされます。 * `missingSysID` 予期されるsys_idパラメーターがない場合にスローされます。 * `network(NetworkServiceError)` * genericError(文字列) * operationCanceled * serviceDisabled * serverError(エラー) * systemError(エラー) ネットワークサービスでエラーが発生した場合にスローされます。 {#NTblServ-record-async_S_S_O__NowDataErroriOS-ul-enum} |
[表 : 38. 返される内容]

{#NTblServ-record-async_S_S_O__table_gsr_23j_ppb}  
次のコード例は、このメソッドを呼び出す方法を示しています。

    func fetchTableRecord(sysId: String, tableName: String, includeFields: [FieldName] = [FieldName](), readOptions: FieldReadConfiguration.Options = []) async throws -> NowRecord {
        let readConfig = FieldReadConfiguration(includeFields: includeFields, options: readOptions)
        do {
            let dataResult: Data = try await tableService.record(with: sysId, from: tableName, configuration: configuration)
            let recordResult: NowRecord = dataResult.convertToRecord()
            return recordResult
        } catch {
            print("Fetch failed with NowDataError: \(error)")
            throw error
        }
    }

## NowTableService - record(with sysId: SysID, from tableName: String, configuration: FieldReadConfiguration, completion: @escaping (Result\<Data, NowDataError\>) {#ariaid-title21}

指定されたテーブルから指定されたレコードを取得し、レコードが取得された後に完了ハンドラーを実行します。
必要に応じて、戻り値をカスタム Codable モデルにデコードするか、代わりに関数 [NowTableService - paginator\<Model: Decodable\>(from tableName: String, path: String = Constants.resultPath, coder: coder = .default, configuration: FetchConfiguration? = nil)](https://servicenow-prod.fluidtopics.net/oOte0XsLyXvzQxPHCgteyw#NTblServ-paginator_S_S_S_O "ネストを処理するデコードされたモデルのページの反復を可能にするページネータを作成します。") を使用できます。 または、便利な関数 convertToRecords() を使用して、データを NowRecord オブジェクトに変換することもできます。NowRecords を出力するように発行元を変換する方法を次に示します。

    let dataPublisher: AnyPublisher<Data, NowDataError> = ...
    let recordsPublisher: AnyPublisher<[NowRecord], NowDataError> = myResult.convertToRecords()

結果セットが大きい場合は、 [NowTableService - paginator(from tableName: String, configuration: FetchConfiguration? = nil)](https://servicenow-prod.fluidtopics.net/oOte0XsLyXvzQxPHCgteyw#NTblServ-paginator_S_O "レコードのページを反復処理できるページネーターを作成します。") 関数を使用してページネーションされた結果をフェッチします。
{#NTblServ-record_S_S_O_O__table_fzv_fnj_ppb__entry__3}{#NTblServ-record_S_S_O_O__mobilesdkiOS-tableName-entry}

| 名前 | タイプ | 説明 |
|-|-|-|
| sysId | 文字列 | ServiceNowインスタンスから返されるレコードのSys_id。 |
| テーブル名から | 文字列 | レコードの取得元となるテーブルの名前 ( incident など)。 |
| 構成 | [FetchConfiguration](https://servicenow-prod.fluidtopics.net/s4pcOrhOcnm~4lgw1mUrfQ#FetchConfigiOSStructure "FetchConfiguration 構造体には、ServiceNow インスタンスからレコードをフェッチするための構成を定義する機能が用意されています。") | オプション。返されるレコード、ページネーションページのサイズ制限、取得するフィールド、フィールドに含めるものを定義するフィルターなど、取得したレコードに適用する構成。 デフォルト:nil - すべてのレコードが返されます。 |
| 完了 | @escaping (結果\<データ、NowDataError\>) | レコードを取得した後に実行する完了ハンドラー。 戻り値: * 成功:データ:要求されたレコード * エラー:NowDataError * `accessToken(アクセストークンプロバイダーエラー)` * AccessTokenProviderError:アクセストークンプロバイダーのエラーコードまたはメッセージ。 * アクセストークン取得に失敗しました * userSessionError(_エラー:エラー) アクセストークンにエラーがある場合にスローされます。 * `attachmentValidation` 添付ファイルが検証に失敗したときにスローされます。 * `badResponse(statusCode: HTTPStatusCode)` * HTTPStatusCode:インスタンスから受信したステータスコード。 要求が予期しない応答を返した場合にスローされます * `cannotDecodeModel(デコードエラー)` * DecodingError:デコードエラーが検出されました。 Codable モデルを JSON からデコードできない場合にスローされます。 * `cannotDecodeProperty(タイプ:任意、差出人:文字列)` * type:文字列からデコードするラップされた型。 * from:指定されたタイプにデコードする文字列。 文字列でラップされた値を JSON からデコードできない場合にスローされます。 * `cannotEncodeModel(エンコーディングエラー)` * EncodingError:エンコードエラーが検出されました。 Codable モデルを JSON にエンコードできない場合にスローされます。 * `cannotParseResponse` インスタンスからの応答を予期される形式に解析できない場合にスローされます。 * `無効な URL` URL を形成できない場合にスローされます。たとえば、文字列に URL で無効な文字が含まれているか、空の文字列である場合などです。 * `missingAttachmentMetadata` 添付ファイルのメタデータヘッダーがない場合にスローされます。 * `missingServiceConfiguration` 予期されるサービス構成がない場合にスローされます。 * `missingSysID` 予期されるsys_idパラメーターがない場合にスローされます。 * `network(NetworkServiceError)` * genericError(文字列) * operationCanceled * serviceDisabled * serverError(エラー) * systemError(エラー) ネットワークサービスでエラーが発生した場合にスローされます。 {#NTblServ-record_S_S_O_O__NowDataErroriOS-ul-enum} {#NTblServ-record_S_S_O_O__ul_uzx_thj_ppb} |
[表 : 39. パラメーター]

{#NTblServ-record_S_S_O_O__table_fzv_fnj_ppb} {#NTblServ-record_S_S_O_O__table_gzv_fnj_ppb__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 40. 返される内容]

{#NTblServ-record_S_S_O_O__table_gzv_fnj_ppb}  
次のコード例は、このメソッドを呼び出す方法を示しています。

    func fetchTableRecords( tableName: String, filterQuery: String, includeFields: [FieldName] = [FieldName](), readOptions: FieldReadConfiguration.Options = [], limit: Int?) {
      let readConfig = FieldReadConfiguration(includeFields: includeFields, options: readOptions)
      let config = FetchConfiguration(Filter(query: filterQuery), limit, readConfig)
      tableService.records (from: tableName, configuration: fetchConfiguration) { [weak self] result in
        switch result {
          case .success(let dataResult):
            let recordResult: [NowRecord] = dataResult.convertToRecords()
            // Return recordResult

          case .failure(let error):
            // Failed to fetch record with NowDataError
        }
      }
    }

## NowTableService - record(with sysId: SysID, from tableName: String, configuration: FieldReadConfiguration? = nil) {#ariaid-title22}

ServiceNowインスタンスの指定されたテーブルから指定されたレコードを取得するパブリッシャーを作成します。
注:  
このメソッドは廃止されました。代わりに、メソッドの async/await 実装を使用する必要があります。
publisher は、カスタム [Codable モデル](https://developer.apple.com/documentation/foundation/archives_and_serialization/encoding_and_decoding_custom_types)にデコードできるデータを出力するか、 [NowTableService - paginator\<Model: Decodable\>(from tableName: String, path: String = Constants.resultPath, coder: coder = .default, configuration: FetchConfiguration? = nil)](https://servicenow-prod.fluidtopics.net/oOte0XsLyXvzQxPHCgteyw#NTblServ-paginator_S_S_S_O "ネストを処理するデコードされたモデルのページの反復を可能にするページネータを作成します。") 関数を使用することもできます。 または、便利な関数 convertToRecords() を使用して、データを NowRecord オブジェクトに変換することもできます。NowRecords を出力するように発行元を変換する方法を次に示します。。

    let dataPublisher: AnyPublisher<Data, NowDataError> = ...
    let recordsPublisher: AnyPublisher<[NowRecord], NowDataError> = myPublisher.convertToRecords()

{#NTblServ-record_S_S_O__table_fsr_23j_ppb__entry__3}{#NTblServ-record_S_S_O__mobilesdkiOS-tableName-entry}

| 名前 | タイプ | 説明 |
|-|-|-|
| sysId | 文字列 | ServiceNowインスタンスから返されるレコードのSys_id。 |
| テーブル名から | 文字列 | レコードの取得元となるテーブルの名前 ( incident など)。 |
| 構成 | [FetchConfiguration](https://servicenow-prod.fluidtopics.net/s4pcOrhOcnm~4lgw1mUrfQ#FetchConfigiOSStructure "FetchConfiguration 構造体には、ServiceNow インスタンスからレコードをフェッチするための構成を定義する機能が用意されています。") | オプション。返されるレコード、ページネーションページのサイズ制限、取得するフィールド、フィールドに含めるものを定義するフィルターなど、取得したレコードに適用する構成。 デフォルト:nil - すべてのレコードが返されます。 |
[表 : 41. パラメーター]

{#NTblServ-record_S_S_O__table_fsr_23j_ppb}{#NTblServ-record_S_S_O__table_gsr_23j_ppb__entry__2}

| タイプ | Description (説明) |
|-|-|
| AnyPublisher\<Data、NowDataError\> | 成功:指定されたレコードを含むデータオブジェクト。 失敗:NowDataError * `accessToken(アクセストークンプロバイダーエラー)` * AccessTokenProviderError:アクセストークンプロバイダーのエラーコードまたはメッセージ。 * アクセストークン取得に失敗しました * userSessionError(_エラー:エラー) アクセストークンにエラーがある場合にスローされます。 * `attachmentValidation` 添付ファイルが検証に失敗したときにスローされます。 * `badResponse(statusCode: HTTPStatusCode)` * HTTPStatusCode:インスタンスから受信したステータスコード。 要求が予期しない応答を返した場合にスローされます * `cannotDecodeModel(デコードエラー)` * DecodingError:デコードエラーが検出されました。 Codable モデルを JSON からデコードできない場合にスローされます。 * `cannotDecodeProperty(タイプ:任意、差出人:文字列)` * type:文字列からデコードするラップされた型。 * from:指定されたタイプにデコードする文字列。 文字列でラップされた値を JSON からデコードできない場合にスローされます。 * `cannotEncodeModel(エンコーディングエラー)` * EncodingError:エンコードエラーが検出されました。 Codable モデルを JSON にエンコードできない場合にスローされます。 * `cannotParseResponse` インスタンスからの応答を予期される形式に解析できない場合にスローされます。 * `無効な URL` URL を形成できない場合にスローされます。たとえば、文字列に URL で無効な文字が含まれているか、空の文字列である場合などです。 * `missingAttachmentMetadata` 添付ファイルのメタデータヘッダーがない場合にスローされます。 * `missingServiceConfiguration` 予期されるサービス構成がない場合にスローされます。 * `missingSysID` 予期されるsys_idパラメーターがない場合にスローされます。 * `network(NetworkServiceError)` * genericError(文字列) * operationCanceled * serviceDisabled * serverError(エラー) * systemError(エラー) ネットワークサービスでエラーが発生した場合にスローされます。 {#NTblServ-record_S_S_O__NowDataErroriOS-ul-enum} |
[表 : 42. 返される内容]

{#NTblServ-record_S_S_O__table_gsr_23j_ppb}  
この例では、指定されたテーブルから指定されたフィールドを使用して、指定されたレコードを取得する関数を作成する方法を示します。呼び出しの出力は ByteArray で、データを任意のモデルに変換できます。

    tableService.record(with: sysId, from: tableName, configuration: fetchConfiguration)
        .subscribe(on: DispatchQueue.global())
        .receive(on: DispatchQueue.main)
        .convertToRecord()
        .sink { completion in
            if case let .failure(error) = completion {
                print("Record retrieval failed with NowDataError: \(error)")
            }
        } receiveValue: { record in
            print("Successfully retrieved record: \(record)")
        }
        .store(in: &subscriptions)

## NowTableService - records(from tableName: String, configuration: FetchConfiguration? = nil) async throws {#ariaid-title23}

指定されたテーブルからレコードを取得します。
ザ publisher は、カスタム [Codable モデル](https://developer.apple.com/documentation/foundation/archives_and_serialization/encoding_and_decoding_custom_types)にデコードできるデータを出力するか、 [NowTableService - paginator\<Model: Decodable\>(from tableName: String, path: String = Constants.resultPath, coder: coder = .default, configuration: FetchConfiguration? = nil)](https://servicenow-prod.fluidtopics.net/oOte0XsLyXvzQxPHCgteyw#NTblServ-paginator_S_S_S_O "ネストを処理するデコードされたモデルのページの反復を可能にするページネータを作成します。") 関数を使用することもできます。 または、便利な関数 convertToRecords() を使用して、データを NowRecord オブジェクトに変換することもできます。NowRecords を出力するように発行元を変換する方法を次に示します。

    let dataPublisher: AnyPublisher<Data, NowDataError> = ...
    let recordsPublisher: AnyPublisher<[NowRecord], NowDataError> = myPublisher.convertToRecords()

結果セットが大きい場合は、 [NowTableService - paginator(from tableName: String, configuration: FetchConfiguration? = nil)](https://servicenow-prod.fluidtopics.net/oOte0XsLyXvzQxPHCgteyw#NTblServ-paginator_S_O "レコードのページを反復処理できるページネーターを作成します。") 関数を使用してページネーションされた結果をフェッチします。
{#NTblServ-records-async_S_O__id_rzw_lcj_ppb__entry__3}{#NTblServ-records-async_S_O__mobilesdkiOS-tableName-entry}

| 名前 | タイプ | 説明 |
|-|-|-|
| テーブル名から | 文字列 | レコードの取得元となるテーブルの名前 ( incident など)。 |
| 構成 | [FetchConfiguration](https://servicenow-prod.fluidtopics.net/s4pcOrhOcnm~4lgw1mUrfQ#FetchConfigiOSStructure "FetchConfiguration 構造体には、ServiceNow インスタンスからレコードをフェッチするための構成を定義する機能が用意されています。") | オプション。返されるレコード、ページネーションページのサイズ制限、取得するフィールド、フィールドに含めるものを定義するフィルターなど、取得したレコードに適用する構成。 デフォルト:nil - すべてのレコードが返されます。 |
[表 : 43. パラメーター]

{#NTblServ-records-async_S_O__id_rzw_lcj_ppb} {#NTblServ-records-async_S_O__table_yvr_d1j_ppb__entry__2}

| タイプ | 説明 |
|-|-|
| Data (データ) | メソッドが成功したときに返されます。指定されたレコードを含むデータオブジェクト。 |
| NowDataError | メソッドが失敗したときにスローされます。 * `accessToken(アクセストークンプロバイダーエラー)` * AccessTokenProviderError:アクセストークンプロバイダーのエラーコードまたはメッセージ。 * アクセストークン取得に失敗しました * userSessionError(_エラー:エラー) アクセストークンにエラーがある場合にスローされます。 * `attachmentValidation` 添付ファイルが検証に失敗したときにスローされます。 * `badResponse(statusCode: HTTPStatusCode)` * HTTPStatusCode:インスタンスから受信したステータスコード。 要求が予期しない応答を返した場合にスローされます * `cannotDecodeModel(デコードエラー)` * DecodingError:デコードエラーが検出されました。 Codable モデルを JSON からデコードできない場合にスローされます。 * `cannotDecodeProperty(タイプ:任意、差出人:文字列)` * type:文字列からデコードするラップされた型。 * from:指定されたタイプにデコードする文字列。 文字列でラップされた値を JSON からデコードできない場合にスローされます。 * `cannotEncodeModel(エンコーディングエラー)` * EncodingError:エンコードエラーが検出されました。 Codable モデルを JSON にエンコードできない場合にスローされます。 * `cannotParseResponse` インスタンスからの応答を予期される形式に解析できない場合にスローされます。 * `無効な URL` URL を形成できない場合にスローされます。たとえば、文字列に URL で無効な文字が含まれているか、空の文字列である場合などです。 * `missingAttachmentMetadata` 添付ファイルのメタデータヘッダーがない場合にスローされます。 * `missingServiceConfiguration` 予期されるサービス構成がない場合にスローされます。 * `missingSysID` 予期されるsys_idパラメーターがない場合にスローされます。 * `network(NetworkServiceError)` * genericError(文字列) * operationCanceled * serviceDisabled * serverError(エラー) * systemError(エラー) ネットワークサービスでエラーが発生した場合にスローされます。 {#NTblServ-records-async_S_O__NowDataErroriOS-ul-enum} |
[表 : 44. 返される内容]

{#NTblServ-records-async_S_O__table_yvr_d1j_ppb}  
次のコード例は、このメソッドを呼び出す方法を示しています。

    func fetchTableRecords( tableName: String, filterQuery: String,
     includeFields: [FieldName] = [FieldName](), readOptions:
     FieldReadConfiguration.Options = [], limit: Int?) {
        let readConfig = FieldReadConfiguration(includeFields: includeFields, options: readOptions)
        let config = FetchConfiguration(Filter(query: filterQuery), limit, readConfig)
        do {
          let dataResult: Data = try await tableService.records(from: tableName, configuration: config)
          let recordResult: [NowRecord] = dataResult.convertToRecords()
          // return recordResult
        } catch {
          print("Fetch failed with NowDataError: \(error)")
          throw error 
      }
    }

## NowTableService - records(from tableName: String, configuration: FetchConfiguration? = nil, completion: @escaping (Result\<Data, NowDataError\>)) {#ariaid-title24}

指定されたテーブルからレコードを取得し、レコードを取得した後に completion ハンドラーを実行します。
必要に応じて、戻り値をカスタム Codable モデルにデコードするか、代わりに関数 [NowTableService - paginator\<Model: Decodable\>(from tableName: String, path: String = Constants.resultPath, coder: coder = .default, configuration: FetchConfiguration? = nil)](https://servicenow-prod.fluidtopics.net/oOte0XsLyXvzQxPHCgteyw#NTblServ-paginator_S_S_S_O "ネストを処理するデコードされたモデルのページの反復を可能にするページネータを作成します。") を使用できます。 または、便利な関数 convertToRecords() を使用して、データを NowRecord オブジェクトに変換することもできます。NowRecords を出力するように発行元を変換する方法を次に示します。

    let dataPublisher: AnyPublisher<Data, NowDataError> = ...
    let recordsPublisher: AnyPublisher<[NowRecord], NowDataError> = myResult.convertToRecords()

結果セットが大きい場合は、 [NowTableService - paginator(from tableName: String, configuration: FetchConfiguration? = nil)](https://servicenow-prod.fluidtopics.net/oOte0XsLyXvzQxPHCgteyw#NTblServ-paginator_S_O "レコードのページを反復処理できるページネーターを作成します。") 関数を使用してページネーションされた結果をフェッチします。
{#NTblServ-records_S_O_O__table_uvc_y2j_ppb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| tableName 内 | 文字列 | レコードを書き込むテーブルの名前 ( インシデントなど)。 |
| 構成 | [FetchConfiguration](https://servicenow-prod.fluidtopics.net/s4pcOrhOcnm~4lgw1mUrfQ#FetchConfigiOSStructure "FetchConfiguration 構造体には、ServiceNow インスタンスからレコードをフェッチするための構成を定義する機能が用意されています。") | オプション。返されるレコード、ページネーションページのサイズ制限、取得するフィールド、フィールドに含めるものを定義するフィルターなど、取得したレコードに適用する構成。 デフォルト:nil - すべてのレコードが返されます。 |
| 完了 | @escaping (結果\<データ、NowDataError\>) | レコードを取得した後に実行する完了ハンドラー。 戻り値: * 成功:データ:要求されたレコード * エラー:NowDataError * `accessToken(アクセストークンプロバイダーエラー)` * AccessTokenProviderError:アクセストークンプロバイダーのエラーコードまたはメッセージ。 * アクセストークン取得に失敗しました * userSessionError(_エラー:エラー) アクセストークンにエラーがある場合にスローされます。 * `attachmentValidation` 添付ファイルが検証に失敗したときにスローされます。 * `badResponse(statusCode: HTTPStatusCode)` * HTTPStatusCode:インスタンスから受信したステータスコード。 要求が予期しない応答を返した場合にスローされます * `cannotDecodeModel(デコードエラー)` * DecodingError:デコードエラーが検出されました。 Codable モデルを JSON からデコードできない場合にスローされます。 * `cannotDecodeProperty(タイプ:任意、差出人:文字列)` * type:文字列からデコードするラップされた型。 * from:指定されたタイプにデコードする文字列。 文字列でラップされた値を JSON からデコードできない場合にスローされます。 * `cannotEncodeModel(エンコーディングエラー)` * EncodingError:エンコードエラーが検出されました。 Codable モデルを JSON にエンコードできない場合にスローされます。 * `cannotParseResponse` インスタンスからの応答を予期される形式に解析できない場合にスローされます。 * `無効な URL` URL を形成できない場合にスローされます。たとえば、文字列に URL で無効な文字が含まれているか、空の文字列である場合などです。 * `missingAttachmentMetadata` 添付ファイルのメタデータヘッダーがない場合にスローされます。 * `missingServiceConfiguration` 予期されるサービス構成がない場合にスローされます。 * `missingSysID` 予期されるsys_idパラメーターがない場合にスローされます。 * `network(NetworkServiceError)` * genericError(文字列) * operationCanceled * serviceDisabled * serverError(エラー) * systemError(エラー) ネットワークサービスでエラーが発生した場合にスローされます。 {#NTblServ-records_S_O_O__NowDataErroriOS-ul-enum} {#NTblServ-records_S_O_O__ul_uzx_thj_ppb} |
[表 : 45. パラメーター]

{#NTblServ-records_S_O_O__table_uvc_y2j_ppb} {#NTblServ-records_S_O_O__table_vvc_y2j_ppb__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 46. 返される内容]

{#NTblServ-records_S_O_O__table_vvc_y2j_ppb}  
次のコード例は、このメソッドを呼び出す方法を示しています。

    func fetchTableRecords( tableName: String, filterQuery: String, includeFields: [FieldName] = [FieldName](), readOptions: FieldReadConfiguration.Options = [], limit: Int?) {
      let readConfig = FieldReadConfiguration(includeFields: includeFields, options: readOptions)
      let config = FetchConfiguration(Filter(query: filterQuery), limit, readConfig)
      tableService.records (from: tableName, configuration: fetchConfiguration) { [weak self] result in
        switch result {
          case .success(let dataResult):
            let recordResult: [NowRecord] = dataResult.convertToRecords()
            // return recordResult

          case .failure(let error):
            // Failed to fetch record with NowDataError
        }
      }
    }

## NowTableService - records(from tableName: String, configuration: FetchConfiguration? = nil) {#ariaid-title25}

指定したテーブルからレコードを取得できるパブリッシャーを作成します。
注:  
このメソッドは廃止されました。代わりに、メソッドの async/await 実装を使用する必要があります。  
publisher は、カスタム [Codable モデル](https://developer.apple.com/documentation/foundation/archives_and_serialization/encoding_and_decoding_custom_types)にデコードできるデータを出力するか、 [NowTableService - paginator\<Model: Decodable\>(from tableName: String, path: String = Constants.resultPath, coder: coder = .default, configuration: FetchConfiguration? = nil)](https://servicenow-prod.fluidtopics.net/oOte0XsLyXvzQxPHCgteyw#NTblServ-paginator_S_S_S_O "ネストを処理するデコードされたモデルのページの反復を可能にするページネータを作成します。") 関数を使用することもできます。 または、便利な関数 convertToRecords() を使用して、データを NowRecord オブジェクトに変換することもできます。NowRecords を出力するように発行元を変換する方法を次に示します。。

    let dataPublisher: AnyPublisher<Data, NowDataError> = ...
    let recordsPublisher: AnyPublisher<[NowRecord], NowDataError> = myPublisher.convertToRecords()

結果セットが大きい場合は、 [NowTableService - paginator(from tableName: String, configuration: FetchConfiguration? = nil)](https://servicenow-prod.fluidtopics.net/oOte0XsLyXvzQxPHCgteyw#NTblServ-paginator_S_O "レコードのページを反復処理できるページネーターを作成します。") 関数を使用してページネーションされた結果をフェッチします。
{#NTblServ-records_S_O__id_rzw_lcj_ppb__entry__3}{#NTblServ-records_S_O__mobilesdkiOS-tableName-entry}

| 名前 | タイプ | 説明 |
|-|-|-|
| テーブル名から | 文字列 | レコードの取得元となるテーブルの名前 ( incident など)。 |
| 構成 | [FetchConfiguration](https://servicenow-prod.fluidtopics.net/s4pcOrhOcnm~4lgw1mUrfQ#FetchConfigiOSStructure "FetchConfiguration 構造体には、ServiceNow インスタンスからレコードをフェッチするための構成を定義する機能が用意されています。") | オプション。返されるレコード、ページネーションページのサイズ制限、取得するフィールド、フィールドに含めるものを定義するフィルターなど、取得したレコードに適用する構成。 デフォルト:nil - すべてのレコードが返されます。 |
[表 : 47. パラメーター]

{#NTblServ-records_S_O__id_rzw_lcj_ppb} {#NTblServ-records_S_O__table_yvr_d1j_ppb__entry__2}

| タイプ | Description (説明) |
|-|-|
| AnyPublisher\<Data、NowDataError\> | 成功:指定されたレコードを含むデータオブジェクト。 失敗:NowDataError * `accessToken(アクセストークンプロバイダーエラー)` * AccessTokenProviderError:アクセストークンプロバイダーのエラーコードまたはメッセージ。 * アクセストークン取得に失敗しました * userSessionError(_エラー:エラー) アクセストークンにエラーがある場合にスローされます。 * `attachmentValidation` 添付ファイルが検証に失敗したときにスローされます。 * `badResponse(statusCode: HTTPStatusCode)` * HTTPStatusCode:インスタンスから受信したステータスコード。 要求が予期しない応答を返した場合にスローされます * `cannotDecodeModel(デコードエラー)` * DecodingError:デコードエラーが検出されました。 Codable モデルを JSON からデコードできない場合にスローされます。 * `cannotDecodeProperty(タイプ:任意、差出人:文字列)` * type:文字列からデコードするラップされた型。 * from:指定されたタイプにデコードする文字列。 文字列でラップされた値を JSON からデコードできない場合にスローされます。 * `cannotEncodeModel(エンコーディングエラー)` * EncodingError:エンコードエラーが検出されました。 Codable モデルを JSON にエンコードできない場合にスローされます。 * `cannotParseResponse` インスタンスからの応答を予期される形式に解析できない場合にスローされます。 * `無効な URL` URL を形成できない場合にスローされます。たとえば、文字列に URL で無効な文字が含まれているか、空の文字列である場合などです。 * `missingAttachmentMetadata` 添付ファイルのメタデータヘッダーがない場合にスローされます。 * `missingServiceConfiguration` 予期されるサービス構成がない場合にスローされます。 * `missingSysID` 予期されるsys_idパラメーターがない場合にスローされます。 * `network(NetworkServiceError)` * genericError(文字列) * operationCanceled * serviceDisabled * serverError(エラー) * systemError(エラー) ネットワークサービスでエラーが発生した場合にスローされます。 {#NTblServ-records_S_O__NowDataErroriOS-ul-enum} |
[表 : 48. 返される内容]

{#NTblServ-records_S_O__table_yvr_d1j_ppb}  
この例では、指定したテーブルから複数のレコードをフェッチする関数を作成する方法を示します。これは、将来のある時点で実行されるように要求をスケジュールし、ByteArray応答を返すオブジェクトを作成します。

    tableService.records(from: tableName, configuration: fetchConfiguration)
        .subscribe(on: DispatchQueue.global())
        .receive(on: DispatchQueue.main)
        .convertToRecords()
        .sink { completion in
            if case let .failure(error) = completion {
                print("Record retrieval failed with NowDataError: \(error)")
            }
        } receiveValue: { records in
            print("Successfully retrieved records: \(records)")
        }
        .store(in: &subscriptions)

## NowTableService - update\<Model: SysIdentifiableModel\>(_ model: Model, in tableName: String, coder: coder = .default, writeOptions: FieldWriteOptions? = nil, configuration: FetchConfiguration? = nil) async throws {#ariaid-title26}

指定されたテーブル内の指定されたコード化可能モデルを更新します。
{#NTblServ-update-async_S_S_S_O_O__table_n4q_3yk_spb__entry__3}

| 名前 | タイプ | Description (説明) |
|-|-|-|
| モデル | モデル | テーブルで更新する `SysIdentifiableModel` モデル。 |
| tableName 内 | 文字列 | レコードを書き込むテーブルの名前 ( インシデントなど)。 |
| コーダー | コーダー | オプション。ServiceNow インスタンスとの間で送受信されるデータのエンコードまたはデコードに使用する`コーダー`。 可能な値： * default: 既定のエンコーダーは、デバイスの`ロケール`と`タイム ゾーン`を使用して、`yyy-MM-dd HH:mm:ss` 形式を使用して日付を書式設定します。 * custom(JSONEncoder, JSONDecoder): `カスタム` コーダーを使用して、JSON のデコード/エンコードをよりきめ細かく制御します。 この列挙は、特別な日付形式、タイムゾーン、またはロケールを使用する場合など、独自の `JSONEncoder` と `JSONDecoder`を指定する場合にのみ使用してください。 let myEncoder = JSONEncoder() myEncoder.dateFormat = ... let myDecoder = JSONDecoder() myDecoder.dateFormat = ... let coder: Coder = .custom(myEncoder, myDecoder) {#NTblServ-update-async_S_S_S_O_O__ul_nx3_wrd_sqb} デフォルト:.default |
| 書き込みオプション | [フィールド書き込みオプション](https://servicenow-prod.fluidtopics.net/a7rJUASi8wEa4P_XFxtitg#FieldWriteOptionsiOSStruct "FieldWriteOptions クラスは、ServiceNow インスタンス上のレコードのフィールドを更新または作成するためのオプションを設定する関数を提供します。") | オプション。レコードに書き込まれるデータに適用する構成オプション。 デフォルト:nil |
| 構成 | [FetchConfiguration](https://servicenow-prod.fluidtopics.net/s4pcOrhOcnm~4lgw1mUrfQ#FetchConfigiOSStructure "FetchConfiguration 構造体には、ServiceNow インスタンスからレコードをフェッチするための構成を定義する機能が用意されています。") | オプション。返されるレコード、ページネーションページのサイズ制限、取得するフィールド、フィールドに含めるものを定義するフィルターなど、取得したレコードに適用する構成。 デフォルト:nil - すべてのレコードが返されます。 |
[表 : 49. パラメーター]

{#NTblServ-update-async_S_S_S_O_O__table_n4q_3yk_spb} {#NTblServ-update-async_S_S_S_O_O__table_o4q_3yk_spb__entry__2}

| タイプ | Description (説明) |
|-|-|
| モデル | メソッドが成功したときに返されます。指定されたテーブルで更新された復号化可能なモデル。 |
| NowDataError | メソッドが失敗したときにスローされます。 * `accessToken(アクセストークンプロバイダーエラー)` * AccessTokenProviderError:アクセストークンプロバイダーのエラーコードまたはメッセージ。 * アクセストークン取得に失敗しました * userSessionError(_エラー:エラー) アクセストークンにエラーがある場合にスローされます。 * `attachmentValidation` 添付ファイルが検証に失敗したときにスローされます。 * `badResponse(statusCode: HTTPStatusCode)` * HTTPStatusCode:インスタンスから受信したステータスコード。 要求が予期しない応答を返した場合にスローされます * `cannotDecodeModel(デコードエラー)` * DecodingError:デコードエラーが検出されました。 Codable モデルを JSON からデコードできない場合にスローされます。 * `cannotDecodeProperty(タイプ:任意、差出人:文字列)` * type:文字列からデコードするラップされた型。 * from:指定されたタイプにデコードする文字列。 文字列でラップされた値を JSON からデコードできない場合にスローされます。 * `cannotEncodeModel(エンコーディングエラー)` * EncodingError:エンコードエラーが検出されました。 Codable モデルを JSON にエンコードできない場合にスローされます。 * `cannotParseResponse` インスタンスからの応答を予期される形式に解析できない場合にスローされます。 * `無効な URL` URL を形成できない場合にスローされます。たとえば、文字列に URL で無効な文字が含まれているか、空の文字列である場合などです。 * `missingAttachmentMetadata` 添付ファイルのメタデータヘッダーがない場合にスローされます。 * `missingServiceConfiguration` 予期されるサービス構成がない場合にスローされます。 * `missingSysID` 予期されるsys_idパラメーターがない場合にスローされます。 * `network(NetworkServiceError)` * genericError(文字列) * operationCanceled * serviceDisabled * serverError(エラー) * systemError(エラー) ネットワークサービスでエラーが発生した場合にスローされます。 {#NTblServ-update-async_S_S_S_O_O__NowDataErroriOS-ul-enum} |
[表 : 50. 返される内容]

{#NTblServ-update-async_S_S_S_O_O__table_o4q_3yk_spb}  
次のコード例は、このメソッドを呼び出す方法を示しています。

    struct User: SysIdentifiableModel {
        var sysId: String = ""
        var name: String}
         
    func updateUser(user: User) async throws -> User {
        do {
            let result = try await tableService.update(user, in: "sys_user")
            return result
        } catch {
            print("Update failed with NowDataError: \(error)")
            throw error
        }
    }

## NowTableService - update\<Model: SysIdentifiableModel\>(_ model: Model, in tableName: String, coder: Coder = .default, writeOptions: FieldWriteOptions? = nil, configuration: FetchConfiguration? = nil, completion: @escaping (Result\<Model, NowDataError\>)) {#ariaid-title27}

指定されたテーブル内の指定された Codable モデルを更新し、 completion ハンドラーを実行します。
{#NTblServ-update_S_S_S_O_O_O__table_nmv_vpr_spb__entry__3}

| 名前 | タイプ | Description (説明) |
|-|-|-|
| モデル | モデル | テーブルで更新する `SysIdentifiableModel` モデル。 |
| tableName 内 | 文字列 | レコードを書き込むテーブルの名前 ( インシデントなど)。 |
| コーダー | コーダー | オプション。ServiceNow インスタンスとの間で送受信されるデータのエンコードまたはデコードに使用する`コーダー`。 可能な値： * default: 既定のエンコーダーは、デバイスの`ロケール`と`タイム ゾーン`を使用して、`yyy-MM-dd HH:mm:ss` 形式を使用して日付を書式設定します。 * custom(JSONEncoder, JSONDecoder): `カスタム` コーダーを使用して、JSON のデコード/エンコードをよりきめ細かく制御します。 この列挙は、特別な日付形式、タイムゾーン、またはロケールを使用する場合など、独自の `JSONEncoder` と `JSONDecoder`を指定する場合にのみ使用してください。 let myEncoder = JSONEncoder() myEncoder.dateFormat = ... let myDecoder = JSONDecoder() myDecoder.dateFormat = ... let coder: Coder = .custom(myEncoder, myDecoder) {#NTblServ-update_S_S_S_O_O_O__ul_nx3_wrd_sqb} デフォルト:.default |
| 書き込みオプション | [フィールド書き込みオプション](https://servicenow-prod.fluidtopics.net/a7rJUASi8wEa4P_XFxtitg#FieldWriteOptionsiOSStruct "FieldWriteOptions クラスは、ServiceNow インスタンス上のレコードのフィールドを更新または作成するためのオプションを設定する関数を提供します。") | オプション。レコードに書き込まれるデータに適用する構成オプション。 デフォルト:nil |
| 構成 | [FetchConfiguration](https://servicenow-prod.fluidtopics.net/s4pcOrhOcnm~4lgw1mUrfQ#FetchConfigiOSStructure "FetchConfiguration 構造体には、ServiceNow インスタンスからレコードをフェッチするための構成を定義する機能が用意されています。") | オプション。返されるレコード、ページネーションページのサイズ制限、取得するフィールド、フィールドに含めるものを定義するフィルターなど、取得したレコードに適用する構成。 デフォルト:nil - すべてのレコードが返されます。 |
| 完了 | @escaping (Result\<Model, NowDataError\>) | 指定されたコード化可能モデルを更新した後に実行する完了ハンドラー。 戻り値: * 成功:モデル * 失敗:NowDataError * `accessToken(アクセストークンプロバイダーエラー)` * AccessTokenProviderError:アクセストークンプロバイダーのエラーコードまたはメッセージ。 * アクセストークン取得に失敗しました * userSessionError(_エラー:エラー) アクセストークンにエラーがある場合にスローされます。 * `attachmentValidation` 添付ファイルが検証に失敗したときにスローされます。 * `badResponse(statusCode: HTTPStatusCode)` * HTTPStatusCode:インスタンスから受信したステータスコード。 要求が予期しない応答を返した場合にスローされます * `cannotDecodeModel(デコードエラー)` * DecodingError:デコードエラーが検出されました。 Codable モデルを JSON からデコードできない場合にスローされます。 * `cannotDecodeProperty(タイプ:任意、差出人:文字列)` * type:文字列からデコードするラップされた型。 * from:指定されたタイプにデコードする文字列。 文字列でラップされた値を JSON からデコードできない場合にスローされます。 * `cannotEncodeModel(エンコーディングエラー)` * EncodingError:エンコードエラーが検出されました。 Codable モデルを JSON にエンコードできない場合にスローされます。 * `cannotParseResponse` インスタンスからの応答を予期される形式に解析できない場合にスローされます。 * `無効な URL` URL を形成できない場合にスローされます。たとえば、文字列に URL で無効な文字が含まれているか、空の文字列である場合などです。 * `missingAttachmentMetadata` 添付ファイルのメタデータヘッダーがない場合にスローされます。 * `missingServiceConfiguration` 予期されるサービス構成がない場合にスローされます。 * `missingSysID` 予期されるsys_idパラメーターがない場合にスローされます。 * `network(NetworkServiceError)` * genericError(文字列) * operationCanceled * serviceDisabled * serverError(エラー) * systemError(エラー) ネットワークサービスでエラーが発生した場合にスローされます。 {#NTblServ-update_S_S_S_O_O_O__NowDataErroriOS-ul-enum} {#NTblServ-update_S_S_S_O_O_O__ul_dpx_jvk_spb} |
[表 : 51. パラメーター]

{#NTblServ-update_S_S_S_O_O_O__table_nmv_vpr_spb} {#NTblServ-update_S_S_S_O_O_O__table_omv_vpr_spb__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 52. 返される内容]

{#NTblServ-update_S_S_S_O_O_O__table_omv_vpr_spb}  
次のコード例は、このメソッドを呼び出す方法を示しています。

    struct User: SysIdentifiableModel {
      var sysId: String = ""
      var name: String
    }

    let user = User(sysId: "12345", name: "abel")
    let coder: Coder = .default

    tableService.update(user, in: "sys_user") { [weak self] result in
      switch result {
        case .success(let model):
          do {
            let data = try coder.jsonEncoder.encode(model)
            self?.publish(data: data)
          } catch {
            self?.publish(result: .failure(error))
          }            
        case .failure(let error):
          // Failed to update with NowDataError
          self?.publish(result: .failure(error))
      }
    }

## NowTableService - update\<Model: SysIdentifiableModel\>(_ model: Model, in tableName: String, coder: Coder = .default, writeOptions: FieldWriteOptions? = nil, configuration: FetchConfiguration? = nil) {#ariaid-title28}

指定されたテーブルの指定されたコード可能モデルを更新します。
注:  
このメソッドは廃止されました。代わりに、メソッドの async/await 実装を使用する必要があります。
{#NTblServ-update_S_S_S_O_O__table_n4q_3yk_spb__entry__3}

| 名前 | タイプ | Description (説明) |
|-|-|-|
| モデル | モデル | テーブルで更新する `SysIdentifiableModel` モデル。 |
| tableName 内 | 文字列 | レコードを書き込むテーブルの名前 ( インシデントなど)。 |
| コーダー | コーダー | オプション。ServiceNow インスタンスとの間で送受信されるデータのエンコードまたはデコードに使用する`コーダー`。 可能な値： * default: 既定のエンコーダーは、デバイスの`ロケール`と`タイム ゾーン`を使用して、`yyy-MM-dd HH:mm:ss` 形式を使用して日付を書式設定します。 * custom(JSONEncoder, JSONDecoder): `カスタム` コーダーを使用して、JSON のデコード/エンコードをよりきめ細かく制御します。 この列挙は、特別な日付形式、タイムゾーン、またはロケールを使用する場合など、独自の `JSONEncoder` と `JSONDecoder`を指定する場合にのみ使用してください。 let myEncoder = JSONEncoder() myEncoder.dateFormat = ... let myDecoder = JSONDecoder() myDecoder.dateFormat = ... let coder: Coder = .custom(myEncoder, myDecoder) {#NTblServ-update_S_S_S_O_O__ul_nx3_wrd_sqb} デフォルト:.default |
| 書き込みオプション | [フィールド書き込みオプション](https://servicenow-prod.fluidtopics.net/a7rJUASi8wEa4P_XFxtitg#FieldWriteOptionsiOSStruct "FieldWriteOptions クラスは、ServiceNow インスタンス上のレコードのフィールドを更新または作成するためのオプションを設定する関数を提供します。") | オプション。レコードに書き込まれるデータに適用する構成オプション。 デフォルト:nil |
| 構成 | [FetchConfiguration](https://servicenow-prod.fluidtopics.net/s4pcOrhOcnm~4lgw1mUrfQ#FetchConfigiOSStructure "FetchConfiguration 構造体には、ServiceNow インスタンスからレコードをフェッチするための構成を定義する機能が用意されています。") | オプション。返されるレコード、ページネーションページのサイズ制限、取得するフィールド、フィールドに含めるものを定義するフィルターなど、取得したレコードに適用する構成。 デフォルト:nil - すべてのレコードが返されます。 |
[表 : 53. パラメーター]

{#NTblServ-update_S_S_S_O_O__table_n4q_3yk_spb} {#NTblServ-update_S_S_S_O_O__table_o4q_3yk_spb__entry__2}

| タイプ | Description (説明) |
|-|-|
| AnyPublisher\<Model、NowDataError\> | 成功:指定されたテーブルで更新されたデコード可能なモデル。 失敗:NowDataError * `accessToken(アクセストークンプロバイダーエラー)` * AccessTokenProviderError:アクセストークンプロバイダーのエラーコードまたはメッセージ。 * アクセストークン取得に失敗しました * userSessionError(_エラー:エラー) アクセストークンにエラーがある場合にスローされます。 * `attachmentValidation` 添付ファイルが検証に失敗したときにスローされます。 * `badResponse(statusCode: HTTPStatusCode)` * HTTPStatusCode:インスタンスから受信したステータスコード。 要求が予期しない応答を返した場合にスローされます * `cannotDecodeModel(デコードエラー)` * DecodingError:デコードエラーが検出されました。 Codable モデルを JSON からデコードできない場合にスローされます。 * `cannotDecodeProperty(タイプ:任意、差出人:文字列)` * type:文字列からデコードするラップされた型。 * from:指定されたタイプにデコードする文字列。 文字列でラップされた値を JSON からデコードできない場合にスローされます。 * `cannotEncodeModel(エンコーディングエラー)` * EncodingError:エンコードエラーが検出されました。 Codable モデルを JSON にエンコードできない場合にスローされます。 * `cannotParseResponse` インスタンスからの応答を予期される形式に解析できない場合にスローされます。 * `無効な URL` URL を形成できない場合にスローされます。たとえば、文字列に URL で無効な文字が含まれているか、空の文字列である場合などです。 * `missingAttachmentMetadata` 添付ファイルのメタデータヘッダーがない場合にスローされます。 * `missingServiceConfiguration` 予期されるサービス構成がない場合にスローされます。 * `missingSysID` 予期されるsys_idパラメーターがない場合にスローされます。 * `network(NetworkServiceError)` * genericError(文字列) * operationCanceled * serviceDisabled * serverError(エラー) * systemError(エラー) ネットワークサービスでエラーが発生した場合にスローされます。 {#NTblServ-update_S_S_S_O_O__NowDataErroriOS-ul-enum} |
[表 : 54. 返される内容]

{#NTblServ-update_S_S_S_O_O__table_o4q_3yk_spb}  
次のコード例は、このメソッドを呼び出す方法を示しています。

    struct User: SysIdentifiableModel {
      var sysId: String = ""
      var name: String
    }

    let user = User(sysId: "12345", name: "abel")
    let coder: Coder = .default

    tableService.update(user, in: "sys_user")
      .subscribe(on: DispatchQueue.global())
      .receive(on: DispatchQueue.main)
      .sink { [weak self] completion in
        if case let .failure(error) = completion {
          // Failed to update with NowDataError
          self?.publish(result: .failure(error))
        }
      } receiveValue: { [weak self] updatedModel in
        do {
          let data = try coder.jsonEncoder.encode(updatedModel)
          self?.publish(data: data)
        } catch {
          // Failed to update with NowDataError
          self?.publish(result: .failure(error))
        }
      }
      .store(in: &subscriptions)

## NowTableService - updateRecord(sysId: SysID, in tableName: String, withfields: \[FieldName: FieldValue\], writeOptions: FieldWriteOptions? = nil, configuration: FieldReadConfiguration? = nil) async throws {#ariaid-title29}

指定されたレコードを指定されたフィールドで更新します。
データをカスタム [Codable モデル](https://developer.apple.com/documentation/foundation/archives_and_serialization/encoding_and_decoding_custom_types)に復号化することも、関数 [NowTableService - paginator\<Model: Decodable\>(from tableName: String, path: String = Constants.resultPath, coder: coder = .default, configuration: FetchConfiguration? = nil)](https://servicenow-prod.fluidtopics.net/oOte0XsLyXvzQxPHCgteyw#NTblServ-paginator_S_S_S_O "ネストを処理するデコードされたモデルのページの反復を可能にするページネータを作成します。") を使用することもできます。 または、便利な関数 convertToRecords() を使用して、データを NowRecord オブジェクトに変換することもできます。NowRecords を出力するように発行元を変換する方法を次に示します。

    let dataPublisher: AnyPublisher<Data, NowDataError> = ...
    let recordsPublisher: AnyPublisher<[NowRecord], NowDataError> = myPublisher.convertToRecords()

注:  
レコード内のすべてのフィールドは更新できない場合があります。たとえば、プリフィックスが `sys_` のフィールドは、通常、自動的に生成され、更新できないシステムパラメーターです。指定されておらず、システムによって自動生成されていないフィールドは、関連するデータタイプの NULL 値に設定されます。
{#NTblServ-updateRecord-async_S_A_O_O__table_cjl_5sj_ppb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| sysId | 文字列 | ServiceNowインスタンスから返されるレコードのSys_id。 |
| フィールドあり | \[FieldName:FieldValue\] | レコードに含めるフィールドの名前と値のペア。 |
| tableName 内 | 文字列 | レコードを書き込むテーブルの名前 ( インシデントなど)。 |
| 書き込みオプション | [フィールド書き込みオプション](https://servicenow-prod.fluidtopics.net/a7rJUASi8wEa4P_XFxtitg#FieldWriteOptionsiOSStruct "FieldWriteOptions クラスは、ServiceNow インスタンス上のレコードのフィールドを更新または作成するためのオプションを設定する関数を提供します。") | オプション。レコードに書き込まれるデータに適用する構成オプション。 デフォルト:nil |
| 構成 | [FetchConfiguration](https://servicenow-prod.fluidtopics.net/s4pcOrhOcnm~4lgw1mUrfQ#FetchConfigiOSStructure "FetchConfiguration 構造体には、ServiceNow インスタンスからレコードをフェッチするための構成を定義する機能が用意されています。") | オプション。返されるレコード、ページネーションページのサイズ制限、取得するフィールド、フィールドに含めるものを定義するフィルターなど、取得したレコードに適用する構成。 デフォルト:nil - すべてのレコードが返されます。 |
[表 : 55. パラメーター]

{#NTblServ-updateRecord-async_S_A_O_O__table_cjl_5sj_ppb} {#NTblServ-updateRecord-async_S_A_O_O__table_djl_5sj_ppb__entry__2}

| タイプ | 説明 |
|-|-|
| Data (データ) | メソッドが成功したときに返されます。更新されたレコードを含むデータオブジェクト。 |
| NowDataError | メソッドが失敗したときにスローされます。 * `accessToken(アクセストークンプロバイダーエラー)` * AccessTokenProviderError:アクセストークンプロバイダーのエラーコードまたはメッセージ。 * アクセストークン取得に失敗しました * userSessionError(_エラー:エラー) アクセストークンにエラーがある場合にスローされます。 * `attachmentValidation` 添付ファイルが検証に失敗したときにスローされます。 * `badResponse(statusCode: HTTPStatusCode)` * HTTPStatusCode:インスタンスから受信したステータスコード。 要求が予期しない応答を返した場合にスローされます * `cannotDecodeModel(デコードエラー)` * DecodingError:デコードエラーが検出されました。 Codable モデルを JSON からデコードできない場合にスローされます。 * `cannotDecodeProperty(タイプ:任意、差出人:文字列)` * type:文字列からデコードするラップされた型。 * from:指定されたタイプにデコードする文字列。 文字列でラップされた値を JSON からデコードできない場合にスローされます。 * `cannotEncodeModel(エンコーディングエラー)` * EncodingError:エンコードエラーが検出されました。 Codable モデルを JSON にエンコードできない場合にスローされます。 * `cannotParseResponse` インスタンスからの応答を予期される形式に解析できない場合にスローされます。 * `無効な URL` URL を形成できない場合にスローされます。たとえば、文字列に URL で無効な文字が含まれているか、空の文字列である場合などです。 * `missingAttachmentMetadata` 添付ファイルのメタデータヘッダーがない場合にスローされます。 * `missingServiceConfiguration` 予期されるサービス構成がない場合にスローされます。 * `missingSysID` 予期されるsys_idパラメーターがない場合にスローされます。 * `network(NetworkServiceError)` * genericError(文字列) * operationCanceled * serviceDisabled * serverError(エラー) * systemError(エラー) ネットワークサービスでエラーが発生した場合にスローされます。 {#NTblServ-updateRecord-async_S_A_O_O__NowDataErroriOS-ul-enum} |
[表 : 56. 返される内容]

{#NTblServ-updateRecord-async_S_A_O_O__table_djl_5sj_ppb}  
次のコード例は、このメソッドを呼び出す方法を示しています。

    do { 
        let dataResult: Data = try await tableService.updateRecord(with: fields, in: tableName, writeOptions: writeOptions, configuration: configuration) 
        let recordResult: NowRecord = dataResult.convertToRecord() 
    } catch { 
        print("Record update failed with NowDataError: \(error)") 
    }

## NowTableService - updateRecord(sysId: SysID, in tableName: String, with fields: \[FieldName: FieldValue\], writeOptions: FieldWriteOptions? = nil, configuration: FieldReadConfiguration? = nil, completion: @escaping (Result\<Data, NowDataError\>) {#ariaid-title30}

指定されたフィールドで指定されたレコードを更新し、レコードが保存されたら completion ハンドラーを実行します。
必要に応じて、戻り値をカスタム Codable モデルにデコードするか、代わりに関数 [NowTableService - paginator\<Model: Decodable\>(from tableName: String, path: String = Constants.resultPath, coder: coder = .default, configuration: FetchConfiguration? = nil)](https://servicenow-prod.fluidtopics.net/oOte0XsLyXvzQxPHCgteyw#NTblServ-paginator_S_S_S_O "ネストを処理するデコードされたモデルのページの反復を可能にするページネータを作成します。") を使用できます。 または、便利な関数 convertToRecords() を使用して、データを NowRecord オブジェクトに変換することもできます。NowRecords を出力するように発行元を変換する方法を次に示します。

    let dataPublisher: AnyPublisher<Data, NowDataError> = ...
    let recordsPublisher: AnyPublisher<[NowRecord], NowDataError> = myResult.convertToRecords()

注:  
レコード内のすべてのフィールドは更新できない場合があります。たとえば、プリフィックスが `sys_` のフィールドは、通常、自動的に生成され、更新できないシステムパラメーターです。指定されておらず、システムによって自動生成されていないフィールドは、関連するデータタイプの NULL 値に設定されます。
{#NTblServ-updateRecord_S_A_O_O_O__table_jq5_ttj_ppb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| sysId | 文字列 | ServiceNowインスタンスから返されるレコードのSys_id。 |
| フィールドあり | \[FieldName:FieldValue\] | レコードに含めるフィールドの名前と値のペア。 |
| tableName 内 | 文字列 | レコードを書き込むテーブルの名前 ( インシデントなど)。 |
| 書き込みオプション | [フィールド書き込みオプション](https://servicenow-prod.fluidtopics.net/a7rJUASi8wEa4P_XFxtitg#FieldWriteOptionsiOSStruct "FieldWriteOptions クラスは、ServiceNow インスタンス上のレコードのフィールドを更新または作成するためのオプションを設定する関数を提供します。") | オプション。レコードに書き込まれるデータに適用する構成オプション。 デフォルト:nil |
| 構成 | [FetchConfiguration](https://servicenow-prod.fluidtopics.net/s4pcOrhOcnm~4lgw1mUrfQ#FetchConfigiOSStructure "FetchConfiguration 構造体には、ServiceNow インスタンスからレコードをフェッチするための構成を定義する機能が用意されています。") | オプション。返されるレコード、ページネーションページのサイズ制限、取得するフィールド、フィールドに含めるものを定義するフィルターなど、取得したレコードに適用する構成。 デフォルト:nil - すべてのレコードが返されます。 |
| 完了 | @escaping (結果\<データ、NowDataError\>) | レコードを取得した後に実行する完了ハンドラー。 戻り値: * 成功:データ:要求されたレコード * エラー:NowDataError * `accessToken(アクセストークンプロバイダーエラー)` * AccessTokenProviderError:アクセストークンプロバイダーのエラーコードまたはメッセージ。 * アクセストークン取得に失敗しました * userSessionError(_エラー:エラー) アクセストークンにエラーがある場合にスローされます。 * `attachmentValidation` 添付ファイルが検証に失敗したときにスローされます。 * `badResponse(statusCode: HTTPStatusCode)` * HTTPStatusCode:インスタンスから受信したステータスコード。 要求が予期しない応答を返した場合にスローされます * `cannotDecodeModel(デコードエラー)` * DecodingError:デコードエラーが検出されました。 Codable モデルを JSON からデコードできない場合にスローされます。 * `cannotDecodeProperty(タイプ:任意、差出人:文字列)` * type:文字列からデコードするラップされた型。 * from:指定されたタイプにデコードする文字列。 文字列でラップされた値を JSON からデコードできない場合にスローされます。 * `cannotEncodeModel(エンコーディングエラー)` * EncodingError:エンコードエラーが検出されました。 Codable モデルを JSON にエンコードできない場合にスローされます。 * `cannotParseResponse` インスタンスからの応答を予期される形式に解析できない場合にスローされます。 * `無効な URL` URL を形成できない場合にスローされます。たとえば、文字列に URL で無効な文字が含まれているか、空の文字列である場合などです。 * `missingAttachmentMetadata` 添付ファイルのメタデータヘッダーがない場合にスローされます。 * `missingServiceConfiguration` 予期されるサービス構成がない場合にスローされます。 * `missingSysID` 予期されるsys_idパラメーターがない場合にスローされます。 * `network(NetworkServiceError)` * genericError(文字列) * operationCanceled * serviceDisabled * serverError(エラー) * systemError(エラー) ネットワークサービスでエラーが発生した場合にスローされます。 {#NTblServ-updateRecord_S_A_O_O_O__NowDataErroriOS-ul-enum} {#NTblServ-updateRecord_S_A_O_O_O__ul_uzx_thj_ppb} |
[表 : 57. パラメーター]

{#NTblServ-updateRecord_S_A_O_O_O__table_jq5_ttj_ppb} {#NTblServ-updateRecord_S_A_O_O_O__table_kq5_ttj_ppb__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 58. 返される内容]

{#NTblServ-updateRecord_S_A_O_O_O__table_kq5_ttj_ppb}  
次のコード例は、このメソッドを呼び出す方法を示しています。

    tableService.updateRecord(sysId: sysId, in: tableName, with: fields, writeOptions: writeOptions, configuration: readConfiguration) { [weak self] result in
      switch result {
        case .success(let data):
          self?.publish(data: data)
        case .failure(let error):
           // Failed to update with NowDataError
      }
    }

## NowTableService - updateRecord(sysId: SysID, in tableName: String, withfields: \[FieldName: FieldValue\], writeOptions: FieldWriteOptions? = nil, configuration: FieldReadConfiguration? = nil) {#ariaid-title31}

指定されたレコードを指定されたフィールドで更新します。
注:  
このメソッドは廃止されました。代わりに、メソッドの async/await 実装を使用する必要があります。  
publisher は、カスタム [Codable モデル](https://developer.apple.com/documentation/foundation/archives_and_serialization/encoding_and_decoding_custom_types)にデコードできるデータを出力するか、 [NowTableService - paginator\<Model: Decodable\>(from tableName: String, path: String = Constants.resultPath, coder: coder = .default, configuration: FetchConfiguration? = nil)](https://servicenow-prod.fluidtopics.net/oOte0XsLyXvzQxPHCgteyw#NTblServ-paginator_S_S_S_O "ネストを処理するデコードされたモデルのページの反復を可能にするページネータを作成します。") 関数を使用することもできます。 または、便利な関数 convertToRecords() を使用して、データを NowRecord オブジェクトに変換することもできます。NowRecords を出力するように発行元を変換する方法を次に示します。。

    let dataPublisher: AnyPublisher<Data, NowDataError> = ...
    let recordsPublisher: AnyPublisher<[NowRecord], NowDataError> = myPublisher.convertToRecords()

注:  
レコード内のすべてのフィールドは更新できない場合があります。たとえば、プリフィックスが `sys_` のフィールドは、通常、自動的に生成され、更新できないシステムパラメーターです。指定されておらず、システムによって自動生成されていないフィールドは、関連するデータタイプの NULL 値に設定されます。
{#NTblServ-updateRecord_S_A_O_O__table_cjl_5sj_ppb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| sysId | 文字列 | ServiceNowインスタンスから返されるレコードのSys_id。 |
| フィールドあり | \[FieldName:FieldValue\] | レコードに含めるフィールドの名前と値のペア。 |
| tableName 内 | 文字列 | レコードを書き込むテーブルの名前 ( インシデントなど)。 |
| 書き込みオプション | [フィールド書き込みオプション](https://servicenow-prod.fluidtopics.net/a7rJUASi8wEa4P_XFxtitg#FieldWriteOptionsiOSStruct "FieldWriteOptions クラスは、ServiceNow インスタンス上のレコードのフィールドを更新または作成するためのオプションを設定する関数を提供します。") | オプション。レコードに書き込まれるデータに適用する構成オプション。 デフォルト:nil |
| 構成 | [FetchConfiguration](https://servicenow-prod.fluidtopics.net/s4pcOrhOcnm~4lgw1mUrfQ#FetchConfigiOSStructure "FetchConfiguration 構造体には、ServiceNow インスタンスからレコードをフェッチするための構成を定義する機能が用意されています。") | オプション。返されるレコード、ページネーションページのサイズ制限、取得するフィールド、フィールドに含めるものを定義するフィルターなど、取得したレコードに適用する構成。 デフォルト:nil - すべてのレコードが返されます。 |
[表 : 59. パラメーター]

{#NTblServ-updateRecord_S_A_O_O__table_cjl_5sj_ppb} {#NTblServ-updateRecord_S_A_O_O__table_djl_5sj_ppb__entry__2}

| タイプ | Description (説明) |
|-|-|
| AnyPublisher\<Data、NowDataError\> | 成功:更新されたレコードを含むデータオブジェクト。 失敗:NowDataError * `accessToken(アクセストークンプロバイダーエラー)` * AccessTokenProviderError:アクセストークンプロバイダーのエラーコードまたはメッセージ。 * アクセストークン取得に失敗しました * userSessionError(_エラー:エラー) アクセストークンにエラーがある場合にスローされます。 * `attachmentValidation` 添付ファイルが検証に失敗したときにスローされます。 * `badResponse(statusCode: HTTPStatusCode)` * HTTPStatusCode:インスタンスから受信したステータスコード。 要求が予期しない応答を返した場合にスローされます * `cannotDecodeModel(デコードエラー)` * DecodingError:デコードエラーが検出されました。 Codable モデルを JSON からデコードできない場合にスローされます。 * `cannotDecodeProperty(タイプ:任意、差出人:文字列)` * type:文字列からデコードするラップされた型。 * from:指定されたタイプにデコードする文字列。 文字列でラップされた値を JSON からデコードできない場合にスローされます。 * `cannotEncodeModel(エンコーディングエラー)` * EncodingError:エンコードエラーが検出されました。 Codable モデルを JSON にエンコードできない場合にスローされます。 * `cannotParseResponse` インスタンスからの応答を予期される形式に解析できない場合にスローされます。 * `無効な URL` URL を形成できない場合にスローされます。たとえば、文字列に URL で無効な文字が含まれているか、空の文字列である場合などです。 * `missingAttachmentMetadata` 添付ファイルのメタデータヘッダーがない場合にスローされます。 * `missingServiceConfiguration` 予期されるサービス構成がない場合にスローされます。 * `missingSysID` 予期されるsys_idパラメーターがない場合にスローされます。 * `network(NetworkServiceError)` * genericError(文字列) * operationCanceled * serviceDisabled * serverError(エラー) * systemError(エラー) ネットワークサービスでエラーが発生した場合にスローされます。 {#NTblServ-updateRecord_S_A_O_O__NowDataErroriOS-ul-enum} |
[表 : 60. 返される内容]

{#NTblServ-updateRecord_S_A_O_O__table_djl_5sj_ppb}  
この例では、指定したテーブルのレコードを指定したフィールドで更新する関数を作成する方法を示します。呼び出しの出力は ByteArray で、データを任意のモデルに変換できます。

    tableService.updateRecord(sysId: sysId, in: tableName, with: fields, writeOptions: writeOptions, configuration: readConfiguration)
        .subscribe(on: DispatchQueue.global())
        .receive(on: DispatchQueue.main)
        .convertToRecord()
        .sink { completion in
            if case let .failure(error) = completion {
                print("Update failed with NowDataError: \(error)")
            }
        } receiveValue: { record in
            print("Record updated: \(record)")
        }
        .store(in: &subscriptions)