# AMPP Folder Organizer

IronPython 3.4 script for Grass Valley AMPP Framelight X Script Task brick. Automatically organizes ingested assets into nested virtual folders based on filename prefixes, using `--` as the path delimiter.

## Overview

This script runs as part of the FramelightX asset ingestion pipeline. It parses filenames with the format:

```
FolderName--SubFolder--Filename.ext
```

and creates the folder structure `FolderName/SubFolder/` in AMPP, linking the asset to the deepest folder.

## Example

| Filename | Result |
|----------|--------|
| `BMG--Videos--Clip1.mp4` | Creates `BMG/Videos/`, links asset there |
| `NEWS--PKG--Story.mxf` | Creates `NEWS/PKG/`, links asset there |
| `IMG--4709.jpg` | Creates `IMG/`, links asset there |
| `NoPrefix.mp4` | Skipped (no `--` found) |

## History

- **v3.2** → v3.3: Fixed special character handling in folder names (apostrophes, ampersands, etc.) by properly URL-encoding the hierarchy lookup path.

## Environment

- **Runtime:** IronPython 3.4 on .NET 8
- **Available Objects:** `httpClient` (ScriptHttpClient), `job` (ScsJob), `asset` (ScriptAsset), `logger` (ScriptLogger)
- **HTTP Endpoint:** Relative paths to AMPP API (e.g., `api/v1/store/folder/folders`)

## API Calls

### Get or check folder existence
```
GET api/v1/store/folder/folders/hierarchy?path={encoded_path}
```

### Create folder
```
POST api/v1/store/folder/folders
Body: {"name:text": "FolderName", "parentFolders:tags": ["parentFolderId"]}
```

### Link asset to folder
```
POST api/v1/store/folder/references
Body: {"folder:id": "folderId", "asset:id": "assetId"}
```

## Deployment

Copy the script content into a FramelightX **Script Task** brick. Place it **before** the Proxy Generator in the ingest workflow.

## Notes

- The script is idempotent: running it multiple times on the same asset is safe.
- Special characters (apostrophes, ampersands, parentheses) are preserved in folder names.
- The `--` delimiter is URL-safe and does not conflict with filesystem conventions.