# 6 Specific interface for specified field type (limit specified field type available)

## 1 extension browse button number interface parameter value

> Limit condition: only applicable to non-date browse button type
>
> Scenario: control browse button optional data range, limit range, dependent form field filter data range, etc.; for Lenovo input range and pop-up window selection range;
>
> Implementation: interface expansion parameters will be submitted to the server interface through url parameters, need to modify the browse button interface class to take effect
>
> *appendBrowserDataUrlParam：function (field Mark, jsonParam)*

Parameter Description

| Parameter | type   | Required | Remarks |
| --------- | ------ | -------- | ------- |
| fieldMark | String | Yes      | field   |
| jsonParam | JSON   | Yes      | url     |

```javascript
 WfForm.appendBrowserDataUrlParam("field395",{"customerid ":"2"});
 // Add url parameter customerid to browse button 395 when requesting background data
```

## 2 Gets the display valye for browser buttom

> Limit condition: Only for Non-date browse button only
>
> Get multiple browse button value, split string with splitChar
>
> *getBrowserShowName：function(fieldMark, splitChar)*

Parameter Description

| Parameter | type   | Required | Remarks                                                           |
| --------- | ------ | -------- | ----------------------------------------------------------------- |
| fieldMark | String | Yes      | field designation, format field${ field ID}\_field${ line number} |
| splitChar | String | No       | delimiter, separated by comma by default                          |

```javascript
 WfForm.getBrowserShowName("field110");
 // Gets a comma-separated browse button field display value
```

## 3 Remove the option value from slection box

> Limit condition: Only for selection box
>
> *removeSelectOption：function only (fieldMark, optionkeys)*

Parameter Description

| Parameter  | type   | Required | Remarks                                                               |
| ---------- | ------ | -------- | --------------------------------------------------------------------- |
| fieldMark  | String | Yes      | field designation, format field${ field ID}\_field${ line number}     |
| optionKeys | String | Yes      | Option options key values to be removed, multiple separated by commas |

```javascript
 WfForm.removeSelectOption("field112","3,4");
 // Removes the option in id selection box with a value of 3/4ja
```

## 4 Control selection box field option

> Limit condition: Only for selection box
>
> *controlSelectOption：function only (fieldMark, optionkeys)*

Parameter Description

| Parameter  | type   | Required | Remarks                                                           |
| ---------- | ------ | -------- | ----------------------------------------------------------------- |
| fieldMark  | String | Yes      | field designation, format field${ field ID}\_field${ line number} |
| optionKeys | String | Yes      | Fully control the range of options in the selection box           |

```javascript
WfForm.controlSelectOption("field112","1,2,4");
// The control selection box shows only 1/2/4 options
WfForm.controlSelectOption("field112","");
// Clear all options in the box
```

## 5 Gets the display value of the selection box

> Limit condition: Only for selection box
>
> Get multiple selection box value, split string with splitChar
>
> *getSelectShowName：function(fieldMark, splitChar)*

Parameter Description

| Parameter | type   | Required | Remarks                                                                       |
| --------- | ------ | -------- | ----------------------------------------------------------------------------- |
| fieldMark | String | Yes      | field designation, format field${ field ID}\_field${ line number}             |
| splitChar | String | No       | Separator, separated by comma by default (used only with multiple checkboxes) |

```javascript
 WfForm.getSelectShowName("field110_3");
 // Gets the value displayed in the field of the selection box
```

## 6 When text field is editable, if empty value display default gray prompt, mouse click input prompt disappear

> Limit condition: only for single line text, integer, floating, multi-line text field (non-html) field type; support main field and detail field
>
> *setTextFieldEmptyShowContent：function (fieldMark, showContent)*

Parameter Description

| Parameter   | type   | Required | Remarks                                                           |
| ----------- | ------ | -------- | ----------------------------------------------------------------- |
| fieldMark   | String | Yes      | field designation, format field${ field ID}\_field${ line number} |
| showContent | String | Yes      | Hint information displayed when null, gray                        |

```javascript
jQuery(document).ready(function(){
 WfForm.setTextFieldEmptyShowContent("field 27555"," single text default prompt information 1");
 WfForm.setTextFieldEmptyShowContent("field 27566"," Multi-text default prompt 2");
 WfForm.setTextFieldEmptyShowContent("field222_0"," detail field prompt information ");
 // need to be used in conjunction with additional row events in interface 5.9
});
```

## 7 The props override browse button component

> Supports only the browse button type, please use carefully, will completely overrides the browse button props
>
> only passes props, the specific passed properties implement what requirements are controlled by internal function
>
> *overrideBrowserProp: function(fieldMark,jsonParam)*

Parameter Description

| Parameter | type   | Required | Remarks                                                           |
| --------- | ------ | -------- | ----------------------------------------------------------------- |
| fieldMark | String | Yes      | field designation, format field${ field ID}\_field${ line number} |
| jsonParam | JSON   | Yes      | Extending or copying props parameters                             |

```javascript
Example WfForm.overrideBrowserProp("field111"){
 onBeforeFocusCheck：function (success, failure){/***/}
});// Copy the props of the Browse button field 111
```

## 8 Control Date Browse button date range

> Minimum version: KB900190501
>
> Only support date type, control manual selection of date range
>
> *controlDateRange：function (fieldMark, start, end)*

Parameter Description

| Parameter | type      | Required                               | Remarks                                                                                                                                        |
| --------- | --------- | -------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| fieldMark | String    | Yes                                    | field designation, format field${ field ID}\_field${ line number}                                                                              |
| start     | String    | Yes                                    | Support for two formats, the first standard date format, such as 2019-05-28, the second integer, how many days before / after the current date |
| end       | String No | Format and start parameters consistent |                                                                                                                                                |

```javascript
Example WfForm.controlDateRange("field111",-5,10);
// Limit the optional range of dates, five days forward and 10 days later
WfForm.controlDateRange("field111",0,'2019-12-31');
// Limit today to this year
WfForm.controlDateRange("field222_0",'2019-05-01','2019-05-31');
// detail field, limiting the month
```

## 9 Control whether radio button printing only shows select text

> Minimum version: KB900190501
>
> only supports single line text box in the selection box, the printing scnario, whether only the selected text is displayed, and the display empty if no selected
>
> *controlRadioPrintText: function(fieldid)*

Parameter Description

| Parameter | type   | Required | Remarks                                               |
| --------- | ------ | -------- | ----------------------------------------------------- |
| fieldMark | String | Yes      | fields id, format ${fields ID}, support detail fields |

Example

```javascript
WfForm.controlRadioPrintText("12580");
// radio field 12580 print text
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ec9help.weaver.com.co/1-ec9-workflow-engine-form-api/6-specific-interface-for-specified-field-type-limit-specified-field-type-available.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.