• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# DataAbilityResult
2
3The DataAbilityResult module defines the operation result on DataAbilities. When you call [executeBatch](js-apis-inner-ability-dataAbilityHelper.md#dataabilityhelperexecutebatch) to operate the database, the operation result is returned through the **DataAbilityResult** object.
4
5> **NOTE**
6>
7> The initial APIs of this module are supported since API version 7. Newly added APIs will be marked with a superscript to indicate their earliest API version.
8>
9> The APIs of this module can be used only in the FA model.
10
11## Modules to Import
12
13```ts
14import ability from '@ohos.ability.ability';
15```
16
17## Attributes
18
19**System capability**: SystemCapability.Ability.AbilityRuntime.FAModel
20
21| Name     | Type | Read Only | Optional   |       Description  |
22| -------- | -------- | -------- | -------- | -------- |
23| uri      | string    | No | Yes   | URI of the DataAbility. Example: 'dataability:///com.example.xxx.xxxx'. |
24| count     | number   | No | Yes   | Number of rows affected by the operation. |
25
26**Example**
27
28<!--code_no_check_fa-->
29```ts
30import ability from '@ohos.ability.ability';
31import featureAbility from '@ohos.ability.featureAbility';
32import rdb from '@ohos.data.rdb';
33import { BusinessError } from '@ohos.base';
34
35// Perform database operations in batches.
36function executeBatchOperation() {
37    let dataAbilityUri = ('dataability:///com.example.myapplication.TestDataAbility');
38    let DAHelper: ability.DataAbilityHelper;
39    DAHelper = featureAbility.acquireDataAbilityHelper(dataAbilityUri);
40
41    let valueBucket: rdb.ValuesBucket = {
42        'name': 'DataAbilityHelperTest',
43        'age': 24,
44        'salary': 2024.20,
45    };
46    let predicateBackReferences = new Map<number, number>()
47    predicateBackReferences.set(1, 1)
48
49    let operations: Array<ability.DataAbilityOperation> = [
50        {
51            uri: dataAbilityUri,
52            type: featureAbility.DataAbilityOperationType.TYPE_INSERT,
53            valuesBucket: valueBucket,
54            expectedCount: 1,
55            predicatesBackReferences: predicateBackReferences,
56            interrupted: true,
57        },
58        {
59            uri: dataAbilityUri,
60            type: featureAbility.DataAbilityOperationType.TYPE_INSERT,
61            valuesBucket: valueBucket,
62            expectedCount: 1,
63            predicatesBackReferences: predicateBackReferences,
64            interrupted: true,
65        }
66    ];
67    try {
68        DAHelper.executeBatch(dataAbilityUri, operations).then((data) => {
69            for (let i = 0; i < data.length; i++) {
70                let dataAbilityResult: ability.DataAbilityResult = data[i];
71                console.log(`dataAbilityResult.uri: ${dataAbilityResult.uri}`);
72                console.log(`dataAbilityResult.count: ${dataAbilityResult.count}`);
73            }
74        }).catch((err: BusinessError) => {
75            console.error(`executeBatch error: ${JSON.stringify(err)}`);
76        });
77    } catch (err) {
78        console.error(`executeBatch error: ${JSON.stringify(err as BusinessError)}`);
79    }
80}
81```
82