---
auto_generated: true
created: 2026-05-18
manual_updated_at: 2026-05-18
modified: 2026-05-18
name: User_Manual
status: active
tags:
- client/dowjones
- domain/ai
- tech/gemini
- type/sop
type: sop
---

# User Manual: Dow Jones Job Naming Tool

## What This Tool Does

The Dow Jones Job Naming Tool is a web-based application designed to generate standardized job names for marketing, events, and content initiatives following the Dow Jones naming convention. It features an interactive spreadsheet interface for bulk management and an AI-powered command bar (powered by Google Gemini) for natural language input.

## Who Uses It

- **Marketing Teams**: For tracking performance marketing campaigns (PMKT).
- **Brand Managers**: For managing brand initiatives (BRND).
- **Event Coordinators**: For naming and tracking specific events (EVNT).
- **B2B Operations**: For managing business-to-business projects (B2B).

## How to Access

1. Navigate to the web application URL in your browser.
2. Ensure you have an active internet connection, as the tool fetches data from a backend API and uses Google Gemini for AI features.
3. Upon loading, the tool will display a spreadsheet interface with existing job records.

## Main Workflows

### 1. Manual Job Name Creation

1. **Open the Spreadsheet**: Locate the empty row at the bottom or select an existing row to edit.
2. **Fill in Variables**:
   - **OMGID**: Enter the unique Job ID (e.g., `000000`).
   - **Domain**: Select from the dropdown: `PMKT`, `BRND`, `EVNT`, or `B2B`.
   - **Subteam**: (Required for non-EVNT domains) Select from `ACQ`, `B2B`, `CMKT`, `ENGRT`, or `ENT`.
   - **Brand**: (Required for non-EVNT domains) Select from the list (e.g., `WSJ`, `WSJ+`, `BAR`).
   - **Event**: (Required for EVNT domain) Select from the dropdown (e.g., `GH`, `GFF`).
   - **Initiative**: Enter a short text description (e.g., `BIC`, `Email`).
   - **YY**: Enter the 2-digit year (e.g., `26`).
   - **Sequence**: Enter the sequence number (e.g., `01`).
   - **AssetName**: Enter the asset name (e.g., `MetaBanner`).
   - **Version**: Enter the version number (e.g., `1`).
3. **Auto-Generation**: The **Filename** column will automatically generate the standardized name based on the naming convention:
   - **Standard**: `[OMGID] - [Domain]-[Subteam]-[Brand]-[Initiative]-[YY]-[Sequence]_[AssetName]_v[Version]`
   - **Event**: `[OMGID] - EVNT-[EventAbbrev]-[YY]-[Sequence]_[AssetName]_v[Version]`
4. **Save**: Data is saved locally via the browser's session or local storage mechanism triggered by `saveData()`.

### 2. Using the AI Command Bar

1. Locate the command input bar at the top of the interface.
2. Type a natural language request (e.g., "Create a new job for PMKT ACQ WSJ BIC-26-01").
3. Click **Send** or press Enter.
4. The tool processes the request via Google Gemini, parses the intent, and populates the spreadsheet rows accordingly.
5. Review the generated rows in the spreadsheet and verify the auto-generated filenames.

### 3. Exporting Data

1. Click the **Export** button (usually located in the toolbar).
2. The current state of the spreadsheet will be downloaded or shared based on the implementation of `exportBtn`. Note: The codebase references `jspreadsheet`, which may support built-in CSV/Excel export.

## FAQ

**Q: Why does my filename look wrong?**
A: Ensure you have selected the correct Domain. If Domain is `EVNT`, Subteam and Brand fields are hidden/irrelevant. If Domain is not `EVNT`, Subteam and Brand are mandatory.

**Q: Can I edit an existing row?**
A: Yes, simply click on any cell in the spreadsheet and modify the value. The filename will update automatically.

**Q: Where is the data stored?**
A: Data is fetched from `api.php?action=load` on page load and saved via `saveData()` (likely to a backend database or local storage depending on the implementation of that function, which is not fully visible in the snippet but implied to be persistent).

**Q: What if I don't see the AI Command Bar?**
A: Check your browser console for errors. The tool requires `google-gemini` integration which may fail if API keys are missing or network requests are blocked.

**Q: How do I clear the URL params after using the builder mode?**
A: The tool automatically clears the URL parameters after parsing them to create a new row, using `window.history.replaceState()`.

## Related
- [[01 Projects/wsj-filenaming/DEVELOPER_MANUAL.md]]