Update README with LGL Team migration documentation

- Document wrike_monitor_lgl.py production version
- Explain HTML link format for OMG# field
- Document recursive duplicate detection in Business Areas
- Add discovery tool usage instructions
- Add Version 3.0 changelog
- Clarify differences between Staging and LGL Team versions
This commit is contained in:
Dave Porter 2025-12-17 15:22:38 -05:00
parent a0cfe4b796
commit 026d97d491

View file

@ -1,14 +1,17 @@
# Wrike Import Tools
Two Python tools for automatically importing project structures and deliverable tasks into Wrike from JSON files.
Python tools for automatically importing project structures and deliverable tasks into Wrike from JSON files.
## Tools Overview
### 1. wrike_import.py - Simple Batch Processor
A standalone script for one-time or manual batch imports. Processes all JSON files in a directory and exits.
### 1. wrike_monitor.py - Real-time Monitor Service (Staging)
A continuous monitoring service that watches a folder 24/7, processes files as they arrive, and sends daily email reports. Designed to run as a systemd service on the **Staging board**.
### 2. wrike_monitor.py - Real-time Monitor Service
A continuous monitoring service that watches a folder 24/7, processes files as they arrive, and sends daily email reports. Designed to run as a systemd service.
### 2. wrike_monitor_lgl.py - Real-time Monitor Service (LGL Team - Production)
Production version configured for the **LGL Team board**. Features recursive duplicate detection across the entire Business Areas folder and stores OMG# as HTML links matching the existing board format.
### 3. discover_board_info.py - Board Discovery Tool
Automated tool to discover Space IDs, custom field IDs, and item types for any Wrike board. Generates configuration snippets for easy setup.
## Common Features
@ -546,9 +549,66 @@ This script is provided as-is for internal use.
- Production deployment as a service
- Detailed statistics and monitoring
## LGL Team Production Version (wrike_monitor_lgl.py)
### Key Differences from Staging Version
**OMG# Format:**
- LGL Team stores OMG# as **HTML links** instead of plain text
- Format: `<a href="https://bissell.omg.oliver.solutions/projects/{id}">{number}</a>`
- Script automatically generates and parses HTML format
**Duplicate Detection:**
- **Recursive search** across entire "Business Areas" folder
- Uses `descendants=true` API parameter for efficient searching
- Searches **ALL subfolders** at any depth
- If OMG# exists anywhere in Business Areas → Skip (no duplicate)
- Other folders (Templates, Production Tracker, etc.) are ignored
**Configuration:**
- API Token: Updated for production access
- Space: "LGL Team" (MQAAAABoHcTY)
- All 11 custom fields mapped to LGL Team IDs
- Custom item types not required (set to None)
**Running the LGL Team Version:**
```bash
# Install dependencies
pip install -r requirements.txt
# Configure paths in wrike_monitor_lgl.py (lines 41-44)
# Run the monitor
python wrike_monitor_lgl.py
```
### Discovery Tool Usage
To discover configuration for any board:
```bash
# Run discovery tool
python discover_board_info.py
# Edit TARGET_SPACE in the script to discover different boards
# Generates config_{space_name}.py with all IDs
```
## Changelog
### Version 2.0 (Current)
### Version 3.0 (December 2025) - LGL Team Migration
- **NEW**: Added wrike_monitor_lgl.py for LGL Team (production) board
- **NEW**: HTML link format for OMG# field (matching existing entries)
- **NEW**: Recursive duplicate detection across entire Business Areas folder
- **NEW**: discover_board_info.py - automated board configuration discovery
- **NEW**: HTML extraction and comparison for accurate duplicate detection
- **NEW**: Global OMG# uniqueness within Business Areas folder
- **IMPROVED**: Duplicate detection now searches recursively, not just parent project
- **IMPROVED**: OMG# format matches existing board entries (clickable links)
- **FIXED**: Handles OMG# stored as HTML `<a>` tags
- **ADDED**: config_lgl_team.py - LGL Team configuration reference
- **ADDED**: test_duplicate_detection.py - testing tool
### Version 2.0
- **NEW**: Added wrike_monitor.py - real-time monitoring service
- **NEW**: Folder watching with watchdog
- **NEW**: Daily email reports at 7PM