# Step by step Achetype editing **Category:** [Technical (archive)](https://discourse.openehr.org/c/technical-archive/156) **Created:** 2008-06-25 13:31 UTC **Views:** 1 **Replies:** 5 **URL:** https://discourse.openehr.org/t/step-by-step-achetype-editing/14779 --- ## Post #1 by @Paria_Kashfi Hi all, I've just started browsing and investigating two existing archetype editors, hardly could I find a step by step tutorial for creating Archetypes \(and then Templates\) Is there any recommended resource? Regards paria PhD Student IDC | Interaction Design Collegium Department of Computing Science and Engineering Chalmers University of Technology Email: hajar\.kashfi@chalmers\.se Office:\+46 \(0\)31 7725407 Mobile Phone: \+46 \(0\)707222815 Postal adress: IT University of Göteborg 412 96 Göteborg, Sweden Visit: Room Simula B, House Svea, Campus Lindholmen --- ## Post #2 by @Tim_Cook2 AFAIK there isn't a step\-by\-step tutorial\. There are many resources on the website and I suppose they can be a bit daunting to navigate\. There is an ongoing discussion on the openEHR Clinical list on deciding how to select an archetype type to begin creating a specific archetype\. To get you started you might refer to this discussion and the very nice presentation that Gerard Freriks just published on the openEHR website\. Discussion: http://lists.chime.ucl.ac.uk/mailman/private/openehr-clinical/2008-June/000894.html There are related threads on this so you'll need to read several\. Presentation: http://tinyurl.com/6h2vs8 HTH, \-\-Tim --- ## Post #3 by @ian.mcnicoll Hi Paria, The Ocean archetype editor help files are not too bad as a 'technical' guide and these other pages might be helpful openEHR Entry Types FAQs http://www.openehr.org/shared-resources/faqs/entrytypes.html What reference model class to use when? http://www.openehr.org/wiki/pages/viewpage.action?pageId=786529 and, of course, look at existing examples http://www.archetypes.com.au/archetypefinder/archetypefinder Although you may find the discussion pointed to by Tim to be of interest, in my experience, beginners often find the Evaluation or Observation debate confusing because there are many grey\-area examples in clinical practice\. I take the view that much of this debate, though fun, can be distracting, since other than the clear cases where a clinical concept demands the sophisticated, precise timing/state features of the Observation class, the consequences of mis\-labelling e\.g a Barthel Score as Evaluation, rather than Observation, are almost nil\. One other useful tip, which the 'professionals' find very useful is to use mindmapping software such as Freemind to setup and refine the basic archetype structure, before replicating in the archetype editor\. Have fun, Ian Dr Ian McNicoll office / fax \+44\(0\)141 560 4657 mobile \+44 \(0\)775 209 7859 skype ianmcnicoll Consultant \- Ocean Informatics ian\.mcnicoll@oceaninformatics\.com Consultant \- IRIS GP Accounts Member of BCS Primary Health Care Specialist Group – www\.phcsg\.org --- ## Post #4 by @Andersson_Richard Hi Paria\. I´m right now trying to write a tutorial for the Ocean informatics archetype editor\. My knowledge of archetypes was zero some week ago, so yet I have no complete tutorial\. I believe the tutorial will be some gathered material of different threads out there, plus some examples on how to step\-by\-step build an archetype\. You are welcome to mail questions to me\. If I can help you, I would be glad\. If not, I get some good ideas on what I need to include in a tutorial\. :\) Possibly I can start on a tutorial for the template builder too, but thats a later question right now\. Richard Andersson Student Department of Informatics University of Lund This summer on Department of IT\-strategy University Hospital of Lund richard\.andersson@skane\.se --- ## Post #5 by @Paria_Kashfi Great! Actually I tried to study papers and presentation in the website, to be honest, not all of them, but what I found was a background knowledge of openEHR and two archetype editors that I already had found in MIE2008 ,maybe more in detail this time. Last week, I tried to install both Editors on my Mac. For LIU one, I had no problem but I couldn't find a Mac version for OceanInformatic version, hence, I installed a Virtual Box, a XP on it and after some tricky processes I could install and run the second editor. As a part of my PhD studies, I'm responsible to find out whether openEHR archetypes are feasible and applicable for our case or not- seems it is getting more and more popular as a standard model- however, the first step for using them in a real project is to make end users- clinicians- use an editor to create archetypes, templates and so on. but how to start? As far as I found, there's no completely helpful tutorial for those editors yet. Helps sound interesting at the first glance but when one , as a newcomer to these concepts, wants to start creating a project, an Archetype, problems rise. as for myself, I was just scramble to find what I should when I want to create an archetype for a specific disease. maybe the problem is that I'm not a medical expert, I told myself, but yesterday when I checked the discussion in medical group that Tim sent me, I found it's also hard for clinicians to decide about some components,...well, maybe not in the start point. for me confusions exist: should I start with a composition? then go for sections and entries? couldn' find it up to this moment! If you are familiar with OWL, I was expecting something like Pizza Finder tutorial for Archetypes as well. a Step by step tutorial, including a sample case. should we expect one who wants just browse and find if these editors are usable enough for her/him to know any details about openEHR architecture, specifications ,etc? Pizza finder tutorial, for instance, at the end carried me to this point: "well, now I feel OWL is worth learning, going to details. OWL Ontologies are what I was searching for!" Anyway, that tutorial would be very helpful for me too. maybe, I even can share my experience through this way -paria > Hi Paria. > I´m right now trying to write a tutorial for the Ocean informatics archetype editor. My knowledge of archetypes was zero some week ago, so yet I have no complete tutorial. > > I believe the tutorial will be some gathered material of different threads out there, plus some examples on how to step-by-step build an archetype. > > You are welcome to mail questions to me. If I can help you, I would be glad. If not, I get some good ideas on what I need to include in a tutorial. :) > > Possibly I can start on a tutorial for the template builder too, but thats a later question right now. > > Richard Andersson > Student > Department of Informatics > University of Lund > This summer on Department of IT-strategy > University Hospital of Lund > [richard.andersson@skane.se](mailto:richard.andersson@skane.se) > > ________________________________ > > Från: openehr-technical-bounces@openehr.org genom Päria Kashfi > Skickat: on 2008-06-25 15:31 > Till: For openEHR technical discussions > Ämne: Step by step Achetype editing > > Hi all, > I've just started browsing and investigating two existing archetype > editors, > hardly could I find a step by step tutorial for creating Archetypes > (and then Templates) > Is there any recommended resource? > > Regards > paria > > PhD Student > IDC | Interaction Design Collegium > Department of Computing Science and Engineering > Chalmers University of Technology > > Email: hajar.kashfi@chalmers.se > Office:+46 (0)31 7725407 > Mobile Phone: +46 (0)707222815 > Postal adress: > IT University of Göteborg > 412 96 Göteborg, Sweden > Visit: Room Simula B, House Svea, Campus Lindholmen > > _______________________________________________ > openEHR-technical mailing list > openEHR-technical@openehr.org > http://lists.chime.ucl.ac.uk/mailman/listinfo/openehr-technical > > _______________________________________________ > openEHR-technical mailing list > openEHR-technical@openehr.org > http://lists.chime.ucl.ac.uk/mailman/listinfo/openehr-technical PhD Student IDC | Interaction Design Collegium Department of Computing Science and Engineering Chalmers University of Technology Email: [hajar.kashfi@chalmers.se](mailto:hajar.kashfi@chalmers.se) Office:+46 (0)31 7725407 Mobile Phone: +46 (0)707222815 Postal adress: IT University of Göteborg 412 96 Göteborg, Sweden Visit: Room Simula B, House Svea, Campus Lindholmen --- ## Post #6 by @Paria_Kashfi These links are of a great help! Tanks to Ian > Hi Paria, > > The Ocean archetype editor help files are not too bad as a 'technical' > guide and these other pages might be helpful > > openEHR Entry Types FAQs > [http://www.openehr.org/shared-resources/faqs/entrytypes.html](http://www.openehr.org/shared-resources/faqs/entrytypes.html) > > What reference model class to use when? > http://www.openehr.org/wiki/pages/viewpage.action?pageId=786529 > > and, of course, look at existing examples > http://www.archetypes.com.au/archetypefinder/archetypefinder > > Although you may find the discussion pointed to by Tim to be of > interest, in my experience, beginners often find the Evaluation or > Observation debate confusing because there are many grey-area examples > in clinical practice. I take the view that much of this debate, > though fun, can be distracting, since other than the clear cases where > a clinical concept demands the sophisticated, precise timing/state > features of the Observation class, the consequences of mis-labelling > e.g a Barthel Score as Evaluation, rather than Observation, are almost > nil. > > One other useful tip, which the 'professionals' find very useful is to > use mindmapping software such as Freemind to setup and refine the > basic archetype structure, before replicating in the archetype editor. > > Have fun, > > Ian > Dr Ian McNicoll > office / fax +44(0)141 560 4657 > mobile +44 (0)775 209 7859 > skype ianmcnicoll > > Consultant - Ocean Informatics ian.mcnicoll@oceaninformatics.com > Consultant - IRIS GP Accounts > > Member of BCS Primary Health Care Specialist Group – www.phcsg.org > > > > > > > > > Hi all, > > > > I've just started browsing and investigating two existing archetype > > > > editors, > > > > hardly could I find a step by step tutorial for creating Archetypes > > > > (and then Templates) > > > > Is there any recommended resource? > > > > > > AFAIK there isn't a step-by-step tutorial. There are many resources on > > > the website and I suppose they can be a bit daunting to navigate. > > > > > > There is an ongoing discussion on the openEHR Clinical list on deciding > > > how to select an archetype type to begin creating a specific archetype. > > > > > > To get you started you might refer to this discussion and the very nice > > > presentation that Gerard Freriks just published on the openEHR website. > > > > > > Discussion: > > > http://lists.chime.ucl.ac.uk/mailman/private/openehr-clinical/2008-June/000894.html > > > > > > There are related threads on this so you'll need to read several. > > > > > > Presentation: http://tinyurl.com/6h2vs8 > > > > > > HTH, > > > --Tim > > > > > > > > > > > > -- > > > Timothy Cook, MSc > > > Health Informatics Research & Development Services > > > LinkedIn Profile:http://www.linkedin.com/in/timothywaynecook > > > Skype ID == timothy.cook > > > ************************************************************** > > > *You may get my Public GPG key from popular keyservers or * > > > *from this link http://timothywayne.cook.googlepages.com/home* > > > ************************************************************** > > > > > > _______________________________________________ > > > openEHR-technical mailing list > > > openEHR-technical@openehr.org > > > http://lists.chime.ucl.ac.uk/mailman/listinfo/openehr-technical > > > > > > > > _______________________________________________ > openEHR-technical mailing list > openEHR-technical@openehr.org > http://lists.chime.ucl.ac.uk/mailman/listinfo/openehr-technical PhD Student IDC | Interaction Design Collegium Department of Computing Science and Engineering Chalmers University of Technology Email: [hajar.kashfi@chalmers.se](mailto:hajar.kashfi@chalmers.se) Office:+46 (0)31 7725407 Mobile Phone: +46 (0)707222815 Postal adress: IT University of Göteborg 412 96 Göteborg, Sweden Visit: Room Simula B, House Svea, Campus Lindholmen --- **Canonical:** https://discourse.openehr.org/t/step-by-step-achetype-editing/14779 **Original content:** https://discourse.openehr.org/t/step-by-step-achetype-editing/14779