Adding UML to the Wiki

Previous Topic Next Topic
 
classic Classic list List threaded Threaded
12 messages Options
Reply | Threaded
Open this post in threaded view
|

Adding UML to the Wiki

Ron Wheeler

http://blog.lunatech.com/2007/04/27/uml-class-diagrams-confluence-using-graphviz-and-dot
Shows some simple ways to add UML to the wiki using Graphviz.

Ron


--
Ron Wheeler
President
Artifact Software Inc
email: [hidden email]
skype: ronaldmwheeler
phone: 866-970-2435, ext 102

Reply | Threaded
Open this post in threaded view
|

Re: Adding UML to the Wiki

Jacques Le Roux
Administrator
Maybe we could create a page in the wiki (children of https://cwiki.apache.org/confluence/display/OFBADMIN/Apache+OFBiz+Contributors or directly a
section in https://cwiki.apache.org/confluence/display/OFBADMIN/OFBiz+Contributors+Best+Practices) with Guidelines for graphics in the wiki?

Jacques

Le 19/02/2015 15:29, Ron Wheeler a écrit :
>
> http://blog.lunatech.com/2007/04/27/uml-class-diagrams-confluence-using-graphviz-and-dot
> Shows some simple ways to add UML to the wiki using Graphviz.
>
> Ron
>
>
Reply | Threaded
Open this post in threaded view
|

Re: Adding UML to the Wiki

Ron Wheeler
That would be great.
I do not have write access to that part of the wiki but I could
contribute some text and examples and links to the sites that I have
found for Graphviz.

It would be good to have some guidelines  ( "Use the embedded Wiki tools
such as Graphviz and Gliffy whenever possible." "when you create a
grphic externally, add the source file to a child page as an attachment  
with the name of the tool and how the graphic can be regenerated." If
you create Use Cases or other UML, add the model as a child page.")

What are people using for UML?
One can use Gliffy but it does not create a model so there is no
repurposing or analysis possible from the effort of creating the drawing.
I have only seen a few Use Case drawings in the wiki but I did not find
the source model that was used to create the drawings or even a mention
of the tool used and I did not check to see if they were in Gliffy or not.
I use ArgoUML which is free and open source.
It is pretty complete but like some other open source products, it lacks
a bit of polish and the docs are spotty.


Ron


On 19/02/2015 9:49 AM, Jacques Le Roux wrote:

> Maybe we could create a page in the wiki (children of
> https://cwiki.apache.org/confluence/display/OFBADMIN/Apache+OFBiz+Contributors 
> or directly a section in
> https://cwiki.apache.org/confluence/display/OFBADMIN/OFBiz+Contributors+Best+Practices)
> with Guidelines for graphics in the wiki?
>
> Jacques
>
> Le 19/02/2015 15:29, Ron Wheeler a écrit :
>>
>> http://blog.lunatech.com/2007/04/27/uml-class-diagrams-confluence-using-graphviz-and-dot 
>>
>> Shows some simple ways to add UML to the wiki using Graphviz.
>>
>> Ron
>>
>>
>


--
Ron Wheeler
President
Artifact Software Inc
email: [hidden email]
skype: ronaldmwheeler
phone: 866-970-2435, ext 102

Reply | Threaded
Open this post in threaded view
|

Re: Adding UML to the Wiki

Jacques Le Roux
Administrator

Le 19/02/2015 17:19, Ron Wheeler a écrit :
> That would be great.
> I do not have write access to that part of the wiki but I could contribute some text and examples and links to the sites that I have found for
> Graphviz.
>
> It would be good to have some guidelines  ( "Use the embedded Wiki tools such as Graphviz and Gliffy whenever possible." "when you create a grphic
> externally, add the source file to a child page as an attachment  with the name of the tool and how the graphic can be regenerated." If you create
> Use Cases or other UML, add the model as a child page.")
>
> What are people using for UML?

I believe most people use ArgoUML, at least I know the Neogia team did at some point They also mentioned their UFO tool
http://www.neogia.org/wiki/index.php/U.F.O.
It has only the entity part, but anyway, sincerely I'm not a fan of UML and such, I'm more inclined to something like Hemp where graphics are less
important
https://www.linkedin.com/groups/HEMP-Book-Now-Available-4640689.S.255382432

I tend to find https://cwiki.apache.org/confluence/display/OFBIZ/Data+Model+Diagrams enough for my needs.
For my day to day work, I rely more on search in OOTB *mode*.xml files. Data Model Diagrams sounds convenient but they are also often blurring things.
When you have a data model with 800+ tables it's not surprising...

Jacques

> One can use Gliffy but it does not create a model so there is no repurposing or analysis possible from the effort of creating the drawing.
> I have only seen a few Use Case drawings in the wiki but I did not find the source model that was used to create the drawings or even a mention of
> the tool used and I did not check to see if they were in Gliffy or not.
> I use ArgoUML which is free and open source.
> It is pretty complete but like some other open source products, it lacks a bit of polish and the docs are spotty.
>
>
> Ron
>
>
> On 19/02/2015 9:49 AM, Jacques Le Roux wrote:
>> Maybe we could create a page in the wiki (children of https://cwiki.apache.org/confluence/display/OFBADMIN/Apache+OFBiz+Contributors or directly a
>> section in https://cwiki.apache.org/confluence/display/OFBADMIN/OFBiz+Contributors+Best+Practices) with Guidelines for graphics in the wiki?
>>
>> Jacques
>>
>> Le 19/02/2015 15:29, Ron Wheeler a écrit :
>>>
>>> http://blog.lunatech.com/2007/04/27/uml-class-diagrams-confluence-using-graphviz-and-dot
>>> Shows some simple ways to add UML to the wiki using Graphviz.
>>>
>>> Ron
>>>
>>>
>>
>
>
Reply | Threaded
Open this post in threaded view
|

Re: Adding UML to the Wiki

Pierre Smits
In the past I have often used the UML tools/solutions available as Eclipse
plugins. And I mainly used the use-case part for generating those diagrams.
But without an export to .rtf such a tool is useless...

Best regards,

Pierre Smits

*ORRTIZ.COM <http://www.orrtiz.com>*
Services & Solutions for Cloud-
Based Manufacturing, Professional
Services and Retail & Trade
http://www.orrtiz.com

On Thu, Feb 19, 2015 at 6:36 PM, Jacques Le Roux <
[hidden email]> wrote:

>
> Le 19/02/2015 17:19, Ron Wheeler a écrit :
>
>> That would be great.
>> I do not have write access to that part of the wiki but I could
>> contribute some text and examples and links to the sites that I have found
>> for Graphviz.
>>
>> It would be good to have some guidelines  ( "Use the embedded Wiki tools
>> such as Graphviz and Gliffy whenever possible." "when you create a grphic
>> externally, add the source file to a child page as an attachment  with the
>> name of the tool and how the graphic can be regenerated." If you create Use
>> Cases or other UML, add the model as a child page.")
>>
>> What are people using for UML?
>>
>
> I believe most people use ArgoUML, at least I know the Neogia team did at
> some point They also mentioned their UFO tool http://www.neogia.org/wiki/
> index.php/U.F.O.
> It has only the entity part, but anyway, sincerely I'm not a fan of UML
> and such, I'm more inclined to something like Hemp where graphics are less
> important
> https://www.linkedin.com/groups/HEMP-Book-Now-
> Available-4640689.S.255382432
>
> I tend to find https://cwiki.apache.org/confluence/display/OFBIZ/Data+
> Model+Diagrams enough for my needs.
> For my day to day work, I rely more on search in OOTB *mode*.xml files.
> Data Model Diagrams sounds convenient but they are also often blurring
> things. When you have a data model with 800+ tables it's not surprising...
>
> Jacques
>
>
>  One can use Gliffy but it does not create a model so there is no
>> repurposing or analysis possible from the effort of creating the drawing.
>> I have only seen a few Use Case drawings in the wiki but I did not find
>> the source model that was used to create the drawings or even a mention of
>> the tool used and I did not check to see if they were in Gliffy or not.
>> I use ArgoUML which is free and open source.
>> It is pretty complete but like some other open source products, it lacks
>> a bit of polish and the docs are spotty.
>>
>>
>> Ron
>>
>>
>> On 19/02/2015 9:49 AM, Jacques Le Roux wrote:
>>
>>> Maybe we could create a page in the wiki (children of
>>> https://cwiki.apache.org/confluence/display/OFBADMIN/
>>> Apache+OFBiz+Contributors or directly a section in
>>> https://cwiki.apache.org/confluence/display/OFBADMIN/
>>> OFBiz+Contributors+Best+Practices) with Guidelines for graphics in the
>>> wiki?
>>>
>>> Jacques
>>>
>>> Le 19/02/2015 15:29, Ron Wheeler a écrit :
>>>
>>>>
>>>> http://blog.lunatech.com/2007/04/27/uml-class-diagrams-
>>>> confluence-using-graphviz-and-dot
>>>> Shows some simple ways to add UML to the wiki using Graphviz.
>>>>
>>>> Ron
>>>>
>>>>
>>>>
>>>
>>
>>
Reply | Threaded
Open this post in threaded view
|

Re: Adding UML to the Wiki

Pierre Smits
Unfortunately, ArgoUML only supports UML 1.4.

Best regards,

Pierre Smits

*ORRTIZ.COM <http://www.orrtiz.com>*
Services & Solutions for Cloud-
Based Manufacturing, Professional
Services and Retail & Trade
http://www.orrtiz.com

On Thu, Feb 19, 2015 at 6:43 PM, Pierre Smits <[hidden email]>
wrote:

> In the past I have often used the UML tools/solutions available as Eclipse
> plugins. And I mainly used the use-case part for generating those diagrams.
> But without an export to .rtf such a tool is useless...
>
> Best regards,
>
> Pierre Smits
>
> *ORRTIZ.COM <http://www.orrtiz.com>*
> Services & Solutions for Cloud-
> Based Manufacturing, Professional
> Services and Retail & Trade
> http://www.orrtiz.com
>
> On Thu, Feb 19, 2015 at 6:36 PM, Jacques Le Roux <
> [hidden email]> wrote:
>
>>
>> Le 19/02/2015 17:19, Ron Wheeler a écrit :
>>
>>> That would be great.
>>> I do not have write access to that part of the wiki but I could
>>> contribute some text and examples and links to the sites that I have found
>>> for Graphviz.
>>>
>>> It would be good to have some guidelines  ( "Use the embedded Wiki tools
>>> such as Graphviz and Gliffy whenever possible." "when you create a grphic
>>> externally, add the source file to a child page as an attachment  with the
>>> name of the tool and how the graphic can be regenerated." If you create Use
>>> Cases or other UML, add the model as a child page.")
>>>
>>> What are people using for UML?
>>>
>>
>> I believe most people use ArgoUML, at least I know the Neogia team did at
>> some point They also mentioned their UFO tool http://www.neogia.org/wiki/
>> index.php/U.F.O.
>> It has only the entity part, but anyway, sincerely I'm not a fan of UML
>> and such, I'm more inclined to something like Hemp where graphics are less
>> important
>> https://www.linkedin.com/groups/HEMP-Book-Now-
>> Available-4640689.S.255382432
>>
>> I tend to find https://cwiki.apache.org/confluence/display/OFBIZ/Data+
>> Model+Diagrams enough for my needs.
>> For my day to day work, I rely more on search in OOTB *mode*.xml files.
>> Data Model Diagrams sounds convenient but they are also often blurring
>> things. When you have a data model with 800+ tables it's not surprising...
>>
>> Jacques
>>
>>
>>  One can use Gliffy but it does not create a model so there is no
>>> repurposing or analysis possible from the effort of creating the drawing.
>>> I have only seen a few Use Case drawings in the wiki but I did not find
>>> the source model that was used to create the drawings or even a mention of
>>> the tool used and I did not check to see if they were in Gliffy or not.
>>> I use ArgoUML which is free and open source.
>>> It is pretty complete but like some other open source products, it lacks
>>> a bit of polish and the docs are spotty.
>>>
>>>
>>> Ron
>>>
>>>
>>> On 19/02/2015 9:49 AM, Jacques Le Roux wrote:
>>>
>>>> Maybe we could create a page in the wiki (children of
>>>> https://cwiki.apache.org/confluence/display/OFBADMIN/
>>>> Apache+OFBiz+Contributors or directly a section in
>>>> https://cwiki.apache.org/confluence/display/OFBADMIN/
>>>> OFBiz+Contributors+Best+Practices) with Guidelines for graphics in the
>>>> wiki?
>>>>
>>>> Jacques
>>>>
>>>> Le 19/02/2015 15:29, Ron Wheeler a écrit :
>>>>
>>>>>
>>>>> http://blog.lunatech.com/2007/04/27/uml-class-diagrams-
>>>>> confluence-using-graphviz-and-dot
>>>>> Shows some simple ways to add UML to the wiki using Graphviz.
>>>>>
>>>>> Ron
>>>>>
>>>>>
>>>>>
>>>>
>>>
>>>
>
Reply | Threaded
Open this post in threaded view
|

Re: Adding UML to the Wiki

Ron Wheeler
In reply to this post by Jacques Le Roux
On 19/02/2015 12:36 PM, Jacques Le Roux wrote:

>
> Le 19/02/2015 17:19, Ron Wheeler a écrit :
>> That would be great.
>> I do not have write access to that part of the wiki but I could
>> contribute some text and examples and links to the sites that I have
>> found for Graphviz.
>>
>> It would be good to have some guidelines  ( "Use the embedded Wiki
>> tools such as Graphviz and Gliffy whenever possible." "when you
>> create a grphic externally, add the source file to a child page as an
>> attachment  with the name of the tool and how the graphic can be
>> regenerated." If you create Use Cases or other UML, add the model as
>> a child page.")
>>
>> What are people using for UML?
>
> I believe most people use ArgoUML, at least I know the Neogia team did
> at some point They also mentioned their UFO tool
> http://www.neogia.org/wiki/index.php/U.F.O.
> It has only the entity part, but anyway, sincerely I'm not a fan of
> UML and such, I'm more inclined to something like Hemp where graphics
> are less important
> https://www.linkedin.com/groups/HEMP-Book-Now-Available-4640689.S.255382432 
>
>
> I tend to find
> https://cwiki.apache.org/confluence/display/OFBIZ/Data+Model+Diagrams 
> enough for my needs.
> For my day to day work, I rely more on search in OOTB *mode*.xml
> files. Data Model Diagrams sounds convenient but they are also often
> blurring things. When you have a data model with 800+ tables it's not
> surprising...

I agree that looking at the entity definitions is better specially since
the graphics are 5 years old.
If the drawings were updated as changes are made, it would be a more
useful tool.


>
> Jacques
>
>> One can use Gliffy but it does not create a model so there is no
>> repurposing or analysis possible from the effort of creating the
>> drawing.
>> I have only seen a few Use Case drawings in the wiki but I did not
>> find the source model that was used to create the drawings or even a
>> mention of the tool used and I did not check to see if they were in
>> Gliffy or not.
>> I use ArgoUML which is free and open source.
>> It is pretty complete but like some other open source products, it
>> lacks a bit of polish and the docs are spotty.
>>
>>
>> Ron
>>
>>
>> On 19/02/2015 9:49 AM, Jacques Le Roux wrote:
>>> Maybe we could create a page in the wiki (children of
>>> https://cwiki.apache.org/confluence/display/OFBADMIN/Apache+OFBiz+Contributors 
>>> or directly a section in
>>> https://cwiki.apache.org/confluence/display/OFBADMIN/OFBiz+Contributors+Best+Practices)
>>> with Guidelines for graphics in the wiki?
>>>
>>> Jacques
>>>
>>> Le 19/02/2015 15:29, Ron Wheeler a écrit :
>>>>
>>>> http://blog.lunatech.com/2007/04/27/uml-class-diagrams-confluence-using-graphviz-and-dot 
>>>>
>>>> Shows some simple ways to add UML to the wiki using Graphviz.
>>>>
>>>> Ron
>>>>
>>>>
>>>
>>
>>
>


--
Ron Wheeler
President
Artifact Software Inc
email: [hidden email]
skype: ronaldmwheeler
phone: 866-970-2435, ext 102

Reply | Threaded
Open this post in threaded view
|

Re: Adding UML to the Wiki

Ron Wheeler
In reply to this post by Pierre Smits
On 19/02/2015 12:49 PM, Pierre Smits wrote:
> Unfortunately, ArgoUML only supports UML 1.4.
Probably more than I can support it!

I would be happy if there were uptodate Use Case drawings in a model
that could be used to create svg or png for the wiki or a dynamic view
that could be explored in a browser.

>
> Best regards,
>
> Pierre Smits
>
> *ORRTIZ.COM <http://www.orrtiz.com>*
> Services & Solutions for Cloud-
> Based Manufacturing, Professional
> Services and Retail & Trade
> http://www.orrtiz.com
>
> On Thu, Feb 19, 2015 at 6:43 PM, Pierre Smits <[hidden email]>
> wrote:
>
>> In the past I have often used the UML tools/solutions available as Eclipse
>> plugins. And I mainly used the use-case part for generating those diagrams.
>> But without an export to .rtf such a tool is useless...
>>
>> Best regards,
>>
>> Pierre Smits
>>
>> *ORRTIZ.COM <http://www.orrtiz.com>*
>> Services & Solutions for Cloud-
>> Based Manufacturing, Professional
>> Services and Retail & Trade
>> http://www.orrtiz.com
>>
>> On Thu, Feb 19, 2015 at 6:36 PM, Jacques Le Roux <
>> [hidden email]> wrote:
>>
>>> Le 19/02/2015 17:19, Ron Wheeler a écrit :
>>>
>>>> That would be great.
>>>> I do not have write access to that part of the wiki but I could
>>>> contribute some text and examples and links to the sites that I have found
>>>> for Graphviz.
>>>>
>>>> It would be good to have some guidelines  ( "Use the embedded Wiki tools
>>>> such as Graphviz and Gliffy whenever possible." "when you create a grphic
>>>> externally, add the source file to a child page as an attachment  with the
>>>> name of the tool and how the graphic can be regenerated." If you create Use
>>>> Cases or other UML, add the model as a child page.")
>>>>
>>>> What are people using for UML?
>>>>
>>> I believe most people use ArgoUML, at least I know the Neogia team did at
>>> some point They also mentioned their UFO tool http://www.neogia.org/wiki/
>>> index.php/U.F.O.
>>> It has only the entity part, but anyway, sincerely I'm not a fan of UML
>>> and such, I'm more inclined to something like Hemp where graphics are less
>>> important
>>> https://www.linkedin.com/groups/HEMP-Book-Now-
>>> Available-4640689.S.255382432
>>>
>>> I tend to find https://cwiki.apache.org/confluence/display/OFBIZ/Data+
>>> Model+Diagrams enough for my needs.
>>> For my day to day work, I rely more on search in OOTB *mode*.xml files.
>>> Data Model Diagrams sounds convenient but they are also often blurring
>>> things. When you have a data model with 800+ tables it's not surprising...
>>>
>>> Jacques
>>>
>>>
>>>   One can use Gliffy but it does not create a model so there is no
>>>> repurposing or analysis possible from the effort of creating the drawing.
>>>> I have only seen a few Use Case drawings in the wiki but I did not find
>>>> the source model that was used to create the drawings or even a mention of
>>>> the tool used and I did not check to see if they were in Gliffy or not.
>>>> I use ArgoUML which is free and open source.
>>>> It is pretty complete but like some other open source products, it lacks
>>>> a bit of polish and the docs are spotty.
>>>>
>>>>
>>>> Ron
>>>>
>>>>
>>>> On 19/02/2015 9:49 AM, Jacques Le Roux wrote:
>>>>
>>>>> Maybe we could create a page in the wiki (children of
>>>>> https://cwiki.apache.org/confluence/display/OFBADMIN/
>>>>> Apache+OFBiz+Contributors or directly a section in
>>>>> https://cwiki.apache.org/confluence/display/OFBADMIN/
>>>>> OFBiz+Contributors+Best+Practices) with Guidelines for graphics in the
>>>>> wiki?
>>>>>
>>>>> Jacques
>>>>>
>>>>> Le 19/02/2015 15:29, Ron Wheeler a écrit :
>>>>>
>>>>>> http://blog.lunatech.com/2007/04/27/uml-class-diagrams-
>>>>>> confluence-using-graphviz-and-dot
>>>>>> Shows some simple ways to add UML to the wiki using Graphviz.
>>>>>>
>>>>>> Ron
>>>>>>
>>>>>>
>>>>>>
>>>>


--
Ron Wheeler
President
Artifact Software Inc
email: [hidden email]
skype: ronaldmwheeler
phone: 866-970-2435, ext 102

Reply | Threaded
Open this post in threaded view
|

Re: Adding UML to the Wiki

Jacques Le Roux
Administrator
In reply to this post by Ron Wheeler

Le 20/02/2015 02:15, Ron Wheeler a écrit :

> On 19/02/2015 12:36 PM, Jacques Le Roux wrote:
>>
>> Le 19/02/2015 17:19, Ron Wheeler a écrit :
>>> That would be great.
>>> I do not have write access to that part of the wiki but I could contribute some text and examples and links to the sites that I have found for
>>> Graphviz.
>>>
>>> It would be good to have some guidelines  ( "Use the embedded Wiki tools such as Graphviz and Gliffy whenever possible." "when you create a grphic
>>> externally, add the source file to a child page as an attachment  with the name of the tool and how the graphic can be regenerated." If you create
>>> Use Cases or other UML, add the model as a child page.")
>>>
>>> What are people using for UML?
>>
>> I believe most people use ArgoUML, at least I know the Neogia team did at some point They also mentioned their UFO tool
>> http://www.neogia.org/wiki/index.php/U.F.O.
>> It has only the entity part, but anyway, sincerely I'm not a fan of UML and such, I'm more inclined to something like Hemp where graphics are less
>> important
>> https://www.linkedin.com/groups/HEMP-Book-Now-Available-4640689.S.255382432
>>
>> I tend to find https://cwiki.apache.org/confluence/display/OFBIZ/Data+Model+Diagrams enough for my needs.
>> For my day to day work, I rely more on search in OOTB *mode*.xml files. Data Model Diagrams sounds convenient but they are also often blurring
>> things. When you have a data model with 800+ tables it's not surprising...
>
> I agree that looking at the entity definitions is better specially since the graphics are 5 years old.
> If the drawings were updated as changes are made, it would be a more useful tool.

Of course and update would be welcome, but sincerely I don't think there is much important things missing in those graphics, at least nothing
preventing me to work on custom projects.

Apart some adding I can't quickly recall

I have "recently" (more than 1 year ago) marginally updated the GeoPoint data model https://issues.apache.org/jira/browse/OFBIZ-5453

Before the last change was r1222544 and it was 3+ year ago, see
https://cwiki.apache.org/confluence/display/OFBIZ/Revisions+Requiring+Data+Migration+-+upgrade+ofbiz

That's why I don't think we are missing much there, did you note something specific?

Jacques

>
>
>>
>> Jacques
>>
>>> One can use Gliffy but it does not create a model so there is no repurposing or analysis possible from the effort of creating the drawing.
>>> I have only seen a few Use Case drawings in the wiki but I did not find the source model that was used to create the drawings or even a mention of
>>> the tool used and I did not check to see if they were in Gliffy or not.
>>> I use ArgoUML which is free and open source.
>>> It is pretty complete but like some other open source products, it lacks a bit of polish and the docs are spotty.
>>>
>>>
>>> Ron
>>>
>>>
>>> On 19/02/2015 9:49 AM, Jacques Le Roux wrote:
>>>> Maybe we could create a page in the wiki (children of https://cwiki.apache.org/confluence/display/OFBADMIN/Apache+OFBiz+Contributors or directly
>>>> a section in https://cwiki.apache.org/confluence/display/OFBADMIN/OFBiz+Contributors+Best+Practices) with Guidelines for graphics in the wiki?
>>>>
>>>> Jacques
>>>>
>>>> Le 19/02/2015 15:29, Ron Wheeler a écrit :
>>>>>
>>>>> http://blog.lunatech.com/2007/04/27/uml-class-diagrams-confluence-using-graphviz-and-dot
>>>>> Shows some simple ways to add UML to the wiki using Graphviz.
>>>>>
>>>>> Ron
>>>>>
>>>>>
>>>>
>>>
>>>
>>
>
>
Reply | Threaded
Open this post in threaded view
|

Re: Adding UML to the Wiki

Ron Wheeler
On 20/02/2015 2:24 AM, Jacques Le Roux wrote:

>
> Le 20/02/2015 02:15, Ron Wheeler a écrit :
>> On 19/02/2015 12:36 PM, Jacques Le Roux wrote:
>>>
>>> Le 19/02/2015 17:19, Ron Wheeler a écrit :
>>>> That would be great.
>>>> I do not have write access to that part of the wiki but I could
>>>> contribute some text and examples and links to the sites that I
>>>> have found for Graphviz.
>>>>
>>>> It would be good to have some guidelines  ( "Use the embedded Wiki
>>>> tools such as Graphviz and Gliffy whenever possible." "when you
>>>> create a grphic externally, add the source file to a child page as
>>>> an attachment  with the name of the tool and how the graphic can be
>>>> regenerated." If you create Use Cases or other UML, add the model
>>>> as a child page.")
>>>>
>>>> What are people using for UML?
>>>
>>> I believe most people use ArgoUML, at least I know the Neogia team
>>> did at some point They also mentioned their UFO tool
>>> http://www.neogia.org/wiki/index.php/U.F.O.
>>> It has only the entity part, but anyway, sincerely I'm not a fan of
>>> UML and such, I'm more inclined to something like Hemp where
>>> graphics are less important
>>> https://www.linkedin.com/groups/HEMP-Book-Now-Available-4640689.S.255382432 
>>>
>>>
>>> I tend to find
>>> https://cwiki.apache.org/confluence/display/OFBIZ/Data+Model+Diagrams enough
>>> for my needs.
>>> For my day to day work, I rely more on search in OOTB *mode*.xml
>>> files. Data Model Diagrams sounds convenient but they are also often
>>> blurring things. When you have a data model with 800+ tables it's
>>> not surprising...
>>
>> I agree that looking at the entity definitions is better specially
>> since the graphics are 5 years old.
>> If the drawings were updated as changes are made, it would be a more
>> useful tool.
>
> Of course and update would be welcome, but sincerely I don't think
> there is much important things missing in those graphics, at least
> nothing preventing me to work on custom projects.
>
> Apart some adding I can't quickly recall
>
> I have "recently" (more than 1 year ago) marginally updated the
> GeoPoint data model https://issues.apache.org/jira/browse/OFBIZ-5453
>
> Before the last change was r1222544 and it was 3+ year ago, see
> https://cwiki.apache.org/confluence/display/OFBIZ/Revisions+Requiring+Data+Migration+-+upgrade+ofbiz
>
> That's why I don't think we are missing much there, did you note
> something specific?

Once I saw the age, I did not spend a lot of time there.
I am building my current understanding from the xml files.
There is more information there and I have more confidence that they
reflect the current product.


Ron

>
> Jacques
>
>>
>>
>>>
>>> Jacques
>>>
>>>> One can use Gliffy but it does not create a model so there is no
>>>> repurposing or analysis possible from the effort of creating the
>>>> drawing.
>>>> I have only seen a few Use Case drawings in the wiki but I did not
>>>> find the source model that was used to create the drawings or even
>>>> a mention of the tool used and I did not check to see if they were
>>>> in Gliffy or not.
>>>> I use ArgoUML which is free and open source.
>>>> It is pretty complete but like some other open source products, it
>>>> lacks a bit of polish and the docs are spotty.
>>>>
>>>>
>>>> Ron
>>>>
>>>>
>>>> On 19/02/2015 9:49 AM, Jacques Le Roux wrote:
>>>>> Maybe we could create a page in the wiki (children of
>>>>> https://cwiki.apache.org/confluence/display/OFBADMIN/Apache+OFBiz+Contributors 
>>>>> or directly a section in
>>>>> https://cwiki.apache.org/confluence/display/OFBADMIN/OFBiz+Contributors+Best+Practices)
>>>>> with Guidelines for graphics in the wiki?
>>>>>
>>>>> Jacques
>>>>>
>>>>> Le 19/02/2015 15:29, Ron Wheeler a écrit :
>>>>>>
>>>>>> http://blog.lunatech.com/2007/04/27/uml-class-diagrams-confluence-using-graphviz-and-dot 
>>>>>>
>>>>>> Shows some simple ways to add UML to the wiki using Graphviz.
>>>>>>
>>>>>> Ron
>>>>>>
>>>>>>
>>>>>
>>>>
>>>>
>>>
>>
>>
>


--
Ron Wheeler
President
Artifact Software Inc
email: [hidden email]
skype: ronaldmwheeler
phone: 866-970-2435, ext 102

Reply | Threaded
Open this post in threaded view
|

Re: Adding UML to the Wiki

Jacques Le Roux
Administrator
In reply to this post by Ron Wheeler
Ron you might be interested by https://issues.apache.org/jira/browse/INFRA-9194?focusedCommentId=14348690

Thanks

Jacques

Le 19/02/2015 15:29, Ron Wheeler a écrit :
>
> http://blog.lunatech.com/2007/04/27/uml-class-diagrams-confluence-using-graphviz-and-dot
> Shows some simple ways to add UML to the wiki using Graphviz.
>
> Ron
>
>
Reply | Threaded
Open this post in threaded view
|

Re: Adding UML to the Wiki

Nicolas Malin-2
In reply to this post by Jacques Le Roux
Hi,

The ufo application read all entitymodel présent on OFBiz to help the
analyst to construct an uml.
Maybe it's possible to convert the diagram result to Graphviz syntax ?

Nicolas

Le 19/02/2015 18:36, Jacques Le Roux a écrit :

>
> Le 19/02/2015 17:19, Ron Wheeler a écrit :
>> That would be great.
>> I do not have write access to that part of the wiki but I could
>> contribute some text and examples and links to the sites that I have
>> found for Graphviz.
>>
>> It would be good to have some guidelines  ( "Use the embedded Wiki
>> tools such as Graphviz and Gliffy whenever possible." "when you
>> create a grphic externally, add the source file to a child page as an
>> attachment  with the name of the tool and how the graphic can be
>> regenerated." If you create Use Cases or other UML, add the model as
>> a child page.")
>>
>> What are people using for UML?
>
> I believe most people use ArgoUML, at least I know the Neogia team did
> at some point They also mentioned their UFO tool
> http://www.neogia.org/wiki/index.php/U.F.O.
> It has only the entity part, but anyway, sincerely I'm not a fan of
> UML and such, I'm more inclined to something like Hemp where graphics
> are less important
> https://www.linkedin.com/groups/HEMP-Book-Now-Available-4640689.S.255382432 
>
>
> I tend to find
> https://cwiki.apache.org/confluence/display/OFBIZ/Data+Model+Diagrams 
> enough for my needs.
> For my day to day work, I rely more on search in OOTB *mode*.xml
> files. Data Model Diagrams sounds convenient but they are also often
> blurring things. When you have a data model with 800+ tables it's not
> surprising...
>
> Jacques
>
>> One can use Gliffy but it does not create a model so there is no
>> repurposing or analysis possible from the effort of creating the
>> drawing.
>> I have only seen a few Use Case drawings in the wiki but I did not
>> find the source model that was used to create the drawings or even a
>> mention of the tool used and I did not check to see if they were in
>> Gliffy or not.
>> I use ArgoUML which is free and open source.
>> It is pretty complete but like some other open source products, it
>> lacks a bit of polish and the docs are spotty.
>>
>>
>> Ron
>>
>>
>> On 19/02/2015 9:49 AM, Jacques Le Roux wrote:
>>> Maybe we could create a page in the wiki (children of
>>> https://cwiki.apache.org/confluence/display/OFBADMIN/Apache+OFBiz+Contributors 
>>> or directly a section in
>>> https://cwiki.apache.org/confluence/display/OFBADMIN/OFBiz+Contributors+Best+Practices)
>>> with Guidelines for graphics in the wiki?
>>>
>>> Jacques
>>>
>>> Le 19/02/2015 15:29, Ron Wheeler a écrit :
>>>>
>>>> http://blog.lunatech.com/2007/04/27/uml-class-diagrams-confluence-using-graphviz-and-dot 
>>>>
>>>> Shows some simple ways to add UML to the wiki using Graphviz.
>>>>
>>>> Ron
>>>>
>>>>
>>>
>>
>>