AllFusion^® Process Modeler r7 Readme

11.0 Contact Customer Support

1.0 Welcome

Welcome to AllFusion Process Modeler r7, a member of the AllFusion Modeling Suite. This file contains product installation considerations, operating system support, known issues, and information about contacting Computer Associates Customer Support.

2.0 Operating System Support

AllFusion Process Modeler (AllFusion PM) r7 requires that you have one of the following operating systems installed:

• Microsoft Windows Server 2003

• Microsoft Windows XP (Service Pack 2)

• Microsoft Windows 2000

3.0 System Requirements

The following requirements must be met or exceeded for AllFusion PM r7 to install and run correctly:

• 85 MB hard disk space

• 512 MB RAM (1 GB recommended for large models)

4.0 Installation Considerations

Installation and upgrade procedures for this release of AllFusion PM are in the AllFusion PM Getting Started guide.

If you intend to share your process models with others using AllFusion MM, you must install AllFusion PM on all workstations on which the model may be saved or opened.

If you previously installed a release of AllFusion PM Version 4.1.4 (including one of the service packs), the AllFusion PM r7 installation program detects the presence of the previous release and automatically installs the necessary files independently.

The Start menu path was changed to: Start, Programs, Computer Associates, AllFusion, Process Modeler r7, AllFusion Process Modeler. If you find that there are extra items in the start menu, uninstall and then reinstall AllFusion PM r7.

If you want to preserve spell checking dictionaries that contain user additions from AllFusion PM Version 4.0, do not uninstall AllFusion PM Version 4.0 before installing AllFusion PM r7. Install AllFusion PM r7 in a different folder than AllFusion PM Version 4.0. The spell checking dictionaries are copied from AllFusion PM Version 4.0 to AllFusion PM r7 automatically.

5.0 General Considerations

5.1 Published Fixes

All published fixes for this product can be found through Published Solutions on SupportConnect.

5.2 Before Using AllFusion PM

This section contains general information you should know before using AllFusion PM:

• Support for AllFusion Model Manager r7

  AllFusion PM r7 is enabled for use with AllFusion Model Manager (AllFusion MM) r7. See the AllFusion MM Readme file and the AllFusion MM Administrator Guide for installation instructions and advisory notes for using AllFusion MM r7 with AllFusion PM r7.

• AllFusion PM API sample application

  Information regarding the sample application that is within the AllFusion PM API is no longer contained in the file readme_AllFusion_Process_Modeler_Sample_App.html. See the section AllFusion Process Modeler API Sample Application for this information.

  Important! The purpose of the sample application is to provide an integrator with an example of a simple AllFusion PM API client. It is not a utility or a functioning part of AllFusion PM.

6.0 Documentation Changes

Updated guides will be available at http://ca.com/support.

7.0 Known Issues

No known issues at this time.

8.0 AllFusion Process Modeler API Sample Application

8.1 Installation Considerations

This section describes the installation considerations for the sample application.

Dependencies

AllFusion PM r7 must be installed. The following components must also be installed and successfully registered:

• AllFusion PM API (PM_SCAPI.dll)

• Microsoft Data Formatting Object Library (msstdfmt.dll)

Note: The implementation code is only compatible with Microsoft Visual Studio 6.0 and not the Microsoft .NET development environment.

Installing the Add-in Component

To install the sample application as an add-in component in AllFusion PM, follow these steps:

1. Register PM_SCAPI_AddinDLL.dll using the program regsvr32.exe.

2. Start AllFusion PM.

3. Open an existing project or create a new one.

4. Select Add-Ins and then Customize from the Tools menu.

   The Add-In Manager dialog opens.

5. Click the Add Menu Item button.

   The Add New Menu Item dialog opens.

6. Select Command in the Menu Type group, and then select Com Object.

7. Type API Sample in the Name field.

   This will be the name of the menu item in the Tools, Add-Ins menu.

8. Type PM_SCAPI_AddinDLL.PM_SCAPIAddin in the COM ProgID field or click the browse button to select the ID from a list. If PM_SCAPI_AddinDLL.PM_SCAPIAddin does not show up in the list, make sure the PM_SCAPI_AddinDLL.dll was registered.

9. Type Run in the Function Name field.

10. Click OK to close the Add New Menu Item dialog.

11. Click Save in the Add-In Manager dialog.

To test the add-in component, select Tools, Add-Ins, then API Sample.

8.2 General Considerations

Published Fixes

All published fixes for this product can be found through Published Solutions on SupportConnect.

Sample Application Files

The following files are used to implement the sample application in Microsoft Visual Basic 6.0:

• DeleteNonScalarValue.frm

• Main.bas (used for the standalone executable only)

• ModifyObject.frm

• NewProject.frm

• PM_SCAPI_AddinDll.vbp (Visual Basic project file for the add-in component)

• PM_SCAPI_Sample_Exe.vbp (Visual Basic project file for the standalone executable)

• PM_SCAPIAddin.cls (used for the add-in component only)

• ProjectView.frm

• ProjectView.frx

• ReallocateArrayForm.frm

• SelectProject.frm

• SelectProject.frx

• UtilFunctions.bas

The following files are used to execute the sample applications:

• PM_SCAPI_AddinDLL.dll (Add-in component)

• PM_SCAPI_Sample_Exe.exe (Standalone executable)

Using the Sample Application

The sample application is provided within the AllFusion Process Modeler Script Client API (AllFusion PM API).

Important! The purpose of the sample application is to provide an integrator with an example of a simple AllFusion PM API client. It is not a utility or a functioning part of AllFusion PM.

The AllFusion PM API can be used within a standalone executable or within an add-in component that is run within the environment of AllFusion PM. An example of each type of client written in Visual Basic is provided. For more information regarding the AllFusion PM API, see the AllFusion PM API Reference Guide.

Whether you run the sample application as a standalone executable or as an add-in component, the functionality is the same. To run the sample application as a standalone executable, run PM_SCAPI_Sample_Exe.exe. To view the implementation as a standalone executable, load PM_SCAPI_Sample_Exe.vbp into Visual Basic. To run the sample application as an add-in component, you must install the add-in component first if you have not already installed it. From the Tools menu within AllFusion PM, select Add-Ins, and then API Sample. To view the implementation as an add-in component, load PM_SCAPI_AddinDLL.vbp into Visual Basic.

Model Selection

The first dialog box of the sample application allows you to select the AllFusion PM models to view or to output to a text file. If the sample application was invoked as an add-in component from within AllFusion PM, the models that are currently open are displayed by default. If the sample application was invoked as a standalone executable, the list of projects is empty at first. All the models listed are either displayed or written to a text file. The list of models can be modified by creating a new model, adding an existing model, or removing a model from the list. The functionality of this dialog is implemented in SelectProject.frm.

Choose any of the following to modify the list of models:

• Click on Add Project to add an existing model to the list.

• Click on Remove Selected Project to remove the selected model from the list. This only removes the selected model and does not delete it.

• Click on New Project to create a new project. Note that this project will not be saved unless it is explicitly saved in the Project View.

Choose any of the following to perform on the listed models:

• Click on View to display the Project View, which shows the models in a tree view.

• Click Output to File to export the data in the models to a text file.

• Click Cancel to exit from the sample application.

Project View

The Project View displays the contents of the selected models in a tree view. When an AllFusion PM object is selected in the tree view, its properties and property values are displayed. The functionality of this dialog is implemented in ProjectView.frm.

The Properties box displays the following information regarding each property:

• Name of property

• SCAPI property value type

• If the property is scalar or non-scalar

• Property values

The following functions can be performed on a model object by right-clicking the model object:

• Create new child. Select this item to create a new child for the selected model object. The pull right menu displays the valid children types for the selected object.

• Modify Object. Select this item to modify the property values of the selected model object.

• Delete Object. Select this item to delete the selected model object.

• Save Model. Select this item to save the model to which the object belongs. This saves all modifications to the .bp1 file.

The following function can be performed on an object type by right-clicking on the object type:

• Create New Object. Select this item to create a new object of the selected object type.

The Project View also demonstrates the filtering capabilities of the AllFusion PM API. The following options control what model objects to display or hide in the tree view and are listed under Object View Options:

• View all objects

• View only user-defined objects. View only objects such as UDPs.

• Hide user-defined objects. Hides objects such as UDPs.

The following options control the type of properties to display for the selected object. These options are listed under Property View Options:

• View all properties

• View only scalar properties

• View only non-scalar properties

To close the Project View, click Close.

Note: Any modifications made will not be saved unless the model is explicitly saved using the Save command on the pop-up menu for a model object.

Modifying an Object

A dialog displays when a model object is being created or modified by using the commands on the pop-up menu in the tree view. In this dialog, the property values of the object are displayed and can be modified. The functionality of this dialog is implemented in ModifyObject.frm.

In general, most of the properties can be directly modified in the text fields. However, there are some special cases such as deleting a property value or modifying the number of values for a non-scalar property when you use the Edit menu instead. The Edit menu provides the following functions:

• Reallocate Array. This menu item is only enabled if the selected property is non-scalar. Select this option to change the number of values for a non-scalar property.

• Delete. Select this option to delete the property. If the property is non-scalar, you are prompted to either delete just the single value that is selected or to delete all the property values.

Click OK to accept the changes.

Note: This will only display the changes in the Project View. The modifications will not be saved until the model is explicitly saved using the Save command on the pop-up menu for a model object.

Click Cancel to ignore the modifications.

9.0 International Support

An internationalized product is an English product that runs correctly on local language versions of the required operating system and required third-party products, and supports local language data for input and output. Internationalized products also support the ability to specify local language conventions for date, time, currency and number formats.

A translated product (sometimes referred to as a localized product) is an internationalized product that includes local language support for the product's user interface, online help and other documentation, as well as local language default settings for date, time, currency, and number formats.

In addition to the English release of this product, Computer Associates supports only those languages listed in the following table.

Language	Internationalized	Translated
Brazilian-Portuguese	Yes	No
Chinese (Simplified)	Yes	No
Chinese (Traditional)	Yes	No
Czech	Yes	No
Danish	Yes	No
Dutch	Yes	No
Finnish	Yes	No
French	Yes	No
German	Yes	No
Greek	Yes	No
Hungarian	Yes	No
Italian	Yes	No
Japanese	Yes	Yes
Korean	Yes	No
Norwegian	Yes	No
Polish	Yes	No
Russian	Yes	No
Spanish	Yes	No
Swedish	Yes	No
Turkish	Yes	No

Note: If you run the product in a language environment not listed in the table, you may experience problems.

10.0 Documentation

The file names for the PDF guides are as follows:

Guide Name	File Name
AllFusion Process Modeler API Reference Guide	PM_API_Ref.pdf
AllFusion Process Modeler Getting Started Guide	PM_GSG.pdf
AllFusion Process Modeler Methods Guide	PMMethods.pdf
AllFusion Process Modeler Release Summary	PM_RelSum.pdf

To view PDF files, you must download and install the Adobe Reader from the Adobe website if it is not already installed on your computer.

Updated guides will be available at http://ca.com/support.

11.0 Contact Customer Support

For online technical assistance and a complete list of locations, primary service hours, and telephone numbers, contact Customer Support at http://ca.com/support.