---
auto_generated: true
created: 2026-05-18
manual_updated_at: 2026-05-18
modified: 2026-05-18
name: User_Manual
status: active
tags:
- client/hm
- status/active
- tech/typescript
- type/sop
type: sop
---

# USER_MANUAL: H&M O2E Tool (OMG Static)

## What This Tool Does

The H&M O2E Tool (OMG Static) is a web-based utility designed to streamline document management for H&M agents using the One2Edit API. It automates repetitive tasks such as relinking missing images in InDesign documents, checking image status across folders, exporting documents to InDesign and PDF formats, and validating image aspect ratios.

## Who Uses It

This tool is intended for:
- **H&M Agents**: Content managers and designers who handle H&M marketing materials.
- **Digital Asset Managers**: Staff responsible for maintaining image libraries and document integrity.
- **Quality Assurance Personnel**: Users who need to validate image ratios and link statuses across campaigns.

## How to Access

1. Open your preferred web browser.
2. Navigate to the `index.html` file provided in the project directory.
3. The tool will load directly in your browser; no server installation is required for basic usage.

## Main Workflows

### 1. Relink Images
Automatically fixes broken image links in H&M documents.

**Option A: Link by File**
1. Select **"Relink Images"** from the action dropdown.
2. Choose **"Link by File"** as the method.
3. Enter the specific **Document ID** of the file to process.
4. Click **Submit**.

**Option B: Link by Folder**
1. Select **"Relink Images"** from the action dropdown.
2. Choose **"Link by Folder"** as the method.
3. Enter the **Folder ID** containing the documents.
4. Click **Submit** to batch-process all documents in that folder.

### 2. Check Image Status
View which images are linked and which are missing across multiple documents.

1. Select **"Image Status"** from the action dropdown.
2. Enter the **Folder ID** to analyze.
3. Click **Submit**.
4. Review the results: see per-document status and folder-level summaries (linked vs. missing).

### 3. Export INDD Documents
Convert documents in a folder to InDesign (.indd) format.

1. Select **"Export INDD"** from the action dropdown.
2. Enter the **Folder ID** containing the documents.
3. Click **Submit**.
4. Assets will be exported to the designated location.

### 4. Export PDF Documents
Export documents to PDF with specific filtering and naming conventions.

1. Select **"Export PDF"** from the action dropdown.
2. Enter the **Folder ID**.
3. Click **Submit**.
4. The tool applies **R100 filtering** and transforms names (e.g., `R100` becomes `RATIOS`).

### 5. Ratio Check
Validate image aspect ratios against expected standards.

1. Select **"Ratio Check"** from the action dropdown.
2. Enter the **Input Path** of the images or folder.
3. Enter the **Expected Ratio** (e.g., 1.414 for A4).
4. Enter the **Tolerance** value for acceptable deviation.
5. Click **Submit** to validate.

## FAQ

**Q: What is a "Session"?**
A: A session is a temporary working context used to open, modify, and save documents. The tool automatically manages opening and closing these sessions.

**Q: How are images matched if the original link is broken?**
A: The tool uses intelligent matching:
- For H&M logos, it uses hardcoded asset IDs.
- For generic images, it searches the campaign folder structure (`Assets/[Campaign]/Links/RGB` or `CMYK`) using fuzzy matching algorithms.

**Q: Can I process multiple folders at once?**
A: Currently, folder-level actions (Export, Status, Relink) process one folder ID at a time. Batch processing across multiple distinct folders is not supported in a single click.

**Q: Why are my exported PDFs renamed?**
A: The PDF export feature includes a name transformation step where `R100` is replaced with `RATIOS` to comply with branding or file naming conventions.

## Related
- [[01 Projects/hm-o2e-tool/DEVELOPER_MANUAL.md]]