• 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> The APIs of this module can be used only in the FA model.
9
10## Modules to Import
11
12```ts
13import ability from '@ohos.ability.ability';
14```
15
16**System capability**: SystemCapability.Ability.AbilityRuntime.FAModel
17
18| Name      | Type |     Mandatory   |       Description  |
19| --------  | --------  | --------    | --------    |
20| uri?      | string    |      No   | URI of the DataAbility. Example: 'dataability:///com.example.xxx.xxxx'. |
21| count?     | number    |      No   | Number of rows affected by the operation. |
22
23**Example**
24
25```ts
26import featureAbility from '@ohos.ability.featureAbility';
27
28// Perform database operations in batches.
29function executeBatchOperation() {
30    let dataAbilityUri = ('dataability:///com.example.myapplication.TestDataAbility');
31    let DAHelper: ability.DataAbilityHelper;
32    try {
33        DAHelper = featureAbility.acquireDataAbilityHelper(dataAbilityUri);
34        if (DAHelper === null) {
35            console.error('DAHelper is null');
36        }
37    } catch (err) {
38        console.error('acquireDataAbilityHelper fail, error: ${JSON.stringify(err)}');
39    }
40
41    let valueBucket = {
42        'name': 'DataAbilityHelperTest',
43        'age': 24,
44        'salary': 2024.20,
45    };
46    let operations = [
47    {
48        uri: dataAbilityUri,
49        type: featureAbility.DataAbilityOperationType.TYPE_INSERT,
50        valuesBucket: valueBucket,
51        predicates: null,
52        expectedCount: 1,
53        PredicatesBackReferences: {},
54        interrupted: true,
55    },
56    {
57        uri: dataAbilityUri,
58        type: featureAbility.DataAbilityOperationType.TYPE_INSERT,
59        valuesBucket: valueBucket,
60        predicates: null,
61        expectedCount: 1,
62        PredicatesBackReferences: {},
63        interrupted: true,
64    }
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 => {
75            console.error('executeBatch error: ${JSON.stringify(err)}');
76        });
77    } catch (err) {
78        console.error('executeBatch error: ${JSON.stringify(err)}');
79    }
80}
81```
82