Hancom Technology Support Center

https://tech.hancomins.com/
Admin
Hancom Technology Support Center is a comprehensive technical support portal providing FAQs, product...
Tokens:235,546
Snippets:2,377
Trust Score:5.9
Update:6 months ago
Show doc for...
Tokens:
Raw
### Call Report Window Print Setup

Source: https://tech.hancomins.com/up/api-e50/symbols/Report.html

Launches the general print setup screen for the report.

```javascript
report.printWindowView();
```

--------------------------------

### FAQ - Crosstab Concept and Basic Setup

Source: https://tech.hancomins.com/faq?cate_code=1&mid=8&no=1250660

Explanation of the crosstab concept and how to perform basic setup.

```APIDOC
## FAQ: Crosstab Concept and Basic Setup

### Description
Provides an explanation of the crosstab concept and guidance on basic setup procedures.
```

--------------------------------

### exePrintVersionInfo

Source: https://tech.hancomins.com/up/api-e50/symbols/Report.html

If there is an update for the EXE print program, this function specifies the updated version in the code and displays an installation guide window.

```APIDOC
## exePrintVersionInfo(strVersion)

### Description
If there is an update for the EXE print program, this function specifies the updated version in the code and displays an installation guide window.

### Method
Not specified (likely a function call within a JavaScript context)

### Parameters
#### Path Parameters
- **strVersion** (String) - Required - The version information of the EXE print program.

### Since
Not specified
```

--------------------------------

### Call Report HWP Print Setup

Source: https://tech.hancomins.com/up/api-e50/symbols/Report.html

Launches the print setup screen for the report using HWP format.

```javascript
report.printHWPView();
```

--------------------------------

### Set Guide Text Visibility

Source: https://tech.hancomins.com/up/api-e50/symbols/EFormSignGroup.html

Configures whether the guide text remains visible after signing.

```javascript
signGroup.setGuideTextVisible(true);
```

--------------------------------

### Call Report PDF Print Setup

Source: https://tech.hancomins.com/up/api-e50/symbols/Report.html

Launches the print setup screen for the report in PDF format.

```javascript
report.printView();
```

--------------------------------

### Get Selectbox Guide Text

Source: https://tech.hancomins.com/up/api-e50/symbols/EFormSelectbox.html

Retrieve the guide text string displayed for the selectbox. This text often serves as a placeholder or hint.

```javascript
var text = SelectBox.getGuideText();
```

--------------------------------

### Call Report HTML Print Setup

Source: https://tech.hancomins.com/up/api-e50/symbols/Report.html

Launches the print setup screen for the report using HTML format.

```javascript
report.printHTMLView();
```

--------------------------------

### Call Report EXE Print Setup

Source: https://tech.hancomins.com/up/api-e50/symbols/Report.html

Launches the print setup screen for the report using an external EXE program, primarily for Windows environments.

```javascript
report.printEXEView();
```

--------------------------------

### Set Guide Background Color

Source: https://tech.hancomins.com/up/api-e50/symbols/EFormRadiobox.html

Sets the background color and alpha transparency for the radiobox guide.

```javascript
radiobox.setGuideBGColor(0, 0, 0, 0.2);
```

--------------------------------

### Create OOF Report Example

Source: https://tech.hancomins.com/up/api50/symbols/createOOFReport.html

Use this example to create a report. Ensure you have the necessary XML data and a target DOM element.

```javascript
var report = null;

         report = createReport('./Clip.jsp', xmlStringOOF, targetDOM_Div);

         report.view();
```

--------------------------------

### Set Guide Background Color

Source: https://tech.hancomins.com/up/api-e50/symbols/EFormCalendar.html

Configures the background color and alpha transparency for the calendar guide.

```javascript
calendar.setGuideBGColor(0, 0, 0, 0.2);
```

--------------------------------

### Set Guide Background Color

Source: https://tech.hancomins.com/up/api-e50/symbols/EFormButton.html

Configures the background color and alpha transparency for the button's guide.

```javascript
  button의 가이드 배경 색상을 설정하는 함수입니다.   

button.setGuideBGColor(0, 0, 0, 0.2);
```

--------------------------------

### setGuideBGColor

Source: https://tech.hancomins.com/up/api-e50/symbols/EFormVideo.html

Sets the background color for the video guide.

```APIDOC
## setGuideBGColor

### Description
Sets the background color for the video guide.

### Parameters
- **nRed** (Number) - Required - 0~255
- **nGreen** (Number) - Required - 0~255
- **nBlue** (Number) - Required - 0~255
- **nAlpha** (Number) - Required - 0~1
- **isSendData** (Any) - Optional

### Request Example
video.setGuideBGColor(0, 0, 0, 0.2);
```

--------------------------------

### Call Report Mobile PDF Print Setup

Source: https://tech.hancomins.com/up/api-e50/symbols/Report.html

Launches the print setup screen for the report in a mobile PDF format.

```javascript
report.printMobileView();
```

--------------------------------

### FAQ - Formula Field Usage

Source: https://tech.hancomins.com/faq?cate_code=1&mid=8&no=1250660

Guide on how to use formula fields in CLIP Report, including available functions and examples.

```APIDOC
## FAQ: Formula Field Usage

### Description
This guide explains how to use formula fields in CLIP Report, supporting JavaScript syntax.

### Available Functions

*   **SUM**: Calculates the sum.
*   **Avg**: Calculates the average.
*   **Count**: Counts the number of items.
*   **Min**: Finds the minimum value.
*   **MAX**: Finds the maximum value.
*   **Var**: Calculates the variance.
*   **varp**: Calculates the population variance.
*   **Stddev**: Calculates the standard deviation.
*   **Stddevp**: Calculates the population standard deviation.
*   **Field**: Retrieves the field value of the current record.
*   **Fieldbyint**: Retrieves the field value of the current record as an integer.
*   **prev**: Retrieves the field value of the previous record.
*   **Next**: Retrieves the field value of the next record.
*   **Fieldat**: Retrieves the field value of the Nth record.
*   **Format**: Sets the output format.

### Examples

**Example 1 (SUM with condition):**
```javascript
return rexpert.sum(0, "data.Production", 0, "", "and(data.ID=3,data.Factory=Paris)");
```

**Example 2 (SUM with OR condition):**
```javascript
return rexpert.sum(0, "data.Production", 0, "", "or(data.ID=3,data.Factory=Paris)");
```

**Example 3 (Get Field Value):**
```javascript
return rexpert.field("data.Factory");
```

**Example 4 (Get Field Value at Nth Record):**
```javascript
return rexpert.fieldat("data.Factory", 6);
```

**Example 5 (Format Field Value):**
```javascript
var data = rexpert.field("data.Badness");
return rexpert.format(data, "#,##0");
```

**Example 6 (Format Field Value - alternative):**
```javascript
return rexpert.format(rexpert.field("data.Badness"), "#,##0");
```
```

--------------------------------

### setGuideBGColor

Source: https://tech.hancomins.com/up/api-e50/symbols/EFormInput.html

Sets the background color for the guide.

```APIDOC
## setGuideBGColor

### Description
Sets the background color for the inputbox guide.

### Parameters
- **nRed** (Number) - Required - 0-255
- **nGreen** (Number) - Required - 0-255
- **nBlue** (Number) - Required - 0-255
- **nAlpha** (Number) - Required - 0-1
- **isSendData** (Boolean) - Required
```

--------------------------------

### Set Video Guide Background Color

Source: https://tech.hancomins.com/up/api-e50/symbols/EFormVideo.html

Configure the background color for the video guide. Accepts RGBA values for precise color and transparency control.

```javascript
video.setGuideBGColor(0, 0, 0, 0.2);
```

--------------------------------

### Set Guide Text

Source: https://tech.hancomins.com/up/api-e50/symbols/EFormSignGroup.html

Updates the content of the signGroup guide text.

```javascript
signGroup.setGuideText("서명완료");
```

--------------------------------

### Set Guide Background Color

Source: https://tech.hancomins.com/up/api-e50/symbols/EFormInput.html

Sets the background color for the input box guide using RGBA values.

```javascript
inputbox.setGuideBGColor(0, 0, 0, 0.2);
```

--------------------------------

### setGuideBGColor

Source: https://tech.hancomins.com/up/api-e50/symbols/EFormButton.html

Sets the guide background color for a button.

```APIDOC
## setGuideBGColor(nRed, nGreen, nBlue, nAlpha, isSendData)

### Description
Sets the guide background color for a button.

### Method
Not applicable (JavaScript function)

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
None

### Request Example
```javascript
button.setGuideBGColor(0, 0, 0, 0.2);
```

### Response
#### Success Response (200)
None

#### Response Example
None

### Parameters
* **nRed** (Number) - 0~255 - Red component of the color.
* **nGreen** (Number) - 0~255 - Green component of the color.
* **nBlue** (Number) - 0~255 - Blue component of the color.
* **nAlpha** (Number) - 0~1 - Alpha (transparency) component of the color.
* **isSendData** (any) - Not specified
```

--------------------------------

### setGuideBGColor

Source: https://tech.hancomins.com/up/api-e50/symbols/EFormCalendar.html

Sets the background color for the calendar guide.

```APIDOC
## setGuideBGColor(nRed, nGreen, nBlue, nAlpha, isSendData)

### Description
Sets the background color for the calendar guide.

### Method
`setGuideBGColor`

### Parameters
#### Path Parameters
- **nRed** (Number) - Required - Red component of the color (0-255).
- **nGreen** (Number) - Required - Green component of the color (0-255).
- **nBlue** (Number) - Required - Blue component of the color (0-255).
- **nAlpha** (Number) - Required - Alpha (transparency) component of the color (0-1).
- **isSendData** (any) - Optional - Parameter for sending data.

### Request Example
```javascript
calendar.setGuideBGColor(0, 0, 0, 0.2);
```

### Response
This method does not return a value.
```

--------------------------------

### radiobox.setGuideBGColor()

Source: https://tech.hancomins.com/up/api-e50/symbols/EFormRadiobox.html

Sets the guide background color for the radiobox.

```APIDOC
## setGuideBGColor(nRed, nGreen, nBlue, nAlpha, isSendData)

### Description
Sets the guide background color for the radiobox.

### Parameters
#### Request Body
- **nRed** (Number) - Required - 0~255
- **nGreen** (Number) - Required - 0~255
- **nBlue** (Number) - Required - 0~255
- **nAlpha** (Number) - Required - 0~1
- **isSendData** (Any) - Optional

### Request Example
radiobox.setGuideBGColor(0, 0, 0, 0.2);
```

--------------------------------

### setGuideBGColor

Source: https://tech.hancomins.com/up/api-e50/symbols/EFormSignGroup.html

Sets the background color for the guide area.

```APIDOC
## setGuideBGColor(nRed, nGreen, nBlue, nAlpha, isSendData)

### Description
Sets the background color and transparency for the guide area.

### Parameters
- **nRed** (Number) - Required - 0-255.
- **nGreen** (Number) - Required - 0-255.
- **nBlue** (Number) - Required - 0-255.
- **nAlpha** (Number) - Required - 0-1.
- **isSendData** (Boolean) - Optional - Data transmission flag.
```

--------------------------------

### SelectBox.setGuideBGColor

Source: https://tech.hancomins.com/up/api-e50/symbols/EFormSelectbox.html

Sets the background color for the SelectBox guide.

```APIDOC
## SelectBox.setGuideBGColor

### Description
SelectBox의 가이드 배경 색상을 설정하는 함수

### Method
Not applicable (JavaScript function)

### Endpoint
Not applicable (JavaScript function)

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
None

### Request Example
```javascript
SelectBox.setGuideBGColor(0, 0, 0, 0.2);
```

### Response
#### Success Response (200)
None

#### Response Example
None

### Parameters
- **nRed** (Number) - 0~255
- **nGreen** (Number) - 0~255
- **nBlue** (Number) - 0~255
- **nAlpha** (Number) - 0~1
- **isSendData** (Type not specified)

### Since
version 5.0.67
```

--------------------------------

### setGuideBGColor

Source: https://tech.hancomins.com/up/api-e50/symbols/EFormImage.html

Sets the background color for the guide overlay of the image control.

```APIDOC
## setGuideBGColor

### Description
Sets the background color for the guide overlay of the image control. This function allows for customization of the visual guide appearance.

### Method
`image.setGuideBGColor(nRed, nGreen, nBlue, nAlpha, isSendData)`

### Parameters
#### Path Parameters
- **nRed** (Number) - Required - The red component of the color (0-255).
- **nGreen** (Number) - Required - The green component of the color (0-255).
- **nBlue** (Number) - Required - The blue component of the color (0-255).
- **nAlpha** (Number) - Required - The alpha (transparency) component of the color (0-1).
- **isSendData** (any) - Optional - Parameter indicating if data should be sent.

### Request Example
```javascript
image.setGuideBGColor(0, 0, 0, 0.2);
```

### Since
version 5.0.67
```

--------------------------------

### setGuideText

Source: https://tech.hancomins.com/up/api-e50/symbols/EFormSignGroup.html

Sets the guide text content.

```APIDOC
## setGuideText(strMessage, isMirroring)

### Description
Updates the guide text displayed in the signGroup.

### Parameters
- **strMessage** (String) - Required - The guide message.
- **isMirroring** (Boolean) - Required - Synchronization flag for mirroring.
```

--------------------------------

### SelectBox.setGuideText

Source: https://tech.hancomins.com/up/api-e50/symbols/EFormSelectbox.html

Sets the guide text for the SelectBox.

```APIDOC
## SelectBox.setGuideText

### Description
SelectBox의 가이드텍스트 문자을 설정 하는 함수

### Method
Not applicable (JavaScript function)

### Endpoint
Not applicable (JavaScript function)

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
None

### Request Example
```javascript
SelectBox.setGuideText("선택");
```

### Response
#### Success Response (200)
None

#### Response Example
None

### Parameters
- **text** (String) - text

### Since
version 5.0.141
```

--------------------------------

### setGuideTextVisible

Source: https://tech.hancomins.com/up/api-e50/symbols/EFormSignGroup.html

Sets whether the guide text remains visible after signing.

```APIDOC
## setGuideTextVisible(isVisible)

### Description
Configures if the guide text should be visible after the user has signed.

### Parameters
- **isVisible** (Boolean) - Required - Visibility state.
```

--------------------------------

### Checkbox - setGuideBGColor

Source: https://tech.hancomins.com/up/api-e50/symbols/EFormCheckbox.html

Sets the guide background color for the checkbox.

```APIDOC
## setGuideBGColor

### Description
Sets the guide background color for the checkbox.

### Method
JavaScript method call

### Endpoint
N/A (Client-side JavaScript)

### Parameters
#### Query Parameters
- **nRed** (Number) - Required - 0~255
- **nGreen** (Number) - Required - 0~255
- **nBlue** (Number) - Required - 0~255
- **nAlpha** (Number) - Required - 0~1
- **isSendData** (any) - Optional

### Request Example
```javascript
checkbox.setGuideBGColor(0, 0, 0, 0.2);
```

### Response
N/A (This is a setter method)

### Since
version 5.0.67
```

--------------------------------

### onRequiredGuideEvent

Source: https://tech.hancomins.com/up/api-e50/symbols/EFormInput.html

Event handler for required guide mismatch.

```APIDOC
## onRequiredGuideEvent

### Description
Executes the provided function when the input value does not match the guide text.

### Parameters
- **eventFunction** (Function) - Required - The function to execute.
```

--------------------------------

### Initialize and Configure clipSignPathPlugin

Source: https://tech.hancomins.com/up/api-e50/symbols/clipSignPathPlugin.html

Example showing the instantiation of the plugin, addition of checklists and signature fields, and setting a save event handler.

```javascript
var signPlugin = new clipSignPathPlugin();   
//설정  
signPlugin.addCheckList(true, "기타1", "check1");  
signPlugin.addCheckList(true, "기타2", "check2");  
signPlugin.addCheckList(true, "기타3", "check3");  
signPlugin.addCheckList(true, "기타4", "check4");  
  
signPlugin.addSignList(5, "성명", "sign1");  
signPlugin.addSignList(5, "서명", "sign2");  
  
signPlugin.setSaveEvent(function(result){  
alert(JSON.stringify(result));   
});  
//실행   
signPlugin.createView();
```

--------------------------------

### SelectBox.setGuideTextColor

Source: https://tech.hancomins.com/up/api-e50/symbols/EFormSelectbox.html

Sets the text color for the SelectBox guide.

```APIDOC
## SelectBox.setGuideTextColor

### Description
SelectBox의 가이드텍스트 문자 색성을 설정 하는 함수

### Method
Not applicable (JavaScript function)

### Endpoint
Not applicable (JavaScript function)

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
None

### Request Example
```javascript
SelectBox.setGuideTextColor(155, 0, 0);
```

### Response
#### Success Response (200)
None

#### Response Example
None

### Parameters
- **nRed** (Number) - 0 ~ 255
- **nGreen** (Number) - 0 ~ 255
- **nBlue** (Number) - 0 ~ 255

### Since
version 5.0.141
```

--------------------------------

### Get Format

Source: https://tech.hancomins.com/up/api-e50/symbols/EFormInput.html

Retrieves the output format applied to the input box.

```javascript
var title = inputbox.getFormat();
```

--------------------------------

### Create and Configure a Report

Source: https://tech.hancomins.com/up/api-e50/symbols/createReport.html

Use this function to create a report instance. Configure its display settings and then call view() to render it. Ensure the reportPath points to your report server.

```javascript
var report = null;

report = createReport('http://localhost:8080/ClipReport/Clip.jsp', xmlStringOOF, targetDOM_Div);

report.setFadeView(false);

report.setSlidePage(true);

report.setProgress('./img/deploying.gif', '50%', '30%');

report.view();
```

--------------------------------

### Set Guide Background Color

Source: https://tech.hancomins.com/up/api-e50/symbols/EFormSignGroup.html

Sets the background color for the signGroup guide area.

```javascript
signGroup.setGuideBGColor(0, 0, 0, 0.2);
```

--------------------------------

### Create View

Source: https://tech.hancomins.com/up/api-e50/symbols/clipSignPathPlugin.html

Executes the signPlugin and renders the configured information.

```javascript
 signPlugin.createView();
```

--------------------------------

### Report Configuration and Viewing

Source: https://tech.hancomins.com/up/api-e50/symbols/createReport.html

This section provides examples of configuring report settings and viewing the report.

```APIDOC
## Report Configuration and Viewing Example

### Description
Demonstrates how to set various report properties and then display the report.

### Code Example
```javascript
var report = null;
report = createReport('http://localhost:8080/ClipReport/Clip.jsp', xmlStringOOF, targetDOM_Div);

// Configure report settings
report.setFadeView(false);
report.setSlidePage(true);
report.setProgress('./img/deploying.gif', '50%', '30%');

// View the report
report.view();
```

### Notes
- `setFadeView(false)`: Disables fade-in effect for the report.
- `setSlidePage(true)`: Enables slide page transition.
- `setProgress(imageUrl, width, height)`: Sets a progress indicator image with specified dimensions.
- `report.view()`: Renders and displays the report.
```

--------------------------------

### Connection Method Example

Source: https://tech.hancomins.com/up/api-e50/symbols/pdfPrintPlugIn.html

Demonstrates how to use the connection method of pdfPrintPlugIn to set the server URL and parameters for PDF printing. The returned status indicates the browser's print handling capability.

```javascript
var status = pdfPrintOb.connection("http://localhost:8088/ClipReport/export/exportForPDF.jsp","fdafd=aaa&tttt=2sd");
```

--------------------------------

### Initialize and Connect to PDF Printing Server

Source: https://tech.hancomins.com/up/api-e50/symbols/pdfPrintPlugIn.html

Establishes a connection to the PDF printing server with the specified URL and parameters. The status returned indicates the printing environment.

```APIDOC
## POST /pdfPrintPlugIn/connection

### Description
Connects to the PDF printing server using the provided URL and parameters. Returns a status code indicating the printing environment.

### Method
POST

### Endpoint
/pdfPrintPlugIn/connection

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
None

### Request Example
```javascript
var pdfPrintOb = new pdfPrintPlugIn();
var status = pdfPrintOb.connection("http://localhost:8088/ClipReport/export/exportForPDF.jsp", "fdafd=aaa&tttt=2sd");
```

### Response
#### Success Response (200)
- **status** (Number) - The status of the current browser for printing.
    * 0: Normal
    * 1: Popup printing is used
    * 2: Adobe Reader version is too low (10 or higher required)
    * 3: Adobe Reader cannot be detected on the PC
    * 4: Edge browser

If the `print` function is executed:
- Status 1 and 2 will open the content in a new browser window.
- Status 3 and 4 will download the PDF to the PC.

#### Response Example
```json
{
  "status": 0
}
```
```

--------------------------------

### Set Sign Guide Text

Source: https://tech.hancomins.com/up/api-e50/symbols/EFormSign.html

Changes the content of the guide text for the sign control. Supports mirroring the text.

```javascript
sign.setGuideText(strMessage, isMirroring);
```

--------------------------------

### Initialize and Configure clipTabPlugin

Source: https://tech.hancomins.com/up/api-e50/symbols/clipTabPlugin.html

Demonstrates how to instantiate the plugin and set common options for viewer objects added to tabs.

```javascript
var tabPlugin = new clipTabPlugin(document.getElementById("targetDiv"));   
//tab에 넣은 뷰어 객체의 공통 옵션 설정  
tabPlugin.setOptionEvent(function(objEformOrReport, strEventString){   
objEformOrReport.setNecessaryEnabled(true);   
});  
  
//tab에 뷰어 객체상태로 추가  
tabPlugin.appendTab("test1", eform);  
//공통옵션 적용에서 분기처리 가능하도록 구분 문자열 추가   
//tabPlugin.appendTab("test1", eform, strEventString);  
//다른 색상의 탭을 표시 하기 위한 클래스이름 추가   
//tabPlugin.appendTab("test1", eform, strEventString, tabSelectClass, tabUnSelectClass);  
//지정한 위치에 탭을 추가하기 위한 index추가   
//tabPlugin.appendTab("test1", eform, strEventString, tabSelectClass, tabUnSelectClass, tabIndex);  
  
//키 구조 상태로 넣을 때 (key ex> ({'status':true,'wait':0.0,'uid':'c40d8d516467b431dbacf84e6aad745c9','version':{'build':'1.0.0.281','day':'20200827'}, "printerList":[{"name":"Printer1"}]})  
//tabPlugin.appendTabByEForm("test2", eFormKey2);  
//tabPlugin.appendTabByEForm("test3", eFormKey3);   
//공통옵션 적용에서 분기처리 가능하도록 구분 문자열 추가   
//tabPlugin.appendTabByEForm("test3", eFormKey3, strEventString);  
* //다른 색상의 탭을 표시 하기 위한 클래스이름 추가   
//tabPlugin.appendTabByEForm("test3", eFormKey3, strEventString, tabSelectClass, tabUnSelectClass);  
//지정한 위치에 탭을 추가하기 위한 index추가   
//tabPlugin.appendTabByEForm("test3", eFormKey3, strEventString, tabSelectClass, tabUnSelectClass, tabIndex);
```

--------------------------------

### Handle InputBox Required Guide Event

Source: https://tech.hancomins.com/up/api-e50/symbols/EFormInput.html

Executes a provided function when the input value does not match the guide text.

```javascript
inputbox.onRequiredGuideEvent(function(eventTarget){
		alert("입력한 값이 일치하지 않습니다.");
});
```

--------------------------------

### Set Checkbox Guide Background Color

Source: https://tech.hancomins.com/up/api-e50/symbols/EFormCheckbox.html

Configures the background color of the checkbox guide. Accepts RGBA values.

```javascript
checkbox.setGuideBGColor(0, 0, 0, 0.2);
```

--------------------------------

### Set Sign Guide Text Visibility

Source: https://tech.hancomins.com/up/api-e50/symbols/EFormSign.html

Controls whether the guide text remains visible even after the signature is completed.

```javascript
sign.setGuideTextVisible(isVisible);
```

--------------------------------

### Initialize and Configure clipSignPlugin

Source: https://tech.hancomins.com/up/api-e50/symbols/clipSignPlugin.html

Instantiate the clipSignPlugin and configure various elements like checkboxes, signature fields, and save event handlers before creating the view. Ensure clipreport.js is linked.

```javascript
var signPlugin = new clipSignPlugin();

//설정
signPlugin.addCheckList(true, "기타1", "check1");
signPlugin.addCheckList(true, "기타2", "check2");
signPlugin.addCheckList(true, "기타3", "check3");
signPlugin.addCheckList(true, "기타4", "check4");

signPlugin.addSignList(5, "성명", "sign1");
signPlugin.addSignList(5, "서명", "sign2");

signPlugin.setSaveEvent(function(result){
alert(JSON.stringify(result)); 
});
//실행 
signPlugin.createView();
```

--------------------------------

### Set SelectBox Guide Text

Source: https://tech.hancomins.com/up/api-e50/symbols/EFormSelectbox.html

Sets the text that appears in the SelectBox when no option is selected. This text serves as a guide to the user.

```javascript
SelectBox.setGuideText("선택");
```

--------------------------------

### Get Video Value

Source: https://tech.hancomins.com/up/api-e50/symbols/EFormVideo.html

Retrieves the current value of the video control, typically its URL. Use this to get the source of the video.

```javascript
var value = video.getValue();
```

--------------------------------

### Verify Image URL

Source: https://tech.hancomins.com/faq?cate_code=1&mid=8&no=1251379

Example of testing an image URL directly from the server console.

```text
https://ClipReport5/image/55/5ca13d8453042_image.jpg
```

--------------------------------

### Initialize and Connect pdfPrintPlugIn

Source: https://tech.hancomins.com/up/api-e50/symbols/pdfPrintPlugIn.html

Instantiate the pdfPrintPlugIn and establish a connection to the PDF printing server with specified parameters. Ensure the PDF is generated with setPrintPop(true) for printing.

```javascript
var pdfPrintOb = new pdfPrintPlugIn();
var status = pdfPrintOb.connection("http://localhost:8088/ClipReport/export/exportForPDF.jsp","fdafd=aaa&tttt=2sd");
```

--------------------------------

### Set Guide Background Color for Controls in EFormGroup

Source: https://tech.hancomins.com/up/api-e50/symbols/EFormGroup.html

Set the guide background color for all controls within the EFormGroup using RGBA values.

```javascript
group.setGuideBGColor(0, 0, 0, 0.2);
```

--------------------------------

### Fix Scroll Position in EForm Mirroring Guide Line

Source: https://tech.hancomins.com/up/api-e50/symbols/Report.html

Configures the EForm mirroring service to fix the scroll position on the main screen to match the sub-screen's scroll position. This function sets the default values for the guide line and can be modified using the guide line buttons.

```javascript
eform.setGuiderLinePinPaper(true);
```

--------------------------------

### Set Sign Guide Text Visibility

Source: https://tech.hancomins.com/up/api-e50/symbols/EFormSign.html

Determines whether the guide text remains visible after the signature is completed. Available since version 5.0.1.

```javascript
sign.setGuideTextVisible(true);
```

--------------------------------

### Set Sign Guide Background Color

Source: https://tech.hancomins.com/up/api-e50/symbols/EFormSign.html

Sets the background color for the guide area of the sign control. Accepts RGBA values and an option to send data.

```javascript
sign.setGuideBGColor(nRed, nGreen, nBlue, nAlpha, isSendData);
```

--------------------------------

### FAQ - Image File Not Loading from Server

Source: https://tech.hancomins.com/faq?cate_code=1&mid=8&no=1250660

Troubleshooting steps for when image files are not loading correctly from the server.

```APIDOC
## FAQ: Image File Not Loading from Server

### Description
This guide addresses issues where image files fail to load when accessed from the server.

### Troubleshooting Steps

1.  **Verify Server Access and URL**: 
    *   Connect to the server (e.g., via SSH or console).
    *   Check if the image URL is accessible and test it.
    *   Example URL: `https://ClipReport5/image/55/5ca13d8453042_image.jpg`

2.  **Check WAS Logs for AWT Errors**: 
    *   If using Unix or Linux servers, verify Java options and the installation of X-window related library class files.
    *   **Java Option**: Add the option `-Djava.awt.headless=true` to enable GUI class usage in non-Windows environments.
```

--------------------------------

### Set SelectBox Guide Text Color

Source: https://tech.hancomins.com/up/api-e50/symbols/EFormSelectbox.html

Defines the color of the guide text within the SelectBox using RGB values. Each color component ranges from 0 to 255.

```javascript
SelectBox.setGuideTextColor(155, 0, 0);
```

--------------------------------

### Set SelectBox Guide Background Color

Source: https://tech.hancomins.com/up/api-e50/symbols/EFormSelectbox.html

Configures the background color for the SelectBox's guide area using RGBA values. The alpha value controls transparency.

```javascript
SelectBox.setGuideBGColor(0, 0, 0, 0.2);
```

--------------------------------

### Handle Input Required Guide Events in eForm

Source: https://tech.hancomins.com/up/api-e50/symbols/Report.html

This event is triggered when the input value in an input box does not match the guide text. It's useful for validating required fields.

```javascript
eform.onInputRequiredGuideEvent(function(eventTarget){
		alert("입력한 값이 일치하지 않습니다.");
});
```

--------------------------------

### Set Sign Guide Background Color

Source: https://tech.hancomins.com/up/api-e50/symbols/EFormSign.html

Sets the background color for the sign control's guide area using RGBA values. Available since version 5.0.67.

```javascript
sign.setGuideBGColor(0, 0, 0, 0.2);
```

--------------------------------

### iframe 로컬 네트워크 접근 허용 (모든 도메인)

Source: https://tech.hancomins.com/allnotice?mode=view&no=1252652

iframe을 사용하여 다른 도메인의 뷰어 페이지를 출력할 때, 모든 도메인에 대해 로컬 네트워크 접근을 허용하려면 allow 속성에 "local-network-access *"를 설정합니다. 이 설정은 원본 소스 코드에 적용해야 합니다.

```html
<iframe src="https://bbb.com" allow="local-network-access *"></iframe>
```

--------------------------------

### Set Guide Background Color for Image

Source: https://tech.hancomins.com/up/api-e50/symbols/EFormImage.html

Customize the background color of the image's guide area using RGBA values. This function is available since version 5.0.67.

```javascript
image.setGuideBGColor(0, 0, 0, 0.2);
```

--------------------------------

### Display Guide Scroll Line in EForm Mirroring

Source: https://tech.hancomins.com/up/api-e50/symbols/Report.html

Sets whether to display the guide scroll line on the main screen in the EForm mirroring service. This must be set before the viewer is activated.

```javascript
eform.setGuiderLineDisplay(false);
```

--------------------------------

### Constructor: createOOFReport

Source: https://tech.hancomins.com/up/api50/symbols/createOOFReport.html

Initializes a new report instance using the specified report server path, OOF XML configuration, and target DOM tag.

```APIDOC
## Constructor createOOFReport

### Description
Initializes and generates a report based on the provided report server path, OOF XML document, and target DOM element.

### Parameters
#### Path Parameters
- **reportPath** (String) - Required - The location of the report server.
- **oof** (String) - Required - The XML document information used for the report.
- **targetTag** (Object) - Required - The DOM tag designated for rendering the report.

### Request Example
```javascript
var report = null;
report = createReport('./Clip.jsp', xmlStringOOF, targetDOM_Div);
report.view();
```

### Response
#### Success Response
- **Object** (Report) - Returns the generated report object.

### Version
2.0.0.1
```

--------------------------------

### Set Sign Guide Text

Source: https://tech.hancomins.com/up/api-e50/symbols/EFormSign.html

Changes the content of the guide text for the sign control. An optional boolean parameter can synchronize the text if mirroring is used. Available since version 5.0.1.

```javascript
sign.setGuideText("서명완료");
```

--------------------------------

### Control Guide Line Display

Source: https://tech.hancomins.com/up/api-e50/symbols/Report.html

Sets the visibility of the guide scroll line on the main screen in the EForm mirroring service. This function can only be used after the viewer is activated. Available since version 5.0.414.

```javascript
eform.guiderLineDisplay(false);
```

--------------------------------

### exePrint

Source: https://tech.hancomins.com/up/api-e50/symbols/Report.html

Executes printing with specified options.

```APIDOC
## exePrint(isPopUp, printName, tray, startNumber, endNumber, copies, option)

### Description
Executes printing with specified options.

### Method
Not specified (likely a function call within a JavaScript context)

### Parameters
#### Path Parameters
- **isPopUp** (Boolean) - Optional - Whether to use the print 안내창.
- **printName** (String) - Optional - The name of the printer (default: "").
- **tray** (String or Array[String]) - Optional - Tray value (default: ""). An integer value applies the tray to all pages, while an Array[Integer] specifies tray values per page.
- **startNumber** (Integer) - Optional - The starting page number for printing.
- **endNumber** (Integer) - Optional - The ending page number for printing ( -1 for entire print).
- **copies** (Integer) - Optional - The number of copies to print.
- **option** (String) - Optional - Detailed options (default: ""). For additional options, specify the count and values as a string. Example: "1,bsPaper:1" for one option, "2,bsPaper:1,docName:wmark_report1" for two.
  - bsPaper: Paper type setting (supported from version 1.0.0.76). 1=Default, 2=Simplex, 3=Vertical duplex, 4=Horizontal duplex.
  - docName: Spool title setting (supported from version 1.0.0.78).

### Request Example
```javascript
report.exePrint(true, "", "", 1, -1, 1, "");
report.exePrint(false, "ML-3010", "260", 1, 3, 1, "");
report.exePrint(false, "ML-3010", ["260","340","220"], 1, 3, 1, "");
report.exePrint(false, "ML-3010", ["260","340","220"], 1, 3, 1, "1,bsPaper:1");
```

### Since
version 5.0.1
```

--------------------------------

### report.exePrintVersionInfo

Source: https://tech.hancomins.com/up/api-e50/symbols/Report.html

Sets the version information for the print program to compare with the installed version.

```APIDOC
## report.exePrintVersionInfo(strVersion)

### Description
Specifies the version of the print program to compare against the version installed on the PC.

### Parameters
#### Path Parameters
- **strVersion** (String) - Required - The patched version information.

### Request Example
report.exePrintVersionInfo("1.0.0.30");
```

--------------------------------

### Set Environment Variable Path

Source: https://tech.hancomins.com/faq?mid=8&no=1251379&start=1

Example path for environment variable configuration for CLIP report 5.0.

```text
C:\Program Files (x86)\Clipsoft\CLIP report 5.0\jre\bin
```

--------------------------------

### Print Directly via EXE

Source: https://tech.hancomins.com/up/api50/symbols/ReportView.html

Initiates an immediate EXE print without displaying a print preview. Available since version 5.0.53.

```javascript
printEXEDirect();
```

--------------------------------

### Get Value

Source: https://tech.hancomins.com/up/api-e50/symbols/EFormSignGroup.html

Retrieves the value of the signGroup.

```javascript
var value = signGroup.getValue();
```

--------------------------------

### Initialize EFormVideo Object

Source: https://tech.hancomins.com/up/api-e50/symbols/EFormVideo.html

Instantiate an EFormVideo object by retrieving it from a group's control list. Ensure the control type is 'video' before assignment.

```javascript
var arrayControlList = group.getControlList(); 
if(null != arrayControlList[0] && "button" == arrayControlList[0].getType()){
var video = arrayControlList[0];
}
```

--------------------------------

### Set Exe Print Server Path

Source: https://tech.hancomins.com/up/api50/symbols/ReportView.html

Forces the server path for the executable print service.

```javascript
report.setStrExePrintServerPath("http://localhost:8080/ClipReport5/CLIP.jsp");
```

--------------------------------

### Get value

Source: https://tech.hancomins.com/up/api-e50/symbols/EFormCheckbox.html

Retrieves the value of the checkbox.

```javascript
var value = checkbox.getValue();
```

--------------------------------

### Execute Print with Options

Source: https://tech.hancomins.com/up/api50/symbols/ReportView.html

Executes a print job with specified options, potentially showing a print prompt. Available since version 5.0.53.

```javascript
report.exePrint(true, "", "", 1, -1, 1, "");
```

```javascript
report.exePrint(false, "ML-3010", "260", 1, 3, 1, "");
```

```javascript
report.exePrint(false, "ML-3010", ["260","340","220"], 1, 3, 1, "");
```

```javascript
report.exePrint(false, "ML-3010", ["260","340","220"], 1, 3, 1, "1,bsPaper:1");
```

--------------------------------

### createMainEForm Constructor

Source: https://tech.hancomins.com/up/api-e50/symbols/createMainEForm.html

Initializes the remote control main EForm viewer within a JSP document.

```APIDOC
## createMainEForm

### Description
Initializes the remote control main EForm viewer. This function is used to create the main viewer within a single JSP document.

### Parameters
- **serverPath** (String) - Required - The location of the report server.
- **wsServerPath** (String) - Required - The address of the relay server.
- **roomkey** (String) - Required - A key to connect different viewers. If set to an empty string, the main viewer will receive a generated room key from the server.
- **reportKey** (String) - Required - The report key issued by the report engine in the JSP.
- **targetTag** (Object) - Required - The tag element where the EForm viewer will be rendered.

### Returns
- **Object** - Returns the EForm viewer object.

### Since
version 5.0.1
```

--------------------------------

### Execute clipSignPlugin View

Source: https://tech.hancomins.com/up/api-e50/symbols/clipSignPlugin.html

Renders the configured signature and checkbox controls on the page. This function should be called after all configurations are set.

```javascript
signPlugin.createView();
```

--------------------------------

### Generate Download Settings Frame

Source: https://tech.hancomins.com/up/api50/symbols/ReportView.html

Creates a page for configuring download settings.

```javascript
report.callDownloadFrame();
```

--------------------------------

### setExePrintVersionInfo

Source: https://tech.hancomins.com/up/api50/symbols/ReportView.html

Specifies the updated version of the EXE print program to prompt installation of the new version.

```APIDOC
## setExePrintVersionInfo(strVersion)

### Description
Specifies the updated version of the EXE print program. This prompts the user to install the new version if it differs from the currently installed version.

### Method
```javascript
report.setExePrintVersionInfo("1.0.30");
```

### Parameters
#### Path Parameters
- **strVersion** (String) - Description: The version information of the patched program.

### Since
version 5.0.53
```

--------------------------------

### CLIP Report DB Connection Configuration

Source: https://tech.hancomins.com/faq?cate_code=1&mid=8&no=1250642

Shows how to add database connection information using `addConnectionData`. This is useful for specifying which database to connect to from the `DataConnection.properties` file.

```java
oof.addConnectionData("*", "mssql");
```

```java
oof.addConnectionData("*", dbname);
```

--------------------------------

### Get visibility status

Source: https://tech.hancomins.com/up/api-e50/symbols/EFormCheckbox.html

Checks if the checkbox is visible.

```javascript
if(checkbox.getVisible()){
 
}
```

--------------------------------

### Get disabled status

Source: https://tech.hancomins.com/up/api-e50/symbols/EFormCheckbox.html

Checks if the checkbox is disabled.

```javascript
if(checkbox.getDisabled()){
 
}
```

--------------------------------

### Get Value

Source: https://tech.hancomins.com/up/api-e50/symbols/EFormButton.html

Retrieve the value associated with the button.

```javascript
button의 value 값을 반환합니다.   

 var value = button.getValue();
```

--------------------------------

### Select Page

Source: https://tech.hancomins.com/up/api50/symbols/ReportView.html

Navigates to a specified page number. Accepts page number as a string or integer. Available since version 5.0.1.

```javascript
report.selectPage("1"); report.selectPage(1);
```

--------------------------------

### Configure HWP Export Options

Source: https://tech.hancomins.com/up/api-e50/symbols/_global_.html

Defines the default settings for fast HWP export, including layout constraints, table handling, and text formatting.

```javascript
fileName{String} 문서를 저장 할 파일 이름  

fixSize {Boolean} 크기 고정  

allowOverlay {Boolean} 겹침 허용  

setPageBottomMarginToZero {Boolean} 페이지 바닥 여백을 0으로 설정  

outputLikeWord {Boolean} 글자처럼 출력  

tableSplitMethod {Integer}  

1 = 나눔   

2 = 셀 단위로 나눔   

3 = 나누지 않음   

defaultCharGap {Integer} 기본 자간  

charRatio {Integer} 장평  

putCheckboxIntoCell {Boolean} 셀 안에 체크박스 넣기(version 1.0.0.22)  

splitTextByLine {Boolean} 텍스트를 라인별로 나눠서 표현(version 1.0.0.23)  

mergeTable{Boolean} 이웃한 테이블과 병합할 것인지 여부(version 1.0.0.55)  

lineSpaceRate{Integer} 줄간격 비율(version 1.0.0.58)  

positionRelTo{Integer} 좌표 기준(version 1.0.0.63)  

1 = 종이   

2 = 문단   

hwpExportMethod{Integer} 저장 방식(version 1.0.0.99)  

1 = 일반   

2 = 표만 나열하기   

표만 나열하기 옵션 사용 시[크기고정(false), 겸침 허용(false), 표 합치기(false), 페이지 바닥 여백 0로 설정(false),   

글자처럼(true), 테이블셀에 표 넣기(true), 페이지영역에서 표 나눔(셀 단위로 나눔) , 위치 기준(문단) 으로 고정]  
 
splitPageOnListTableOnly{Boolean}  “표만 나열하기” 시 페이지 나눔 (version 1.0.0.102)   

pageBottomMarginApplicationRate {Integer}  “페이지 바닥 여백을 0으로 설정” 이 false일때 사용가능하며 페이지 아래쪽 여백 적용비율(1~100) (version 1.0.0.107)  

insertPageNumber {Boolean}  페이지 넘버 삽입 (version 1.0.0.173)  

mergeAllTablesOnListTableOnly {Boolean}  표만 나열하기 일떄 모든 테이블 병합하기 (version 1.0.0.212)  

insertLabelWithTextOnListTableOnly {Boolean}  표만 나열하기 일떄 글상자를 텍스트로 삽입 (version 1.0.0.212)  

isTransparentMode {Boolean}  표의 배경 투명으로 표시  (version 1.0.0.291)  

isSectionClear {Boolean}  배경색상을 설정했을경우 무시  (version 1.0.0.367)
```

--------------------------------

### Get Label

Source: https://tech.hancomins.com/up/api-e50/symbols/EFormButton.html

Retrieve the label text of the button.

```javascript
button의 label 값을 반환합니다.   

 var value = button.getLabel();
```

--------------------------------

### setHTMLPrintInServer

Source: https://tech.hancomins.com/up/api50/symbols/ReportView.html

Configures HTML printing to be handled by the server.

```APIDOC
## setHTMLPrintInServer(isHTMLPrintInServer)

### Description
Configures HTML printing to be handled by the server.

### Method
```
report.setHTMLPrintInServer(true);
```

### Parameters
#### Path Parameters
- **isHTMLPrintInServer** (Boolean) - Description: Set to true to enable server-side HTML printing. Default is false.

### Since
version 5.0.207
```

--------------------------------

### Get Memo Data API

Source: https://tech.hancomins.com/up/api50/symbols/ReportView.html

Extracts memo data.

```APIDOC
## GET /api/reports/memo

### Description
Extracts memo data.

### Method
GET

### Endpoint
/api/reports/memo

### Request Example
```javascript
report.getMemoData();
```

### Response
#### Success Response (200)
- **memoData** (Array[][]) - An array containing the memo data.

#### Response Example
```json
[
  ["Memo 1 Content", "Author 1", "Timestamp 1"],
  ["Memo 2 Content", "Author 2", "Timestamp 2"]
]
```
```

--------------------------------

### Get Thumbnail Data

Source: https://tech.hancomins.com/up/api50/symbols/ReportView.html

Retrieves thumbnail information as an array.

```javascript
report.callGetThumbnailData();
```

--------------------------------

### Set Print Frame First

Source: https://tech.hancomins.com/up/api50/symbols/ReportView.html

Creates the HTML print frame initially to speed up font rendering. Enable this for faster initial print display.

```javascript
report.setPrintFrameFirst(true);
```

--------------------------------

### Get Value

Source: https://tech.hancomins.com/up/api-e50/symbols/EFormInput.html

Retrieves the current value of the input box.

```javascript
var value = inputbox.getValue();
```

--------------------------------

### Execute Print

Source: https://tech.hancomins.com/up/api-e50/symbols/Report.html

Prints the report using the EXE print module with specified options.

```javascript
report.exePrint(true, "", "", 1, -1, 1, "");  
report.exePrint(false, "ML-3010", "260", 1, 3, 1, ""); 
report.exePrint(false, "ML-3010", ["260","340","220"], 1, 3, 1, "");
report.exePrint(false, "ML-3010", ["260","340","220"], 1, 3, 1, "1,bsPaper:1");
```

--------------------------------

### Get Title

Source: https://tech.hancomins.com/up/api-e50/symbols/EFormInput.html

Retrieves the accessibility title of the input box.

```javascript
var title = inputbox.getTitle();
```
Tokens:
Raw