Solution Testing and Debugging Guide
Total Page:16
File Type:pdf, Size:1020Kb
Solution Testing and Debugging Guide Version 1.0, July 2015 Solution Testing and Debuggin Guidelines Copyright © 2015, Oracle and/or its affiliates. All rights reserved. This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited. The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing. If this software or related documentation is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, the following notice is applicable: U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007). Oracle USA, Inc., 500 Oracle Parkway, Redwood City, CA 94065. This software is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications which may create a risk of personal injury. If you use this software in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure the safe use of this software. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software in dangerous applications. Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners. This software and documentation may provide access to or information on content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services. Contents 1. Introduction ............................................................................................................. 3 2. Environments .......................................................................................................... 4 3. Testing and Debugging Solutions ......................................................................... 5 3.1 Testing and Debugging in OSM .................................................................................. 5 3.1.1. Debugging OSM XQuery Expressions ............................................................................... 5 3.1.2. Testing OSM Cartridge Projects ........................................................................................ 7 3.1.3. Testing OSM SOM Components ........................................................................................ 7 3.1.4. Submitting Test Orders from Design Studio....................................................................... 8 3.2 Testing and Debugging in UIM ................................................................................... 9 3.2.1. Testing the Design and Assign Provider Function ............................................................. 9 3.2.2. Testing the Calculate Technical Action Provider Function............................................... 10 3.3 Testing and Debugging in ASAP ...............................................................................11 3.3.1. Testing ASAP Cartridge Projects Using OCA .................................................................. 11 3.3.2. Testing ASAP Cartridge Projects Using the ASAP Test Suite ......................................... 13 3.3.3. Testing ASAP Cartridge Projects Using Design Studio Activation Tests ......................... 13 3.3.4. Testing ASAP Cartridge Projects Using ASAP Unit Tests ............................................... 15 3.3.5. Testing ASAP Cartridge Projects Using Design Studio Custom Unit Tests .................... 16 3.3.6. Initializing the ASAP Environment .................................................................................... 19 3.3.7. Reviewing ASAP Work Order Statuses ........................................................................... 19 3.4 Using Emulators ........................................................................................................21 4. Troubleshooting .................................................................................................... 22 4.1 Determining Version Numbers ...................................................................................22 4.1.1. Determining the ASAP Application Version Number ....................................................... 22 4.1.2. Determining the UIM Application Version Number .......................................................... 22 4.1.3. Determining the OSM Application Version Number ......................................................... 23 4.1.4. Determining the Design Studio Version Number ............................................................. 23 4.1.5. Determining Design Studio Project Version Numbers ..................................................... 24 4.2 Working with Log Files...............................................................................................25 4.2.1. Working with the OSM Log Files ...................................................................................... 25 4.2.2. Working with the ASAP Log File ...................................................................................... 25 4.2.3. Working with the UIM Log Files ....................................................................................... 26 4.3 Working with Utilities .................................................................................................26 4.3.1. Working with OSM Utilities ............................................................................................... 26 4.3.2. Working with ASAP Utilities ............................................................................................. 27 4.3.3. Working with UIM Utilities ................................................................................................ 28 4.4 Understanding Common Errors .................................................................................29 4.4.1. Understanding UIM Errors ............................................................................................... 29 4.4.2. Understanding OSM Errors .............................................................................................. 30 4.4.3. Understanding ASAP Errors ............................................................................................ 30 Solution Testing and Debugging Guide 1. Introduction This paper describes techniques that you can use during solution development to accelerate solution testing and debugging processes. Solution Testing and Debugging Guide 2. Environments Solution development testing and debugging includes the following testing phases: • System Testing and System Integration Testing • Hand-off point to the SI, customer, or to the larger Oracle team • User Acceptance Testing • Performance Testing • Non-Functional Testing • System Readiness Testing • Failover Testing • Operational Readiness Testing This paper focuses on techniques that you can use during developer-level unit testing to prepare for integration testing. Solution Testing and Debugging Guide 3. Testing and Debugging Solutions You can use multiple techniques to test and debug solutions. Some techniques are determined by the application in which you are working. This section describes common testing and debugging techniques for some Oracle Communications applications. 3.1 Testing and Debugging in OSM OSM is metadata-driven: when you add new OSM entities, such as new Project or Order entities, Design Studio builder identifies all errors. Fix these problems first. 3.1.1. Debugging OSM XQuery Expressions XQuery is used extensively in OSM. There are many tools available for debugging XQuery expressions. This section describes techniques for debugging XQuery expressions using the oXygen XML editor as a stand-alone editor or by installing the oXygen Eclipse plug-in. Note: To use the oXygen XML editor, you must first obtain an oXygen license. Using the oXygen XML Editor as a Stand-Alone Editor The oXygen XML editor features syntax highlighting and checking of XQuery source files. To use the oXygen XML editor, you must first configure the editor to ensure that it can properly validate the OSM automator XQuery source code. Completing