Persistence Layer: usage all-versions and all-forms

[bruno.buzzi]

Alex/Erik,

Testing GemStone/S Persistence layer with Orbeon Forms 2018.2.3.201905172253
PE popup some doubts on me:

From:
https://doc.orbeon.com/form-runner/api/persistence/forms-metadata#api

There are two options: all-versions & all-forms

So far i only see these options used inside Form Builder (to get all
versions of a given form definition) and displaying Summaries (to get only
version equals to the selected version in the combobox).

This is working ok on GemStone/S PL.

But from the documentation it seems that Form Runner Home page should
support these options ? Or i'm confused ?
(https://doc.orbeon.com/form-runner/api/persistence/forms-metadata#api)

Something like:
https://demo.orbeon.com/demo/fr/?all-versions=true&all-forms=true

I tried these URL on Orbeon demo but answer "Page Not Found".

Or after all these two option are only used inside Form Builder (to create
Versions combobox) and in Summaries to create also (Versions combobox) ?

It seems i do not see the applicability of these two options.

regards,
bruno


--
Sent from: http://discuss.orbeon.com/

[Alessandro Vernet]

Hi Bruno,

I am not sure to follow. How specifically would you want the Form Runner
home page to behave differently?

At this point:

- As far as permissions, if the user is an admin, then the home page shows
all forms (`all-forms=true` behavior); otherwise it only shows the forms the
user has access to.
- As far as versioning and the Form Runner home page, we have a few
improvements in mind, for instance, when publishing, to better control what
version you publish to, maybe like you can when publishing from Form Builder
(https://github.com/orbeon/orbeon-forms/issues/1451), and just showing
version information (https://github.com/orbeon/orbeon-forms/issues/3448).

‑Alex

-----
--
Follow Orbeon on Twitter: @orbeon
Follow me on Twitter: @avernet

[bruno.buzzi]

Alex,

Actually was a general question about *all-versions=true* and
*all-forms=true* options described at:
https://doc.orbeon.com/form-runner/api/persistence/forms-metadata#api

Where and when these two options are used ?

regards,
bruno

[Alessandro Vernet]

Hi Bruno,

Got it, so here is what I can find:

- `all-forms`, defaults to `false`: The default is useful if you want to
show the forms the current user has access to, for instance to build a list
with links to `/new` or `/summary` for each form. Setting it to `true` is
useful if you want to really see all the published forms, including
libraries, unavailable forms, and also without taking permissions into
account. The Form Runner home page uses both of those, depending on whether
you're an admin or not.

https://doc.orbeon.com/form-runner/api/persistence/forms-metadata#returning-all-form-definitions

- `all-versions`, defaults to `false`: The Form Runner home page currently
doesn't do much with versioning, so uses the default. But everywhere you
care to who about the different versions of a form you have published, then
you would want to set this parameter to `true`. For instance, you'll want to
use `true` in summary pages, where we now have a drop-down to select the
form version. Also, `true` would be used in Form Builder, when publishing a
form, to populate the dropdown allowing you to select an existing version of
a form you might want to override.

https://doc.orbeon.com/form-runner/api/persistence/forms-metadata#returning-all-form-definition-versions

You'll let me know if this helps.

‑Alex

-----
--
Follow Orbeon on Twitter: @orbeon
Follow me on Twitter: @avernet