Work with Structured Data
Steps
Have a connected assistant read and update the entries an XWiki application keeps on its pages, such as meetings, tasks or blog posts (see Agent Authentication for what it may open and change).
- Ask the assistant which fields the application's entries have.
- Ask for the entries you want, naming the fields to show and any condition they must meet.
- Ask it to change an entry, and check what it reports: the fields it set and the page's new version. It reads the entry's current version first, because an update is refused if the page changed since.
FAQ
Why does the assistant say a value is invalid?
It checks the field's type: a number, a date or a boolean that does not parse is refused. A value for a list field is stored as given, and the class's validation regexp is not checked, so a choice that is not in the list is not caught.
Can it set a password or a computed field?
No. Password fields and computed fields cannot be set with the write tools: passwords can only be set in the wiki UI, and a computed field has no stored value.
Can it change the fields themselves?
Yes, where the write tools are enabled, and that changes every entry of that application at once. Agree it with your administrator before asking for it.
Where are these entries stored?
On wiki pages, as structured objects attached to them, which is why changing one saves a new version of its page.
