Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Difference between revisions of "Descriptive XSD Smoke Test Scenarios"

(Export Diagram as Image)
(Preferences)
Line 125: Line 125:
  
 
Make sure the Directive "Automatically remove unused XSD imports and XML Namespace entries" is unchecked. Make changes if needed and press OK, otherwise press cancel.  Select an XML Schema -> right click on the Directives node in the Outline view -> Add Import -> In the Properties view, select General from the vertical tab -> press the ... button for Schema location -> choose Workbench projects and press Next -> choose an XML schema, which isn't used by the current schema (or isn't the schema itself) -> press the Finish button -> Save the file, nothing should happen.  Now check the Directive "Automatically remove unused XSD imports and XML Namespace entries" and press OK.  If you Save again, the import will disappear.
 
Make sure the Directive "Automatically remove unused XSD imports and XML Namespace entries" is unchecked. Make changes if needed and press OK, otherwise press cancel.  Select an XML Schema -> right click on the Directives node in the Outline view -> Add Import -> In the Properties view, select General from the vertical tab -> press the ... button for Schema location -> choose Workbench projects and press Next -> choose an XML schema, which isn't used by the current schema (or isn't the schema itself) -> press the Finish button -> Save the file, nothing should happen.  Now check the Directive "Automatically remove unused XSD imports and XML Namespace entries" and press OK.  If you Save again, the import will disappear.
 +
 +
 +
==Zooming==
 +
# '''Zoom out''': open a XSD file and go to the Design View.  From the menubar -> XSD -> Zoom Out.  Try several times and make sure the text and the boxes get smaller
 +
# '''Zoom in''': open a XSD file and go to the Design View.  From the menubar -> XSD -> Zoom In.  Try several times and make sure the text and the boxes get larger
  
 
== Links ==
 
== Links ==

Revision as of 18:05, 15 October 2008

Example Setup

Examples found via: New -> Example ... -> Editing and validating XML files

Open and Close Editor

  1. Workspace XSD file: open an XSD file from the workspace and verify its content
  2. Non-workspace XSD file: open an XSD file from outside the workspace and verify its content. In addition, edit this file from an external editor and ensure a File changed dialog appears in Eclipse

Selection Tests

Synchronization between Properties, Design, Source, and Outline views: while conducting the Add/Modify tests, delete tests, and drag & drop tests, observe that these three views are synchronized


Note: if the nodes are collapsed and you add a new child, the node will not automatically expand. Therefore to test synchronization, expand the nodes whenever necessary to verify the synchronization between the Outline and Design view

Add/Modify Tests

For the tests where a new item is added:

  • Verify that the item was successfully added by finding and selecting the item from the Outline view or Design view
  • Whenever possible, modify the name of the item by changing the Name property in the Properties view under General properties

Tests:

  1. Include: create a copy of the XML schema of interest and copy to another workspace directory. In Outline view, right click on the Directives node -> Add Include. In the Properties view, select the copied schema as the Schema location
  2. Import: in Outline view, right click on the Directives node -> Add Import. Select a schema from the workbench
  3. Redefine: in Outline view, right click on the Directives node -> Add Redefine. Select a schema from the workbench
  4. Element: in Outline view, right click on the Elements node -> Add Element
  5. Attribute: in Outline view, right click on the Attributes node -> Add Attribute
  6. Attribute Group: in Outline view, right click on the Attributes node -> Add Attribute Group. Right click on the newly created Attribute Group -> Add Attribute
  7. Attribute default and fixed values: right click on an Attribute -> select the Default radio button from the Properties view under the General vertical tab -> Put a value. Verify changes by going to Source view. Now change the radio button to Fixed and verify the change in the source view.
  8. Complex Type: in Outline view, right click on the Types node -> Add Complex Type
  9. Simple Type: in Outline view, right click on the Types node -> Add Simple Type
  10. Group: in Outline view, right click on the Groups node -> Add Group
  11. Attribute ref: in Outline view, right click on a Complex Type -> Add Attribute Ref
  12. Attribute ref default and fixed values: right click on an Attribute ref -> select the Default radio button from the Properties view under the General vertical tab -> Put a value. Verify changes by going to Source view. Now change the radio button to Fixed and verify the change in the source view.
  13. Attribute group ref: in Outline view, right click on a Complex Type -> Add Attribute Group Ref
  14. Any Attribute: in Outline view, right click on a Complex Type -> Add Any Attribute
  15. Sequence: in Outline view, right click on a Complex Type -> Add Sequence
  16. Choice: in Outline view, right click on a Complex Type -> Add Choice
  17. All: in Outline view, right click on a Complex Type -> Add All
  18. Repeat the same steps for Design View. The UI element to mouseover and right click for each test is highlighted when selected in the Outline view

Delete Tests

  1. Delete items: Delete the following in Outline or Design view: Include, Import, Redefine, Element, Attribute, Attribute Group, Complex Type, Simple Type, Group, Attribute ref, Attribute group ref, Any Attribute, Sequence, Choice, All
  2. Delete locals and globals: Delete locals by removing a non-root element from the XML schema document and remove globals by removing a root element from the XML schema. Remove by right clicking on the element -> Delete

Drag & Drop Tests

  1. Sequence: setup by creating a new Complex Type, adding a sequence, and adding a few elements into the sequence. In the Design view, re-order the sequence elements by dragging. The reordering must be reflected in both the Design and Outline view
  2. Attribute: setup by creating a new Complex Type and adding a few attributes. In the Design view, re-order the attributes by dragging. The reordering must be reflected in both the Design and Outline view

Source Editing

  1. As you type validation: add invalid attributes or elements to the XML Schema. As you type them, the text should be underlined in red and on mouseover, an error message should be displayed
  2. Content Assist: use CTRL+SPACE in various parts of the Schema to see the possible entries that can be added
  3. Context menus: right click in the Design, Outline, and Source view to check the context menus
  4. Formatting: in the Source view, right click -> source -> Format. Now untab some elements by selecting elements and using SHIFT+TAB. To reformat, right click -> source -> Format.
  5. Toggle comment: in Source view, right click -> source -> Toggle Comment
  6. Add block comment: in Source view, right click -> source -> Add Block Comment
  7. Remove block comment: in Source view, right click while inside a block comment -> source -> Remove block Comment
  8. Switching between Design and Source view: make sure changes to the source are reflected in the Design view

Navigation History

The Navigation History's back and forward buttons can be found in the toolbar as a left and right arrow respectively. A shortcut is to use ALT+LEFT and ALT+RIGHT.


In the Design View, go to the Schema Index View (top level view of the Schema). Create a chain of references by clicking on items that bring the view to a lower level. Also test external references such as imports and includes by clicking on them. Use the back and forward arrows to navigate through the chain of references. Ensure the correct Design View is displayed for the item and the back and forward buttons navigate correctly through the chain of references.

Hyperlink Navigation

  1. Referenced components: in the Source View, press F3 or "CTRL+click" over a referenced component. The source editor should go to the referenced component
  2. Imports and Includes in the Source View: in the Source View, press F3 or "CTRL+click" over an import or include and the selection should jump to the referenced component
  3. Imports and Includes in the Design View: in the Design View, double click on an include or import, which will automatically open the editor

Extensions

  1. Add extensions: right click on a Complex Type -> select the Extension vertical tab from the Properties view -> under Extension, click the Add button -> click Add in the ADd Extension Components menu -> fill in a name -> select a schema from the workspace -> Click OK until you return to the Add Extension Components menu -> select a component from the Available components to Add list and press OK
  2. Add extension attribute: Note: uses results from previous step. From the instructions above, add an attribute by selecting an Extension from the list -> Fill in a value for any values that show up in the Extension Details list, which is to the right of the Extensions list
  3. Delete extensions: Note: uses results from previous step. Right click on an Extension in the Extensions list -> Remove

Constraints

  1. Initial Setup: create a new Element, from the Properties view, select Constraints from the vertical tab. Let this view be known as the Constraints property view
  2. Lengths: modify the Minimum length and Maximum length properties in the Constraints property view
  3. Enumerations: in the Constraints property view, use Add, Add..., Edit..., and Delete to test enumeration values

Refactoring

Rename: in the Outline view, right click on the Elements node -> Add Element -> in the Properties view under General properties, change the Type to be referencing an element from another XML Schema in the workspace via Browse... -> go to that Schema in the workspace and highlight the referenced element -> Refactor -> rename. right click on a complex type -> Refactor -> Rename... -> press OK after renaming. Now ensure the changes were reflected in the Schema that referenced this element.

File Creation & Saving

  1. Save and Save-As: Use save and save-as on XML schema files
  2. Close without saving: changes should not be committed
  3. Open existing XML schema file
  4. Create a new XML schema: File -> New -> Other... -> XML folder -> XML Schema

Export Diagram as Image

From the menubar, XSD -> Export Diagram as Image -> choose filename -> Press OK. Open the image and ensure the proper image is exported (according to what's shown in the Design view) and the image is not cut-off (the Schema Index view is cut-off https://bugs.eclipse.org/bugs/show_bug.cgi?id=250953)

Validation

  1. Schema validation: introduce invalid elements or attributes to a valid XML schema. Right click on the schema in the Package Explorer -> Validate. A red X should show up because the XML schema is invalid. Revert the changes and revalidate, the X should dissapear
  2. Disconnected mode: disconnect your computer from the internet and check that nothing breaks
  3. Validation builder: right click on the project -> Properties -> select Validation from the list of properties -> add a check to the "Add Validation Builder to project" checkbox. Introduce changes to a schema that will invalidate an XML file. The error should show up automatically instead of manually validating the XML file

Note: once you enable Add Validation Builder to project, it cannot be disabled through the same menu. It can be removed by right clicking on the project -> Properties -> select Builder from the list of properties -> uncheck Validation form the resulting list

XML Catalog

  1. Load an XML schema from the jar: create a new XML Schema or use an existing XML schema -> select Extensions from the vertical tab in the Properties view -> Add -> Add... -> fill in a schema name -> select a Schema from Catalog (these schema documents are from jar files). Not all schemas will have components, so select schemas like http://schemas.xmlsoap.org/wsdl/ -> a component should show up in the Available components to Add list, select one and press OK. Check that the imported schema shows up in the Source view and the component added
  2. Export XML catalog file: right click on a project in the Package Explorer view -> Export... -> select the XML Catalog from the XML folder and press the Next button -> select a directory to export file to and add a name which ends in .xml -> press the Finish button. Open the newly export XML Catalog File and verify that it isn't empty (should contain the element <catalog xmlns="urn:oasis:names:tc:entity:xmlns:xml:catalog"/>)
  3. Import XML catalog file: right click on a project in the Package Explorer view -> Import... select the XML Catalog from the XML folder and press the Next button -> select a directory -> press the Import Files... button -> Use browse to find the location of an XML Catalog file -> select the XML file(s) -> click the Finish button. Verify the files were added into the correct directory and contain the correct information. A quick way to export files is to use files in the same workspace but export to a different directory within the project

Generators

Generate an XML file from an XSD file: right click on an XML Schema -> Generate -> XML File... -> Add a new file name or use default and press the Next button -> press the Finish button. From the example files, GolfCountryClub.xsd will generate a decent number of elements

Preferences

XSD preferences are found in the menubar Window -> Preferences -> XML -> XML Schema Files


Qualify XSD constructs

Check the Qualify XSD constructs preference. Modify the prefix and the target namespace. Ensure that the prefix and target namespace is used by the new schema wizard.


Honour all schema locations

Test a schema that imports two other schemas with the same namespace and different locations.


Modify full schema conformance

TODO Needs a test schema that would expose the difference


Remove unused imports (New to 3.0.1)

Make sure the Directive "Automatically remove unused XSD imports and XML Namespace entries" is unchecked. Make changes if needed and press OK, otherwise press cancel. Select an XML Schema -> right click on the Directives node in the Outline view -> Add Import -> In the Properties view, select General from the vertical tab -> press the ... button for Schema location -> choose Workbench projects and press Next -> choose an XML schema, which isn't used by the current schema (or isn't the schema itself) -> press the Finish button -> Save the file, nothing should happen. Now check the Directive "Automatically remove unused XSD imports and XML Namespace entries" and press OK. If you Save again, the import will disappear.


Zooming

  1. Zoom out: open a XSD file and go to the Design View. From the menubar -> XSD -> Zoom Out. Try several times and make sure the text and the boxes get smaller
  2. Zoom in: open a XSD file and go to the Design View. From the menubar -> XSD -> Zoom In. Try several times and make sure the text and the boxes get larger

Links

Back to the top