OpenHwp Automation

https://zarathucorp.github.io/openhwpsdk/
Admin
OpenHwp Automation provides a C# wrapper and command-line tools for automating Hancom HWP and...
Tokens:13,597
Snippets:177
Trust Score:9.7
Update:4 months ago
Show doc for...
Tokens:
Raw
### Install Dependencies and Serve Locally

Source: https://zarathucorp.github.io/openhwpsdk/documentation-site

Installs documentation dependencies and starts a local development server for previewing the site.

```bash
python -m pip install -r requirements-docs.txt
mkdocs serve

```

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

### Example HWPX Cell Image Insertion

Source: https://zarathucorp.github.io/openhwpsdk/markdown-hwpx-validation-workflow

Shows how to insert an image into an HWPX cell. The image path is relative to the map XML. 'clearCell="true"' will clear existing content.

```xml
<writeImage path="sample_insert.png" width="40" height="20" clearCell="true" />

```

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

### Example HWPX Cell Text Write

Source: https://zarathucorp.github.io/openhwpsdk/markdown-hwpx-validation-workflow

Demonstrates how to write new text content to a specific cell in an HWPX file. Ensure 'validateCurrentText' is set to 'false' only for deliberate staged rewrites.

```xml
<cell id="table-003-r001-c001" tableIndex="3" row="1" col="1" merged="false">
  <currentText>Existing cell text</currentText>
  <writeText>Replacement cell text</writeText>
  <writeImage path="" width="200" height="200" clearCell="true" />
</cell>

```

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

### Example HWPX Paragraph Anchor Text Replacement

Source: https://zarathucorp.github.io/openhwpsdk/markdown-hwpx-validation-workflow

Illustrates replacing paragraph anchor text. Set 'replaceAnchorText="true"' to update the anchor's text content.

```xml
<anchor id="anchor-0001" partPath="Contents/section0.xml" partRole="bodySection" paragraphIndex="1" occurrence="0">
  <currentText>Existing paragraph text</currentText>
  <writeText replaceAnchorText="true">Replacement paragraph text</writeText>
</anchor>

```

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

### Field Management Commands

Source: https://zarathucorp.github.io/openhwpsdk/cli-reference

Commands for interacting with fields within HWP documents, including checking existence, getting values, and setting new values.

```powershell
& $cli field-exists C:\temp\form.hwp TEST
& $cli field-get C:\temp\form.hwp TEST
& $cli field-set C:\temp\form.hwpx TEST "updated text" C:\temp\form-out.hwpx
```

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

### Merge Cells in HWPX Table

Source: https://zarathucorp.github.io/openhwpsdk/markdown-hwpx-validation-workflow

Merges a block of cells within a specified table in an HWPX file into a single cell. The command requires the table index, starting row and column, and the span for rows and columns. A report is generated.

```bash
src\OpenHwp.Automation.Cli\bin\Release\OpenHwp.Automation.Cli.exe table-merge-package "<template.hwpx>" "C:\temp\openhwpsdk-out\table_merged.hwpx" --table-index 4 --row 1 --column 1 --row-span 2 --col-span 2 --text "Merged cell" --report "C:\temp\openhwpsdk-out\table_merged_report.md"

```

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

### Build Static Site

Source: https://zarathucorp.github.io/openhwpsdk/documentation-site

Builds the static HTML site for deployment, cleaning the output directory first.

```bash
mkdocs build --clean --site-dir site

```

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

### Build the Release Executable

Source: https://zarathucorp.github.io/openhwpsdk/getting-started

Build the project in Release mode from the repository root. The executable will be placed in the specified output directory.

```bash
build.cmd Release
```

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

### Local Development Server URL

Source: https://zarathucorp.github.io/openhwpsdk/documentation-site

The default local URL to access the documentation site during development.

```bash
http://127.0.0.1:8000/

```

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

### Create HWPX Package with Table

Source: https://zarathucorp.github.io/openhwpsdk/markdown-hwpx-validation-workflow

Generates a new HWPX file with a table created from a template, specifying dimensions and initial text content. A report of the operation is also generated.

```bash
src\OpenHwp.Automation.Cli\bin\Release\OpenHwp.Automation.Cli.exe table-create-package "<template.hwpx>" "C:\temp\openhwpsdk-out\new_table.hwpx" --rows 2 --cols 3 --text "Header A|Header B|Header C;Value 1|Value 2|Value 3" --report "C:\temp\openhwpsdk-out\new_table_report.md"

```

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

### Create a New HWPX Document

Source: https://zarathucorp.github.io/openhwpsdk/getting-started

Use the CLI to create a new HWPX document with specified content and save it to a given path. This command initiates document creation.

```powershell
& $cli new-text C:\temp\hello.hwpx "Hello from OpenHwp"
```

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

### Create HWPX Table Package

Source: https://zarathucorp.github.io/openhwpsdk/cli-reference

Creates a new table package within an HWPX file with specified dimensions and initial text content. A report detailing the creation process is generated.

```bash
& $cli table-create-package C:\temp\template.hwpx C:\temp\new-table.hwpx --rows 2 --cols 3 --text "Header A|Header B|Header C;Value 1|Value 2|Value 3" --report C:\temp\new-table-report.md
```

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

### List Pictures in HWPX

Source: https://zarathucorp.github.io/openhwpsdk/cli-reference

Lists all pictures within an HWPX template and saves the inventory to a markdown file.

```bash
& $cli list-pictures C:\temp\template.hwpx C:\temp\picture-inventory.md
```

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

### Build Release Version

Source: https://zarathucorp.github.io/openhwpsdk

Builds the project in Release mode. This command is typically run from the project's root directory.

```batch
build.cmd Release

```

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

### Copy Content from HWPX

Source: https://zarathucorp.github.io/openhwpsdk/markdown-hwpx-validation-workflow

Copies content from a reference HWPX file to a target HWPX file, with options for source and target selection, and generates a report. Use 'probe-copy-from-doc' beforehand.

```bash
src\OpenHwp.Automation.Cli\bin\Release\OpenHwp.Automation.Cli.exe --visible copy-from-doc "<reference.hwpx>" "<target.hwpx>" "C:\temp\openhwpsdk-out\copy_from_doc.hwpx" --source image:0 --target doc-end --report "C:\temp\openhwpsdk-out\copy_from_doc.md"
```

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

### List Header/Footer in HWPX

Source: https://zarathucorp.github.io/openhwpsdk/cli-reference

Lists header and footer information from an HWPX template and saves it to a markdown file.

```bash
& $cli list-header-footer C:\temp\template.hwpx C:\temp\header-footer-inventory.md
```

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

### GitHub Pages Deployment Settings

Source: https://zarathucorp.github.io/openhwpsdk/documentation-site

Configuration path within GitHub repository settings to enable GitHub Actions as the source for Pages deployment.

```bash
Settings > Pages > Build and deployment > Source: GitHub Actions

```

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

### Locate the CLI Executable

Source: https://zarathucorp.github.io/openhwpsdk/getting-started

The Release executable is generated in the following path after a successful build.

```bash
src\OpenHwp.Automation.Cli\bin\Release\OpenHwp.Automation.Cli.exe
```

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

### Basic CLI Commands

Source: https://zarathucorp.github.io/openhwpsdk/cli-reference

Commonly used commands for file operations like version checking, creating new text files, copying, saving, and reading document content.

```powershell
$cli = "src\OpenHwp.Automation.Cli\bin\Release\OpenHwp.Automation.Cli.exe"
& $cli version
& $cli new-text C:\temp\hello.hwpx "Hello from OpenHwp"
& $cli copy-save C:\temp\in.hwpx C:\temp\out.hwpx
& $cli doc-info C:\temp\in.hwp
& $cli read-text C:\temp\in.hwp
& $cli read-page C:\temp\in.hwp 1
& $cli --visible export-pdf C:\temp\in.hwpx C:\temp\out.pdf
```

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

### List Header and Footer Inventory

Source: https://zarathucorp.github.io/openhwpsdk/markdown-hwpx-validation-workflow

Lists the inventory of headers and footers present in an HWPX template file and outputs the information to a markdown file.

```bash
src\OpenHwp.Automation.Cli\bin\Release\OpenHwp.Automation.Cli.exe list-header-footer "C:\temp\template.hwpx" "C:\temp\header_footer_inventory.md"
```

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

### Scan HWPX Features

Source: https://zarathucorp.github.io/openhwpsdk/cli-reference

Scans a directory for HWPX features and reports the findings to a markdown file.

```bash
& $cli scan-hwpx-features C:\temp\hwpx-samples C:\temp\feature-scan.md
```

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

### Fill Markdown Table in HWPX

Source: https://zarathucorp.github.io/openhwpsdk/markdown-hwpx-validation-workflow

Fills a markdown table within an HWPX file with specified data. This command is used for populating tables, potentially for educational content, with control over rows, columns, and cell content. A new HWPX file is created with the filled table.

```bash
src\OpenHwp.Automation.Cli\bin\Release\OpenHwp.Automation.Cli.exe --visible fill-markdown-table "<template.hwpx>" "<source.md>" "C:\temp\openhwpsdk-out\cell_fill_education_2rows.hwpx" 8 3 1 0 1 2 5

```

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

### List Field Inventory

Source: https://zarathucorp.github.io/openhwpsdk/markdown-hwpx-validation-workflow

Lists all fields within an HWPX template file, including their properties and types, and outputs the inventory to a markdown file.

```bash
src\OpenHwp.Automation.Cli\bin\Release\OpenHwp.Automation.Cli.exe --visible list-fields "<template.hwpx>" "C:\temp\field_inventory.md" --com
```

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

### Export HWPX to PDF

Source: https://zarathucorp.github.io/openhwpsdk/markdown-hwpx-validation-workflow

Exports HWPX files to PDF format for visual inspection. Use this command to generate PDF previews of your templates or documents.

```bash
src\OpenHwp.Automation.Cli\bin\Release\OpenHwp.Automation.Cli.exe --visible export-pdf "<template.hwpx>" "C:\temp\openhwpsdk-out\template_original.pdf"
src\OpenHwp.Automation.Cli\bin\Release\OpenHwp.Automation.Cli.exe --visible export-pdf "C:\temp\openhwpsdk-out\cell_fill_education_2rows.hwpx" "C:\temp\openhwpsdk-out\cell_fill_education_2rows.pdf"
```

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

### Visual Smoke Test Commands

Source: https://zarathucorp.github.io/openhwpsdk/cli-reference

Runs a visual smoke test on a corpus of HWPX files, exporting them to PDFs and generating a comprehensive report. Includes options for handling expected export failures and strict cleanup.

```powershell
& $cli --visible visual-smoke-corpus C:\temp\hwpx-corpus C:\temp\visual-smoke C:\temp\visual-smoke\visual-smoke-report.md
& $cli --visible visual-smoke-corpus C:\temp\hwpx-corpus C:\temp\visual-smoke C:\temp\visual-smoke\visual-smoke-report.md --expect-export-failure "known-nonrenderable.hwpx=1:Failed to open" --strict-cleanup
```

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

### Diagnose HWP COM Environment

Source: https://zarathucorp.github.io/openhwpsdk/getting-started

Run a diagnostic command to check the status of the local HWP COM environment. Use `--visible` mode to observe the HWP application during the diagnostic process, aiding in troubleshooting.

```powershell
& $cli --visible diagnose-com
```

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

### Add Header/Footer Text

Source: https://zarathucorp.github.io/openhwpsdk/cli-reference

Creates a minimal one-paragraph text body and a matching reference with a section-unique header/footer 'idRef' in an HWPX file. This command rejects duplicate 'idRef' or 'kind + section + applyPageType' combinations.

```bash
& $cli add-header-footer-text C:\temp\template.hwpx C:\temp\header-footer-text.hwpx --kind footer --section section0 --id-ref footer-odd --apply-page-type ODD --text "Odd footer" --report C:\temp\header-footer-text.md
```

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

### GitHub Actions Workflow File

Source: https://zarathucorp.github.io/openhwpsdk/documentation-site

Specifies the location of the GitHub Actions workflow file used for documentation deployment.

```bash
.github/workflows/docs.yml

```

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

### Submission Template Profile Command

Source: https://zarathucorp.github.io/openhwpsdk/cli-reference

Fills a submission template with data from a Markdown source, with options for asset root, image mode, and reporting.

```powershell
& $cli fill-submission-template C:\temp\template.hwpx C:\temp\source.md C:\temp\submission-filled.hwpx --profile r-and-d-startup-2026 --asset-root C:\temp --image-mode package --report C:\temp\submission-filled-report.md
```

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

### Apply Filled HWPX Form Map (Package Mode)

Source: https://zarathucorp.github.io/openhwpsdk/markdown-hwpx-validation-workflow

Applies a filled form map to an HWPX template using package mode, which is COM-free. This method preserves package entries and can embed images as package-level objects.

```bash
src\OpenHwp.Automation.Cli\bin\Release\OpenHwp.Automation.Cli.exe apply-form-map --package "<template.hwpx>" "C:\temp\openhwpsdk-out\template_form_map_filled.xml" "C:\temp\openhwpsdk-out\template_form_map_package_applied.hwpx" --report "C:\temp\openhwpsdk-out\template_form_map_package_apply.md"
```

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

### List Markdown Tables from HWPX

Source: https://zarathucorp.github.io/openhwpsdk/markdown-hwpx-validation-workflow

Extracts and lists all markdown tables found within a specified HWPX source file.

```bash
src\OpenHwp.Automation.Cli\bin\Release\OpenHwp.Automation.Cli.exe markdown-table-list "<source.md>"

```

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

### Fill HWPX Submission Template

Source: https://zarathucorp.github.io/openhwpsdk/markdown-hwpx-validation-workflow

Fills an HWPX submission template from a Markdown source using a specified profile. Supports image embedding and generates a detailed report.

```bash
src\OpenHwp.Automation.Cli\bin\Release\OpenHwp.Automation.Cli.exe fill-submission-template "<template.hwpx>" "<source.md>" "C:\temp\openhwpsdk-out\submission_filled.hwpx" --profile r-and-d-startup-2026 --asset-root "<image-root>" --image-mode package --report "C:\temp\openhwpsdk-out\submission_filled_report.md"
```

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

### Check CLI Version

Source: https://zarathucorp.github.io/openhwpsdk

Checks the version of the OpenHwp Automation CLI. Ensure the path to the executable is correct.

```powershell
src\OpenHwp.Automation.Cli\bin\Release\OpenHwp.Automation.Cli.exe version

```

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

### HWP COM Diagnostics

Source: https://zarathucorp.github.io/openhwpsdk/cli-reference

Commands to diagnose COM component health, with and without a specified HWPX file.

```powershell
& $cli --visible diagnose-com
& $cli --visible diagnose-com C:\temp\in.hwpx
```

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

### Check CLI Version in PowerShell

Source: https://zarathucorp.github.io/openhwpsdk/getting-started

Set the CLI executable path in a PowerShell variable and then execute the 'version' command. This is a convenient way to verify the build.

```powershell
$cli = "src\OpenHwp.Automation.Cli\bin\Release\OpenHwp.Automation.Cli.exe"
& $cli version
```

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

### Form Map Workflow Commands

Source: https://zarathucorp.github.io/openhwpsdk/cli-reference

Commands for extracting, probing, and applying form maps to HWPX templates. Supports both package mode (COM-free) and HWP-backed mode.

```powershell
& $cli extract-form-map C:\temp\template.hwpx C:\temp\template-form-map.xml
& $cli --visible probe-form-map C:\temp\template.hwpx C:\temp\template-form-map.xml C:\temp\template-probe.md
& $cli --visible apply-form-map C:\temp\template.hwpx C:\temp\template-form-map.xml C:\temp\filled.hwpx --report C:\temp\filled-apply.md
& $cli apply-form-map --package C:\temp\template.hwpx C:\temp\template-form-map.xml C:\temp\filled-package.hwpx --report C:\temp\filled-package-apply.md
```

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

### List Fields in HWPX

Source: https://zarathucorp.github.io/openhwpsdk/cli-reference

Lists fields within an HWPX template and reports package write contracts. Supports 'press-field' and 'checkbox' types for writes, while others are marked as 'skipped_unsafe'.

```bash
& $cli --visible list-fields C:\temp\template.hwpx C:\temp\field-inventory.md --com
```

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

### List Pictures in HWPX

Source: https://zarathucorp.github.io/openhwpsdk/image-replacement

Inspects an HWPX file to generate an inventory of its pictures, including their properties and binary data paths. This is useful for identifying target images for replacement.

```powershell
$cli = "src\OpenHwp.Automation.Cli\bin\Release\OpenHwp.Automation.Cli.exe"
& $cli list-pictures C:\temp\template.hwpx C:\temp\picture-inventory.md

```

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

### Read Text from HWPX Document

Source: https://zarathucorp.github.io/openhwpsdk/getting-started

Read and display the text content from an existing HWPX file using the CLI. This command is useful for verifying document content.

```powershell
& $cli read-text C:\temp\hello.hwpx
```

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

### Copy from HWPX Document

Source: https://zarathucorp.github.io/openhwpsdk/cli-reference

Copies a source element from one HWPX document to a target location in another, creating a new HWPX file with the copied content. A report of the copy operation is generated.

```bash
& $cli --visible copy-from-doc C:\temp\reference.hwpx C:\temp\target.hwpx C:\temp\copied.hwpx --source image:0 --target doc-end --report C:\temp\copy-report.md
```

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

### Diagnose HWP COM Visibility

Source: https://zarathucorp.github.io/openhwpsdk

Runs the CLI to diagnose HWP COM, with the --visible flag to show the HWP application window during the process. This is useful for debugging COM interactions.

```powershell
src\OpenHwp.Automation.Cli\bin\Release\OpenHwp.Automation.Cli.exe --visible diagnose-com

```

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

### Add Header/Footer Reference

Source: https://zarathucorp.github.io/openhwpsdk/markdown-hwpx-validation-workflow

Adds a reference to a header or footer in an HWPX file, specifying the kind, section, an ID reference, and the page type to apply it to. Generates a report.

```bash
src\OpenHwp.Automation.Cli\bin\Release\OpenHwp.Automation.Cli.exe add-header-footer-reference "C:\temp\template.hwpx" "C:\temp\header_footer_reference.hwpx" --kind footer --section section0 --id-ref footer-ref --apply-page-type ODD --report "C:\temp\header_footer_reference.md"
```

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

### Probe Copying Content from HWPX

Source: https://zarathucorp.github.io/openhwpsdk/markdown-hwpx-validation-workflow

Probes the process of copying content from a reference HWPX to a target HWPX without performing the actual copy. It allows specifying source and target locations and generates a report.

```bash
src\OpenHwp.Automation.Cli\bin\Release\OpenHwp.Automation.Cli.exe --visible probe-copy-from-doc "<reference.hwpx>" "<target.hwpx>" --source image:0 --target doc-end --report "C:\temp\openhwpsdk-out\copy_probe.md"
```

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

### Apply Filled HWPX Form Map with COM

Source: https://zarathucorp.github.io/openhwpsdk/markdown-hwpx-validation-workflow

Applies a filled form map to an HWPX template using HWP automation (COM). This method requires an active HWP editor session.

```bash
src\OpenHwp.Automation.Cli\bin\Release\OpenHwp.Automation.Cli.exe --visible apply-form-map "<template.hwpx>" "C:\temp\openhwpsdk-out\template_form_map_filled.xml" "C:\temp\openhwpsdk-out\template_form_map_applied.hwpx"
```

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

### Probe Copy from HWPX Document

Source: https://zarathucorp.github.io/openhwpsdk/cli-reference

Probes the feasibility of copying a source element (e.g., an image) from one HWPX document to a target location in another. It generates a report to help validate the operation before execution.

```bash
& $cli --visible probe-copy-from-doc C:\temp\reference.hwpx C:\temp\target.hwpx --source image:0 --target doc-end --report C:\temp\copy-probe.md
```

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

### Scan HWPX Features

Source: https://zarathucorp.github.io/openhwpsdk/markdown-hwpx-validation-workflow

Scans HWPX files within a directory to identify and report on various features, including header/footer, fields, bookmarks, and more. Provides detailed coverage analysis.

```bash
src\OpenHwp.Automation.Cli\bin\Release\OpenHwp.Automation.Cli.exe scan-hwpx-features "C:\temp\hwpx-samples" "C:\temp\hwpx_feature_scan.md"
```

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

### Export HWPX Document to PDF

Source: https://zarathucorp.github.io/openhwpsdk/getting-started

Export an HWPX document to a PDF file using the HWP COM interface. The `--visible` flag shows the HWP application during the export process, which is helpful for debugging.

```powershell
& $cli --visible export-pdf C:\temp\hello.hwpx C:\temp\hello.pdf
```

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

### List HWPX Controls

Source: https://zarathucorp.github.io/openhwpsdk/cli-reference

Lists controls within an HWPX document. This command is useful for identifying elements before performing copy/paste operations.

```bash
& $cli --visible list-controls C:\temp\reference.hwpx C:\temp\reference-controls.md
```

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

### Validate HWPX Layout with Row Change Allowlist

Source: https://zarathucorp.github.io/openhwpsdk/markdown-hwpx-validation-workflow

This command validates the layout of HWPX files and allows specifying table indices to ignore row count changes.

```bash
src\OpenHwp.Automation.Cli\bin\Release\OpenHwp.Automation.Cli.exe validate-layout "<template.hwpx>" "C:\temp\openhwpsdk-out\submission_filled.hwpx" "C:\temp\openhwpsdk-out\submission_filled_layout.md" --allow-table-row-change 10

```

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

### Add Columns to HWPX Table

Source: https://zarathucorp.github.io/openhwpsdk/cli-reference

Adds a specified number of columns with provided text content to an existing table in an HWPX file at a given column index. A report of the operation is generated.

```bash
& $cli table-column-package C:\temp\template.hwpx C:\temp\column-added.hwpx --table-index 4 --action add --column 1 --count 1 --text "HNEW;R1NEW;R2NEW" --report C:\temp\column-added-report.md
```

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

### Set Header/Footer Apply Page Type

Source: https://zarathucorp.github.io/openhwpsdk/cli-reference

Updates the 'applyPageType' for an existing header/footer reference in an HWPX file. This command focuses solely on updating the page type and does not create new elements or edit rich content.

```bash
& $cli set-header-footer-apply-page-type C:\temp\template.hwpx C:\temp\header-footer-page-type.hwpx --kind footer --section section0 --id-ref footer-ref --apply-page-type BOTH --report C:\temp\header-footer-page-type.md
```

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

### Add Header/Footer Text with Reference

Source: https://zarathucorp.github.io/openhwpsdk/markdown-hwpx-validation-workflow

Adds specific text to a header or footer section, linked by an ID reference and applied to a particular page type. Generates a report of the operation.

```bash
src\OpenHwp.Automation.Cli\bin\Release\OpenHwp.Automation.Cli.exe add-header-footer-text "C:\temp\template.hwpx" "C:\temp\header_footer_text.hwpx" --kind footer --section section0 --id-ref footer-odd --apply-page-type ODD --text "Odd footer" --report "C:\temp\header_footer_text.md"
```

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

### Validate HWPX Layout

Source: https://zarathucorp.github.io/openhwpsdk/markdown-hwpx-validation-workflow

Performs structural layout validation on an HWPX file, comparing it against a template and generating a detailed report. Essential for ensuring visual consistency.

```bash
src\OpenHwp.Automation.Cli\bin\Release\OpenHwp.Automation.Cli.exe validate-layout "<template.hwpx>" "C:\temp\openhwpsdk-out\cell_fill_education_2rows.hwpx" "C:\temp\openhwpsdk-out\cell_fill_education_2rows_layout_report.md"
```

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

### Validation Commands

Source: https://zarathucorp.github.io/openhwpsdk/cli-reference

Commands to validate document layout and content, generating reports for layout classifications and content requirements.

```powershell
& $cli validate-layout C:\temp\template.hwpx C:\temp\filled.hwpx C:\temp\layout-report.md
& $cli validate-content C:\temp\filled.hwpx C:\temp\content-report.md --require "required text"
```

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

### Probe HWPX Template Form Map

Source: https://zarathucorp.github.io/openhwpsdk/markdown-hwpx-validation-workflow

Probes all mapped positions in an HWPX template without modifying the document. Generates a report detailing the success of finding each form element.

```bash
src\OpenHwp.Automation.Cli\bin\Release\OpenHwp.Automation.Cli.exe --visible probe-form-map "<template.hwpx>" "C:\temp\openhwpsdk-out\template_form_map.xml" "C:\temp\openhwpsdk-out\template_form_map_probe_all.md"
```

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

### Add Rows to HWPX Table

Source: https://zarathucorp.github.io/openhwpsdk/cli-reference

Adds a specified number of rows with provided text content to an existing table in an HWPX file at a given row index. A report of the operation is generated.

```bash
& $cli table-row-package C:\temp\template.hwpx C:\temp\row-added.hwpx --table-index 4 --action add --row 1 --count 2 --text "R1C1|R1C2|R1C3|R1C4;R2C1|R2C2|R2C3|R2C4" --report C:\temp\row-added-report.md
```

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

### Add Header/Footer Reference

Source: https://zarathucorp.github.io/openhwpsdk/cli-reference

Adds a new header/footer reference for an existing 'idRef' within a specified section of an HWPX file. It rejects operations that would duplicate an existing reference with the same kind, section, and applyPageType.

```bash
& $cli add-header-footer-reference C:\temp\template.hwpx C:\temp\header-footer-reference.hwpx --kind footer --section section0 --id-ref footer-ref --apply-page-type ODD --report C:\temp\header-footer-reference.md
```

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

### Style Cells in HWPX Table

Source: https://zarathucorp.github.io/openhwpsdk/markdown-hwpx-validation-workflow

Applies a specific border fill style to a cell within an HWPX table. The command requires the table index, row, column, and the border-fill ID. A report is generated.

```bash
src\OpenHwp.Automation.Cli\bin\Release\OpenHwp.Automation.Cli.exe table-cell-style-package "<template.hwpx>" "C:\temp\openhwpsdk-out\styled_cell.hwpx" --table-index 4 --row 1 --column 1 --border-fill-id 32 --report "C:\temp\openhwpsdk-out\styled_cell_report.md"

```

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

### List Markdown Table Contents

Source: https://zarathucorp.github.io/openhwpsdk/cli-reference

Reads a markdown file and lists its table contents.

```bash
& $cli markdown-table-list C:\temp\input.md
```

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

### Replace Image in HWPX Control

Source: https://zarathucorp.github.io/openhwpsdk/cli-reference

Replaces the image linked to a specific control within an HWPX file while preserving the control's existing properties like placement and wrapping. A report of the replacement operation is generated.

```bash
& $cli replace-image-control C:\temp\template.hwpx C:\temp\replaced.hwpx --target control:gso:0 --image C:\temp\new-image.png --report C:\temp\replace-image-report.md
```

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

### Set Page Number Position

Source: https://zarathucorp.github.io/openhwpsdk/markdown-hwpx-validation-workflow

Configures the position and appearance of page numbers in an HWPX document, including draw position, side character, and generates a report.

```bash
src\OpenHwp.Automation.Cli\bin\Release\OpenHwp.Automation.Cli.exe --visible page-number-set "<template.hwpx>" "C:\temp\page_numbered.hwpx" --draw-pos 5 --side-char "-" --report "C:\temp\page_numbered.md"
```

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

### Extract HWPX Template Form Map

Source: https://zarathucorp.github.io/openhwpsdk/markdown-hwpx-validation-workflow

Extracts the form map from an HWPX template to an XML file. This XML maps document elements and form fields for later manipulation.

```bash
src\OpenHwp.Automation.Cli\bin\Release\OpenHwp.Automation.Cli.exe extract-form-map "<template.hwpx>" "C:\temp\openhwpsdk-out\template_form_map.xml"
```

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

### Replace Image Control in HWPX

Source: https://zarathucorp.github.io/openhwpsdk/image-replacement

Replaces a specific image within an HWPX file with a new image, preserving the original picture control's layout properties. It generates a report detailing the replacement process and validation checks.

```powershell
& $cli replace-image-control C:\temp\template.hwpx C:\temp\replaced.hwpx --target control:gso:0 --image C:\temp\new-image.png --report C:\temp\replace-image-report.md

```

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

### Set Header/Footer Text

Source: https://zarathucorp.github.io/openhwpsdk/markdown-hwpx-validation-workflow

Modifies the text content of a specific header or footer section within an HWPX file and generates a report detailing the changes.

```bash
src\OpenHwp.Automation.Cli\bin\Release\OpenHwp.Automation.Cli.exe set-header-footer-text "C:\temp\template.hwpx" "C:\temp\header_footer_text_write.hwpx" --kind header --section section0 --anchor "Header fixture" --text "Updated Header Fixture" --report "C:\temp\header_footer_text_write.md"
```

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

### Set Cell Background Color in HWPX Table

Source: https://zarathucorp.github.io/openhwpsdk/markdown-hwpx-validation-workflow

Applies a background color to a specific cell in an HWPX table using a hex color code. The command specifies the table index, row, column, and the color. A report is generated.

```bash
src\OpenHwp.Automation.Cli\bin\Release\OpenHwp.Automation.Cli.exe table-cell-background-package "<template.hwpx>" "C:\temp\openhwpsdk-out\background_cell.hwpx" --table-index 4 --row 1 --column 1 --color "#FFF2CC" --report "C:\temp\openhwpsdk-out\background_cell_report.md"

```

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

### Equalize HWPX Table Cell Sizes

Source: https://zarathucorp.github.io/openhwpsdk/cli-reference

Adjusts the widths and heights of cells within a specified HWPX table to be equal. A report of the equalization is generated.

```bash
& $cli table-cell-size-package C:\temp\template.hwpx C:\temp\equalized-table.hwpx --table-index 11 --equalize-widths --equalize-heights --report C:\temp\equalized-table-report.md
```

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

### Validate HWPX Content

Source: https://zarathucorp.github.io/openhwpsdk/markdown-hwpx-validation-workflow

Validates the content of an HWPX file against specified requirements and generates a content report. Useful for ensuring data integrity and adherence to standards.

```bash
src\OpenHwp.Automation.Cli\bin\Release\OpenHwp.Automation.Cli.exe validate-content "C:\temp\openhwpsdk-out\submission_filled.hwpx" "C:\temp\openhwpsdk-out\submission_filled_content_report.md" --require "required text"
```

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

### Split Merged Cells in HWPX Table

Source: https://zarathucorp.github.io/openhwpsdk/markdown-hwpx-validation-workflow

Splits a previously merged cell in an HWPX table back into multiple cells, defining the new content for each. The command specifies the source file, output file, table index, and the new cell text. A report is generated.

```bash
src\OpenHwp.Automation.Cli\bin\Release\OpenHwp.Automation.Cli.exe table-split-package "C:\temp\openhwpsdk-out\table_merged.hwpx" "C:\temp\openhwpsdk-out\table_split.hwpx" --table-index 4 --row 1 --column 1 --text "A|B;C|D" --report "C:\temp\openhwpsdk-out\table_split_report.md"

```

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

### Align Cells in HWPX Table

Source: https://zarathucorp.github.io/openhwpsdk/markdown-hwpx-validation-workflow

Sets the horizontal and vertical alignment for a specific cell within an HWPX table. The command specifies the table index, row, column, and the desired alignment. A report is generated.

```bash
src\OpenHwp.Automation.Cli\bin\Release\OpenHwp.Automation.Cli.exe table-cell-align-package "<template.hwpx>" "C:\temp\openhwpsdk-out\aligned_cell.hwpx" --table-index 4 --row 1 --column 1 --horizontal right --vertical bottom --report "C:\temp\openhwpsdk-out\aligned_cell_report.md"

```

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

### Set HWPX Table Cell Background

Source: https://zarathucorp.github.io/openhwpsdk/cli-reference

Sets the background color for a specific cell within an HWPX table. A report of the modification is generated.

```bash
& $cli table-cell-background-package C:\temp\template.hwpx C:\temp\background-cell.hwpx --table-index 4 --row 1 --column 1 --color "#FFF2CC" --report C:\temp\background-cell-report.md
```

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

### Add Diagonal Line to Cell in HWPX Table

Source: https://zarathucorp.github.io/openhwpsdk/markdown-hwpx-validation-workflow

Adds a diagonal line to a specified cell in an HWPX table, allowing customization of direction, width, and color. A report of the operation is generated.

```bash
src\OpenHwp.Automation.Cli\bin\Release\OpenHwp.Automation.Cli.exe table-cell-diagonal-package "<template.hwpx>" "C:\temp\openhwpsdk-out\diagonal_cell.hwpx" --table-index 4 --row 1 --column 1 --direction both --width "0.15 mm" --color "#000000" --report "C:\temp\openhwpsdk-out\diagonal_cell_report.md"

```
Tokens:
Raw