@lotics/cli 0.318.23 → 0.318.24
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/docs/agent_surface.md
CHANGED
|
@@ -98,6 +98,7 @@ the screen already holds.
|
|
|
98
98
|
| `create_<entity>` | Opens one row of <entity>. | every field the add asks, and the link it files the row under | an entity the app adds rows of |
|
|
99
99
|
| `update_<entity>` | Changes one row of <entity>; every input but the row is optional, and one left out is left as it is. | `record_id`, and each field a person edits — a files field or a link to several rows as `<field>_added` / `<field>_removed` | an entity the app edits |
|
|
100
100
|
| `remove_<entity>` | Removes one row of <entity>. | `record_id` | an entity the app removes rows of |
|
|
101
|
+
| `restore_<entity>` | Brings back one deleted row of <entity>. | `record_id` | an entity the app removes rows of |
|
|
101
102
|
| `act_<act>` | <label> — on one row of <entity>, refused where its conditions do not hold. | `record_id` — `record_ids` on an act over several rows — and what the act asks | each Act that names no workflow of its own |
|
|
102
103
|
| `archive_<act>` | Hands back every file of <label> on one row of <entity> as one archive. | `record_id` | an Act making a set of papers (`templates`) |
|
|
103
104
|
| `<workflow>_<book>` | The workflow of that name as a Book of the app, or a log of it, runs it, where its own table or page makes it differ. | that workflow's | an app with Books or logs |
|
|
@@ -33,7 +33,7 @@ Every record read carries `comment_count`. `query_records` takes `comments: true
|
|
|
33
33
|
|
|
34
34
|
## Deleting and restoring
|
|
35
35
|
|
|
36
|
-
A keyed entry is removed by `null`: a field, check, view, option, instruction, query alias, a member or a group. A resource addressed by its id is deleted with `delete: true` and brought back with `restore: true`, beside its id: a table in a `set_tables` item (`{ table_id, delete: true }`; `cascade` deletes the links that point at the deleted tables and is refused unless the call deletes; `force` goes with a patch that loses stored values and is refused on a call that only deletes or restores), a knowledge doc (`set_knowledge` with `knowledge_doc_id`), a template (`set_template` with `template_id`), an app (`set_app` with `app_id`) and a workflow (`set_workflow` with `workflow_id`; a deletion only). Records are deleted by `delete_records` and brought back by `update_records` with `restore: true` and `record_ids` or `filters
|
|
36
|
+
A keyed entry is removed by `null`: a field, check, view, option, instruction, query alias, a member or a group. A resource addressed by its id is deleted with `delete: true` and brought back with `restore: true`, beside its id: a table in a `set_tables` item (`{ table_id, delete: true }`; `cascade` deletes the links that point at the deleted tables and is refused unless the call deletes; `force` goes with a patch that loses stored values and is refused on a call that only deletes or restores), a knowledge doc (`set_knowledge` with `knowledge_doc_id`), a template (`set_template` with `template_id`), an app (`set_app` with `app_id`) and a workflow (`set_workflow` with `workflow_id`; a deletion only). Records are deleted by `delete_records` and brought back by `update_records` with `restore: true` and `record_ids` or `filters`: the rows their delete took come back with them, all or none, and a row needing its link stays deleted while the row it names does. `delete` takes no other key. A call that deletes asks for approval; one that does not never does.
|
|
37
37
|
|
|
38
38
|
## Locking and changing a locked record
|
|
39
39
|
|
|
@@ -41,7 +41,7 @@ A keyed entry is removed by `null`: a field, check, view, option, instruction, q
|
|
|
41
41
|
|
|
42
42
|
## Undoing a write
|
|
43
43
|
|
|
44
|
-
A write is put back by writing the value `query_audit_logs` shows before the change: `update_records` for a field, `update_records` with `restore: true` for a deleted record, `delete_records` for a record a run created.
|
|
44
|
+
A write is put back by writing the value `query_audit_logs` shows before the change: `update_records` for a field, `update_records` with `restore: true` for a deleted record, with the rows its delete took, or an app's `restore_<entity>` where the row went by that app's Delete, `delete_records` for a record a run created.
|
|
45
45
|
|
|
46
46
|
## Files
|
|
47
47
|
|