proj_set_document_parameter
Set or update document-level parameters like title block data on a specific schematic sheet. Creates a hidden parameter if missing and writes it to disk immediately.
Instructions
Set a document-level parameter on a specific schematic sheet.
Useful for per-sheet title block data (e.g., "SheetTitle", "Revision"). If the parameter already exists it is updated; otherwise a new hidden parameter object is created on the sheet.
NOTE: the target sheet must already be loaded as a proper project
member. Call proj_load_sheets once at the start of a batch;
auto-opening from inside this tool risks detaching the sheet and
rendering it as a "free document". If the sheet isn't loaded this
tool returns NOT_LOADED.
The write is persisted to disk immediately via the IServerDocument
API, no subsequent app_save_all is required.
Args: file_path: Full path to the schematic document (.SchDoc). Use Windows-style backslashes (e.g. C:\path\Sheet.SchDoc), not forward slashes. name: Parameter name value: Parameter value
Returns:
Dictionary with file_path, name, value, and dirty=true
(the in-memory flag; the disk write already happened, so no
app_save_all is needed for this parameter).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | ||
| value | Yes | ||
| file_path | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||