dohertj2/wwtools
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Revert "graccesscli/docs: document the package-only writeback boundary"

Browse Source 
This reverts commit c12fbc5988.
This commit is contained in:
Joseph Doherty
2026-05-05 21:19:00 -04:00
parent 4e242ca824
commit e4e54254d8
1 changed files with 0 additions and 37 deletions
Download Patch File Download Diff File Expand all files Collapse all files
graccesscli/docs/script-parsing.md
-37
View File
@@ -88,43 +88,6 @@ $scripts | Sort-Object Name | Select-Object Name, DataType, Category, Locked
This discovers script-related setting names and metadata. For bodies, prefer `object scripts get --llm-json` or `object snapshot --llm-json`; both can include package-backed script text when GRAccess export is available. Normal CLI script parsing must not query the Galaxy SQL database; SQL is development verification/debug-only.
## Editing Script Content
`IAttribute.SetValue` is **not** a complete editor for ScriptExtension content. The GRAccess COM API silently no-ops writes to any attribute whose `AttributeCategory` is `MxCategoryPackageOnly` or `MxCategoryPackageOnly_Lockable` — the call returns `Successful=true`, the surrounding checkout/save/checkin sequence completes cleanly, and a verify-read via direct `IAttribute.GetValue` confirms the value is unchanged.
For a `ScriptExtension` primitive named `Foo`, the package-only fields are:
| Field | Editable via `SetValue` | Editable via |
|---|---|---|
| `Foo.ExecuteText` | no — `MxCategoryPackageOnly_Lockable` | System Platform IDE |
| `Foo.DeclarationsText` | no — `MxCategoryPackageOnly_Lockable` | IDE |
| `Foo.StartupText` | no — `MxCategoryPackageOnly_Lockable` | IDE |
| `Foo.ShutdownText` | no — `MxCategoryPackageOnly_Lockable` | IDE |
| `Foo.OnScanText` | no — `MxCategoryPackageOnly_Lockable` | IDE |
| `Foo.OffScanText` | no — `MxCategoryPackageOnly_Lockable` | IDE |
| `Foo.Expression` | no — `MxCategoryPackageOnly_Lockable` | IDE |
| `Foo.TriggerType` | yes — `MxCategoryWriteable_C_Lockable` | `object scripts settings set --trigger-type` |
| `Foo.TriggerPeriod` | yes — `MxCategoryWriteable_C_Lockable` | `object scripts settings set --trigger-period-ms` |
The CLI guards every `SetValue` site with `EnsureMutableViaSetValue`. Writes to package-only attributes fail fast with `exit 1` and a message naming the category, instead of returning a misleading `success: true`. This applies to:
- `object scripts set` (any `--field` that's package-only, including the default `ExecuteText`)
- `object scripts settings set --expression`
- `object attribute value set` (any direct write to a package-only attribute)
`object scripts create` (which calls `AddExtensionPrimitive`) and `object scripts delete` (which calls `DeleteExtensionPrimitive`) are NOT affected — primitive add/delete uses a different COM path and does persist.
To inspect which attributes are package-only on a given object, use:
```powershell
graccess object attributes --galaxy ZB --name '$DelmiaReceiver' --type template --configurable --json |
ConvertFrom-Json |
Where-Object { $_.Category -like 'MxCategoryPackageOnly*' } |
Select-Object Name, Category
```
There is no documented GRAccess COM path that bypasses this restriction; the IDE edits script bodies through a separate Object Editor channel (IDM) that is not exposed to GRAccess clients. Bulk script changes that need automation should be staged via the IDE and exported to `.aaPKG`, then the package promoted between Galaxies via `objects export` / `galaxy import-objects`.
## Export Template Objects For Script Bodies
Use object export when you need the full object configuration, including script bodies, declarations, triggers, and extension payloads that are not exposed as simple attribute metadata: