Your SlideShare is downloading. ×
PowerPoint Presentation Title
PowerPoint Presentation Title
PowerPoint Presentation Title
PowerPoint Presentation Title
PowerPoint Presentation Title
PowerPoint Presentation Title
PowerPoint Presentation Title
PowerPoint Presentation Title
PowerPoint Presentation Title
PowerPoint Presentation Title
PowerPoint Presentation Title
PowerPoint Presentation Title
PowerPoint Presentation Title
PowerPoint Presentation Title
PowerPoint Presentation Title
PowerPoint Presentation Title
PowerPoint Presentation Title
PowerPoint Presentation Title
PowerPoint Presentation Title
PowerPoint Presentation Title
PowerPoint Presentation Title
PowerPoint Presentation Title
PowerPoint Presentation Title
PowerPoint Presentation Title
PowerPoint Presentation Title
PowerPoint Presentation Title
PowerPoint Presentation Title
PowerPoint Presentation Title
Upcoming SlideShare
Loading in...5
×

Thanks for flagging this SlideShare!

Oops! An error has occurred.

×
Saving this for later? Get the SlideShare app to save on your phone or tablet. Read anywhere, anytime – even offline.
Text the download link to your phone
Standard text messaging rates apply

PowerPoint Presentation Title

528

Published on

0 Comments
0 Likes
Statistics
Notes
  • Be the first to comment

  • Be the first to like this

No Downloads
Views
Total Views
528
On Slideshare
0
From Embeds
0
Number of Embeds
0
Actions
Shares
0
Downloads
1
Comments
0
Likes
0
Embeds 0
No embeds

Report content
Flagged as inappropriate Flag as inappropriate
Flag as inappropriate

Select your reason for flagging this presentation as inappropriate.

Cancel
No notes for slide

Transcript

  • 1. Drybridge Investigator Comprehensive Schema Comparison Simplifying implementation of schema improvements through business and technical difference analysis Drybridge Consulting Last update: September 4, 2008 Table of Contents Introduction: What is the Drybridge Schema Investigator? ......................................................... 1 Introduction: How can I use the Drybridge Schema Investigator ................................................ 2 Introduction: Workbook Layout....................................................................................................... 3 Introduction: Analysis Options........................................................................................................ 4 Case Study 1: Root Element, Single Schema, Business Analysis ................................................ 6 Case Study 1: Root Element Analysis Worksheet........................................................................... 7 Case Study 1: Supporting Items Worksheet .................................................................................... 9 Case Study 1: Enumerations Worksheet........................................................................................ 10 Case Study 2: Schema Item, Single Schema, Business Analysis ............................................... 11 Case Study 2: Schema Items Analysis Worksheet........................................................................ 13 Case Study 2: Enumerations Worksheet........................................................................................ 13 Case Study 3: Schema Item, Schema Folder, Business Analysis ............................................... 16 Case Study 4: Schema Item, Single Schema, Technical Analysis............................................... 18 Case Study 5: Schema Item, Schema Folder, Technical Analysis .............................................. 21 Appendix: About Drybridge Technologies............................................................................... 24 Appendix: (Frequently Asked) Questions................................................................................ 26 Drybridge Consulting Arthur Colman, President 4 Drybridge Road Medway, MA 02053 USA colman@drybridge.com www.drybridge.com Phone: 617.803.2546
  • 2. DRYBRIDGE INVESTIGATOR – COMPREHENSIVE SCHEMA COMPARISON Introduction: What is the Drybridge Schema Investigator? Introduction What is the Drybridge Schema Investigator? The Drybridge Investigator analyzes and compares two schema and reports on the differences – Spreadsheet output enables the analysis to be used as a work document – Microsoft Excel 2007 add-in Root Element Layout – Root element, children ordering – Business view of the differences – Single schema Schema Item Layout – Schema global item ordering – Business and Technical views of the differences – Single schema or schema folder The Drybridge Investigator – An Excel add-in for XML Schema Comparison Drybridge Consulting XML schemas evolve over time. Your ability to quickly analyze and identify changes allows you to identify the impact of these changes on your environment and proceed with their implementation. The Drybridge Investigator provides information for schema developers and schema implementers. When you generate a difference analysis you can choose to present the information in either: • Schema Item Layout • Root Element Layout Root Element Layout The root element layout compares the two schemas and presents the information using the schema root element as the starting point. • This layout would typically be used by a schema implementer to understand the impact of a new schema version on an existing implementation or trading partner relationship. The schemas are compared using business criteria to identify functional differences. Schema Item Layout The schema item layout compares the two schemas and presents the information ordered by schema global item (elements, attributes, complex types, simple types, attribute groups, and groups). • The technical version of this layout would typically be used by a schema developer to verify and validate every change made between two versions of the schema. • The business version of this layout would be used by schema implementers to identify functional differences between two versions of the schema. Arthur Colman www.Drybridge.com Page: 1 of 27
  • 3. DRYBRIDGE INVESTIGATOR – COMPREHENSIVE SCHEMA COMPARISON Introduction: How can I use the Drybridge Schema Investigator Introduction How can I use the Drybridge Schema Investigator? The Drybridge Investigator produces five different types of reports – Root element based, single schema, business oriented – Schema items, single schema, business oriented – Schema items, schema folder, business oriented – Schema items, single schema, technically oriented – Schema items, schema folder, technically oriented The Drybridge Investigator – An Excel add-in for XML Schema Comparison Drybridge Consulting The Drybridge Schema Investigator reports are designed to provide the full range of comparative analysis that implementers and developers require to understand a single schema or a group of schemas. These reports are designed to meet the broad needs of the implementation and development audience. The reports are easy to generate taking anywhere from a minute, for a report that compares two schemas, to less than two minutes, for a folder comparison of thirty-plus schema. This ability to quickly generate comparative reports will enable you to quickly determine which version best meets your needs. A schema implementer will be most interested in the three reports that are business oriented. These reports present the analytic information from a functional end-user viewpoint. • The root element based analysis presents the comparison in an XML message or business document format. (See Case Study 1) • The schema item format presents the comparison in a dictionary or catalogue format, each schema item is ordered so that you can easily find it. (See Case Study 2) • To determine the aggregate impact of several schemas (even an entire specification) the folder analysis can be used. (See Case Study 3) While a schema developer will certainly be interested in the business oriented reports above the technical reports provide the granular details of changes made between the two schema versions. • Technical changes can be viewed for a single schema (See Case Study 4) or for a group of schemas (See Case Study 5). Arthur Colman www.Drybridge.com Page: 2 of 27
  • 4. DRYBRIDGE INVESTIGATOR – COMPREHENSIVE SCHEMA COMPARISON Introduction: Workbook Layout Introduction Workbook Layout Root Analysis Supporting Items Enumerations The Drybridge Investigator – An Excel add-in for XML Schema Comparison Drybridge Consulting The Drybridge Schema Investigator provides information about changes made to one schema (the target) versus a source schema (the starting point). In order to simplify the review process the information is categorized onto several worksheets. • Analysis Worksheet for a root element analysis this sheet contains the root element and the primary elements; for a schema items analysis, contains all schema items (elements, attributes, types, and groups) • Supporting Items Worksheet for a root element analysis contains the elements that are included in the primary elements • Enumerations Worksheet containing elements and attributes that are defined via enumeration • Audit Worksheet contains information about the comparison process. While your particular analysis will be quite different from what is shown above we can use the above example to discuss some of the features of the output. 1. Hierarchical levels in the XML document are presented using the outline feature of Excel 2. Each item in the XML document is indented according to its Xpath level 3. Each item has the particular change that has been identified indicated. The following actions are communicated: • Added, Deleted, Changed, or No Change 4. Hyperlinks are provided from all sheets when an item is further defined on the Supporting Items or Enumerations Worksheet. 5. Where-used information is presented so that the impact of a particular change can be ascertained. The individual worksheets are discussed further in the case studies. Arthur Colman www.Drybridge.com Page: 3 of 27
  • 5. DRYBRIDGE INVESTIGATOR – COMPREHENSIVE SCHEMA COMPARISON Introduction: Analysis Options Introduction 1 Analysis Options Select the “Add-Ins” tab to access the Drybridge Technologies Value added programs. 2 Click on the “Investigator” icon to open the options window. 3 Select the type of analysis, the layout and then “Start”. The Drybridge Investigator – An Excel add-in for XML Schema Comparison Drybridge Consulting All Drybridge Technologies tools are located on the Add-Ins tab in the Drybridge Technologies Group. Click on the “Investigator” icon to open the “Schema Diff Analysis” options selection window. After you install the Drybridge Investigator a single “Investigator” icon will be inserted. Installing additional tools will add icons to the ribbon bar. You can obtain additional tools from www.drybridge.com. Analysis You can analyze a single schema or identify a folder on your hard drive and analyze all schema contained within that folder. • Source for Comparison – Items in this schema but not in the target are designated as “deleted”. • Target of Comparison – Items in this schema but not in the source are designated as “added”. Presentation You can choose to present the information based on the root element of the selected schema or for all items in the schema. • Root Element Based – The comparison is performed only for items that are children of the root element, regardless of depth. (The Drybridge Investigator determines the root element without requiring user intervention.) • For a single schema the analysis is based on the identified root element from the selected schema. • For a folder based analysis the root element from each schema is used. Schema that are used as “includes” and “imports” are only processed if required. • By Schema Item – The comparison is performed for all items in the selected schema (or schemas). Arthur Colman www.Drybridge.com Page: 4 of 27
  • 6. DRYBRIDGE INVESTIGATOR – COMPREHENSIVE SCHEMA COMPARISON Type of Analysis The Drybridge Investigator performs two types of analysis: • Technical – A technical analysis reports differences at a very granular, specific level. A technical analysis is ideal for schema developers to use to validate all changes between versions. Since a technical analysis performed with root element presentation is meaningless, it is not offered as an option. 1. Changes to type names are considered 2. All content models are considered 3. Global to local scoping is considered • Business – A business analysis only reports those differences that could result in a difference in an XML document derived from the schema. 1. Since type names do not appear in the XML document they are not considered. 2. Only content models that result in a cardinality change are reported 3. Since a change from global to local scoping has no impact on the resultant XML document they are not considered Basic Options • Primary Items Level – For the Root Element Presentation the number entered here determines how deep the Root Analysis goes before spinning off supporting elements. • Show Equal Children – If you want to report only the differences deselect this option. Typically you want to show equal children for context. • Include Where Used – Select this option if you want to include where-used information. Advanced Options • Print Details for Added Child Elements – When an item is added as a child to an element it may be beneficial to provide the details of the children or enumerations. Leave this option deselected if you have another method of viewing the details for additions. • Print Details for Equal Children – When two children are equal (cardinality and content) indicate if you want to see the details of equivalency. About For the latest documentation and release of the Drybridge Schema Investigator (and other Drybridge technologies) use the links on this tab to be directed to the appropriate location at www.drybridge.com. • Drybridge Technologies – for general information • Drybridge Schema Investigator – for information specific to the Drybridge Investigator Arthur Colman www.Drybridge.com Page: 5 of 27
  • 7. DRYBRIDGE INVESTIGATOR – COMPREHENSIVE SCHEMA COMPARISON Case Study 1: Root Element, Single Schema, Business Analysis Case Study Root Element, Business Analysis – Options 1. Analysis – Single Selected Schema 2. Presentation – Root Element Based 3. Type of Analysis – Business Version 4. Basic Options – Primary Items Level = 3 – Show Equal Children – Include Where Used The Drybridge Investigator – An Excel add-in for XML Schema Comparison Drybridge Consulting Case Study Description Schema implementers need to know what has changed when upgrading from one version of a schema to another. The Drybridge Schema Investigator options used in this case study produce worksheets that describe schema changes that affect an XML document produced from the schema. The Root Element layout presents this information in a form that mirrors the XML document. Case Study Discussion To initiate an analysis follow the steps listed in the Analysis Options discussion. The Drybridge Schema Investigator verifies that the workbook opened is empty and then presents the above window. 1. Indicate that you will be analyzing single selected schemas. • Click on the icon to the right of the text box for source schema. A window will open that will either permit you to select a schema from you local hard drive or, if you are dealing with a prepackaged version of the Drybridge Investigator, from the packaged schemas. Do the same for the target schema. 2. Indicate that you will be performing a Root Element Based analysis (the default setting). 3. When performing a Root Element Based analysis the Type of Analysis is a Business Version. 4. Review the Analysis Options. • Depending on the structure of the schemas you are comparing you may want to change the Primary Items Level from “3” to either “2” or “4”. A relatively flat schema may do best at a level of “2” a deep one may do best at “4”. • Show Equal Children = checked • Include Where Used = checked • Print Details for Added Child Elements = unchecked (keep the output simple!) • Print Details for Equal Children = unchecked (keep the output simple!) 5. Press “Start Analysis” . Arthur Colman www.Drybridge.com Page: 6 of 27
  • 8. DRYBRIDGE INVESTIGATOR – COMPREHENSIVE SCHEMA COMPARISON Case Study 1: Root Element Analysis Worksheet Case Study 1 Root Element Analysis Worksheet Comparison starts at the root element Cardinality and type changes communicated in a straight forward fashion Links provided to additional information You can choose to suppress items without any changes The Drybridge Investigator – An Excel add-in for XML Schema Comparison Drybridge Consulting The Root Element Analysis Worksheet provides comparative information for the root level and those items at a level in the schema equal to or greater than the “Primary Items Level” you designated when you initiated the analysis. (Items at a level deeper in the schema structure are considered to be Supporting Items and are presented on their own worksheet.) Schema Version & Includes Area Directly below the column headings is an expandable/contractible section that contains the schema version identification and information about any included, imported, or redefined schemas that are referenced. Root Element and Primary Items Area Below the version area are the root elements and primary items. Column A: Path Elements and attributes in the XML schema are listed under their parent. If the item is defined further on either the Supporting Item or Enumerations Worksheet a hyperlink is provided to the location on that worksheet. Upgrade Note: Currently children are ordered alphabetically instead of in schema order (this is done to facilitate the identification of items that are added and removed). Schema ordering for elements will be implemented in an upcoming release. Arthur Colman www.Drybridge.com Page: 7 of 27
  • 9. DRYBRIDGE INVESTIGATOR – COMPREHENSIVE SCHEMA COMPARISON Column B: Action For a given schema item in the analysis the following actions are identified: • Added – when an item exists in the target schema and is not in the source schema it is classified as “added”. Its cardinality is communicated and, if you have selected this option, its children or enumerations are identified (via hyperlink to the supporting information). • Deleted – when an item exists in the source schema and is not in the target schema it is classified as “deleted”. Its cardinality is communicated. No information about its children or enumerations is communicated. • Changed – when an item’s cardinality or content changes between the source and target schema definitions the source and target information is presented, in detail. • Usage Note: A Root Element analysis can only be performed in a Business Version (not Technical). This means that only changes that can affect the output XML document are shown. • Usage Note: Two children can be structurally equal yet their cardinality (usage within the parent) can be different. In this case only the cardinality difference is communicated. • Usage Note: When two children have different content but equivalent cardinality the cardinality and the content are presented. Note that the content will usually be presented as a hyperlink to an element or enumeration list on their respective worksheets. • No Change – When presenting a comparison in Root Element Layout all child elements and attributes are listed. If there is no change between the source and target the entry is classified as “no change”. Column C & D: Source and Target Details The details of the differences between the source and target schema item are shown in these columns. The type of information that is displayed is cardinality information and type information (is the item a string, a date, etc. and what limits are placed on the type – length, minimum amount, etc.). If there is an outline expansion icon to the far left of the row then details concerning the item’s children are available. Column E: Notes For you to use to make notations regarding the schema item listed. Arthur Colman www.Drybridge.com Page: 8 of 27
  • 10. DRYBRIDGE INVESTIGATOR – COMPREHENSIVE SCHEMA COMPARISON Case Study 1: Supporting Items Worksheet Case Study 1 Supporting Items Worksheet Alphabetic listing of all elements used by the primary items. Cardinality and type changes communicated in a straight forward fashion. Links provided to facilitate navigation. Where-used information permits impact determination. The Drybridge Investigator – An Excel add-in for XML Schema Comparison Drybridge Consulting The Supporting Items Worksheet provides a consolidated view of the elements that have changes that are used in the XML Schema that you have selected to investigate. The layout is similar to that provided in the Root Analysis Worksheet. In addition, where-used information is provided for each item identified as having a change. In addition to where-used information the Supporting Items Worksheet provides the following capabilities: • Cardinality change reporting • Type definition change reporting • Links to elements and enumerations for detailed information Where-Used Information Once you’ve identified a change in a schema it is important to understand what additional impacts that change has on the XML information that is being communicated. Changing how you handle the item without understanding how your change will impact other XML message aspects can cause an undesirable results. The Drybridge Investigator provides where-used information on where an item is used, where it has been added, and where it has been removed. • Scenario Note: Note above that “SafetyAndEnvironmentalInformation” has been added to the DeliveryMessageLineItem element. Arthur Colman www.Drybridge.com Page: 9 of 27
  • 11. DRYBRIDGE INVESTIGATOR – COMPREHENSIVE SCHEMA COMPARISON Case Study 1: Enumerations Worksheet Case Study 1 Enumerations Worksheet Alphabetic listing of all elements and attributes whose enumerations have changed. Only the differences are shown. Where-used information permits impact determination. The Drybridge Investigator – An Excel add-in for XML Schema Comparison Drybridge Consulting The Enumerations Worksheet provides a consolidated view of changes to the enumerations associated with elements and attributes in the XML Schema. The layout is similar to the Analysis and Support worksheets with each item listed followed by: • Where-used information • A listing of the changed enumerations Arthur Colman www.Drybridge.com Page: 10 of 27
  • 12. DRYBRIDGE INVESTIGATOR – COMPREHENSIVE SCHEMA COMPARISON Case Study 2: Schema Item, Single Schema, Business Analysis Case Study 2 Schema Item, Single Schema, Business Analysis – Options Analysis – Single Selected Schema Presentation – By Schema Item Type of Analysis – Business Version Basic Options – Show Equal Children – Include Where Used The Drybridge Investigator – An Excel add-in for XML Schema Comparison Drybridge Consulting Case Study Description Schema implementers need to know what has changed when upgrading from one version of a schema to another. The Drybridge Schema Investigator options used in this case study produce worksheets that describe schema changes that affect an XML document produced from the schema. The Schema Item layout presents this information in a form that mirrors a dictionary. Case Study Discussion To initiate an analysis follow the steps listed in the Analysis Options discussion. The Drybridge Schema Investigator verifies that the workbook opened is empty and then presents the above window. 1. Indicate that you will be analyzing single selected schemas. • Click on the icon to the right of the text box for source schema. A window will open that will either permit you to select a schema from you local hard drive or, if you are dealing with a prepackaged version of the Drybridge Investigator, from the packaged schemas. Do the same for the target schema. 2. Indicate that you will be performing an analysis By Schema Item and that the Type of Analysis will be a Business Version. 3. Review the Analysis Options. • “Primary Items” is only available when performing a Root Element analysis. • Show Equal Children = checked • Include Where Used = checked • Print Details for Added Child Elements = unchecked (keep the output simple!) • Print Details for Equal Children = unchecked (keep the output simple!) 4. Press “Start Analysis”. Arthur Colman www.Drybridge.com Page: 11 of 27
  • 13. DRYBRIDGE INVESTIGATOR – COMPREHENSIVE SCHEMA COMPARISON Understanding the Output (Schema Item, Single Schema, Business Analysis) The “Schema Item” form of presentation organizes the information by type of global item 1 and then alphabetically within those groups. The term “Single Schema” is used because an analysis will usually be performed for two versions of the same schema. • The source and target schemas can include any number of included, imported, or redefined references. A “Business Analysis” presents the differences between the two schemas compressing the impact of global items, with the exception of global elements. To understand the output; remember the following points: • In a business analysis all lower level changes bubble-up to trigger a change notification at the parent level. 1 Global items can be elements, attributes, simple types, complex types, groups, and attribute groups. Arthur Colman www.Drybridge.com Page: 12 of 27
  • 14. DRYBRIDGE INVESTIGATOR – COMPREHENSIVE SCHEMA COMPARISON Case Study 2: Schema Items Analysis Worksheet Case Study 2 Schema Items Analysis Worksheet Comparison starts at the root element Cardinality and type changes communicated in a straight forward fashion Links provided to additional information You can choose to suppress items without any changes The Drybridge Investigator – An Excel add-in for XML Schema Comparison Drybridge Consulting The Schema Item Analysis Worksheet provides comparative information for all the global items that are used by the root element identified for the selected schema. Schema Version & Includes Area Directly below the column headings is an expandable/contractible section that contains the schema version identification and information about any included, imported, or redefined schemas that are referenced. Global Items Areas Below the version area are sections for global elements, global attributes, simple types, complex types, groups, and attribute groups. Within each section the items are in alphabetic order. Column A: Path Elements and attributes in the XML schema are listed under their parent. If the item is defined further elsewhere on the Analysis Sheet or on the Enumerations Worksheet a hyperlink is provided to the location on that worksheet. Upgrade Note: Currently children are ordered alphabetically instead of in schema order (this is done to facilitate the identification of items that are added and removed). Schema ordering for elements will be implemented in an upcoming release. Arthur Colman www.Drybridge.com Page: 13 of 27
  • 15. DRYBRIDGE INVESTIGATOR – COMPREHENSIVE SCHEMA COMPARISON Column B: Action For a given schema item in the analysis the following actions are identified: • Added – when an item exists in the target schema and is not in the source schema it is classified as “added”. Its cardinality is communicated and, if you have selected this option, its children or enumerations are identified (via hyperlink to the supporting information). • Deleted – when an item exists in the source schema and is not in the target schema it is classified as “deleted”. Its cardinality is communicated. No information about its children or enumerations is communicated. • Changed – when an item’s cardinality or content changes between the source and target schema definitions the source and target information is presented, in detail. • Usage Note: Two children can be structurally equal yet their cardinality (usage within the parent) can be different. In this case only the cardinality difference is communicated. • Usage Note: When two children have different content but equivalent cardinality the cardinality and the content are presented. Note that the content will usually be presented as a hyperlink to an element or enumeration list on their respective worksheets. • No Change – When presenting a comparison in Message Layout all child elements and attributes are listed. If there is no change between the source and target the entry is classified as “no change”. Column C & D: Source and Target Details The details of the differences between the source and target schema item are shown in these columns. The type of information that is displayed is cardinality information and type information (is the item a string, a date, etc. and what limits are placed on the type – length, minimum amount, etc.). If there is an outline expansion icon to the far left of the row then details concerning the item’s children are available. Column E: Notes For you to use to make notations regarding the schema item listed. Arthur Colman www.Drybridge.com Page: 14 of 27
  • 16. DRYBRIDGE INVESTIGATOR – COMPREHENSIVE SCHEMA COMPARISON Case Study 2: Enumerations Worksheet Case Study 2 Enumerations Worksheet Alphabetic listing of all elements and attributes whose enumerations have changed. Only the differences are shown. The Drybridge Investigator – An Excel add-in for XML Schema Comparison Drybridge Consulting The Enumerations Worksheet provides a consolidated view of changes to the enumerations associated with elements and attributes in the XML Schema. The layout is similar to the Analysis and Support worksheets with each item listed followed by: • Where-used information • A listing of the changed enumerations Arthur Colman www.Drybridge.com Page: 15 of 27
  • 17. DRYBRIDGE INVESTIGATOR – COMPREHENSIVE SCHEMA COMPARISON Case Study 3: Schema Item, Schema Folder, Business Analysis Case Study 3 Schema Item, Schema Folder, Business Analysis – Options Analysis – All Schema in the Selected Folder Presentation – By Schema Item Type of Analysis – Technical Version Basic Options – Show Equal Children – Include Where Used The Drybridge Investigator – An Excel add-in for XML Schema Comparison Drybridge Consulting Case Study Description When upgrading a group of schemas from one version to another, schema implementers need to know what has changed in the group of schemas as a whole. The Drybridge Schema Investigator options used in this case study produce worksheets that describe the schema changes for all schemas contained in drive folders for the source and targets of the comparisons. The Schema Item layout presents this information in a straight-forward alphabetic approach. • XML specifications can contain numerous schema, if you desire you can compare all of the schemas or you can place only the schemas you want to compare in a drive folder. Case Study Discussion To initiate an analysis follow the steps listed in the Analysis Options discussion. The Drybridge Schema Investigator verifies that the workbook opened is empty and then presents the above window. 1. Indicate that you will be analyzing single selected schemas. • Click on the icon to the right of the text box for source schema. A window will open that will either permit you to select a schema from you local hard drive or, if you are dealing with a prepackaged version of the Drybridge Investigator, from the packaged schemas. Do the same for the target schema. 2. Indicate that you will be performing an analysis By Schema Item and that the Type of Analysis will be a Business Version. 3. Review the Analysis Options. • “Primary Items” is only available when performing a Root Element analysis. • Show Equal Children = checked • Include Where Used = checked • Print Details for Added Child Elements = unchecked (keep the output simple!) Arthur Colman www.Drybridge.com Page: 16 of 27
  • 18. DRYBRIDGE INVESTIGATOR – COMPREHENSIVE SCHEMA COMPARISON • Print Details for Equal Children = unchecked (keep the output simple!) 4. Press “Start Analysis”. Understanding the Output Arthur Colman www.Drybridge.com Page: 17 of 27
  • 19. DRYBRIDGE INVESTIGATOR – COMPREHENSIVE SCHEMA COMPARISON Case Study 3: Process Audit Example for Folder Analysis Case Study 3 Process Audit Example for Folder Analysis The process audit worksheet provides information about errors and content found during the analysis process. This sample illustrates the folder processing steps. The Drybridge Investigator – An Excel add-in for XML Schema Comparison Drybridge Consulting Arthur Colman www.Drybridge.com Page: 18 of 27
  • 20. DRYBRIDGE INVESTIGATOR – COMPREHENSIVE SCHEMA COMPARISON Case Study 4: Schema Item, Single Schema, Technical Analysis Case Study 4 Schema Item, Technical Analysis – Options Analysis – Single Selected Schema Presentation – By Schema Item Type of Analysis – Technical Version Basic Options – Show Equal Children – Include Where Used The Drybridge Investigator – An Excel add-in for XML Schema Comparison Drybridge Consulting Case Study Description Schema developers need to ensure that what has changed when creating a new version of a schema is what was intended. The Drybridge Schema Investigator options used in this case study produce worksheets that describe the granular (technical) changes made between schema versions. Case Study Discussion To initiate an analysis follow the steps listed in the Analysis Options discussion. The Drybridge Schema Investigator verifies that the workbook opened is empty and then presents the above window. 1. Indicate that you will be analyzing single selected schemas. • Click on the icon to the right of the text box for source schema. A window will open that will either permit you to select a schema from you local hard drive or, if you are dealing with a prepackaged version of the Drybridge Investigator, from the packaged schemas. Do the same for the target schema. 2. Indicate that you will be performing a “By Schema Item” analysis. 3. When performing a “By Schema Item” analysis you have a choice between Business and Technical for the “Type of Analysis”. Choose Technical for this case study. 4. Review the Analysis Options. • Primary Items Level – not relevant when “By Schema Item” • Show Equal Children – checked • Include Where Used – unchecked (in practice you may want to check this) • Print Details for Added Child Elements – unchecked (keep the output simple!) • Print Details for Equal Children – unchecked (keep the output simple!) 5. Press “Start Analysis”. Arthur Colman www.Drybridge.com Page: 19 of 27
  • 21. DRYBRIDGE INVESTIGATOR – COMPREHENSIVE SCHEMA COMPARISON Understanding the Output (Schema Item, Single Schema, Technical Analysis) The “Schema Item” form of presentation organizes the information by type of global item 2 and then alphabetically within those groups. The term “Single Schema” is used because an analysis will usually be performed for two versions of the same schema. • The source and target schemas can include any number of included, imported, or redefined references. A “Technical Analysis” is a granular, focused, absolute analysis of the differences between two schemas. This absolute technical granularity results in a very different view of the schema differences from the functional approach that the business analysis provides. To understand the output; remember the following points: • If, from a business perspective, an element changes but that element is defined by a named simple or complex type the change is reported as a change to the type, not the owning element. 2 Global items can be elements, attributes, simple types, complex types, groups, and attribute groups. Arthur Colman www.Drybridge.com Page: 20 of 27
  • 22. DRYBRIDGE INVESTIGATOR – COMPREHENSIVE SCHEMA COMPARISON Case Study 4: Comparing Schema Item Business and Technical Analysis Case Study 4 Comparing Schema Item Business and Technical Analysis Format and structure of the worksheets are equivalent for Schema Item layout regardless of whether the details are presented from a technical perspective or a business perspective. The granular details of the analysis are different The Drybridge Investigator – An Excel add-in for XML Schema Comparison Drybridge Consulting Arthur Colman www.Drybridge.com Page: 21 of 27
  • 23. DRYBRIDGE INVESTIGATOR – COMPREHENSIVE SCHEMA COMPARISON Case Study 5: Schema Item, Schema Folder, Technical Analysis Case Study 5 Schema Item, Schema Folder, Technical Analysis – Options Analysis – All Schema in the Selected Folder Presentation – By Schema Item Type of Analysis – Technical Version Basic Options – Show Equal Children – Include Where Used The Drybridge Investigator – An Excel add-in for XML Schema Comparison Drybridge Consulting Case Study Description Schema developers need to ensure that what has changed when creating a new version of a schema is what was intended. The Drybridge Schema Investigator options used in this case study produce worksheets that describe the granular (technical) changes made between schema versions. Case Study Discussion To initiate an analysis follow the steps listed in the Analysis Options discussion. The Drybridge Schema Investigator verifies that the workbook opened is empty and then presents the above window. 1. Indicate that you will be analyzing single selected schemas. • Click on the icon to the right of the text box for source schema. A window will open that will either permit you to select a schema from you local hard drive or, if you are dealing with a prepackaged version of the Drybridge Investigator, from the packaged schemas. Do the same for the target schema. 2. Indicate that you will be performing a “By Schema Item” analysis. 3. When performing a “By Schema Item” analysis you have a choice between Business and Technical for the “Type of Analysis”. Choose Technical for this case study. 4. Review the Analysis Options. • Primary Items Level – not relevant when “By Schema Item” • Show Equal Children – checked • Include Where Used – unchecked (in practice you may want to check this) • Print Details for Added Child Elements – unchecked (keep the output simple!) • Print Details for Equal Children – unchecked (keep the output simple!) 5. Press “Start Analysis”. Arthur Colman www.Drybridge.com Page: 22 of 27
  • 24. DRYBRIDGE INVESTIGATOR – COMPREHENSIVE SCHEMA COMPARISON Understanding the Output (Schema Item, Schema Folder, Technical Analysis) The “Schema Item” form of presentation organizes the information by type of global item 3 and then alphabetically within those groups. The term “Single Schema” is used because an analysis will usually be performed for two versions of the same schema. • The source and target schemas can include any number of included, imported, or redefined references. A “Technical Analysis” is a granular, focused, absolute analysis of the differences between two schemas. This absolute technical granularity results in a very different view of the schema differences from the functional approach that the business analysis provides. To understand the output; remember the following points: • If, from a business perspective, an element changes but that element is defined by a named simple or complex type the change is reported as a change to the type, not the owning element. 3 Global items can be elements, attributes, simple types, complex types, groups, and attribute groups. Arthur Colman www.Drybridge.com Page: 23 of 27
  • 25. DRYBRIDGE INVESTIGATOR – COMPREHENSIVE SCHEMA COMPARISON Case Study 5: Comparing Schema Folder Business and Technical Analysis Case Study 5 Comparing Schema Folder Business and Technical Analysis Format and structure of the worksheets are equivalent for Schema Folder layout regardless of whether the details are presented from a technical perspective or a business perspective. The granular details of the analysis are different The Drybridge Investigator – An Excel add-in for XML Schema Comparison Drybridge Consulting Arthur Colman www.Drybridge.com Page: 24 of 27
  • 26. DRYBRIDGE INVESTIGATOR – COMPREHENSIVE SCHEMA COMPARISON Appendix: About Drybridge Technologies Appendix Support Development of the Drybridge Investigator The Drybridge Investigator – An Excel add-in for XML Schema Comparison Drybridge Consulting From the web location where you downloaded the Drybridge Schema Investigator program and the documentation you can support the development activities monetarily and by providing feedback. Arthur Colman www.Drybridge.com Page: 25 of 27
  • 27. DRYBRIDGE INVESTIGATOR – COMPREHENSIVE SCHEMA COMPARISON Appendix: (Frequently Asked) Questions Appendix Frequently Asked Questions When do low level changes bubble-up? The Drybridge Investigator – An Excel add-in for XML Schema Comparison Drybridge Consulting • When do low level changes bubble-up? When an item is anonymously defined, locally defined, or the Analysis Type is “Business” then low level changes bubble-up and trigger a change notification at the parent level. Arthur Colman www.Drybridge.com Page: 26 of 27
  • 28. DRYBRIDGE INVESTIGATOR – COMPREHENSIVE SCHEMA COMPARISON Appendix: Selecting the schemas to process Arthur Colman www.Drybridge.com Page: 27 of 27

×