EM HAVE SC

 View Only
Expand all | Collapse all

HAVE 2.0 - Data Dictionary

  • 1.  HAVE 2.0 - Data Dictionary

    Posted 10-22-2014 11:00
    Folks - as we discussed in the EDXL-HAVE SC meeting this afternoon we would like to use a different format for the Data Dictionary section of the standards document. I have CC'ed Chet Ensign from the TC Admin as per Elysa's recommendation.  The approach that I recommend and that we agreed upon was to use an auto-generated document that is driven from the data in our XML Schema. This would mean that there should be no errors (barring a software glitch in OxygenXML) but there are a couple of issues to consider: 1. I can't generate a Word-compatible version so we can't cut and paste the content into the .docx standard file. I proposed that we would include the full PDF (sample attached) as an appendix and reference it in the Data Dictionary. This would need approval from the TC Admin for the format.  2. There may be come formatting issues. If you look at the attached PDF, there are a few images that go beyond the page (e.g. see page 8). We can make a fully browse-able website version available too though - it doesn't have that problem.  Here is a screenshot comparing a draft (ignore the highlights on the left side please) with the normal table and the generated XML Schema documentation on the right. I believe all of the fields and information that we need is there and it includes a pretty good diagram. We'll have the ERM diagram as well (thanks to Patti!) and the rest is coming along well. Thanks a ton for the great meeting. I'll send out the draft minutes in a moment. cheers, Darrell -- Darrell O'Donnell, P.Eng. OASIS Member (volunteer) - www.oasis-open.org   OASIS EM-TC - Member OASIS EM-TC HAVE SC - Co-Chair darrell.odonnell@continuumloop.com Attachment: edxl-have-v2.0-wd.pdf Description: Adobe PDF document

    Attachment(s)

    pdf
    edxl-have-v2.0-wd.pdf   3.02 MB 1 version


  • 2.  RE: [emergency-have] HAVE 2.0 - Data Dictionary

    Posted 10-23-2014 11:34
    Chet,   Please review this process for an auto-generated data dictionary.  We are working diligently to get a PR draft out for HAVE given the interest due to the Ebola situation.  This method would save us time as well as minimize/eliminate the common mistakes made when it is done manually.    Thanks,   Elysa Jones, Chair OASIS Emergency Management Technical Committee Emergency Interoperability Member Section   Elysa     From: emergency-have@lists.oasis-open.org [mailto:emergency-have@lists.oasis-open.org] On Behalf Of Darrell O'Donnell Sent: Wednesday, October 22, 2014 6:00 AM To: HAVE SC Cc: Chet Ensign Subject: [emergency-have] HAVE 2.0 - Data Dictionary   Folks - as we discussed in the EDXL-HAVE SC meeting this afternoon we would like to use a different format for the Data Dictionary section of the standards document.   I have CC'ed Chet Ensign from the TC Admin as per Elysa's recommendation.    The approach that I recommend and that we agreed upon was to use an auto-generated document that is driven from the data in our XML Schema. This would mean that there should be no errors (barring a software glitch in OxygenXML) but there are a couple of issues to consider:   1. I can't generate a Word-compatible version so we can't cut and paste the content into the .docx standard file. I proposed that we would include the full PDF (sample attached) as an appendix and reference it in the Data Dictionary. This would need approval from the TC Admin for the format.    2. There may be come formatting issues. If you look at the attached PDF, there are a few images that go beyond the page (e.g. see page 8). We can make a fully browse-able website version available too though - it doesn't have that problem.    Here is a screenshot comparing a draft (ignore the highlights on the left side please) with the normal table and the generated XML Schema documentation on the right. I believe all of the fields and information that we need is there and it includes a pretty good diagram.     We'll have the ERM diagram as well (thanks to Patti!) and the rest is coming along well.   Thanks a ton for the great meeting. I'll send out the draft minutes in a moment.   cheers,   Darrell     --   Darrell O'Donnell, P.Eng. OASIS Member (volunteer) - www.oasis-open.org   OASIS EM-TC - Member OASIS EM-TC HAVE SC - Co-Chair   darrell.odonnell@continuumloop.com    


  • 3.  Re: [emergency-have] HAVE 2.0 - Data Dictionary

    Posted 10-23-2014 11:36
    Chet - as a consideration we can also generate a detailed and interactive HTML version of the schema. Here is an example that I generated from our working draft:  http://oasis-edxl-have-v2.0-wd.s3.amazonaws.com/edxl-have-v2.0-wd.html cheers, Darrell -- Darrell O'Donnell, P.Eng. OASIS Member (volunteer) - www.oasis-open.org   OASIS EM-TC - Member OASIS EM-TC HAVE SC - Co-Chair darrell.odonnell@continuumloop.com On Thu, Oct 23, 2014 at 7:34 AM, Elysa Jones < elysajones@yahoo.com > wrote: Chet,   Please review this process for an auto-generated data dictionary.  We are working diligently to get a PR draft out for HAVE given the interest due to the Ebola situation.  This method would save us time as well as minimize/eliminate the common mistakes made when it is done manually.    Thanks,   Elysa Jones, Chair OASIS Emergency Management Technical Committee Emergency Interoperability Member Section   Elysa     From: emergency-have@lists.oasis-open.org [mailto: emergency-have@lists.oasis-open.org ] On Behalf Of Darrell O'Donnell Sent: Wednesday, October 22, 2014 6:00 AM To: HAVE SC Cc: Chet Ensign Subject: [emergency-have] HAVE 2.0 - Data Dictionary   Folks - as we discussed in the EDXL-HAVE SC meeting this afternoon we would like to use a different format for the Data Dictionary section of the standards document.   I have CC'ed Chet Ensign from the TC Admin as per Elysa's recommendation.    The approach that I recommend and that we agreed upon was to use an auto-generated document that is driven from the data in our XML Schema. This would mean that there should be no errors (barring a software glitch in OxygenXML) but there are a couple of issues to consider:   1. I can't generate a Word-compatible version so we can't cut and paste the content into the .docx standard file. I proposed that we would include the full PDF (sample attached) as an appendix and reference it in the Data Dictionary. This would need approval from the TC Admin for the format.    2. There may be come formatting issues. If you look at the attached PDF, there are a few images that go beyond the page (e.g. see page 8). We can make a fully browse-able website version available too though - it doesn't have that problem.    Here is a screenshot comparing a draft (ignore the highlights on the left side please) with the normal table and the generated XML Schema documentation on the right. I believe all of the fields and information that we need is there and it includes a pretty good diagram.     We'll have the ERM diagram as well (thanks to Patti!) and the rest is coming along well.   Thanks a ton for the great meeting. I'll send out the draft minutes in a moment.   cheers,   Darrell     --   Darrell O'Donnell, P.Eng. OASIS Member (volunteer) - www.oasis-open.org   OASIS EM-TC - Member OASIS EM-TC HAVE SC - Co-Chair   darrell.odonnell@continuumloop.com    


  • 4.  Re: [emergency-have] HAVE 2.0 - Data Dictionary

    Posted 10-23-2014 20:50
    Elysa, Darrell, let me just be sure I understand your objective here.  The potential social / healthcare benefit is not lost on me so you have no selling to do on that score. I read "The Hot Zone" years ago. Ebola is ample justification for swift action.  If I understand what you want to do, your goal is to approve and publish a Committee Spec Draft of the EDXL-HAVE Data Dictionary as fast as possible so that people have a public version of this refined spec to apply to the Ebola outbreak.  - Is this a brand new work product? Looking at  http://docs.oasis-open.org/emergency/edxl-have/ I don't find anything comparable so I am guessing it is.  - Do you simply want to get it online as an approved CSD of some kind (details we need to work out) or do you also want to move it forward into public review?  Thanks for your answers. I'm just trying to sort out in my mind how we can best accomplish this.  Best,  /chet On Thu, Oct 23, 2014 at 7:35 AM, Darrell O'Donnell < darrell.odonnell@continuumloop.com > wrote: Chet - as a consideration we can also generate a detailed and interactive HTML version of the schema. Here is an example that I generated from our working draft:  http://oasis-edxl-have-v2.0-wd.s3.amazonaws.com/edxl-have-v2.0-wd.html cheers, Darrell -- Darrell O'Donnell, P.Eng. OASIS Member (volunteer) - www.oasis-open.org   OASIS EM-TC - Member OASIS EM-TC HAVE SC - Co-Chair darrell.odonnell@continuumloop.com On Thu, Oct 23, 2014 at 7:34 AM, Elysa Jones < elysajones@yahoo.com > wrote: Chet,   Please review this process for an auto-generated data dictionary.  We are working diligently to get a PR draft out for HAVE given the interest due to the Ebola situation.  This method would save us time as well as minimize/eliminate the common mistakes made when it is done manually.    Thanks,   Elysa Jones, Chair OASIS Emergency Management Technical Committee Emergency Interoperability Member Section   Elysa     From: emergency-have@lists.oasis-open.org [mailto: emergency-have@lists.oasis-open.org ] On Behalf Of Darrell O'Donnell Sent: Wednesday, October 22, 2014 6:00 AM To: HAVE SC Cc: Chet Ensign Subject: [emergency-have] HAVE 2.0 - Data Dictionary   Folks - as we discussed in the EDXL-HAVE SC meeting this afternoon we would like to use a different format for the Data Dictionary section of the standards document.   I have CC'ed Chet Ensign from the TC Admin as per Elysa's recommendation.    The approach that I recommend and that we agreed upon was to use an auto-generated document that is driven from the data in our XML Schema. This would mean that there should be no errors (barring a software glitch in OxygenXML) but there are a couple of issues to consider:   1. I can't generate a Word-compatible version so we can't cut and paste the content into the .docx standard file. I proposed that we would include the full PDF (sample attached) as an appendix and reference it in the Data Dictionary. This would need approval from the TC Admin for the format.    2. There may be come formatting issues. If you look at the attached PDF, there are a few images that go beyond the page (e.g. see page 8). We can make a fully browse-able website version available too though - it doesn't have that problem.    Here is a screenshot comparing a draft (ignore the highlights on the left side please) with the normal table and the generated XML Schema documentation on the right. I believe all of the fields and information that we need is there and it includes a pretty good diagram.     We'll have the ERM diagram as well (thanks to Patti!) and the rest is coming along well.   Thanks a ton for the great meeting. I'll send out the draft minutes in a moment.   cheers,   Darrell     --   Darrell O'Donnell, P.Eng. OASIS Member (volunteer) - www.oasis-open.org   OASIS EM-TC - Member OASIS EM-TC HAVE SC - Co-Chair   darrell.odonnell@continuumloop.com     -- /chet    [§]  ---------------- Chet Ensign Director of Standards Development and TC Administration  OASIS: Advancing open standards for the information society http://www.oasis-open.org Primary: +1 973-996-2298 Mobile: +1 201-341-1393  Check your work using the Support Request Submission Checklist at  http://www.oasis-open.org/committees/download.php/47248/tc-admin-submission-checklist.html   TC Administration information and support is available at http://www.oasis-open.org/resources/tcadmin Follow OASIS on: LinkedIn:     http://linkd.in/OASISopen Twitter:         http://twitter.com/OASISopen Facebook:   http://facebook.com/oasis.open


  • 5.  RE: [emergency-have] HAVE 2.0 - Data Dictionary

    Posted 10-23-2014 21:36
    Chet,   This is not at all a new work.  This evolved from a 1.0 that was used in Haiti after the earthquake.  Lessons learned and other inputs were gathered into a working draft of 2.0 that has been in development for over a year.  The working draft, aka WD09 has been used in experiments and field trials.  We are anxious to get this in hands of implementers because it is so much improved over the 1.0.  We are not asking to bypass any process as we will have a fully developed draft ready for EM-TC review and vote in the next few weeks.    The question asked of you here is whether we are ok to use this method of generating the data dictionary for both expediency and correctness.  It does not fit the normal OASIS template we use and need your guidance in that regard.   Thanks,   Elysa Jones, Chair OASIS Emergency Management Technical Committee Emergency Interoperability Member Section       From: emergency-have@lists.oasis-open.org [mailto:emergency-have@lists.oasis-open.org] On Behalf Of Chet Ensign Sent: Thursday, October 23, 2014 3:50 PM To: Darrell O'Donnell Cc: Elysa Jones; HAVE SC Subject: Re: [emergency-have] HAVE 2.0 - Data Dictionary   Elysa, Darrell, let me just be sure I understand your objective here.    The potential social / healthcare benefit is not lost on me so you have no selling to do on that score. I read "The Hot Zone" years ago. Ebola is ample justification for swift action.    If I understand what you want to do, your goal is to approve and publish a Committee Spec Draft of the EDXL-HAVE Data Dictionary as fast as possible so that people have a public version of this refined spec to apply to the Ebola outbreak.    - Is this a brand new work product? Looking at  http://docs.oasis-open.org/emergency/edxl-have/ I don't find anything comparable so I am guessing it is.    - Do you simply want to get it online as an approved CSD of some kind (details we need to work out) or do you also want to move it forward into public review?    Thanks for your answers. I'm just trying to sort out in my mind how we can best accomplish this.    Best,    /chet     On Thu, Oct 23, 2014 at 7:35 AM, Darrell O'Donnell < darrell.odonnell@continuumloop.com > wrote: Chet - as a consideration we can also generate a detailed and interactive HTML version of the schema. Here is an example that I generated from our working draft:  http://oasis-edxl-have-v2.0-wd.s3.amazonaws.com/edxl-have-v2.0-wd.html   cheers,   Darrell     --   Darrell O'Donnell, P.Eng. OASIS Member (volunteer) - www.oasis-open.org   OASIS EM-TC - Member OASIS EM-TC HAVE SC - Co-Chair   darrell.odonnell@continuumloop.com       On Thu, Oct 23, 2014 at 7:34 AM, Elysa Jones < elysajones@yahoo.com > wrote: Chet,   Please review this process for an auto-generated data dictionary.  We are working diligently to get a PR draft out for HAVE given the interest due to the Ebola situation.  This method would save us time as well as minimize/eliminate the common mistakes made when it is done manually.    Thanks,   Elysa Jones, Chair OASIS Emergency Management Technical Committee Emergency Interoperability Member Section   Elysa     From: emergency-have@lists.oasis-open.org [mailto: emergency-have@lists.oasis-open.org ] On Behalf Of Darrell O'Donnell Sent: Wednesday, October 22, 2014 6:00 AM To: HAVE SC Cc: Chet Ensign Subject: [emergency-have] HAVE 2.0 - Data Dictionary   Folks - as we discussed in the EDXL-HAVE SC meeting this afternoon we would like to use a different format for the Data Dictionary section of the standards document.   I have CC'ed Chet Ensign from the TC Admin as per Elysa's recommendation.    The approach that I recommend and that we agreed upon was to use an auto-generated document that is driven from the data in our XML Schema. This would mean that there should be no errors (barring a software glitch in OxygenXML) but there are a couple of issues to consider:   1. I can't generate a Word-compatible version so we can't cut and paste the content into the .docx standard file. I proposed that we would include the full PDF (sample attached) as an appendix and reference it in the Data Dictionary. This would need approval from the TC Admin for the format.    2. There may be come formatting issues. If you look at the attached PDF, there are a few images that go beyond the page (e.g. see page 8). We can make a fully browse-able website version available too though - it doesn't have that problem.    Here is a screenshot comparing a draft (ignore the highlights on the left side please) with the normal table and the generated XML Schema documentation on the right. I believe all of the fields and information that we need is there and it includes a pretty good diagram.     We'll have the ERM diagram as well (thanks to Patti!) and the rest is coming along well.   Thanks a ton for the great meeting. I'll send out the draft minutes in a moment.   cheers,   Darrell     --   Darrell O'Donnell, P.Eng. OASIS Member (volunteer) - www.oasis-open.org   OASIS EM-TC - Member OASIS EM-TC HAVE SC - Co-Chair   darrell.odonnell@continuumloop.com         -- /chet    [§]  ---------------- Chet Ensign Director of Standards Development and TC Administration  OASIS: Advancing open standards for the information society http://www.oasis-open.org Primary: +1 973-996-2298 Mobile: +1 201-341-1393    Check your work using the Support Request Submission Checklist at  http://www.oasis-open.org/committees/download.php/47248/tc-admin-submission-checklist.html   TC Administration information and support is available at http://www.oasis-open.org/resources/tcadmin Follow OASIS on: LinkedIn:     http://linkd.in/OASISopen Twitter:         http://twitter.com/OASISopen Facebook:   http://facebook.com/oasis.open


  • 6.  Re: [emergency-have] HAVE 2.0 - Data Dictionary

    Posted 10-23-2014 21:56
    Sorry, I should have been more clear. It appears to me that the current EDXL-HAVE published content is in  http://docs.oasis-open.org/emergency/edxl-have/v1.0/emergency_edxl_have-1.0.html . That is an OASIS Standard with Approved Errata.  So I assume that this would be a new Committee Specification Draft that would supersede this one?  On Thu, Oct 23, 2014 at 5:35 PM, Elysa Jones < elysajones@yahoo.com > wrote: Chet,   This is not at all a new work.  This evolved from a 1.0 that was used in Haiti after the earthquake.  Lessons learned and other inputs were gathered into a working draft of 2.0 that has been in development for over a year.  The working draft, aka WD09 has been used in experiments and field trials.  We are anxious to get this in hands of implementers because it is so much improved over the 1.0.  We are not asking to bypass any process as we will have a fully developed draft ready for EM-TC review and vote in the next few weeks.    The question asked of you here is whether we are ok to use this method of generating the data dictionary for both expediency and correctness.  It does not fit the normal OASIS template we use and need your guidance in that regard.   Thanks,   Elysa Jones, Chair OASIS Emergency Management Technical Committee Emergency Interoperability Member Section       From: emergency-have@lists.oasis-open.org [mailto: emergency-have@lists.oasis-open.org ] On Behalf Of Chet Ensign Sent: Thursday, October 23, 2014 3:50 PM To: Darrell O'Donnell Cc: Elysa Jones; HAVE SC Subject: Re: [emergency-have] HAVE 2.0 - Data Dictionary   Elysa, Darrell, let me just be sure I understand your objective here.    The potential social / healthcare benefit is not lost on me so you have no selling to do on that score. I read "The Hot Zone" years ago. Ebola is ample justification for swift action.    If I understand what you want to do, your goal is to approve and publish a Committee Spec Draft of the EDXL-HAVE Data Dictionary as fast as possible so that people have a public version of this refined spec to apply to the Ebola outbreak.    - Is this a brand new work product? Looking at  http://docs.oasis-open.org/emergency/edxl-have/ I don't find anything comparable so I am guessing it is.    - Do you simply want to get it online as an approved CSD of some kind (details we need to work out) or do you also want to move it forward into public review?    Thanks for your answers. I'm just trying to sort out in my mind how we can best accomplish this.    Best,    /chet     On Thu, Oct 23, 2014 at 7:35 AM, Darrell O'Donnell < darrell.odonnell@continuumloop.com > wrote: Chet - as a consideration we can also generate a detailed and interactive HTML version of the schema. Here is an example that I generated from our working draft:  http://oasis-edxl-have-v2.0-wd.s3.amazonaws.com/edxl-have-v2.0-wd.html   cheers,   Darrell     --   Darrell O'Donnell, P.Eng. OASIS Member (volunteer) - www.oasis-open.org   OASIS EM-TC - Member OASIS EM-TC HAVE SC - Co-Chair   darrell.odonnell@continuumloop.com       On Thu, Oct 23, 2014 at 7:34 AM, Elysa Jones < elysajones@yahoo.com > wrote: Chet,   Please review this process for an auto-generated data dictionary.  We are working diligently to get a PR draft out for HAVE given the interest due to the Ebola situation.  This method would save us time as well as minimize/eliminate the common mistakes made when it is done manually.    Thanks,   Elysa Jones, Chair OASIS Emergency Management Technical Committee Emergency Interoperability Member Section   Elysa     From: emergency-have@lists.oasis-open.org [mailto: emergency-have@lists.oasis-open.org ] On Behalf Of Darrell O'Donnell Sent: Wednesday, October 22, 2014 6:00 AM To: HAVE SC Cc: Chet Ensign Subject: [emergency-have] HAVE 2.0 - Data Dictionary   Folks - as we discussed in the EDXL-HAVE SC meeting this afternoon we would like to use a different format for the Data Dictionary section of the standards document.   I have CC'ed Chet Ensign from the TC Admin as per Elysa's recommendation.    The approach that I recommend and that we agreed upon was to use an auto-generated document that is driven from the data in our XML Schema. This would mean that there should be no errors (barring a software glitch in OxygenXML) but there are a couple of issues to consider:   1. I can't generate a Word-compatible version so we can't cut and paste the content into the .docx standard file. I proposed that we would include the full PDF (sample attached) as an appendix and reference it in the Data Dictionary. This would need approval from the TC Admin for the format.    2. There may be come formatting issues. If you look at the attached PDF, there are a few images that go beyond the page (e.g. see page 8). We can make a fully browse-able website version available too though - it doesn't have that problem.    Here is a screenshot comparing a draft (ignore the highlights on the left side please) with the normal table and the generated XML Schema documentation on the right. I believe all of the fields and information that we need is there and it includes a pretty good diagram.     We'll have the ERM diagram as well (thanks to Patti!) and the rest is coming along well.   Thanks a ton for the great meeting. I'll send out the draft minutes in a moment.   cheers,   Darrell     --   Darrell O'Donnell, P.Eng. OASIS Member (volunteer) - www.oasis-open.org   OASIS EM-TC - Member OASIS EM-TC HAVE SC - Co-Chair   darrell.odonnell@continuumloop.com         -- /chet    [§]  ---------------- Chet Ensign Director of Standards Development and TC Administration  OASIS: Advancing open standards for the information society http://www.oasis-open.org Primary: +1 973-996-2298 Mobile: +1 201-341-1393     Check your work using the Support Request Submission Checklist at  http://www.oasis-open.org/committees/download.php/47248/tc-admin-submission-checklist.html   TC Administration information and support is available at http://www.oasis-open.org/resources/tcadmin Follow OASIS on: LinkedIn:     http://linkd.in/OASISopen Twitter:         http://twitter.com/OASISopen Facebook:   http://facebook.com/oasis.open -- /chet    [§]  ---------------- Chet Ensign Director of Standards Development and TC Administration  OASIS: Advancing open standards for the information society http://www.oasis-open.org Primary: +1 973-996-2298 Mobile: +1 201-341-1393  Check your work using the Support Request Submission Checklist at  http://www.oasis-open.org/committees/download.php/47248/tc-admin-submission-checklist.html   TC Administration information and support is available at http://www.oasis-open.org/resources/tcadmin Follow OASIS on: LinkedIn:     http://linkd.in/OASISopen Twitter:         http://twitter.com/OASISopen Facebook:   http://facebook.com/oasis.open


  • 7.  Re: [emergency-have] HAVE 2.0 - Data Dictionary

    Posted 10-23-2014 22:07
    That is right. A new work wrt naming.  It is a 2.0 version though if that matters at this point.  We will be requesting the templates, etc and should pol rivalry do that now.  Thanks Elysa Jones iPhone  On Oct 23, 2014, at 4:56 PM, Chet Ensign < chet.ensign@oasis-open.org > wrote: Sorry, I should have been more clear. It appears to me that the current EDXL-HAVE published content is in  http://docs.oasis-open.org/emergency/edxl-have/v1.0/emergency_edxl_have-1.0.html . That is an OASIS Standard with Approved Errata.  So I assume that this would be a new Committee Specification Draft that would supersede this one?  On Thu, Oct 23, 2014 at 5:35 PM, Elysa Jones < elysajones@yahoo.com > wrote: Chet,   This is not at all a new work.  This evolved from a 1.0 that was used in Haiti after the earthquake.  Lessons learned and other inputs were gathered into a working draft of 2.0 that has been in development for over a year.  The working draft, aka WD09 has been used in experiments and field trials.  We are anxious to get this in hands of implementers because it is so much improved over the 1.0.  We are not asking to bypass any process as we will have a fully developed draft ready for EM-TC review and vote in the next few weeks.    The question asked of you here is whether we are ok to use this method of generating the data dictionary for both expediency and correctness.  It does not fit the normal OASIS template we use and need your guidance in that regard.   Thanks,   Elysa Jones, Chair OASIS Emergency Management Technical Committee Emergency Interoperability Member Section       From: emergency-have@lists.oasis-open.org [mailto: emergency-have@lists.oasis-open.org ] On Behalf Of Chet Ensign Sent: Thursday, October 23, 2014 3:50 PM To: Darrell O'Donnell Cc: Elysa Jones; HAVE SC Subject: Re: [emergency-have] HAVE 2.0 - Data Dictionary   Elysa, Darrell, let me just be sure I understand your objective here.    The potential social / healthcare benefit is not lost on me so you have no selling to do on that score. I read The Hot Zone years ago. Ebola is ample justification for swift action.    If I understand what you want to do, your goal is to approve and publish a Committee Spec Draft of the EDXL-HAVE Data Dictionary as fast as possible so that people have a public version of this refined spec to apply to the Ebola outbreak.    - Is this a brand new work product? Looking at  http://docs.oasis-open.org/emergency/edxl-have/ I don't find anything comparable so I am guessing it is.    - Do you simply want to get it online as an approved CSD of some kind (details we need to work out) or do you also want to move it forward into public review?    Thanks for your answers. I'm just trying to sort out in my mind how we can best accomplish this.    Best,    /chet     On Thu, Oct 23, 2014 at 7:35 AM, Darrell O'Donnell < darrell.odonnell@continuumloop.com > wrote: Chet - as a consideration we can also generate a detailed and interactive HTML version of the schema. Here is an example that I generated from our working draft:  http://oasis-edxl-have-v2.0-wd.s3.amazonaws.com/edxl-have-v2.0-wd.html   cheers,   Darrell     --   Darrell O'Donnell, P.Eng. OASIS Member (volunteer) - www.oasis-open.org   OASIS EM-TC - Member OASIS EM-TC HAVE SC - Co-Chair   darrell.odonnell@continuumloop.com <image002.png>       On Thu, Oct 23, 2014 at 7:34 AM, Elysa Jones < elysajones@yahoo.com > wrote: Chet,   Please review this process for an auto-generated data dictionary.  We are working diligently to get a PR draft out for HAVE given the interest due to the Ebola situation.  This method would save us time as well as minimize/eliminate the common mistakes made when it is done manually.    Thanks,   Elysa Jones, Chair OASIS Emergency Management Technical Committee Emergency Interoperability Member Section   Elysa     From: emergency-have@lists.oasis-open.org [mailto: emergency-have@lists.oasis-open.org ] On Behalf Of Darrell O'Donnell Sent: Wednesday, October 22, 2014 6:00 AM To: HAVE SC Cc: Chet Ensign Subject: [emergency-have] HAVE 2.0 - Data Dictionary   Folks - as we discussed in the EDXL-HAVE SC meeting this afternoon we would like to use a different format for the Data Dictionary section of the standards document.   I have CC'ed Chet Ensign from the TC Admin as per Elysa's recommendation.    The approach that I recommend and that we agreed upon was to use an auto-generated document that is driven from the data in our XML Schema. This would mean that there should be no errors (barring a software glitch in OxygenXML) but there are a couple of issues to consider:   1. I can't generate a Word-compatible version so we can't cut and paste the content into the .docx standard file. I proposed that we would include the full PDF (sample attached) as an appendix and reference it in the Data Dictionary. This would need approval from the TC Admin for the format.    2. There may be come formatting issues. If you look at the attached PDF, there are a few images that go beyond the page (e.g. see page 8). We can make a fully browse-able website version available too though - it doesn't have that problem.    Here is a screenshot comparing a draft (ignore the highlights on the left side please) with the normal table and the generated XML Schema documentation on the right. I believe all of the fields and information that we need is there and it includes a pretty good diagram.   <image003.png>   We'll have the ERM diagram as well (thanks to Patti!) and the rest is coming along well.   Thanks a ton for the great meeting. I'll send out the draft minutes in a moment.   cheers,   Darrell     --   Darrell O'Donnell, P.Eng. OASIS Member (volunteer) - www.oasis-open.org   OASIS EM-TC - Member OASIS EM-TC HAVE SC - Co-Chair   darrell.odonnell@continuumloop.com <image002.png>         -- /chet    [§]  ---------------- Chet Ensign Director of Standards Development and TC Administration  OASIS: Advancing open standards for the information society http://www.oasis-open.org Primary: +1 973-996-2298 Mobile: +1 201-341-1393     Check your work using the Support Request Submission Checklist at  http://www.oasis-open.org/committees/download.php/47248/tc-admin-submission-checklist.html   TC Administration information and support is available at http://www.oasis-open.org/resources/tcadmin Follow OASIS on: LinkedIn:     http://linkd.in/OASISopen Twitter:         http://twitter.com/OASISopen Facebook:   http://facebook.com/oasis.open -- /chet    [§]  ---------------- Chet Ensign Director of Standards Development and TC Administration  OASIS: Advancing open standards for the information society http://www.oasis-open.org Primary: +1 973-996-2298 Mobile: +1 201-341-1393  Check your work using the Support Request Submission Checklist at  http://www.oasis-open.org/committees/download.php/47248/tc-admin-submission-checklist.html   TC Administration information and support is available at http://www.oasis-open.org/resources/tcadmin Follow OASIS on: LinkedIn:     http://linkd.in/OASISopen Twitter:         http://twitter.com/OASISopen Facebook:   http://facebook.com/oasis.open


  • 8.  Re: [emergency-have] HAVE 2.0 - Data Dictionary

    Posted 10-24-2014 13:35
    Ah, ok. Thanks! Got it.  Here is what I am thinking: we handle the linked data dictionary files the same way we would handle any other computer files - by treating them as an additional artifact of the overall work product.  What that means is that you produce a working draft from a template the usual way and you draft it up as an introductory document to the data model. That can be published just like normal - editable source/HTML/PDF. Then we include the data dictionary files as a subtree under that top level folder. In other words:  - the documents go in  http://docs.oasis-open.org/emergency/edxl-have/v2.0/csd01/   - the data dictionary files go in  http://docs.oasis-open.org/emergency/edxl-have/v2.0/csd01/data-dictionary/ I will look more closely at the files themselves and ask about what tweaks we might do to the appearance but with the above in place, the need to closely hew to the look and feel of the published documents is largely eliminated. Robin checked the filenames briefly and everything looks ok there.  One thing that jumps to mind though: if this is going to be an interlinked sub-tree of files, once we load it to docs.oasis-open.org , will you be able to set it up so that the links work?  /chet On Thu, Oct 23, 2014 at 6:06 PM, Elysa Jones < elysajones@yahoo.com > wrote: That is right. A new work wrt naming.  It is a 2.0 version though if that matters at this point.  We will be requesting the templates, etc and should pol rivalry do that now.  Thanks Elysa Jones iPhone  On Oct 23, 2014, at 4:56 PM, Chet Ensign < chet.ensign@oasis-open.org > wrote: Sorry, I should have been more clear. It appears to me that the current EDXL-HAVE published content is in  http://docs.oasis-open.org/emergency/edxl-have/v1.0/emergency_edxl_have-1.0.html . That is an OASIS Standard with Approved Errata.  So I assume that this would be a new Committee Specification Draft that would supersede this one?  On Thu, Oct 23, 2014 at 5:35 PM, Elysa Jones < elysajones@yahoo.com > wrote: Chet,   This is not at all a new work.  This evolved from a 1.0 that was used in Haiti after the earthquake.  Lessons learned and other inputs were gathered into a working draft of 2.0 that has been in development for over a year.  The working draft, aka WD09 has been used in experiments and field trials.  We are anxious to get this in hands of implementers because it is so much improved over the 1.0.  We are not asking to bypass any process as we will have a fully developed draft ready for EM-TC review and vote in the next few weeks.    The question asked of you here is whether we are ok to use this method of generating the data dictionary for both expediency and correctness.  It does not fit the normal OASIS template we use and need your guidance in that regard.   Thanks,   Elysa Jones, Chair OASIS Emergency Management Technical Committee Emergency Interoperability Member Section       From: emergency-have@lists.oasis-open.org [mailto: emergency-have@lists.oasis-open.org ] On Behalf Of Chet Ensign Sent: Thursday, October 23, 2014 3:50 PM To: Darrell O'Donnell Cc: Elysa Jones; HAVE SC Subject: Re: [emergency-have] HAVE 2.0 - Data Dictionary   Elysa, Darrell, let me just be sure I understand your objective here.    The potential social / healthcare benefit is not lost on me so you have no selling to do on that score. I read "The Hot Zone" years ago. Ebola is ample justification for swift action.    If I understand what you want to do, your goal is to approve and publish a Committee Spec Draft of the EDXL-HAVE Data Dictionary as fast as possible so that people have a public version of this refined spec to apply to the Ebola outbreak.    - Is this a brand new work product? Looking at  http://docs.oasis-open.org/emergency/edxl-have/ I don't find anything comparable so I am guessing it is.    - Do you simply want to get it online as an approved CSD of some kind (details we need to work out) or do you also want to move it forward into public review?    Thanks for your answers. I'm just trying to sort out in my mind how we can best accomplish this.    Best,    /chet     On Thu, Oct 23, 2014 at 7:35 AM, Darrell O'Donnell < darrell.odonnell@continuumloop.com > wrote: Chet - as a consideration we can also generate a detailed and interactive HTML version of the schema. Here is an example that I generated from our working draft:  http://oasis-edxl-have-v2.0-wd.s3.amazonaws.com/edxl-have-v2.0-wd.html   cheers,   Darrell     --   Darrell O'Donnell, P.Eng. OASIS Member (volunteer) - www.oasis-open.org   OASIS EM-TC - Member OASIS EM-TC HAVE SC - Co-Chair   darrell.odonnell@continuumloop.com <image002.png>       On Thu, Oct 23, 2014 at 7:34 AM, Elysa Jones < elysajones@yahoo.com > wrote: Chet,   Please review this process for an auto-generated data dictionary.  We are working diligently to get a PR draft out for HAVE given the interest due to the Ebola situation.  This method would save us time as well as minimize/eliminate the common mistakes made when it is done manually.    Thanks,   Elysa Jones, Chair OASIS Emergency Management Technical Committee Emergency Interoperability Member Section   Elysa     From: emergency-have@lists.oasis-open.org [mailto: emergency-have@lists.oasis-open.org ] On Behalf Of Darrell O'Donnell Sent: Wednesday, October 22, 2014 6:00 AM To: HAVE SC Cc: Chet Ensign Subject: [emergency-have] HAVE 2.0 - Data Dictionary   Folks - as we discussed in the EDXL-HAVE SC meeting this afternoon we would like to use a different format for the Data Dictionary section of the standards document.   I have CC'ed Chet Ensign from the TC Admin as per Elysa's recommendation.    The approach that I recommend and that we agreed upon was to use an auto-generated document that is driven from the data in our XML Schema. This would mean that there should be no errors (barring a software glitch in OxygenXML) but there are a couple of issues to consider:   1. I can't generate a Word-compatible version so we can't cut and paste the content into the .docx standard file. I proposed that we would include the full PDF (sample attached) as an appendix and reference it in the Data Dictionary. This would need approval from the TC Admin for the format.    2. There may be come formatting issues. If you look at the attached PDF, there are a few images that go beyond the page (e.g. see page 8). We can make a fully browse-able website version available too though - it doesn't have that problem.    Here is a screenshot comparing a draft (ignore the highlights on the left side please) with the normal table and the generated XML Schema documentation on the right. I believe all of the fields and information that we need is there and it includes a pretty good diagram.   <image003.png>   We'll have the ERM diagram as well (thanks to Patti!) and the rest is coming along well.   Thanks a ton for the great meeting. I'll send out the draft minutes in a moment.   cheers,   Darrell     --   Darrell O'Donnell, P.Eng. OASIS Member (volunteer) - www.oasis-open.org   OASIS EM-TC - Member OASIS EM-TC HAVE SC - Co-Chair   darrell.odonnell@continuumloop.com <image002.png>         -- /chet    [§]  ---------------- Chet Ensign Director of Standards Development and TC Administration  OASIS: Advancing open standards for the information society http://www.oasis-open.org Primary: +1 973-996-2298 Mobile: +1 201-341-1393     Check your work using the Support Request Submission Checklist at  http://www.oasis-open.org/committees/download.php/47248/tc-admin-submission-checklist.html   TC Administration information and support is available at http://www.oasis-open.org/resources/tcadmin Follow OASIS on: LinkedIn:     http://linkd.in/OASISopen Twitter:         http://twitter.com/OASISopen Facebook:   http://facebook.com/oasis.open -- /chet    [§]  ---------------- Chet Ensign Director of Standards Development and TC Administration  OASIS: Advancing open standards for the information society http://www.oasis-open.org Primary: +1 973-996-2298 Mobile: +1 201-341-1393   Check your work using the Support Request Submission Checklist at  http://www.oasis-open.org/committees/download.php/47248/tc-admin-submission-checklist.html   TC Administration information and support is available at http://www.oasis-open.org/resources/tcadmin Follow OASIS on: LinkedIn:     http://linkd.in/OASISopen Twitter:         http://twitter.com/OASISopen Facebook:   http://facebook.com/oasis.open -- /chet    [§]  ---------------- Chet Ensign Director of Standards Development and TC Administration  OASIS: Advancing open standards for the information society http://www.oasis-open.org Primary: +1 973-996-2298 Mobile: +1 201-341-1393  Check your work using the Support Request Submission Checklist at  http://www.oasis-open.org/committees/download.php/47248/tc-admin-submission-checklist.html   TC Administration information and support is available at http://www.oasis-open.org/resources/tcadmin Follow OASIS on: LinkedIn:     http://linkd.in/OASISopen Twitter:         http://twitter.com/OASISopen Facebook:   http://facebook.com/oasis.open


  • 9.  Re: [emergency-have] HAVE 2.0 - Data Dictionary

    Posted 10-24-2014 13:40
      |   view attached
    Chet - Thanks for this note. The links are all relative so they should work just fine.  cheers, Darrell -- Darrell O'Donnell, P.Eng. OASIS Member (volunteer) - www.oasis-open.org   OASIS EM-TC - Member OASIS EM-TC HAVE SC - Co-Chair darrell.odonnell@continuumloop.com On Fri, Oct 24, 2014 at 9:35 AM, Chet Ensign < chet.ensign@oasis-open.org > wrote: Ah, ok. Thanks! Got it.  Here is what I am thinking: we handle the linked data dictionary files the same way we would handle any other computer files - by treating them as an additional artifact of the overall work product.  What that means is that you produce a working draft from a template the usual way and you draft it up as an introductory document to the data model. That can be published just like normal - editable source/HTML/PDF. Then we include the data dictionary files as a subtree under that top level folder. In other words:  - the documents go in  http://docs.oasis-open.org/emergency/edxl-have/v2.0/csd01/   - the data dictionary files go in  http://docs.oasis-open.org/emergency/edxl-have/v2.0/csd01/data-dictionary/ I will look more closely at the files themselves and ask about what tweaks we might do to the appearance but with the above in place, the need to closely hew to the look and feel of the published documents is largely eliminated. Robin checked the filenames briefly and everything looks ok there.  One thing that jumps to mind though: if this is going to be an interlinked sub-tree of files, once we load it to docs.oasis-open.org , will you be able to set it up so that the links work?  /chet On Thu, Oct 23, 2014 at 6:06 PM, Elysa Jones < elysajones@yahoo.com > wrote: That is right. A new work wrt naming.  It is a 2.0 version though if that matters at this point.  We will be requesting the templates, etc and should pol rivalry do that now.  Thanks Elysa Jones iPhone  On Oct 23, 2014, at 4:56 PM, Chet Ensign < chet.ensign@oasis-open.org > wrote: Sorry, I should have been more clear. It appears to me that the current EDXL-HAVE published content is in  http://docs.oasis-open.org/emergency/edxl-have/v1.0/emergency_edxl_have-1.0.html . That is an OASIS Standard with Approved Errata.  So I assume that this would be a new Committee Specification Draft that would supersede this one?  On Thu, Oct 23, 2014 at 5:35 PM, Elysa Jones < elysajones@yahoo.com > wrote: Chet,   This is not at all a new work.  This evolved from a 1.0 that was used in Haiti after the earthquake.  Lessons learned and other inputs were gathered into a working draft of 2.0 that has been in development for over a year.  The working draft, aka WD09 has been used in experiments and field trials.  We are anxious to get this in hands of implementers because it is so much improved over the 1.0.  We are not asking to bypass any process as we will have a fully developed draft ready for EM-TC review and vote in the next few weeks.    The question asked of you here is whether we are ok to use this method of generating the data dictionary for both expediency and correctness.  It does not fit the normal OASIS template we use and need your guidance in that regard.   Thanks,   Elysa Jones, Chair OASIS Emergency Management Technical Committee Emergency Interoperability Member Section       From: emergency-have@lists.oasis-open.org [mailto: emergency-have@lists.oasis-open.org ] On Behalf Of Chet Ensign Sent: Thursday, October 23, 2014 3:50 PM To: Darrell O'Donnell Cc: Elysa Jones; HAVE SC Subject: Re: [emergency-have] HAVE 2.0 - Data Dictionary   Elysa, Darrell, let me just be sure I understand your objective here.    The potential social / healthcare benefit is not lost on me so you have no selling to do on that score. I read "The Hot Zone" years ago. Ebola is ample justification for swift action.    If I understand what you want to do, your goal is to approve and publish a Committee Spec Draft of the EDXL-HAVE Data Dictionary as fast as possible so that people have a public version of this refined spec to apply to the Ebola outbreak.    - Is this a brand new work product? Looking at  http://docs.oasis-open.org/emergency/edxl-have/ I don't find anything comparable so I am guessing it is.    - Do you simply want to get it online as an approved CSD of some kind (details we need to work out) or do you also want to move it forward into public review?    Thanks for your answers. I'm just trying to sort out in my mind how we can best accomplish this.    Best,    /chet     On Thu, Oct 23, 2014 at 7:35 AM, Darrell O'Donnell < darrell.odonnell@continuumloop.com > wrote: Chet - as a consideration we can also generate a detailed and interactive HTML version of the schema. Here is an example that I generated from our working draft:  http://oasis-edxl-have-v2.0-wd.s3.amazonaws.com/edxl-have-v2.0-wd.html   cheers,   Darrell     --   Darrell O'Donnell, P.Eng. OASIS Member (volunteer) - www.oasis-open.org   OASIS EM-TC - Member OASIS EM-TC HAVE SC - Co-Chair   darrell.odonnell@continuumloop.com <image002.png>       On Thu, Oct 23, 2014 at 7:34 AM, Elysa Jones < elysajones@yahoo.com > wrote: Chet,   Please review this process for an auto-generated data dictionary.  We are working diligently to get a PR draft out for HAVE given the interest due to the Ebola situation.  This method would save us time as well as minimize/eliminate the common mistakes made when it is done manually.    Thanks,   Elysa Jones, Chair OASIS Emergency Management Technical Committee Emergency Interoperability Member Section   Elysa     From: emergency-have@lists.oasis-open.org [mailto: emergency-have@lists.oasis-open.org ] On Behalf Of Darrell O'Donnell Sent: Wednesday, October 22, 2014 6:00 AM To: HAVE SC Cc: Chet Ensign Subject: [emergency-have] HAVE 2.0 - Data Dictionary   Folks - as we discussed in the EDXL-HAVE SC meeting this afternoon we would like to use a different format for the Data Dictionary section of the standards document.   I have CC'ed Chet Ensign from the TC Admin as per Elysa's recommendation.    The approach that I recommend and that we agreed upon was to use an auto-generated document that is driven from the data in our XML Schema. This would mean that there should be no errors (barring a software glitch in OxygenXML) but there are a couple of issues to consider:   1. I can't generate a Word-compatible version so we can't cut and paste the content into the .docx standard file. I proposed that we would include the full PDF (sample attached) as an appendix and reference it in the Data Dictionary. This would need approval from the TC Admin for the format.    2. There may be come formatting issues. If you look at the attached PDF, there are a few images that go beyond the page (e.g. see page 8). We can make a fully browse-able website version available too though - it doesn't have that problem.    Here is a screenshot comparing a draft (ignore the highlights on the left side please) with the normal table and the generated XML Schema documentation on the right. I believe all of the fields and information that we need is there and it includes a pretty good diagram.   <image003.png>   We'll have the ERM diagram as well (thanks to Patti!) and the rest is coming along well.   Thanks a ton for the great meeting. I'll send out the draft minutes in a moment.   cheers,   Darrell     --   Darrell O'Donnell, P.Eng. OASIS Member (volunteer) - www.oasis-open.org   OASIS EM-TC - Member OASIS EM-TC HAVE SC - Co-Chair   darrell.odonnell@continuumloop.com <image002.png>         -- /chet    [§]  ---------------- Chet Ensign Director of Standards Development and TC Administration  OASIS: Advancing open standards for the information society http://www.oasis-open.org Primary: +1 973-996-2298 Mobile: +1 201-341-1393     Check your work using the Support Request Submission Checklist at  http://www.oasis-open.org/committees/download.php/47248/tc-admin-submission-checklist.html   TC Administration information and support is available at http://www.oasis-open.org/resources/tcadmin Follow OASIS on: LinkedIn:     http://linkd.in/OASISopen Twitter:         http://twitter.com/OASISopen Facebook:   http://facebook.com/oasis.open -- /chet    [§]  ---------------- Chet Ensign Director of Standards Development and TC Administration  OASIS: Advancing open standards for the information society http://www.oasis-open.org Primary: +1 973-996-2298 Mobile: +1 201-341-1393   Check your work using the Support Request Submission Checklist at  http://www.oasis-open.org/committees/download.php/47248/tc-admin-submission-checklist.html   TC Administration information and support is available at http://www.oasis-open.org/resources/tcadmin Follow OASIS on: LinkedIn:     http://linkd.in/OASISopen Twitter:         http://twitter.com/OASISopen Facebook:   http://facebook.com/oasis.open -- /chet    [§]  ---------------- Chet Ensign Director of Standards Development and TC Administration  OASIS: Advancing open standards for the information society http://www.oasis-open.org Primary: +1 973-996-2298 Mobile: +1 201-341-1393   Check your work using the Support Request Submission Checklist at  http://www.oasis-open.org/committees/download.php/47248/tc-admin-submission-checklist.html   TC Administration information and support is available at http://www.oasis-open.org/resources/tcadmin Follow OASIS on: LinkedIn:     http://linkd.in/OASISopen Twitter:         http://twitter.com/OASISopen Facebook:   http://facebook.com/oasis.open


  • 10.  Re: [emergency-have] HAVE 2.0 - Data Dictionary

    Posted 10-24-2014 13:45
      |   view attached
    Great!  On Fri, Oct 24, 2014 at 9:40 AM, Darrell O'Donnell < darrell.odonnell@continuumloop.com > wrote: Chet - Thanks for this note. The links are all relative so they should work just fine.  cheers, Darrell -- Darrell O'Donnell, P.Eng. OASIS Member (volunteer) - www.oasis-open.org   OASIS EM-TC - Member OASIS EM-TC HAVE SC - Co-Chair darrell.odonnell@continuumloop.com On Fri, Oct 24, 2014 at 9:35 AM, Chet Ensign < chet.ensign@oasis-open.org > wrote: Ah, ok. Thanks! Got it.  Here is what I am thinking: we handle the linked data dictionary files the same way we would handle any other computer files - by treating them as an additional artifact of the overall work product.  What that means is that you produce a working draft from a template the usual way and you draft it up as an introductory document to the data model. That can be published just like normal - editable source/HTML/PDF. Then we include the data dictionary files as a subtree under that top level folder. In other words:  - the documents go in  http://docs.oasis-open.org/emergency/edxl-have/v2.0/csd01/   - the data dictionary files go in  http://docs.oasis-open.org/emergency/edxl-have/v2.0/csd01/data-dictionary/ I will look more closely at the files themselves and ask about what tweaks we might do to the appearance but with the above in place, the need to closely hew to the look and feel of the published documents is largely eliminated. Robin checked the filenames briefly and everything looks ok there.  One thing that jumps to mind though: if this is going to be an interlinked sub-tree of files, once we load it to docs.oasis-open.org , will you be able to set it up so that the links work?  /chet On Thu, Oct 23, 2014 at 6:06 PM, Elysa Jones < elysajones@yahoo.com > wrote: That is right. A new work wrt naming.  It is a 2.0 version though if that matters at this point.  We will be requesting the templates, etc and should pol rivalry do that now.  Thanks Elysa Jones iPhone  On Oct 23, 2014, at 4:56 PM, Chet Ensign < chet.ensign@oasis-open.org > wrote: Sorry, I should have been more clear. It appears to me that the current EDXL-HAVE published content is in  http://docs.oasis-open.org/emergency/edxl-have/v1.0/emergency_edxl_have-1.0.html . That is an OASIS Standard with Approved Errata.  So I assume that this would be a new Committee Specification Draft that would supersede this one?  On Thu, Oct 23, 2014 at 5:35 PM, Elysa Jones < elysajones@yahoo.com > wrote: Chet,   This is not at all a new work.  This evolved from a 1.0 that was used in Haiti after the earthquake.  Lessons learned and other inputs were gathered into a working draft of 2.0 that has been in development for over a year.  The working draft, aka WD09 has been used in experiments and field trials.  We are anxious to get this in hands of implementers because it is so much improved over the 1.0.  We are not asking to bypass any process as we will have a fully developed draft ready for EM-TC review and vote in the next few weeks.    The question asked of you here is whether we are ok to use this method of generating the data dictionary for both expediency and correctness.  It does not fit the normal OASIS template we use and need your guidance in that regard.   Thanks,   Elysa Jones, Chair OASIS Emergency Management Technical Committee Emergency Interoperability Member Section       From: emergency-have@lists.oasis-open.org [mailto: emergency-have@lists.oasis-open.org ] On Behalf Of Chet Ensign Sent: Thursday, October 23, 2014 3:50 PM To: Darrell O'Donnell Cc: Elysa Jones; HAVE SC Subject: Re: [emergency-have] HAVE 2.0 - Data Dictionary   Elysa, Darrell, let me just be sure I understand your objective here.    The potential social / healthcare benefit is not lost on me so you have no selling to do on that score. I read "The Hot Zone" years ago. Ebola is ample justification for swift action.    If I understand what you want to do, your goal is to approve and publish a Committee Spec Draft of the EDXL-HAVE Data Dictionary as fast as possible so that people have a public version of this refined spec to apply to the Ebola outbreak.    - Is this a brand new work product? Looking at  http://docs.oasis-open.org/emergency/edxl-have/ I don't find anything comparable so I am guessing it is.    - Do you simply want to get it online as an approved CSD of some kind (details we need to work out) or do you also want to move it forward into public review?    Thanks for your answers. I'm just trying to sort out in my mind how we can best accomplish this.    Best,    /chet     On Thu, Oct 23, 2014 at 7:35 AM, Darrell O'Donnell < darrell.odonnell@continuumloop.com > wrote: Chet - as a consideration we can also generate a detailed and interactive HTML version of the schema. Here is an example that I generated from our working draft:  http://oasis-edxl-have-v2.0-wd.s3.amazonaws.com/edxl-have-v2.0-wd.html   cheers,   Darrell     --   Darrell O'Donnell, P.Eng. OASIS Member (volunteer) - www.oasis-open.org   OASIS EM-TC - Member OASIS EM-TC HAVE SC - Co-Chair   darrell.odonnell@continuumloop.com <image002.png>       On Thu, Oct 23, 2014 at 7:34 AM, Elysa Jones < elysajones@yahoo.com > wrote: Chet,   Please review this process for an auto-generated data dictionary.  We are working diligently to get a PR draft out for HAVE given the interest due to the Ebola situation.  This method would save us time as well as minimize/eliminate the common mistakes made when it is done manually.    Thanks,   Elysa Jones, Chair OASIS Emergency Management Technical Committee Emergency Interoperability Member Section   Elysa     From: emergency-have@lists.oasis-open.org [mailto: emergency-have@lists.oasis-open.org ] On Behalf Of Darrell O'Donnell Sent: Wednesday, October 22, 2014 6:00 AM To: HAVE SC Cc: Chet Ensign Subject: [emergency-have] HAVE 2.0 - Data Dictionary   Folks - as we discussed in the EDXL-HAVE SC meeting this afternoon we would like to use a different format for the Data Dictionary section of the standards document.   I have CC'ed Chet Ensign from the TC Admin as per Elysa's recommendation.    The approach that I recommend and that we agreed upon was to use an auto-generated document that is driven from the data in our XML Schema. This would mean that there should be no errors (barring a software glitch in OxygenXML) but there are a couple of issues to consider:   1. I can't generate a Word-compatible version so we can't cut and paste the content into the .docx standard file. I proposed that we would include the full PDF (sample attached) as an appendix and reference it in the Data Dictionary. This would need approval from the TC Admin for the format.    2. There may be come formatting issues. If you look at the attached PDF, there are a few images that go beyond the page (e.g. see page 8). We can make a fully browse-able website version available too though - it doesn't have that problem.    Here is a screenshot comparing a draft (ignore the highlights on the left side please) with the normal table and the generated XML Schema documentation on the right. I believe all of the fields and information that we need is there and it includes a pretty good diagram.   <image003.png>   We'll have the ERM diagram as well (thanks to Patti!) and the rest is coming along well.   Thanks a ton for the great meeting. I'll send out the draft minutes in a moment.   cheers,   Darrell     --   Darrell O'Donnell, P.Eng. OASIS Member (volunteer) - www.oasis-open.org   OASIS EM-TC - Member OASIS EM-TC HAVE SC - Co-Chair   darrell.odonnell@continuumloop.com <image002.png>         -- /chet    [§]  ---------------- Chet Ensign Director of Standards Development and TC Administration  OASIS: Advancing open standards for the information society http://www.oasis-open.org Primary: +1 973-996-2298 Mobile: +1 201-341-1393     Check your work using the Support Request Submission Checklist at  http://www.oasis-open.org/committees/download.php/47248/tc-admin-submission-checklist.html   TC Administration information and support is available at http://www.oasis-open.org/resources/tcadmin Follow OASIS on: LinkedIn:     http://linkd.in/OASISopen Twitter:         http://twitter.com/OASISopen Facebook:   http://facebook.com/oasis.open -- /chet    [§]  ---------------- Chet Ensign Director of Standards Development and TC Administration  OASIS: Advancing open standards for the information society http://www.oasis-open.org Primary: +1 973-996-2298 Mobile: +1 201-341-1393   Check your work using the Support Request Submission Checklist at  http://www.oasis-open.org/committees/download.php/47248/tc-admin-submission-checklist.html   TC Administration information and support is available at http://www.oasis-open.org/resources/tcadmin Follow OASIS on: LinkedIn:     http://linkd.in/OASISopen Twitter:         http://twitter.com/OASISopen Facebook:   http://facebook.com/oasis.open -- /chet    [§]  ---------------- Chet Ensign Director of Standards Development and TC Administration  OASIS: Advancing open standards for the information society http://www.oasis-open.org Primary: +1 973-996-2298 Mobile: +1 201-341-1393   Check your work using the Support Request Submission Checklist at  http://www.oasis-open.org/committees/download.php/47248/tc-admin-submission-checklist.html   TC Administration information and support is available at http://www.oasis-open.org/resources/tcadmin Follow OASIS on: LinkedIn:     http://linkd.in/OASISopen Twitter:         http://twitter.com/OASISopen Facebook:   http://facebook.com/oasis.open -- /chet    [§]  ---------------- Chet Ensign Director of Standards Development and TC Administration  OASIS: Advancing open standards for the information society http://www.oasis-open.org Primary: +1 973-996-2298 Mobile: +1 201-341-1393  Check your work using the Support Request Submission Checklist at  http://www.oasis-open.org/committees/download.php/47248/tc-admin-submission-checklist.html   TC Administration information and support is available at http://www.oasis-open.org/resources/tcadmin Follow OASIS on: LinkedIn:     http://linkd.in/OASISopen Twitter:         http://twitter.com/OASISopen Facebook:   http://facebook.com/oasis.open


  • 11.  RE: [emergency-have] HAVE 2.0 - Data Dictionary

    Posted 10-24-2014 12:00
    Chet, Yes, we are currently working on “Emergency Data Exchange Language (EDXL) Hospital AVailability Exchange (HAVE) Version 2.0 Working Draft 02” – toward a committee draft.  The only question on the table to you is:  Can we use the schema to automatically generate the data dictionary?  The output is in a little different format than past standards (better in my opinion for many reasons).  So is that OK?  Darrell sent you a comparison between the past manual “table style” data dictionary vs. how this new output would display.   You saw my points iterating the reasons/benefits.  This is just a data dictionary format question. Thanks ,     Tim __________________________________________________________   From: emergency-have@lists.oasis-open.org [mailto:emergency-have@lists.oasis-open.org] On Behalf Of Chet Ensign Sent: Thursday, October 23, 2014 5:56 PM To: Elysa Jones Cc: Darrell O'Donnell; HAVE SC Subject: Re: [emergency-have] HAVE 2.0 - Data Dictionary   Sorry, I should have been more clear. It appears to me that the current EDXL-HAVE published content is in  http://docs.oasis-open.org/emergency/edxl-have/v1.0/emergency_edxl_have-1.0.html . That is an OASIS Standard with Approved Errata.    So I assume that this would be a new Committee Specification Draft that would supersede this one?    On Thu, Oct 23, 2014 at 5:35 PM, Elysa Jones < elysajones@yahoo.com > wrote: Chet,   This is not at all a new work.  This evolved from a 1.0 that was used in Haiti after the earthquake.  Lessons learned and other inputs were gathered into a working draft of 2.0 that has been in development for over a year.  The working draft, aka WD09 has been used in experiments and field trials.  We are anxious to get this in hands of implementers because it is so much improved over the 1.0.  We are not asking to bypass any process as we will have a fully developed draft ready for EM-TC review and vote in the next few weeks.    The question asked of you here is whether we are ok to use this method of generating the data dictionary for both expediency and correctness.  It does not fit the normal OASIS template we use and need your guidance in that regard.   Thanks,   Elysa Jones, Chair OASIS Emergency Management Technical Committee Emergency Interoperability Member Section       From: emergency-have@lists.oasis-open.org [mailto: emergency-have@lists.oasis-open.org ] On Behalf Of Chet Ensign Sent: Thursday, October 23, 2014 3:50 PM To: Darrell O'Donnell Cc: Elysa Jones; HAVE SC Subject: Re: [emergency-have] HAVE 2.0 - Data Dictionary   Elysa, Darrell, let me just be sure I understand your objective here.    The potential social / healthcare benefit is not lost on me so you have no selling to do on that score. I read "The Hot Zone" years ago. Ebola is ample justification for swift action.    If I understand what you want to do, your goal is to approve and publish a Committee Spec Draft of the EDXL-HAVE Data Dictionary as fast as possible so that people have a public version of this refined spec to apply to the Ebola outbreak.    - Is this a brand new work product? Looking at  http://docs.oasis-open.org/emergency/edxl-have/ I don't find anything comparable so I am guessing it is.    - Do you simply want to get it online as an approved CSD of some kind (details we need to work out) or do you also want to move it forward into public review?    Thanks for your answers. I'm just trying to sort out in my mind how we can best accomplish this.    Best,    /chet     On Thu, Oct 23, 2014 at 7:35 AM, Darrell O'Donnell < darrell.odonnell@continuumloop.com > wrote: Chet - as a consideration we can also generate a detailed and interactive HTML version of the schema. Here is an example that I generated from our working draft:  http://oasis-edxl-have-v2.0-wd.s3.amazonaws.com/edxl-have-v2.0-wd.html   cheers,   Darrell     --   Darrell O'Donnell, P.Eng. OASIS Member (volunteer) - www.oasis-open.org   OASIS EM-TC - Member OASIS EM-TC HAVE SC - Co-Chair   darrell.odonnell@continuumloop.com       On Thu, Oct 23, 2014 at 7:34 AM, Elysa Jones < elysajones@yahoo.com > wrote: Chet,   Please review this process for an auto-generated data dictionary.  We are working diligently to get a PR draft out for HAVE given the interest due to the Ebola situation.  This method would save us time as well as minimize/eliminate the common mistakes made when it is done manually.    Thanks,   Elysa Jones, Chair OASIS Emergency Management Technical Committee Emergency Interoperability Member Section   Elysa     From: emergency-have@lists.oasis-open.org [mailto: emergency-have@lists.oasis-open.org ] On Behalf Of Darrell O'Donnell Sent: Wednesday, October 22, 2014 6:00 AM To: HAVE SC Cc: Chet Ensign Subject: [emergency-have] HAVE 2.0 - Data Dictionary   Folks - as we discussed in the EDXL-HAVE SC meeting this afternoon we would like to use a different format for the Data Dictionary section of the standards document.   I have CC'ed Chet Ensign from the TC Admin as per Elysa's recommendation.    The approach that I recommend and that we agreed upon was to use an auto-generated document that is driven from the data in our XML Schema. This would mean that there should be no errors (barring a software glitch in OxygenXML) but there are a couple of issues to consider:   1. I can't generate a Word-compatible version so we can't cut and paste the content into the .docx standard file. I proposed that we would include the full PDF (sample attached) as an appendix and reference it in the Data Dictionary. This would need approval from the TC Admin for the format.    2. There may be come formatting issues. If you look at the attached PDF, there are a few images that go beyond the page (e.g. see page 8). We can make a fully browse-able website version available too though - it doesn't have that problem.    Here is a screenshot comparing a draft (ignore the highlights on the left side please) with the normal table and the generated XML Schema documentation on the right. I believe all of the fields and information that we need is there and it includes a pretty good diagram.     We'll have the ERM diagram as well (thanks to Patti!) and the rest is coming along well.   Thanks a ton for the great meeting. I'll send out the draft minutes in a moment.   cheers,   Darrell     --   Darrell O'Donnell, P.Eng. OASIS Member (volunteer) - www.oasis-open.org   OASIS EM-TC - Member OASIS EM-TC HAVE SC - Co-Chair   darrell.odonnell@continuumloop.com         -- /chet    [§]  ---------------- Chet Ensign Director of Standards Development and TC Administration  OASIS: Advancing open standards for the information society http://www.oasis-open.org Primary: +1 973-996-2298 Mobile: +1 201-341-1393     Check your work using the Support Request Submission Checklist at  http://www.oasis-open.org/committees/download.php/47248/tc-admin-submission-checklist.html   TC Administration information and support is available at http://www.oasis-open.org/resources/tcadmin Follow OASIS on: LinkedIn:     http://linkd.in/OASISopen Twitter:         http://twitter.com/OASISopen Facebook:   http://facebook.com/oasis.open   -- /chet    [§]  ---------------- Chet Ensign Director of Standards Development and TC Administration  OASIS: Advancing open standards for the information society http://www.oasis-open.org Primary: +1 973-996-2298 Mobile: +1 201-341-1393    Check your work using the Support Request Submission Checklist at  http://www.oasis-open.org/committees/download.php/47248/tc-admin-submission-checklist.html   TC Administration information and support is available at http://www.oasis-open.org/resources/tcadmin Follow OASIS on: LinkedIn:     http://linkd.in/OASISopen Twitter:         http://twitter.com/OASISopen Facebook:   http://facebook.com/oasis.open