!1553 1288 完成：application-dev/reference/apis/js-apis-settings.md

Merge pull request !1553 from ester.zhou/TR-1288

en/application-dev/reference/apis/js-apis-settings.md

+# Settings
+
+> ![icon-note.gif](public_sys-resources/icon-note.gif) **NOTE:**
+> The initial APIs of this module are supported since API version 8. Updates will be marked with a superscript to indicate their earliest API version.
+
+
+This module provides APIs for setting data items.
+
+
+## Modules to Import
+
+```
+import settings from '@ohos.settings';
+```
+
+
+## Required Permissions
+
+None
+
+
+## settings.getUri
+
+getUri(name: string): string
+
+Obtains the URI of a data item.
+
+- Parameters
+  | Name| Type| Mandatory| Description|
+  | -------- | -------- | -------- | -------- |
+  | name | string | Yes| Name of the target data item. Data items can be classified as follows:<br><ul><li>Existing data items in the database, for example:<br></li><ul><li>Brightness: 'settings.screen.brightness' <br> </li> <li>Time format: 'settings.time.format' <br> </li></ul> <li>Custom data items</li></ul>|
+
+- Return value
+  | Type| Description|
+  | -------- | -------- |
+  | string | URI of the data item.|
+
+- Example
+  ```
+   // Obtain the URI of a data item.
+   let urivar = settings.getUri('settings.screen.brightness');  
+  ```
+
+
+## settings.getValue
+
+getValue(dataAbilityHelper: DataAbilityHelper, name: string, defValue: string): string
+
+Obtains the value of a data item.
+
+- Parameters
+  | Name| Type| Mandatory| Description|
+  | -------- | -------- | -------- | -------- |
+  | dataAbilityHelper | [DataAbilityHelper](js-apis-dataAbilityHelper.md) | Yes| **DataAbilityHelper** class.|
+  | name | string | Yes| Name of the target data item. Data items can be classified as follows:<br><ul><li>Existing data items in the database, for example:<br></li><ul><li>Brightness: 'settings.screen.brightness' <br> </li> <li>Time format: 'settings.time.format' <br> </li></ul> <li>Custom data items</li></ul>|
+  | defValue | string | Yes| Default value This parameter is user-defined. If it is not found in the database, the default value is returned.|
+
+- Return value
+  | Type| Description|
+  | -------- | -------- |
+  | string | Value of the data item.|
+
+- Example
+  ```
+  import featureAbility from '@ohos.featureAbility';
+  
+  // Obtain the value of 'settings.screen.brightness' (this data item already exists in the database).
+  let brightness = 'settings.screen.brightness';
+  let uri = settings.getUri(brightness);
+  let helper = featureAbility.acquireDataAbilityHelper(uri);
+  let value = settings.getValue(helper, brightness, '10');
+  ```
+
+
+## settings.setValue
+
+setValue(dataAbilityHelper: DataAbilityHelper, name: string, value: string): boolean
+
+Sets the value of a data item.
+If the specified data item exists in the database, the **setValue** method updates the value of the data item. If the data item does not exist in the database, the **setValue** method inserts the data item into the database.
+
+To use this method, you must have the **ohos.permission.WRITE_SYSTEM_SETTING** permission.
+
+- Parameters
+  | Name| Type| Mandatory| Description|
+  | -------- | -------- | -------- | -------- |
+  | dataAbilityHelper | [DataAbilityHelper](js-apis-dataAbilityHelper.md) | Yes| **DataAbilityHelper** class.|
+  | name | string | Yes| Name of the target data item. Data items can be classified as follows:<br><ul><li>Existing data items in the database, for example:<br></li><ul><li>Brightness: 'settings.screen.brightness' <br> </li> <li>Time format: 'settings.time.format' <br> </li></ul> <li>Custom data items</li></ul>|
+  | value | string | Yes| Value of the data item.|
+
+- Return value
+  | Type| Description|
+  | -------- | -------- |
+  | boolean | Result indicating whether the value is set successfully. Returns **true** if the value is set successfully; returns **false** otherwise.|
+
+- Example
+  ```
+  import featureAbility from '@ohos.featureAbility';
+  
+  // Update the value of 'settings.screen.brightness'. (As this data item exists in the database, the setValue method
+     will update the value of the data item.)
+  let brightness = 'settings.screen.brightness';
+  let uri = settings.getUri(brightness);
+  let helper = featureAbility.acquireDataAbilityHelper(uri);
+  let ret = settings.setValue(helper, brightness, '100');
+  ```