<oXygen/> XML Editor 11.2 User Manual for Eclipse SyncRO Soft Ltd. <oXygen/> XML Editor 11.2 User Manual for Eclipse SyncRO Soft Ltd. Copyright © 2002-2009 SyncRO Soft Ltd. All Rights Reserved. <oXygen/> XML Editor User Manual Copyright © 2009 Syncro Soft SRL All rights reserved. No parts of this work may be reproduced in any form or by any means - graphic, electronic, or mechanical, including photocopying, recording, taping, or information storage and retrieval systems - without the written permission of the publisher. Products that are referred to in this document may be either trademarks and/or registered trademarks of the respective owners. The publisher and the author make no claim to these trademarks. While every precaution has been taken in the preparation of this document, the publisher and the author assume no responsibility for errors or omissions, or for damages resulting from the use of information contained in this document or from the use of programs and source code that may accompany it. In no event shall the publisher and the author be liable for any loss of profit or any other commercial damage caused or alleged to have been caused directly or indirectly by this document. Many of the designations used by manufacturers and sellers to distinguish their products are claimed as trademarks. Where those designations appear in this book, and SyncRO Soft Ltd., was aware of a trademark claim, the designations have been printed in caps or initial caps. While every precaution has been taken in the preparation of this book, the publisher assumes no responsibility for errors or omissions, or for damages resulting from the use of the information contained herein. Third party software components are distributed in the <oXygen/> installation packages, including the Java Runtime Environment (JRE), DocBook DTD and stylesheets. This product includes software developed by the Apache Software Foundation (http://www.apache.org [http://www.apache.org]): the Apache FOP, Xerces XML Parser and Xalan XSLT . This product includes software with copyright (C) 2002-2008 Yutaka Furubayashi (Poka- poka Dream Factory). These products are not the property of SyncRO Soft Ltd.. To the best knowledge of SyncRO Soft Ltd. owners of the aforesaid products granted permission to copy, distribute and/or modify the software and its documents under the terms of the Apache Software License, Version 1.1. Other packages are used under the GNU Lesser General Public License. Users are advised that the JRE is provided as a free software, but in accordance with the licensing requirements of Sun Microsystems. Users are advised that SyncRO Soft Ltd. assumes no responsibility for errors or omissions, or for damages resulting from the use of <oXygen/> and the aforesaid third party software. Nor does SyncRO Soft Ltd. assume any responsibility for licensing of the aforesaid software, should the relevant vendors change their terms. By using <oXygen/> the user accepts respons- ibility to maintain any licenses required by SyncRO Soft Ltd. or third party vendors, unless SyncRO Soft Ltd. declares in writing that the <oXygen/> license is inclusive of third party licensing. Printed: November 2009 Special thanks to: Sean Wheller for his initial contribution to this User Manual. Table of Contents 1. Introduction .................................................................................................................................... 1 Key Features and Benefits ............................................................................................................. 1 About the <oXygen/> User Manual ................................................................................................. 2 2. Installation ...................................................................................................................................... 4 Installation Requirements .............................................................................................................. 4 Platform Requirements ......................................................................................................... 4 Operating System, Tools and Environment Requirements ............................................................ 4 Operating System ........................................................................................................ 4 Tools ......................................................................................................................... 4 Environment Prerequisites ............................................................................................. 4 Installation Instructions ................................................................................................................. 5 Starting <oXygen/> plugin ............................................................................................................ 6 Obtaining and registering a license key ............................................................................................ 6 Named User license registration ............................................................................................. 6 How floating (concurrent) licenses work .................................................................................. 7 How to install the <oXygen/> license server as a Windows service ........................................ 9 How to release a floating license ................................................................................... 10 License registration with a registration code ............................................................................ 10 Unregistering the license key ........................................................................................................ 10 Upgrading the <oXygen/> application ............................................................................................ 10 Checking for new versions ........................................................................................................... 11 Uninstalling the Eclipse plugin ..................................................................................................... 11 3. Getting started ............................................................................................................................... 12 Supported types of documents ...................................................................................................... 12 Getting help .............................................................................................................................. 12 Perspectives .............................................................................................................................. 12 <oXygen/> XML perspective ............................................................................................... 12 The <oXygen/> custom menu ....................................................................................... 13 The <oXygen/> toolbar buttons .................................................................................... 13 The editor pane .......................................................................................................... 13 The Outline view ....................................................................................................... 14 The <oXygen/> Text view ........................................................................................... 14 The <oXygen/> Browser view ...................................................................................... 14 The <oXygen/> XPath Results view .............................................................................. 15 Supported editor types ................................................................................................ 15 <oXygen/> XSLT Debugger Perspective ................................................................................ 16 <oXygen/> XQuery Debugger Perspective .............................................................................. 17 <oXygen/> Database perspective ......................................................................................... 18 4. Editing documents .......................................................................................................................... 20 Working with Unicode ................................................................................................................ 20 Opening and saving Unicode documents ................................................................................. 20 Opening and closing documents .................................................................................................... 20 Creating new documents ..................................................................................................... 21 <oXygen/> plugin wizards ........................................................................................... 21 Creating Documents based on Templates ........................................................................ 26 Saving documents .............................................................................................................. 26 Opening and Saving Remote Documents via FTP/SFTP ............................................................ 26 Changing file permissions on a remote FTP server ........................................................... 28 WebDAV over HTTPS ................................................................................................ 29