TOLOGIX - Infrastructure LawGuide (ILG)

Problem with Meta Fields and Value List design

Assigned to
Anil Vaghela Anil V. Hiren Patel Hiren P. Melissa Cowell, General Manager at Industrial Melissa C. Stefanie Gibson, UX Researcher at Industrial Stefanie G.
Notes
Further to the video below, I believe we need to revisit the design of how meta fields are presented to admin users at the project vs. document level, and also reconsider how values in the value list are used and assigned to different value types. The current setup will lead to redundancies and duplicate entries, and we need to come up with a solution before we proceed with further document uploads.

Stefanie Gibson, UX Researcher at Industrial Stefanie and Melissa Cowell, General Manager at Industrial Melissa , I've proposed making the meta fields presented at the project level and document level only be those that have been added to their respective Meta Field lists. Also, I've proposed making all values appear as available options in any type of meta field (both project and document meta fields), and that when a value is assigned to a project or document, the value type is automatically adjusted in the value list.

Please review and provide your suggested solutions to the problem. Note I know there is still some outstanding discussion on these issues on TargetProcess. Apologies if this is interfering with that process.

Thanks,

Morgan 


Comments & Events

Stefanie Gibson, UX Researcher at Industrial
Hi Morgan Maguire, CEO Morgan
That makes sense to me. 

Here's a summary of the changes that need to happen for value types:
  1. Documents inherit meta data from projects. (this is already happening and should stay the way it is)
  2. On documents, we should only display meta fields added at the document level. 
  3. When adding a new meta field and converting it to a 'Value Type' at the project level, this value type should be made available to all projects and we'll need to change the label on the radio button to read: Value Type(this will make this field available across all projects.)
  4. When adding a new 'Value Type' at the document level, this value type should be made available to all documents and we'll need to change the label on the radio button to read: Value Type(this will make this field available across all documents.) - do you still want this? Or are document meta fields only temporary/specific to the document, meaning we never require to assign a meta field available across all documents?
  5. We need all values available across all value types when a user is editing a project and a document (?). When a user assigns a value to a value type it wasn't previously assigned to, this should be updated in the 'Manage Value List. For this, I'd suggest that we optimize the drop downs a little so that the user is able to scan through the list of values available for that value type first and then we list all values: 
side note - we should probably make these dropdowns list in alphabetical order unless there's a reason for the current ordering that I'm not aware of. 

For a front-end user, they still only see values that have been assigned to value types when filtering content (?). So for Jurisdiction and I expand the Jurisdiction drop down, I still only see those values that have been assigned to Jurisdiction in the Value Types list. This means that the Value Types list really only exists for the benefit of front end users. 



Morgan Maguire, CEO
Hi Anil Vaghela Anil and Stefanie Gibson, UX Researcher at Industrial Stefanie ,

For some reason this got separated into two to-do's: Problem with Meta Fields and Value List design - TOLOGIX - P3 Prototype for Tologix, and you've both commented on different ones... We'll consolidate everything here. Let's proceed with Stefanie Gibson, UX Researcher at Industrial Stefanie suggestions above, but with the following modifications:

3.  As Anil Vaghela Anil suggested, change this to "Value Type", and simply make this an option that connects the project meta field to the Value List. Any meta field created in the Project Meta Field list will automatically apply to all projects.

4. Same for documents, change this to "Value Type", and simply make this an option that connect the document meta field to the Value List. Any meta field created in the Document Meta Field list will automatically apply to all documents.

5. Re Stefanie Gibson, UX Researcher at Industrial Stefanie suggestion of separating values of the same type from all other values, I'm worried that admin users will prioritize values of the same type, rather than select the exact match. However, I understand the reasoning behind this, and we can overcome this by encouraging admin users to use the search option. Let's try this, and we can reassess if necessary.

Re font-end user view, correct, when the user selects a particular filter, they will only be presented with the values that have been assigned to that meta field type.

Thanks,

Morgan
Stefanie Gibson, UX Researcher at Industrial
Ok sounds good. I'll add this to the target process story. 
Morgan Maguire, CEO
Great. Thanks Stefanie Gibson, UX Researcher at Industrial Stefanie .

Morgan 
Anil Vaghela
Hello Stefanie Gibson, UX Researcher at Industrial Stefanie and Morgan Maguire, CEO Morgan ,

We reviewed the revised story but we still have some doubts e.g. where to put "Add Value Type" button. Can you also provide us some screenshots e.g. in which all screens/pages the changes are required? 
Anil Vaghela
OK thanks Stefanie Gibson, UX Researcher at Industrial Stefanie !

This seems OK to us, let Morgan Maguire, CEO Morgan  check and confirm.
Morgan Maguire, CEO
Hi Stefanie Gibson, UX Researcher at Industrial Stefanie and Anil Vaghela Anil ,

The requirements state that the admin user has "the capability to add new value types" from the Manage Document/Project Meta Fields pages. Is this necessary? The value types are determined by what values are created when the admin user adds data to a meta field. 

For example, an admin user is entering meta data for a project, and adds "Bel Pacific" in the "Owner of Private Partner(s)" meta field. This would automatically assigned "Bel Pacific" with the "Owner of Private Partner(s)" value type. If the admin user then adds "Bel Pacific" in the "Contractor(s)/Subcontractor(s)" meta field, this would automatically add "Contractor(s)/Subcontractor(s)" as an additional value type to "Bel Pacific". Conversely, if the admin user, goes back and removes "Bel Pacific" from the "Contractor(s)/Subcontractor(s)" meta field, this would update and remove "Contractor(s)/Subcontracotr(s)" as a value type for "Bel Pacific" (assuming there are not other projects that have "Bel Pacific" added as a "Contractor(s)/Subcontracotr(s)").

This way value types are are added/changed as they edits are made to the data entered into the meta fields. This eliminates the need for making changes to value types through the value list. It also prevents admin users from mismatching value types with what has been added to the meta fields (i.e., ensures the value types are always tied to the meta field types).

Also, I think we should change to the default Value Type to "Yes" when a meta field is created. I don't foresee circumstances where we wouldn't want data entered into a meta field not be associated with the value list.

Thanks,

Morgan
Stefanie Gibson, UX Researcher at Industrial
Hi Morgan Maguire, CEO Morgan
To your first point, this portion of the user story is talking about creating a new value type so the Add Meta Field > check off the radio button to make it a Value Type. Value Types are jurisdiction, projects, public partners etc., and right now there is no way to manually create value new types - this was originally why we started to create this feature. Were you thinking this meant something else or did you want to remove the capability to create new value types? 
Morgan Maguire, CEO
Hi Stefanie Gibson, UX Researcher at Industrial Stefanie ,

No, I don't want to remove the capability of creating new value types. I just thought we might be confusing what the value types are for (categorizing values based on the meta fields they are associated with).

Thanks,

Morgan
Stefanie Gibson, UX Researcher at Industrial
Morgan Maguire, CEO Morgan   Just to make sure we're on the same page - Essentially making a meta-field a value type is just there for the sake of broadening the list of filters we offer. If we think that all new meta-fields should be value types (meaning we always want them to appear on the front-end as a filter), we should remove the radio button to convert a meta field to a value type. Right now we're assuming that a new meta-field might not be something we always want to appear as a filter. 
Morgan Maguire, CEO
Hi Stefanie Gibson, UX Researcher at Industrial Stefanie ,

There may be meta fields that we don't want to appear as a filter on the front-end of the site, which would require a radio button to select that option. At the same time, as I stated above, I don't foresee a reason for creating a meta field that is not tied to the value list. Therefore, may we should change this option from "Value List" to "Filter", which would determine whether the meta-field appears as a front-end filter. Whereas the value list automatically applies to any meta field. Make sense?

Morgan
Stefanie Gibson, UX Researcher at Industrial
That sounds good to me Morgan Maguire, CEO Morgan . If you want to check out the updated user story and confirm we should be good.

Anil Vaghela Anil  
Morgan Maguire, CEO
Looks good. Thanks Stefanie Gibson, UX Researcher at Industrial Stefanie .

Morgan 
Anil Vaghela
Hello Morgan Maguire, CEO Morgan and Stefanie Gibson, UX Researcher at Industrial Stefanie ,

As per our understanding, 
  1. If we add any meta field with "Make this a new search filter" = "No", this will render as "Textbox" at admin side's project or document details. This will not be rendered as a filter at front side.
  2. If we add any meta field with "Make this a new search filter" = "Yes", this will render as "Dropdown box" at admin side's project or document details and this will be rendered as a filter at front side.
  3. If we create any new "value" (e.g. Bel Pacific) to any "value type filter" (e.g. Owner of Private Partner(s)), this "value" will automatically available to all other "value type filters" (e.g. Contractor(s)/Subcontracotr(s) etc.).
Stefanie Gibson, UX Researcher at Industrial
That's correct.

For 1 - this would still be added to the value type list but it would not appear on the front-end. I think a new meta-field could be a dropdown or a text box. Morgan Maguire, CEO Morgan please confirm.

To that end, I think we need to add a little more to this because we now need a way to edit if it appears as search filter and we also now need to specify if a new meta-field should appear on all documents or projects. I assume that if you add a new meta-field that isn't a search filter, you wouldn't want this to appear on all documents and projects respectively. Morgan Maguire, CEO Morgan  is that a correct assumption?
Anil Vaghela
Hello Stefanie Gibson, UX Researcher at Industrial Stefanie and Morgan Maguire, CEO Morgan ,

We need to separate this flow such a way that either new meta-field can be added as Textbox or Dropdown. E.g. if "Make this a new search filter" = "No" then it will be a "Textbox" and if Make this a new search filter = "Yes" then it will rendered as "Dropdownbox" otherwise it will be very difficult to manage at development side. Please suggest.
Morgan Maguire, CEO
Hi Anil Vaghela Anil ,

To put simply, I want eliminate the textbox fields entirely from any meta field created through the Manage Document or Project Meta Fields pages. "Make this a search filter" = "No" will only prevent the meta field from being presented as a filter option on the front-end, but the meta field data will always be tied to the value list. Please do what is necessary to make this happen, but I'm confused why this is difficult to manage given that we're already doing this when "Value List" = "Yes". Just make that the default for every meta field, and then create a new option for the front-end filter.

Thanks,

Morgan
Anil Vaghela
Hello Morgan Maguire, CEO Morgan ,

If we need to eliminate textbox entirely then there is no issue. We will do necessary changes so that,

If "Make this a search filter" = "No" then it will be a dropdown but will not be displayed as a filter at front-end.
 
If "Make this a search filter" = "Yes" then it will be a dropdown but will be displayed as a filter at front-end.
Anil Vaghela
Hello Stefanie Gibson, UX Researcher at Industrial Stefanie and Morgan Maguire, CEO Morgan ,

We reviewed the updated user story "#4232 Create Values and Add to Value List" and have a query for the attached screenshot. We think that there is no need of  "Make this a new search filter" field in this screen as this screen is for "values" for "value types". Please let us know your thoughts.
Stefanie Gibson, UX Researcher at Industrial
Hi Anil Vaghela Anil , You're right. I'll delete this one. I was thinking there was no way to edit this but there is from the meta field view. 
Anil Vaghela
Hello Morgan Maguire, CEO Morgan and Stefanie Gibson, UX Researcher at Industrial Stefanie ,

We have implemented meta field changes for "Manage Project". This is still in beta. Can you please take a look in "Manage Project" and give your feedback.

Please note that this change will apply to new "Type Names"/"Type Values" only. For old entries we need to map Type and Values manually. We are still working on meta fields for "Edit Document".
Morgan Maguire, CEO
Hi Anil Vaghela Anil ,

I have discovered a number of issues outlined below and in the video. However, Stefanie Gibson, UX Researcher at Industrial Stefanie should probably comment further on ensuring the changes are meeting all the requirements in TargetProcess.
  1. Values in value list are automatically getting associated with every type of meta field when they should only get associated with the meta field types where that value has been entered into that meta field for a particular project or document.
  2. Document meta fields are not appearing as front-end filters even though the font-end filter option = "Yes".
  3. Change name of meta field filter option to "Front-End Filter".
  4. Ensure meta field dropdown menus segregate values by listing values applicable to that meta field type, and then all other values.
Thanks,

Morgan

Stefanie Gibson, UX Researcher at Industrial
Yes, I agree. The values should be made available to all value types (aka available in all dropdowns)  in the project and document levels but the only time we should see a 'value' associated with a 'value type' in the manage values list or in the front end is when:
 a) an admin has selected a 'value' in the 'value type's' dropdown
b) when a value is manually added to a value type from the manage values list

I'm also not seeing the document meta filters on the front-end.

I've added the text change and more clarification to the user story although I think Morgan's video/comments sufficiently outline the change needed. 
Anil Vaghela
Hi Morgan Maguire, CEO Morgan and Stefanie Gibson, UX Researcher at Industrial Stefanie ,

We are still working on this and will get back to you soon.
Anil Vaghela
Hi Morgan Maguire, CEO Morgan and Stefanie Gibson, UX Researcher at Industrial Stefanie ,

We are progressing with this change meantime we have a query as follows:

We think that "Select Type" dropdown is not required in "Edit Value List" as "Type" will be assigned/removed to a "Type Name" using Edit Project or Edit Document screen. Hence, we can remove the dropdown from this screen and show only assigned "Types" in readonly format. However user can edit "Type Name" using this screen. Please let us know your thoughts.

Morgan Maguire, CEO
I agree Anil Vaghela Anil . Unless Stefanie Gibson, UX Researcher at Industrial Stefanie sees another reason to keep it, please remove the dropdown. Also, let's change the title for "Type Name" to "Value Name".

Thanks,

Morgan
Stefanie Gibson, UX Researcher at Industrial
This sounds good to me as well.
Anil Vaghela
Hello Morgan Maguire, CEO Morgan and Stefanie Gibson, UX Researcher at Industrial Stefanie ,

We have uploaded a beta version for this task on p3lg. Please check and let us know your feedback.
Stefanie Gibson, UX Researcher at Industrial
Looks awesome so far Anil Vaghela Anil . The one thing I did notice is that when I added a document meta field and selected add as search filter, it is showing up but then when I added a project meta field as a search filter, I can see only the project level filter on the front end and the document filter disappears. It seems like there's some kind of limit set on the filters. 
Morgan Maguire, CEO
Hi Anil Vaghela Anil and Stefanie Gibson, UX Researcher at Industrial Stefanie ,

I realized that my comment above concerning "Problems with saving document in Edit Document state" is the result that I was attempting to save changes on a published document. I'm assuming that implementing Stefanie Gibson, UX Researcher at Industrial Stefanie 's user stories will resolve this problem, but I shouldn't have been able to access the document meta fields when the document is in a published state. 

Thanks,

Morgan
Anil Vaghela
Hello Morgan Maguire, CEO Morgan and Stefanie Gibson, UX Researcher at Industrial Stefanie ,

We will look into above things and get back to you soon. 

I forgot to mention one thing above that if we add any "Type Name" with "Front-end filter" = "Yes", but there is no "Type value" assign to it then it will not be shown at front side as a filter. Hope this is fine.
Anil Vaghela
Hello Morgan Maguire, CEO Morgan ,

Problems with saving values with special characters is resolved on p3lg. Please check and let us know the feedback.

We will look into the other issue (Problem with saving document..) when we will come through the new stories. Hope this is fine.
Stefanie Gibson, UX Researcher at Industrial
Hi Anil Vaghela Anil , to your point above. I think it's fine not to show as a front end filter if there isn't a value assigned yet. 

I do think that the new document flow should resolve these issues. Anil, let me know if you have any questions about those stories. 
Morgan Maguire, CEO
Hi Stefanie Gibson, UX Researcher at Industrial Stefanie and Anil Vaghela Anil ,

Let's keep the settings as is for the front-end filters (i.e., the meta-field doesn't appear until meta data is entered into the field through a project or document). This will ensure we're not causing unused meta fields from appearing on the front-end. We can adjust this at a later stage if necessary. 

Understood concerning the saving issue. We'll hold off on addressing this for the time being.

Also, the punctuation/special character issue appears resolved, so I'll mark this to-do complete.

Morgan

 
Morgan Maguire, CEO
Morgan Maguire completed this to-do.
Anil Vaghela
Hi Stefanie Gibson, UX Researcher at Industrial Stefanie ,

We will review the new stories for document flow and let you know if anything.