How to use DOORS with CANdelaStudio Version 1.0 2008-10-30 Application Note AN-IDG-1-011 Author(s) Restrictions Abstract Huber, Carsten Public Document This application note describes how to add DOORS-IDs to CANdela objects and how they can be used by other tools. Table of Contents 1.0 1.1 1.2 2.0 2.1 2.2 3.0 4.0 Overview ..........................................................................................................................................................1 Preparing a CANdela document for DOORS (Expert view)..........................................................................1 How to enter DOORS-IDs in a CANdela document (Standard view) ...........................................................2 Using DOORS-IDs and links in other Tools.....................................................................................................3 How to start DOORS from within CANoe Option DiVa .................................................................................3 How to start CANdelaStudio from within CANoe Option DiVa......................................................................3 Additional Resources .......................................................................................................................................4 Contacts ...........................................................................................................................................................4 1.0 Overview Telelogic DOORS ® is a requirements analysis and specification tool used in the automobile industry. It allows defining requirements for the implementation of e.g. diagnostic services. Every requirement is referenced by a unique identifier (called DOORS-ID in this document) and a link. DOORS-IDs and links are stored in attributes at the objects of the CANdela document. To connect CANdela objects like services to DOORS-IDs, an attribute category and the attributes must be added to the CANdela document (if not already present). Other tools like CANoe Option DiVa may read the attribute values from the CANdela document to obtain the DOORS-IDs and links. The following is a description on how to attach DOORS-IDs and links to services and how to use the DOORS-IDs in other tools like CANoe Option DiVa. Of course, you can attach DOORS-IDs also to other CANdela objects (variants, diagnostic classes, diagnostic instances, job container). To do so, just add the default attribute described below to the respective CANdela object. 1.1 Preparing a CANdela document for DOORS (Expert view) 1. Open the document in Expert view. Go to chapter “Default Attributes/Services”. 2. Create a new attribute category with qualifier “Requirements”. 3. Create a “String” default attribute with qualifier “DOORS”. 4. Set the attribute category of the new default attribute to “Requirements”. 5. Save the document. The CANdela document is now prepared to store DOORS-IDs and links. Note: You need the Admin Edition of CANdelaStudio to add default attributes to a CANdela document or template. 1 Copyright © 2008 - Vector Informatik GmbH Contact Information: www.vector-informatik.com or ++49-711-80 670-0 How to use DOORS with CANdelaStudio 1.2 How to enter DOORS-IDs in a CANdela document (Standard view) 1. Go to the diagnostic instance containing the service. 2. Open the properties dialog of the service and click on tab card “Attributes”. 3. Select the “DOORS” attribute and press <F2>. An edit box appears. 4. Enter the DOORS-ID and optionally the link separated by “=”. Format: <DOORS-ID>[=<link>] Example: “R001.0=doors://database:12345/?version=1,prodID=1,dbid=42d24,container=5c06” If you want to enter more than one DOORS-ID, press <Ctrl>+<Return> at the end of each line (see Figure 1). 5. Press <Return>. 6. Click on [OK]. Figure 1: Properties dialog of a service with DOORS requirement IDs and links Note: DOORS-IDs and links can also be edited in the Attribute overview dialog of CANdelaStudio. You can find further information on the Attribute overview in the online help of CANdelaStudio. 2 Application Note AN-IDG-1-011 How to use DOORS with CANdelaStudio 2.0 Using DOORS-IDs and links in other Tools This section describes how to use DOORS-IDs in other tools. As an example, CANoe Option DiVa is used to demonstrate the usage. 2.1 How to start DOORS from within CANoe Option DiVa Starting with version 2.1 CANoe Option DiVa uses the DOORS-IDs and links stored at the services of a CANdela document to place the link in the report view (i.e. the generated HTML output of the test results). To open DOORS and navigate to the requirement from within CANoe Option DiVa, click on the link at the top of a page in the report view (see Figure 2). DOORS will open and view the requirement. Figure 2: Report view of CANoe Option DiVa with DOORS link 2.2 How to start CANdelaStudio from within CANoe Option DiVa You can start CANdelaStudio from within CANoe Option DiVa or any HTML browser by clicking on the hyperlinks labeled “CANdelaStudio://” in the report view (see Figure 3). CANdelaStudio opens the associated CANdela document and selects the object pointed to by the hyperlink. Note: This feature is supported starting with CANdelaStudio 6.0 and CANoe Option DiVa 2.1. Earlier versions do not support the CANdelaStudio protocol (“CANdelaStudio://”). However, you can use older versions of CANdelaStudio to add the necessary default attributes and the attribute category to CANdela documents. 3 Application Note AN-IDG-1-011 How to use DOORS with CANdelaStudio Figure 3: Report view of CANoe Option DiVa with CANdelaStudio link 3.0 Additional Resources VECTOR APPLICATION NOTE AN-IDG-1-001 AN-IDG-1-003 AN-IDG-1-004 AN-IDG-1-005 AN-IDG-1-006 AN-IDG-1-009 AN-IDG-1-010 How to get a CANdela document translated How to use the CANdelaStudio command line ODX support in Vector tools How to edit states and state groups CANdelaStudio product activation FAQ How to associate UDS Record numbers with Snapshot data How to create UDS protocol services 19 04 and 19 06 4.0 Contacts Vector Informatik GmbH Ingersheimer Straße 24 70499 Stuttgart Germany Tel.: +49 711-80670-0 Fax: +49 711-80670-111 Email: info@vector-informatik.de Vector CANtech, Inc. 39500 Orchard Hill Pl., Ste 550 Novi, MI 48375 USA Tel: +1-248-449-9290 Fax: +1-248-449-9704 Email: info@vector-cantech.com VecScan AB Theres Svenssons Gata 9 41755 Göteborg Sweden Tel: +46 (0)31 764 76 00 Fax: +46 (0)31 764 76 19 Email: info@vecscan.com Vector France SAS 168 Boulevard Camélinat 92240 Malakoff France Tel: +33 (0)1 42 31 40 00 Fax: +33 (0)1 42 31 40 09 Email: information@vector-france.fr Vector Japan Co. Ltd. Seafort Square Center Bld. 18F 2-3-12, Higashi-shinagawa, Shinagawa-ku Tokyo 140-0002 Japan Tel.: +81 3 5769 7800 Fax: +81 3 5769 6975 Email: info@vector-japan.co.jp Vector Korea IT Inc. Daerung Post Tower III, 508 182-4 Guro-dong, Guro-gu Seoul, 152-790 Republic of Korea Tel.: +82-2-2028-0600 Fax: +82-2-2028-0604 Email: info@vector-korea.com 4 Application Note AN-IDG-1-011