web services and alf events in dimensions cm

1 Copyright ©2008 Serena Software, Inc.

Web Services and ALF Events in Dimensions CM

Steve RansomProduct Manager Sr, Serena


• What are Web Services & ALF Events?• Some Philosophy• What is available now?• What will be available in the Future?• Demonstration Explanation• Demonstration

Agenda


Terms

• Web Services• Allows other software to issue Dimensions CM commands

• WSI-Basic compliant SOAP Web Services for performing common Dimensions operations, implemented using AXIS 2 and Document Literal Style WSDL definitions

• ALF Events• Application Lifecycle Framework (ALF)

• Allows Dimensions CM to tell other software something has happened

• ALF Events fire after the event has started

• www.eclipse.org/alf

http://www.eclipse.org/alf


Some Philosophy - Starting

• ….. go forth and produce some services and events

• But where to start?

?


Some Philosophy - Starting

• The Command Line

• The command line has about 260 commands and we’re adding to it all the time.

• Adding ALF Events doubles this figure


And here they arecreateRequest WSgetRequest WSupdateRequest WSactionRequest WSdelegateRequest WSdelegateRequestForReplication WSdeployRequest WSdefineProject WScreateDesignPart WSCheck In ALFCheck Out ALFUndo Check Out ALFCreate Item ALFAction Request ALFcheckInItem WScheckOutItem WSdeployBaseline WSgetProjectItems WSrelateItemsToParts WSmoveItemToPart WScreateRevisedBaseline WSrelateRequestToRequests WSunrelateRequestFromRequests WScreateProjectBaseline WScreateDesignPartBaseline WSlistProjectRequests WSlistProjectItems WSAssociate Request WSUpdate Request ALFBuild WSBuild Submitted ALFBuild Completed ALFBuild Baseline WSBuild Baseline Submitted ALFBuild Baseline Completed ALFCreate Request ALFRelate Part to Request ALF Relate Requests to Requests ALF Add Attachment To Request WSGet Attachment WS

List ProjectsWSUnrelate Item from Design Part WSUnrelate Part to Request ALFUnrelate Requests to Requests ALFUpdate Attachment WSCreate Item WSDeploy Item WSLock Project WSUnlock Project WS Get Request Items WSGet Item WSRelate Request to Project WSAdd Attachment to Request ALFUpdate Attachment ALFDelete Attachment WSDelete Attachment ALFDefine Version Branch WSExecute a job on a Network Node WSMerge Projects WSAction Project WSList Project Directories WSAction Baseline WSAction Baseline ALFList Baseline Items WSRelate Area to Project WSCreate Project Directory WSAssign/Unassign Users to a Group WSList Groups WSList Users against Project WS Action Item WSAction Item ALFList Design Parts within Project WSAction a List of Items WS Create Merged Baseline WSRename WSSet Working Directory WSDeploy Baseline ALF Deploy Request ALFDelegate Request ALFList Requests in Project WS Delete Item WSDeploy Item ALFDefine Project ALFGet Baseline Items WSUpdate Item Attribues WSUpdate Item Attribues ALF Relate Request to Project ALF Create Baseline ALF

Create Merged Baseline ALF Create Revised Baseline ALF Remove Request Items from Project WSRemove Request from Project ALFRemove Version Branch WSRemove Project WSRemove Project ALFUpdate Project Attributes WSUpdate Project Attributes ALF Merge Projects ALF Create Design Part ALFDelete Design Part Variant WSLock Project ALF Unlock Project ALFAction Project ALFDelete Baseline WSDelete Baseline ALFRelease Baseline WSRelease Baseline ALFRename ALFRelate Item to Design Part ALFUpdate Design Part Attributes WSUnrelate Item from Design Part ALFList Design Parts WS Create Areas WSCreate Areas ALFCreate Build Area WSCreate Build Area ALFList Areas WSList Build Areas WSList Stages WSPopulate Areas WSPopulate Areas ALFPopulate Build Area WSPopulate Build Area ALFRemove Area WSRemove Area ALFRelate Area to Build WSUnrelate Area to Build WSRelate Area to Build ALF Relate Area to Project ALFUnrelate Area to Build ALF Unrelate Area to Project ALF Update Area WSUpdate Area ALFUpdate Build Area WSUpdate Build Area ALFUnrelate an Area from a Project WS

Unrelate an Area from a Project ALFCreate Project Directory ALF Relate Project to Project WSRelate Project to Project ALF Unrelate a Project from a Project ALFAssign/Unassign Groups to a User WSAssign User Roles WSRegister User WSUnregister User WSUpdate User Attributes WSAction All Items and Requests WSAdd Items related to a Request to a Project WSDelete Request WSDelete Request ALFRelate Baselines to Request WSRelate Baselines to Request ALFRelate Item to Request WSRelate Item to Request ALF Relate Part to Request WSRelate Requirement to Request WSRelate Requirement ALF Unrelate Baselines to Request WS Unrelate Baselines to Request ALFUnrelate Item to Request WSUnrelate Item to Request ALFUnrelate Part to Request WSUnrelate Requirement to Request WSUnrelate Requirement ALF Unrelate a Project from a Request WSUnrelate a Project from a Request ALFDelegate Item WSDelegate Item ALFRelate Baseline to Baseline WSRelate Baseline to Baseline ALFRelate Baselines to Project WSRelate Baselines to Project ALFUnrelate Baseline to Baseline WSUnrelate Baseline to Baseline ALF Unrelate Baselines to Project WSUnrelate Baselines to Project ALF Relate Design Part WSRelate Design Part ALFUnrelate Design Part WSUnrelate Design Part ALFDelete Project Directories WSDelete Item ALFUpdate Design Part Attributes ALFDMPMCLIDMDBA


Some Philosophy - Priority

• The Serena Mashup Team• What services and events do you need for Dimensions CM

Mashups?

• Serena consultants from 5 different countries, 3 customers and 3 partners

• What services and events do you need to make implementation and maintenance of Dimensions CM easier in your environment?

• What services and events do you need to make integrations easier with Dimensions CM in your environment?


Some Philosophy - Priority

• Mashups Team• Application Release Management (ARM 2.0), initial pass 10

services and events

• Consultants, Customers and Partners• More management of Dimensions objects

• Can we stop using the Mashup/CM sync engine now?


Some Philosophy - The Result

• ARM (10 services & Events)• Additional ARM type requirements• Replace the sync engine • The remaining 460!

50 services and events}


Web Services WSDL

• Dimensions Root\Common Tools\tomcat\5.5\webapps\ \dmwebservices2\WEB-INF\services\dmwebservices\ META-INF


ALF Events

• Fire after event• Controlled by Dimensions Root\10.1\CM\dfs\

alf_events_config.xml


ALF_EVENTS_CONFIG.XML<Databases> Specify one or more databases

<Database> Specify a specific database <Name>QLARIUS_CM@*-DIM10</Name>

<Projects> Specify one or more projects <Project> Specify a specific project

<Name>QLARIUS:UW_JAVA_*</Name> <Objects> Specify one or more object classes

<Object> Specify a specific object class <Type>Item</Type><Events> for above object type

<Event>create</Event> <Event>check-in</Event> <Event>check-out</Event> <Event>undo-check-out</Event></Events>

</Object><Object> <Type>Request</Type>

<Events> <Event>action</Event>

</Events></Object>

</Objects> </Project></Projects>

</Name></Database>

</Databases>


Currently GA

• Web Services• createRequest

• getRequest

• updateRequest

• actionRequest

• delegateRequest

• delegateRequestForReplication

• deployRequest

• defineProject

• createDesignPart

• ALF Events• Check In

• Check Out

• Undo Check Out

• Create Item

• Action Request


In 10.1.3.2

• Web Services• checkInItem

• checkOutItem

• deployBaseline

• getProjectItems

• relateItemsToParts

• moveItemToPart

• createRevisedBaseline

• relateRequestToRequests

• unrelateRequestFromRequests

• createProjectBaseline

• createDesignPartBaseline

• listProjectRequests

• listProjectItems

• ALF Events


Demonstration Explanation

• Using Serena Business Mashups

NewMashup Wait on Dev

CM

Create RequestWeb Service

Dev CompleteAction RequestALF Event

Wait on BuildAutomatic

Request Lifecycle

CM Build

BuildWeb Service

Wait on TestAutomatic

Do Development

Create BaselineWeb Service

Deploy BaselineWeb Service

Baseline


Questions

web services and alf events in dimensions cm

Documents