---
sourceDocument: オーストラリア API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/api-reference

 Release :

    - australia

ft:locale :

    - ja-JP

ft:publication_title :

    - オーストラリア API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# NowTableService インターフェイス : Android

# NowTableService インターフェイス : Android {#ariaid-title1}

* リリースバージョン: Australia
* 
* 更新日 2026年03月12日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：10分

NowTableService インターフェイスは、ServiceNowインスタンスのテーブル内のレコードを作成、読み取り、削除、および更新できるようにする機能を提供します。  
{#NowTableServiceAndroidInterface__table_vx2_klw_5pb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| 構成 | [NowServiceConfiguration](https://servicenow-prod.fluidtopics.net/kN3GoqTwJ7c0P7uFfos~Dg "NowServiceConfiguration クラスを使用すると、フィーチャ サービスのServiceNow インスタンス URL とパッケージ名を構成できます。") | サービスに関連付ける構成。 |
[表 : 1. プロパティ]

{#NowTableServiceAndroidInterface__table_vx2_klw_5pb}

## NowTableService - createRecord(tableName: String, fields: Map\<String, String\>, writeOptions: FieldWriteOptions?, configuration: FieldReadConfiguration?) {#ariaid-title2}

指定されたテーブルに指定されたレコードを挿入します。
{#NTabServ-createRecord_S_S_S__table_arm_j41_ppb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| tableName | 文字列 | レコードを保存するテーブルの名前。 |
| フィールド | Map\<String, String\> | レコードに作成するすべてのフィールドのキーと値のペア。 注: レコード内の一部のフィールドは、更新できない場合があります。たとえば、プリフィックスが `sys_` のフィールドは、通常、自動的に生成され、更新できないシステムパラメーターです。指定されておらず、システムによって自動生成されなかったフィールドは、関連付けられたデータタイプの null 値に設定されます。 |
| writeOptions | [フィールド書き込みオプション](https://servicenow-prod.fluidtopics.net/kBpneUEXyXMZyXMCFUBKlA#FieldWriteOptionsAndroidAPI "FieldWriteOptions クラスは、ServiceNowインスタンスのレコードのフィールドを更新または作成するためのオプションを設定する関数を提供します。") | オプション。値を表示値として保存するかどうかや、システムフィールドの自動生成を抑制するかどうかなど、フィールドに設定するオプションを書き込みます。 デフォルト:null:オプションが選択されていません |
| 構成 | [フィールド読み取り構成](https://servicenow-prod.fluidtopics.net/foXjYNfKn7Hwi9xKNh5EVg#FieldReadConfigAndroidAPI "FieldReadConfiguration クラスは、応答レコードで返すフィールドと返さないフィールドを定義する機能を提供します。") | オプション。作成されたレコードに対して返すフィールドと、フィールドに含めるものを指定する構成。 |
[表 : 2. パラメーター]

{#NTabServ-createRecord_S_S_S__table_arm_j41_ppb} {#NTabServ-createRecord_S_S_S__table_brm_j41_ppb__entry__2}

| タイプ | 説明 |
|-|-|
| [Call](https://servicenow-prod.fluidtopics.net/f9MOJM5d6RJ30rx8bmji1w#CallAndroidInterface "呼び出しインターフェイスは、処理用に準備された要求を表します。")\<[ByteArray](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-byte-array/)\> | 成功:作成されたレコードを含む ByteArray。この情報は、必要な任意のデータモデルに変換できます。 失敗:NowDataError |
[表 : 3. 返される内容]

{#NTabServ-createRecord_S_S_S__table_brm_j41_ppb}  

    fun createTableRecord( tableName: String, fields: KeyValues, includeFields: String, 
      readOptions: ReadOptions?, writeOptions: WriteOptions?){ 
     
      val readOptionsArray = readOptions?.asArray() ?: arrayOf() 
      val readConfig = FieldReadConfiguration(includeFields.split(","), *readOptionsArray) 
     
      var body:ByteArray? 
     
      val call = tableService.createRecord(tableName, fields.toMap(), 
        writeOptions?.asFieldWriteOptions(), 
        readConfig) 
      call.enqueue({ body = it.body },{ Log.d("Records", "failed to create record") }) 
    } 

## NowTableService:deleteRecord(sysId:文字列、tableName:文字列) {#ariaid-title3}

指定されたテーブルの指定されたレコードを削除します。
{#NTabServ-deleteRecord_S_S__table_esw_b1h_ppb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| sysId | 文字列 | 削除するレコードの sys_id。 |
| tableName | 文字列 | インシデントや資産など、指定されたレコードが配置されているテーブルの名前。 |
[表 : 4. パラメーター]

{#NTabServ-deleteRecord_S_S__table_esw_b1h_ppb} {#NTabServ-deleteRecord_S_S__table_fsw_b1h_ppb__entry__2}

| タイプ | 説明 |
|-|-|
| [Call](https://servicenow-prod.fluidtopics.net/f9MOJM5d6RJ30rx8bmji1w#CallAndroidInterface "呼び出しインターフェイスは、処理用に準備された要求を表します。")\<[ByteArray](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-byte-array/)\> | 成功:何も返されません。 失敗:NowDataError |
[表 : 5. 返される内容]

{#NTabServ-deleteRecord_S_S__table_fsw_b1h_ppb}  
<br />

    fun deleteTableRecord( recordSysId: String, tableName: String, callType: CallTestType){ 
      val tableService = serviceProvider.tableService()
      var body:ByteArray? 
      val call = tableService.deleteRecord(recordSysId, tableName) 
      call.enqueue({ body = it.body },{ Log.d("Records", "failed to create record") }) 
    } 

## NowTableService:paginator(tableName:文字列、構成:FetchConfiguration) {#ariaid-title4}

テーブル内のレコードのページの反復を可能にするページネーターを作成します。
このページネーターを使用して、返されたレコード間を移動したり、最初、最後、前、または次のページのフェッチ、次または前のページがあるかどうかの確認などのナビゲーション操作を実行したりできます。
{#NTabServ-paginator_S_O__table_o32_dbh_ppb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| tableName | 文字列 | ページネーターを作成するテーブルの名前。 |
| 構成 | [FetchConfiguration](https://servicenow-prod.fluidtopics.net/o~iBCGH7rChC6BJZuknstA#FetchConfigAndroidAPI "FetchConfiguration クラスは、関連付けられたServiceNowテーブルからレコードをフェッチするための構成を定義する機能を提供します。") | 使用するフィルター、ページネーションページサイズ制限、取得するフィールド、およびフィールドに含めるものを指定する構成。 |
[表 : 6. パラメーター]

{#NTabServ-paginator_S_O__table_o32_dbh_ppb} {#NTabServ-paginator_S_O__table_p32_dbh_ppb__entry__2}

| タイプ | 説明 |
|-|-|
| Paginator\<[ByteArray](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-byte-array/)\> | 成功:要求されたレコードの ByteArray 出力を使用したページネーター。Paginator オブジェクト内の関数を使用して、返されたレコードを移動できます。 失敗:NowDataError |
[表 : 7. 返される内容]

{#NTabServ-paginator_S_O__table_p32_dbh_ppb}  
<br />

    private fun initTablePaginator() { 
      paginator = service?.paginator(tableName, FetchConfiguration(null, 3)) 
        ?.observe(object: PaginatorCallBack<ByteArray> { 
          override fun onSuccess(response: Response<List<ByteArray>>) { 
          } 
          override fun onFailure(e: NowDataError) { 
            Log.e("NowDataError", "", e) 
          } 
        }) 
    }

## NowTableService - record(sysId: String, tableName: String, configuration: FieldReadConfiguration?) {#ariaid-title5}

指定されたテーブルから指定されたレコードを取得します。
{#NTabServ-record_S_S_O__table_sdk_wch_ppb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| sysId | 文字列 | 取得するレコードの sys_id。 |
| tableName | 文字列 | インシデントや資産など、指定されたレコードが配置されているテーブルの名前。 |
| 構成 | [フィールド読み取り構成](https://servicenow-prod.fluidtopics.net/foXjYNfKn7Hwi9xKNh5EVg#FieldReadConfigAndroidAPI "FieldReadConfiguration クラスは、応答レコードで返すフィールドと返さないフィールドを定義する機能を提供します。") | オプション。取得するフィールドとフィールドに何を含めるかを指定する構成。 |
[表 : 8. パラメーター]

{#NTabServ-record_S_S_O__table_sdk_wch_ppb} {#NTabServ-record_S_S_O__table_tdk_wch_ppb__entry__2}

| タイプ | 説明 |
|-|-|
| [Call](https://servicenow-prod.fluidtopics.net/f9MOJM5d6RJ30rx8bmji1w#CallAndroidInterface "呼び出しインターフェイスは、処理用に準備された要求を表します。")\<[ByteArray](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-byte-array/)\> | 成功:取得されたレコードを含む ByteArray。この情報は、必要な任意のデータモデルに変換できます。 失敗:NowDataError |
[表 : 9. 返される内容]

{#NTabServ-record_S_S_O__table_tdk_wch_ppb}  
<br />

    fun fetchTableRecord( sysId: String, tableName: String, includeFields: String, 
      readOptions: ReadOptions?){ 
     
      val readOptionsArray = readOptions?.asArray() ?: arrayOf() 
      val readConfig = FieldReadConfiguration(includeFields.split(","), *readOptionsArray) 
     
      var body:ByteArray? 
     
      val call = tableService.record(sysId, tableName, readConfig) 
      call.enqueue({ body = it.body },{ Log.d("Record", "failed fetching record") }) 
    }

## NowTableService - records(tableName: String, configuration: FieldReadConfiguration?) {#ariaid-title6}

指定されたテーブルから sll レコードを取得します。
{#NTabServ-records_S_S_O__table_if5_v2h_ppb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| tableName | 文字列 | インシデントや資産などのレコードの取得元のテーブルの名前。 |
| 構成 | [フィールド読み取り構成](https://servicenow-prod.fluidtopics.net/foXjYNfKn7Hwi9xKNh5EVg#FieldReadConfigAndroidAPI "FieldReadConfiguration クラスは、応答レコードで返すフィールドと返さないフィールドを定義する機能を提供します。") | オプション。取得するフィールドとフィールドに何を含めるかを指定する構成。 |
[表 : 10. パラメーター]

{#NTabServ-records_S_S_O__table_if5_v2h_ppb} {#NTabServ-records_S_S_O__table_jf5_v2h_ppb__entry__2}

| タイプ | 説明 |
|-|-|
| [Call](https://servicenow-prod.fluidtopics.net/f9MOJM5d6RJ30rx8bmji1w#CallAndroidInterface "呼び出しインターフェイスは、処理用に準備された要求を表します。")\<[ByteArray](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-byte-array/)\> | 成功:取得されたレコードを含む ByteArray。この情報は、必要な任意のデータモデルに変換できます。 失敗:NowDataError |
[表 : 11. 返される内容]

{#NTabServ-records_S_S_O__table_jf5_v2h_ppb}  
<br />

    fun fetchTableRecords( tableName: String, filterQuery: String, includeFields: String, 
      readOptions: ReadOptions?, limit: Int?){ 
     
      val readOptionsArray = readOptions?.asArray() ?: arrayOf() 
      val readConfig = FieldReadConfiguration(includeFields.split(","), *readOptionsArray) 
      val config = FetchConfiguration(Filter(filterQuery), limit, readConfig) 
     
      var body:ByteArray? 
     
      val call = tableService.records(tableName, config) 
      call.enqueue({ body = it.body },{ Log.d("Records", "failed fetching records") }) 
    } 

## NowTableService - updateRecord(sysId: String, tableName: String, fields: Map\<String, String\>, writeOptions: FieldWriteOptions?, configuration: FieldReadConfiguration?) {#ariaid-title7}

指定されたテーブルの指定されたレコードを指定されたフィールドで更新します。
{#NTabServ-updateRecord_S_S_S_O__table_jtj_nfh_ppb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| tableName | 文字列 | レコードを更新するテーブルの名前。 |
| フィールド | Map\<String, String\> | レコード内のすべてのフィールドを更新するキーと値のペア。 注: レコード内の一部のフィールドは、更新できない場合があります。たとえば、プリフィックスが `sys_` のフィールドは、通常、自動的に生成され、更新できないシステムパラメーターです。指定されておらず、システムによって自動生成されなかったフィールドは、関連付けられたデータタイプの null 値に設定されます。 |
| writeOptions | [フィールド書き込みオプション](https://servicenow-prod.fluidtopics.net/kBpneUEXyXMZyXMCFUBKlA#FieldWriteOptionsAndroidAPI "FieldWriteOptions クラスは、ServiceNowインスタンスのレコードのフィールドを更新または作成するためのオプションを設定する関数を提供します。") | オプション。値を表示値として保存するかどうかや、システムフィールドの自動生成を抑制するかどうかなど、フィールドに設定するオプションを書き込みます。 デフォルト:null:オプションが選択されていません |
| 構成 | [フィールド読み取り構成](https://servicenow-prod.fluidtopics.net/foXjYNfKn7Hwi9xKNh5EVg#FieldReadConfigAndroidAPI "FieldReadConfiguration クラスは、応答レコードで返すフィールドと返さないフィールドを定義する機能を提供します。") | オプション。更新するフィールドとフィールドに何を含めるかを指定する構成。 デフォルト値:null |
[表 : 12. パラメーター]

{#NTabServ-updateRecord_S_S_S_O__table_jtj_nfh_ppb} {#NTabServ-updateRecord_S_S_S_O__table_ktj_nfh_ppb__entry__2}

| タイプ | 説明 |
|-|-|
| [Call](https://servicenow-prod.fluidtopics.net/f9MOJM5d6RJ30rx8bmji1w#CallAndroidInterface "呼び出しインターフェイスは、処理用に準備された要求を表します。")\<[ByteArray](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-byte-array/)\> | 成功:更新されたレコードを含む ByteArray。この情報は、必要な任意のデータモデルに変換できます。 失敗:NowDataError |
[表 : 13. 返される内容]

{#NTabServ-updateRecord_S_S_S_O__table_ktj_nfh_ppb}  
<br />

    fun updateTableRecord( sysId: String, tableName: String, fields: KeyValues, includeFields: String, 
       readOptions: ReadOptions?, writeOptions: WriteOptions?){ 
     
       val readOptionsArray = readOptions?.asArray() ?: arrayOf() 
       val readConfig = FieldReadConfiguration(includeFields.split(","), *readOptionsArray) 
     
       var body:ByteArray? 
     
       val call = tableService.updateRecord(recordSysId, tableName, fields.toMap(), 
         writeOptions?.asFieldWriteOptions(), 
         readConfig) 
       call.enqueue({ body = it.body },{ Log.d("Records", "failed to update record") }) 
    }