NowTableService インターフェイス - Android
NowTableService インターフェイスは、インスタンス上のServiceNowテーブル内のレコードを作成、読み取り、削除、および更新できるようにする機能を提供します。
| 名前 | タイプ | 説明 |
|---|---|---|
| 構成 | NowServiceConfiguration | サービスに関連付ける構成。 |
NowTableService - createRecord(tableName: 文字列, fields: Map<String, 文字列>, writeOptions: FieldWriteOptions?, configuration: FieldReadConfiguration?)
指定されたテーブルに指定されたレコードを挿入します。
| 名前 | タイプ | 説明 |
|---|---|---|
| tableName | 文字列 | レコードを保存するテーブルの名前。 |
| フィールド | Map<String, String> | レコード内に作成するすべてのフィールドのキーと値のペア。 注: レコード内のすべてのフィールドは更新できない場合があります。たとえば、 プリフィックス sys_ を持つフィールドは、通常、自動的に生成されるシステムパラメーターであり、更新することはできません。指定されておらず、システムによって自動生成されないフィールドは、関連付けられたデータタイプの null 値に設定されます。 |
| 書き込みオプション | フィールド書き込みオプション | オプション。値を表示値として格納するかどうか、システムフィールドの自動生成を抑制するかどうかなど、フィールドに設定するオプションを記述します。 デフォルト:null - オプションが選択されていません |
| 構成 | FieldReadConfiguration | オプション。作成されたレコードに対して返すフィールドと、フィールドに含める内容を指定する構成。 |
| タイプ | 説明 |
|---|---|
| call<ByteArray> | 成功:作成されたレコードを含む ByteArray。この情報を、必要なデータモデルに変換できます。 エラー:NowDataError |
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: 文字列)
指定されたテーブルの指定されたレコードを削除します。
| 名前 | タイプ | 説明 |
|---|---|---|
| sysId | 文字列 | 削除するレコードの sys_id。 |
| tableName | 文字列 | インシデントや資産など、指定されたレコードが配置されているテーブルの名前。 |
| タイプ | 説明 |
|---|---|
| call<ByteArray> | 成功:何も返されません。 エラー:NowDataError |
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: 文字列, configuration: FetchConfiguration)
テーブル内のレコードのページの反復を可能にするページネータを作成します。
このページネータを使用して、返されたレコード間を移動し、最初のページ、最後のページ、前ページ、または次のページのフェッチや、次のページまたは前のページがあるかどうかの確認などのナビゲーション操作を実行できます。
| 名前 | タイプ | 説明 |
|---|---|---|
| tableName | 文字列 | ページネータを作成するテーブルの名前。 |
| 構成 | フェッチ構成 | 使用するフィルター、ページネーションページサイズ制限、取得するフィールド、およびフィールドに含めるものを指定した構成。 |
| タイプ | 説明 |
|---|---|
| paginator<ByteArray> | 成功:要求されたレコードの ByteArray 出力を使用するページネータ。Paginator オブジェクト内の関数を使用して、返されたレコードを移動できます。 エラー:NowDataError |
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: 文字列, tableName: 文字列, configuration: FieldReadConfiguration?)
指定されたテーブルから指定されたレコードを取得します。
| 名前 | タイプ | 説明 |
|---|---|---|
| sysId | 文字列 | 取得するレコードの sys_id。 |
| tableName | 文字列 | インシデントや資産など、指定されたレコードが配置されているテーブルの名前。 |
| 構成 | FieldReadConfiguration | オプション。取得するフィールドとフィールドに含める内容を指定する構成。 |
| タイプ | 説明 |
|---|---|
| call<ByteArray> | 成功:取得したレコードを含む ByteArray。この情報を、必要なデータモデルに変換できます。 エラー:NowDataError |
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: 文字列, configuration: FieldReadConfiguration?)
指定されたテーブルから SLL レコードレコードを取得します。
| 名前 | タイプ | 説明 |
|---|---|---|
| tableName | 文字列 | インシデントや資産などのレコードの取得元のテーブルの名前。 |
| 構成 | FieldReadConfiguration | オプション。取得するフィールドとフィールドに含める内容を指定する構成。 |
| タイプ | 説明 |
|---|---|
| call<ByteArray> | 成功:取得されたレコードを含む ByteArray。この情報を、必要なデータモデルに変換できます。 エラー:NowDataError |
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: 文字列, tableName: 文字列, フィールド: マップ<文字列, 文字列>, writeOptions: FieldWriteOptions?, configuration: FieldReadConfiguration?)
指定されたテーブルの指定されたレコードを指定されたフィールドで更新します。
| 名前 | タイプ | 説明 |
|---|---|---|
| tableName | 文字列 | レコードを更新するテーブルの名前。 |
| フィールド | Map<String, String> | レコード内のすべてのフィールドを更新するためのキーと値のペア。 注: レコード内のすべてのフィールドは更新できない場合があります。たとえば、 プリフィックス sys_ を持つフィールドは、通常、自動的に生成されるシステムパラメーターであり、更新することはできません。指定されておらず、システムによって自動生成されないフィールドは、関連付けられたデータタイプの null 値に設定されます。 |
| 書き込みオプション | フィールド書き込みオプション | オプション。値を表示値として格納するかどうか、システムフィールドの自動生成を抑制するかどうかなど、フィールドに設定するオプションを記述します。 デフォルト:null - オプションが選択されていません |
| 構成 | FieldReadConfiguration | オプション。更新するフィールドとフィールドに含めるフィールドを指定する構成。 デフォルト：null |
| タイプ | 説明 |
|---|---|
| call<ByteArray> | 成功:更新されたレコードを含む ByteArray。この情報を、必要なデータモデルに変換できます。 エラー:NowDataError |
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") })
}