Arvados

Updates at e92ec73 - branch 15067-tag-editing-by-ids (wb2's repo)

I'm really struggling trying to make the view show the key/value labels but use their ids when adding a tag. I believe the handleSelect callback may be useful to somehow stash the selected key/value's id somewhere so it can be retrieved at the moment the Add button is clicked.

Already tried the other way around: handling the IDs but I think it's not possible to make the Input component to show the labels because it needs a string while calling onChange and that string is what it'll show on the view.

Any idea will be most appreciated!

My initial impression is that there has to be a way to have form submit with an object. Maybe this will help? https://redux-form.com/7.0.2/docs/faq/customcomponent.md/ Also maybe take a look in view-components/form-fields. These might already do something similar.

If this is impossible, we could connect with the dispatcher and update some other state with the the data we need and use that when the form s submitted. https://redux-form.com/7.0.2/docs/faq/howtoconnect.md/ This should probably be our last resort though.

Updates at 796a3ce0 (WB2 repo)

I've been making lots of progress: The properties' ids are saved on hidden fields on the form so they're available on submission at the same time that the visible fields keep showing the labels. The property "chips" render the properties by their labels when possible, keeping the "copy to clipboard" feature as before, that is, copying the real data to the clipboard (it's trivial to change it).

Also, when some key or value has more than 1 label, the suggestion dropdown list show all the possibilities, and uses the right id when selected. On chip rendering, the displayed label will be the first occurrence as declared on the vocabulary.

Lucas Di Pentima wrote:

Updates at 796a3ce0 (WB2 repo)

I've been making lots of progress: The properties' ids are saved on hidden fields on the form so they're available on submission at the same time that the visible fields keep showing the labels. The property "chips" render the properties by their labels when possible, keeping the "copy to clipboard" feature as before, that is, copying the real data to the clipboard (it's trivial to change it).

Also, when some key or value has more than 1 label, the suggestion dropdown list show all the possibilities, and uses the right id when selected. On chip rendering, the displayed label will be the first occurrence as declared on the vocabulary.

Works great for collections! I know you're still working on it, but here are my observations.

• src/common/config.ts - has a FIXME.

• When clicking on the tag to copy, it copies the IDs not the labels (Looks like you mentioned this above).

• Looks like according to this, you might not need the actual <Field> tag for the hidden field. https://stackoverflow.com/questions/44218104/how-to-set-hidden-fields-in-redux-form-in-react-native/45351256#45351256. If we still need the tags, the hidden fields will expose the ID via browser developer tools. Is this a problem? My initial thought is that as long as we document it for users who are writing a vocabulary, it should be fine.

• What about other places where you can select properties, like the project details panel and from the search drop down? Are these a part of this ticket?

• Do we need a wiki page for how to write a vocabulary with an example and instructions for how to add it to WB2, etc?

• The the more complicated functions moved to vocabulary.ts (getTags, getTagValues) seem pretty isolated and could benefit from unit tests with some vocab permutations. tree.tests.ts might be handy as an example.

Updates at 2f93708c (wb2 repo)
Documentation branch pending.

Eric Biagiotti wrote:

Works great for collections! I know you're still working on it, but here are my observations.

• src/common/config.ts - has a FIXME.

Whoops, fixed.

• When clicking on the tag to copy, it copies the IDs not the labels (Looks like you mentioned this above).

Yes, now it copies whatever the user is reading on the screen.

• Looks like according to this, you might not need the actual <Field> tag for the hidden field. https://stackoverflow.com/questions/44218104/how-to-set-hidden-fields-in-redux-form-in-react-native/45351256#45351256. If we still need the tags, the hidden fields will expose the ID via browser developer tools. Is this a problem? My initial thought is that as long as we document it for users who are writing a vocabulary, it should be fine.

You were right, hidden Field weren't necessary, removed!

• What about other places where you can select properties, like the project details panel and from the search drop down? Are these a part of this ticket?

The search part is being addressed on #15069, but I've reused these components on the project detail panels. Also took the opportunity to make a PropertyChipComponent so it's now being used on the 3 places instead of repeating almost the same code.

• Do we need a wiki page for how to write a vocabulary with an example and instructions for how to add it to WB2, etc?

Will do on the arvados repo.

• The the more complicated functions moved to vocabulary.ts (getTags, getTagValues) seem pretty isolated and could benefit from unit tests with some vocab permutations. tree.tests.ts might be handy as an example.

Done, thanks for the pointer!

Documentation added at 0102502 - branch 15067-wb2-vocabulary-doc (arvados repo)

• Added a new page on the Admin section with a small example of a vocabulary file, explaining its format and how to configure the cluster so that Workbench2 finds it.

Lucas Di Pentima wrote:

Documentation added at 0102502 - branch 15067-wb2-vocabulary-doc (arvados repo)

• Added a new page on the Admin section with a small example of a vocabulary file, explaining its format and how to configure the cluster so that Workbench2 finds it.

Code and functionality is great and LGTM!

Some doc comments/suggestions/nits:

• The Workbench2 Configuration text can be simplified. Maybe something like this? "Workbench2 retrieves the vocabulary file URL from the cluster confg as shown:"

• "The JSON file describes the available options on keys and values and if the user is allowed to enter other kind of free text not covered on defined by the vocabulary."

• Suggestion for line 33: "Keys and values are indexed by identifiers so that the concept of a term is preserved even if vocabulary labels are changed."

• Line 41: Don't need a colon after e.g.

• Line 43, the sentence starting with "Also strict and values members". I would split this sentence/concepts up.

• "when they’re displayed the label shown will be the first one of each group defined on in the vocabulary file"

• "because those labels are the first on in the vocabulary definition.

• The final sentence, maybe something like this would be a bit more clear? "Internally, Workbench2 uses the IDs to do property based searches, so if the user searches by Animal: Human or Species: Homo sapiens, both will return the same results."

Eric Biagiotti wrote:

Code and functionality is great and LGTM!

Thanks! merged.

Some doc comments/suggestions/nits:

Thanks for all the suggestions, they were very useful as my grammar is far from perfect :)

I've updated the documentation at a8ea767df and also added a link to it from the Workbench2's install page.

Lucas Di Pentima wrote:

Thanks for all the suggestions, they were very useful as my grammar is far from perfect :)

I've updated the documentation at a8ea767df and also added a link to it from the Workbench2's install page.

Happy to help! Thanks for listening to my nits :) I have more!

• install-workbench2-app.html.textile.liquid - should say "in the Admin section".
• workbench2-vocabulary.html.textile.liquid
  • Line 41, "saving property keys other than the ones defined in the vocabulary"
  • In general, I think we shouldn't use "properties" interchangeably with "tags". My suggestions below try to address this.
  • Line 43, "Inside the tags member, IDs are defined (IDTAGANIMALS, IDTAGCOMMENT, IGTAGIMPORTANCES) and can have any format that the current application requires."
  • Line 45, "The strict flag inside a tag definition operates the same as the strict_tags root member, but at the individual tag level. When strict is true, a tag’s value options are limited to those defined by the vocabulary"

Doing the rest of my suggestions in a big chunk. This might be easier, and you can copy paste it and look at the diff.

"The @values@ member is optional and is used to define valid key/label pairs when applicable. In the example above, @IDTAGCOMMENT@ allows open-ended text by only defining the tag's ID and labels and leaving out @values@.

When any key or value has more than one label option, Workbench2's user interface will allow the user to select any of the options. But because only the IDs are saved in the system, when the property is displayed in the user interface, the label shown will be the first of each group defined in the vocabulary file. For example, the user could select the property key @Species@ and @Homo sapiens@ as its value, but the user interface will display it as @Animal: Human@ because those labels are the first in the vocabulary definition.

Internally, Workbench2 uses the IDs to do property based searches, so if the user searches by @Animal: Human@ or @Species: Homo sapiens@, both will return the same results." 

Updates on documentation at 83ff3cf35
Thanks!

Lucas Di Pentima wrote:

Updates on documentation at 83ff3cf35
Thanks!

Just need to add highlighting for (IDTAGANIMALS, IDTAGCOMMENT, IGTAGIMPORTANCES) on line 43. Otherwise, this LGTM. Thanks!