# Quick Start Guide: Linking Excel Actions to Word

## Installation (One-Time Setup)

```bash
# Install required Python libraries
pip install -r requirements.txt
```

## Basic Usage

### Step 1: Download Your Files from Google Drive

Download both your `.xlsx` (actions) and `.docx` (meeting minutes) files to your computer.

### Step 2: Add a Placeholder in Your Word Document

Open your Word document and where you want to insert action data, type:
```
<<ACTION_NO>>
```

Or for a specific action:
```
<<ACTION_003>>
```

### Step 3: Run the Script

**Simple example - insert all fields:**
```bash
python link_excel_to_word.py --excel actions.xlsx --word minutes.docx --action-no 003
```

**Insert only specific fields as a table:**
```bash
python link_excel_to_word.py --excel actions.xlsx --word minutes.docx --action-no 003 \
  --table --fields "Action Short Title,Who,Status,Priority"
```

### Step 4: Upload Updated Document to Google Drive

Upload your updated Word document back to Google Drive.

## Common Examples

### View Action Data Without Modifying Word
```bash
python link_excel_to_word.py --excel actions.xlsx --action-no 003
```

### Insert Multiple Actions at Once
```bash
./example_link_actions.sh actions.xlsx minutes.docx 003 004 005
```

## What Gets Inserted?

- **Without --table**: A compact text format like "Action Short Title: Events Planner | Who: BK | Status: Open"
- **With --table**: A nicely formatted 2-column table with Field names and Values

## Need Help?

See `ACTION_ITEM_LINKING_GUIDE.md` for detailed documentation.