[JBoss JIRA] (DROOLS-3659) DMN: UX for documentation reports
by Tiago Dolphine (Jira)
[ https://issues.jboss.org/browse/DROOLS-3659?page=com.atlassian.jira.plugi... ]
Tiago Dolphine commented on DROOLS-3659:
----------------------------------------
Hi [~manstis] about downloading the documentation, the way it was decided to be quicker and work on the same way as the jbpm-designer is to have a printable version of the documentation, see the button on the top right, and use the browser to save as a pdf (now this is coupled to the bpmn documentation view page, but it could be extracted to some common component.
About the documentation generation, yeah it is based on a given text template (we are using https://mustache.github.io/ engine and the syntax that is pretty simple to use) and a data model that should be generated based on the diagram/graph structure, so it is flexible to generate all that is necessary for DMN documentation requirements.
> DMN: UX for documentation reports
> ---------------------------------
>
> Key: DROOLS-3659
> URL: https://issues.jboss.org/browse/DROOLS-3659
> Project: Drools
> Issue Type: Story
> Components: DMN Editor
> Reporter: Liz Clayton
> Assignee: Liz Clayton
> Priority: Major
> Labels: UX, UXTeam, drools-tools
> Attachments: DROOLS-3659-documentation.mp4
>
>
> User stories:
> * As a user I want to generate a PDF or HTML report of the DMN model, with documentation, so that I can hand it off to external team and/or business that needs information about the diagrams and the logic of the decisions being automated. The report can be printed out and used by business teams not involved with the modeling itself, to learn about content of the .dmn file.
> * As a user I need a means through the UI to input additional documentation, links and attachments to nodes.
> Notes:
> - Docs to help with docs formatting.
> - Might be able to leverage Case View docs widget.
--
This message was sent by Atlassian Jira
(v7.12.1#712002)
6 years, 7 months
[JBoss JIRA] (DROOLS-3077) Enhance data type restrictions UX - Decision Table/properties
by Michael Anstis (Jira)
[ https://issues.jboss.org/browse/DROOLS-3077?page=com.atlassian.jira.plugi... ]
Michael Anstis commented on DROOLS-3077:
----------------------------------------
Personally, I am wondering if [~uxdlc] first [proposal|https://redhat.invisionapp.com/share/WJQMEPWBRE9#/348010399_1] was better?
Furthermore whether the _overriding_ Constraint definition (when "Modify" was clicked and the Constraint popover shown) should be applied when the "OK" button on the Constraint popover was clicked and we remove the "OK", "Cancel" buttons from the {{InputClause}} column popover.
> Enhance data type restrictions UX - Decision Table/properties
> -------------------------------------------------------------
>
> Key: DROOLS-3077
> URL: https://issues.jboss.org/browse/DROOLS-3077
> Project: Drools
> Issue Type: Story
> Components: DMN Editor
> Reporter: Liz Clayton
> Assignee: Liz Clayton
> Priority: Major
> Labels: UX, UXTeam, drools-tools
> Attachments: DataType selection ('Properties Panel' and 'in-grid').png, Screen Shot 2018-08-10 at 10.23.36 AM.png, Screen Shot 2018-08-24 at 8.38.37 AM.png, Screen Shot 2018-09-28 at 2.44.59 PM.png, date-time.png, date.png, enumration-widget.png, pop-overc.png, pop-overcSpecs.png, read-mode.png, select.png, time.png
>
>
> *Background*
> Persona: Business analyst or Rules practitioner
> Use Cases:
> * From the DMN canvas view - as a user I want to define data type restrictions (one-off instances) from a decision table .
> * From the Data Types dialog - as a user I want the ability to define constraints for the following types: https://docs.google.com/spreadsheets/d/1HLYwi5JrCEU6IxWRge7RCKANLiHCL0d2E...
> Functional considerations/ pre conditions:
> * Consider interaction in light of Property panel and consistency.
> * Underscore the notion of one-off constraints.
> Verification conditions:
> * Scrum team and PO review.
--
This message was sent by Atlassian Jira
(v7.12.1#712002)
6 years, 7 months
[JBoss JIRA] (DROOLS-3077) Enhance data type restrictions UX - Decision Table/properties
by Michael Anstis (Jira)
[ https://issues.jboss.org/browse/DROOLS-3077?page=com.atlassian.jira.plugi... ]
Michael Anstis commented on DROOLS-3077:
----------------------------------------
[~karreiro] [~uxdlc] On the whole I think it looks good.
However; I think with {{Applicant.Age}} set as the input expression and the Data Type {{Age}} the _existing_ constraint of {{[18..24]}} could be overridden *without* needing to select a different or define a new Data Type. Furthermore I wonder whether the User should _set_ the constraint rather than _add_ one (as they can only have one constraint).
Also, at the moment, if I change the Name or Data Type the change can be undone. However (currently) changes to the Constraint definition cannot be undone. So we have a mis-match of functionality. However we could change this so that clicking OK performs the actions necessary to change the Name, Data-type and Constraint in such a way as they can be undone. Changes made on the Data Types cannot be undone.
Finally, I wonder if adding the "OK", "Cancel" buttons to the {{InputClause}} popover should be replicated to all popovers; otherwise some popovers will continue to apply changes when (a) the "Name" {{TextBox}} looses focus, (b) when a selection is made in the "Data Type" drop-down, (c) when the "OK" button is clicked... just wondering.
> Enhance data type restrictions UX - Decision Table/properties
> -------------------------------------------------------------
>
> Key: DROOLS-3077
> URL: https://issues.jboss.org/browse/DROOLS-3077
> Project: Drools
> Issue Type: Story
> Components: DMN Editor
> Reporter: Liz Clayton
> Assignee: Liz Clayton
> Priority: Major
> Labels: UX, UXTeam, drools-tools
> Attachments: DataType selection ('Properties Panel' and 'in-grid').png, Screen Shot 2018-08-10 at 10.23.36 AM.png, Screen Shot 2018-08-24 at 8.38.37 AM.png, Screen Shot 2018-09-28 at 2.44.59 PM.png, date-time.png, date.png, enumration-widget.png, pop-overc.png, pop-overcSpecs.png, read-mode.png, select.png, time.png
>
>
> *Background*
> Persona: Business analyst or Rules practitioner
> Use Cases:
> * From the DMN canvas view - as a user I want to define data type restrictions (one-off instances) from a decision table .
> * From the Data Types dialog - as a user I want the ability to define constraints for the following types: https://docs.google.com/spreadsheets/d/1HLYwi5JrCEU6IxWRge7RCKANLiHCL0d2E...
> Functional considerations/ pre conditions:
> * Consider interaction in light of Property panel and consistency.
> * Underscore the notion of one-off constraints.
> Verification conditions:
> * Scrum team and PO review.
--
This message was sent by Atlassian Jira
(v7.12.1#712002)
6 years, 7 months
[JBoss JIRA] (DROOLS-3659) DMN: UX for documentation reports
by Michael Anstis (Jira)
[ https://issues.jboss.org/browse/DROOLS-3659?page=com.atlassian.jira.plugi... ]
Michael Anstis commented on DROOLS-3659:
----------------------------------------
It would appear that the content of the _documentation_ tab cannot be downloaded.. [~tdolphine] did I miss something?
> DMN: UX for documentation reports
> ---------------------------------
>
> Key: DROOLS-3659
> URL: https://issues.jboss.org/browse/DROOLS-3659
> Project: Drools
> Issue Type: Story
> Components: DMN Editor
> Reporter: Liz Clayton
> Assignee: Liz Clayton
> Priority: Major
> Labels: UX, UXTeam, drools-tools
> Attachments: DROOLS-3659-documentation.mp4
>
>
> User stories:
> * As a user I want to generate a PDF or HTML report of the DMN model, with documentation, so that I can hand it off to external team and/or business that needs information about the diagrams and the logic of the decisions being automated. The report can be printed out and used by business teams not involved with the modeling itself, to learn about content of the .dmn file.
> * As a user I need a means through the UI to input additional documentation, links and attachments to nodes.
> Notes:
> - Docs to help with docs formatting.
> - Might be able to leverage Case View docs widget.
--
This message was sent by Atlassian Jira
(v7.12.1#712002)
6 years, 7 months
[JBoss JIRA] (DROOLS-3659) DMN: UX for documentation reports
by Michael Anstis (Jira)
[ https://issues.jboss.org/browse/DROOLS-3659?page=com.atlassian.jira.plugi... ]
Michael Anstis updated DROOLS-3659:
-----------------------------------
Attachment: DROOLS-3659-documentation.mp4
> DMN: UX for documentation reports
> ---------------------------------
>
> Key: DROOLS-3659
> URL: https://issues.jboss.org/browse/DROOLS-3659
> Project: Drools
> Issue Type: Story
> Components: DMN Editor
> Reporter: Liz Clayton
> Assignee: Liz Clayton
> Priority: Major
> Labels: UX, UXTeam, drools-tools
> Attachments: DROOLS-3659-documentation.mp4
>
>
> User stories:
> * As a user I want to generate a PDF or HTML report of the DMN model, with documentation, so that I can hand it off to external team and/or business that needs information about the diagrams and the logic of the decisions being automated. The report can be printed out and used by business teams not involved with the modeling itself, to learn about content of the .dmn file.
> * As a user I need a means through the UI to input additional documentation, links and attachments to nodes.
> Notes:
> - Docs to help with docs formatting.
> - Might be able to leverage Case View docs widget.
--
This message was sent by Atlassian Jira
(v7.12.1#712002)
6 years, 7 months
[JBoss JIRA] (DROOLS-3659) DMN: UX for documentation reports
by Michael Anstis (Jira)
[ https://issues.jboss.org/browse/DROOLS-3659?page=com.atlassian.jira.plugi... ]
Michael Anstis commented on DROOLS-3659:
----------------------------------------
[~uxdlc] [~tirelli] To be honest I am a little confused....
Adding attachments appears to be a feature of _other_ DMN modellers and not part of the Specification (although we can obviously include similar functionality).
The _documentation_ tab (and feature supported by Stunner as [~tdolphine] mentions) would, presumably, produce a text document from a template including whatever we (as the DMN team) want. It could include a list of attachments, it could include "Questions" and "Allowed answers" it could include a summary of nodes, boxed expressions and their descriptions etc.
So, whilst [~uxdlc] work here showing how attachments can be handled I see it as something quite different to what we may want on the _documentation_ tab... that as far as I'm aware remains completely undefined. Am I missing something?
I've attached a video of BPMN's "documentation" for information.
> DMN: UX for documentation reports
> ---------------------------------
>
> Key: DROOLS-3659
> URL: https://issues.jboss.org/browse/DROOLS-3659
> Project: Drools
> Issue Type: Story
> Components: DMN Editor
> Reporter: Liz Clayton
> Assignee: Liz Clayton
> Priority: Major
> Labels: UX, UXTeam, drools-tools
> Attachments: DROOLS-3659-documentation.mp4
>
>
> User stories:
> * As a user I want to generate a PDF or HTML report of the DMN model, with documentation, so that I can hand it off to external team and/or business that needs information about the diagrams and the logic of the decisions being automated. The report can be printed out and used by business teams not involved with the modeling itself, to learn about content of the .dmn file.
> * As a user I need a means through the UI to input additional documentation, links and attachments to nodes.
> Notes:
> - Docs to help with docs formatting.
> - Might be able to leverage Case View docs widget.
--
This message was sent by Atlassian Jira
(v7.12.1#712002)
6 years, 7 months
[JBoss JIRA] (DROOLS-3704) [DMN Designer] Boxed expressions - Decision Table - Input clause - Properties panel is not consistent
by Michael Anstis (Jira)
[ https://issues.jboss.org/browse/DROOLS-3704?page=com.atlassian.jira.plugi... ]
Michael Anstis commented on DROOLS-3704:
----------------------------------------
[~uxdlc] For the purpose of being _agile_ I assume this JIRA adds the Name and Data Type of the {{InputClause}} to the Properties Panel leaving the Constraints there (for now).. when the JIRA to add Constraints to the popover is worked on presumably we can remove Constraints from the Properties Panel... so I guess IMO what I've implemented - and attached a screenshot of - would be OK (for now).
> [DMN Designer] Boxed expressions - Decision Table - Input clause - Properties panel is not consistent
> -----------------------------------------------------------------------------------------------------
>
> Key: DROOLS-3704
> URL: https://issues.jboss.org/browse/DROOLS-3704
> Project: Drools
> Issue Type: Enhancement
> Components: DMN Editor
> Reporter: Guilherme Carreiro
> Assignee: Michael Anstis
> Priority: Major
> Labels: drools-tools
> Attachments: 1.png, DROOLS-3704.png
>
>
> Properties panel is not consistent with the popover:
> !1.png|thumbnail!
--
This message was sent by Atlassian Jira
(v7.12.1#712002)
6 years, 7 months