add doc description

Signed-off-by: Nxinking129 <xinxin13@huawei.com>

zh-cn/application-dev/reference/apis/js-apis-app-form-formHost.md

@@ -1865,3 +1865,197 @@ try {
 }
 ```
 
+## getRunningFormInfosByFilter
+
+function getRunningFormInfosByFilter(formProviderFilter: formInfo.formProviderFilter): Promise<Array<formInfo.RunningFormInfo>>
+
+根据提供方信息查询卡片已有的使用方列表信息。使用Promise异步回调。
+
+**需要权限**：ohos.permission.REQUIRE_FORM
+
+**系统能力**：SystemCapability.Ability.Form
+
+**参数：**
+
+| 参数名      | 类型            | 必填 | 说明                             |
+| ----------- | --------------- | ---- | -------------------------------- |
+| formProviderFilter     | formInfo.formProviderFilter | 是   | 卡片提供方应用信息。 |
+
+**返回值：**
+
+| 类型                | 说明                      |
+| ------------------- | ------------------------- |
+| Promise<Array<formInfo.RunningFormInfo>> | Promise对象，返回查询到的使用方列表信息。 |
+
+**错误码：**
+
+| 错误码ID | 错误信息 |
+| -------- | -------- |
+| 201 | Permissions denied. |
+| 202 | The application is not a system application. |
+| 401 | If the input parameter is not valid parameter. |
+| 16500050 | An IPC connection error happened. |
+| 16501000  | An internal functional error occurred. |
+| 以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。 |                    |
+
+```ts
+import formHost from '@ohos.app.form.formHost';
+
+let formInstanceFilter = {
+  bundleName: "com.example.formprovide",
+  abilityName: "EntryFormAbility",
+  formName: "widget",
+  moduleName: "entry"
+}
+try {
+  formHost.getRunningFormInfosByFilter(formInstanceFilter).then(data1 => {
+    console.info('formHost getRunningFormInfosByFilter return err :');
+  }).catch((error) => {
+    console.error(`error, code: ${error.code}, message: ${error.message}`);
+  });
+} catch(error) {
+  console.error(`catch error, code: ${error.code}, message: ${error.message}`);
+}
+```
+
+## getRunningFormInfosByFilter
+
+function getRunningFormInfosByFilter(formProviderFilter: formInfo.formProviderFilter, callback: AsyncCallback<Array<formInfo.FormInfo>>): void
+
+根据提供方信息查询卡片已有的使用方列表信息。使用callback异步回调。
+
+**需要权限**：ohos.permission.REQUIRE_FORM
+
+**系统能力**：SystemCapability.Ability.Form
+
+**参数：**
+
+| 参数名      | 类型            | 必填 | 说明                             |
+| ----------- | --------------- | ---- | -------------------------------- |
+| formProviderFilter     | formInfo.formProviderFilter | 是   | 卡片提供方应用信息。 |
+| callback | AsyncCallback<Array<[formInfo.RunningFormInfo](js-apis-app-form-formInfo.md)>> | 是 | 回调函数。返回查询到的使用方列表信息，error为undefined，data为查询到的使用方列表信息；否则为错误对象。 |
+
+**错误码：**
+
+| 错误码ID | 错误信息 |
+| -------- | -------- |
+| 201 | Permissions denied. |
+| 202 | The application is not a system application. |
+| 401 | If the input parameter is not valid parameter. |
+| 16500050 | An IPC connection error happened. |
+| 16501000  | An internal functional error occurred. |
+| 以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。 |                    |
+
+```ts
+import formHost from '@ohos.app.form.formHost';
+
+let formInstanceFilter = {
+  bundleName: "com.example.formprovide",
+  abilityName: "EntryFormAbility",
+  formName: "widget",
+  moduleName: "entry"
+}
+try {
+  formHost.getRunningFormInfosByFilter(formInstanceFilter,(error, data) => {
+    if (error) {
+      console.error(`error, code: ${error.code}, message: ${error.message}`);
+    } else {
+      console.log('formHost getRunningFormInfosByFilter, data: ${JSON.stringify(data)}');
+    }
+  });
+} catch(error) {
+  console.error(`catch error, code: ${error.code}, message: ${error.message}`);
+}
+```
+
+## getRunningFormInfoById
+
+function getRunningFormInfoById(formId: string): Promise<Array<formInfo.RunningFormInfo>>
+
+根据formId查询卡片已有的使用方列表信息。使用Promise异步回调。
+
+**需要权限**：ohos.permission.REQUIRE_FORM
+
+**系统能力**：SystemCapability.Ability.Form
+
+**参数：**
+
+| 参数名      | 类型            | 必填 | 说明                             |
+| ----------- | --------------- | ---- | -------------------------------- |
+| formId     | string | 是   | 卡片标识。 |
+
+**返回值：**
+
+| 类型                | 说明                      |
+| ------------------- | ------------------------- |
+| Promise<Array<formInfo.RunningFormInfo>> | Promise对象，返回查询到的使用方列表信息。 |
+
+**错误码：**
+
+| 错误码ID | 错误信息 |
+| -------- | -------- |
+| 201 | Permissions denied. |
+| 202 | The application is not a system application. |
+| 401 | If the input parameter is not valid parameter. |
+| 16500050 | An IPC connection error happened. |
+| 16501000  | An internal functional error occurred. |
+| 以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。 |                    |
+
+```ts
+import formHost from '@ohos.app.form.formHost';
+let formId = '12400633174999288';
+try {
+  formHost.getRunningFormInfoById(formId).then(data1 => {
+    console.info('formHost getRunningFormInfoById return err :');
+  }).catch((error) => {
+    console.error(`error, code: ${error.code}, message: ${error.message}`);
+  });
+} catch(error) {
+  console.error(`catch error, code: ${error.code}, message: ${error.message}`);
+}
+```
+
+## getRunningFormInfoById
+
+function getRunningFormInfoById(formId: string, callback: AsyncCallback<Array<formInfo.FormInfo>>): void
+
+根据提供方信息查询卡片已有的使用方列表信息。使用callback异步回调。
+
+**需要权限**：ohos.permission.REQUIRE_FORM
+
+**系统能力**：SystemCapability.Ability.Form
+
+**参数：**
+
+| 参数名      | 类型            | 必填 | 说明                             |
+| ----------- | --------------- | ---- | -------------------------------- |
+| formId     | string | 是   | 卡片标识。 |
+| callback | AsyncCallback<Array<[formInfo.RunningFormInfo](js-apis-app-form-formInfo.md)>> | 是 | 回调函数。返回查询到的使用方列表信息，error为undefined，data为查询到的使用方列表信息；否则为错误对象。 |
+
+**错误码：**
+
+| 错误码ID | 错误信息 |
+| -------- | -------- |
+| 201 | Permissions denied. |
+| 202 | The application is not a system application. |
+| 401 | If the input parameter is not valid parameter. |
+| 16500050 | An IPC connection error happened. |
+| 16501000  | An internal functional error occurred. |
+| 以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。 |                    |
+
+```ts
+import formHost from '@ohos.app.form.formHost';
+
+let formId = '12400633174999288';
+try {
+  formHost.getRunningFormInfoById(formId,(error, data) => {
+    if (error) {
+      console.error(`error, code: ${error.code}, message: ${error.message}`);
+    } else {
+      console.log('formHost getRunningFormInfoById, data: ${JSON.stringify(data)}');
+    }
+  });
+} catch(error) {
+  console.error(`catch error, code: ${error.code}, message: ${error.message}`);
+}
+```
\ No newline at end of file

zh-cn/application-dev/reference/apis/js-apis-app-form-formInfo.md

@@ -137,4 +137,34 @@ import formInfo from '@ohos.app.form.formInfo';
 | 名称        |  值   | 说明         |
 | ----------- | ---- | ------------ |
 | FORM_VISIBLE | 1   | 表示卡片为可见。 |
-| FORM_INVISIBLE   | 2   | 表示卡片为不可见。 |
\ No newline at end of file
+| FORM_INVISIBLE   | 2   | 表示卡片为不可见。 |
+
+## RunningFormInfo 
+
+卡片使用方信息
+
+**系统能力**：SystemCapability.Ability.Form
+
+| 名称        | 类型                 | 可读    | 可写    | 说明                                                         |
+| ----------- | -------- | -------- | -------------------- | ------------------------------------------------------------ |
+| formId  | string               | 是    | 否     | 卡片标识。                   |
+| bundleName  | string               | 是    | 否     | 提供方卡片所属包的Bundle名称。                   |
+| hostBundleName  | string               | 是    | 否     | 使用方卡片所属包的Bundle名称。                   |
+| visibilityType  | [VisibilityType](#visibilitytype)               | 是    | 否     | 卡片当前可见类型枚举。                   |
+| moduleName  | string               | 是    | 否     | 卡片所属模块的模块名称。                      |
+| abilityName | string               | 是    | 否     | 卡片所属的Ability名称。                       |
+| formName        | string               | 是    | 否     | 卡片名称。                                 |
+| dimension | number               | 是    | 否     | 卡片规格。   |
+
+## formProviderFilter 
+
+卡片提供方信息
+
+**系统能力**：SystemCapability.Ability.Form
+
+| 名称        | 类型                 | 可读    | 可写    | 说明                                                         |
+| ----------- | -------- | -------- | -------------------- | ------------------------------------------------------------ |
+| bundleName  | string               | 是    | 否     | 提供方卡片所属包的Bundle名称。                   |
+| formName        | string               | 是    | 否     | 卡片名称。                                 |
+| moduleName  | string               | 是    | 否     | 卡片所属模块的模块名称。                      |
+| abilityName | string               | 是    | 否     | 卡片所属的Ability名称。                       |
\ No newline at end of file