Contents
Terminology Changes
Old Term | New Term |
---|---|
Serena Business Mashups | Serena® Business Manager or SBM |
mashup | process app |
Mashup Server | SBM Server |
Configuration Utility | SBM Configurator |
Mashup Composer | SBM Composer |
Mashup Manager | SBM Application Administrator |
Mashup Administrator | SBM System Administrator |
Web interface | SBM User Workspace |
Mashup Repository | SBM Application Repository |
Mashup Script | SBM AppScript |
Mashup Registry | AppCentral™ |
Mashups API | SBM API |
mashup tool | event definition |
mashup event | event |
What's New
64-bit Support
Serena Business Manager is now supported on 64-bit versions of Windows 2008 R2 Server. Upgrade support for migrating existing 32-bit installations of SBM to 64-bit is handled through a new suite installation on one or more 64-bit Windows 2008 R2 servers. You can either perform a Custom installation that installs one or more SBM components on multiple 64-bit operating systems or you can perform a Complete installation, which installs every component on a single 64-bit server. You can continue to perform Remote Administration tasks or connect directly to the database via ODBC using 32-bit clients. Serena License Manager 2.1.5 is also supported on the 64-bit Windows 2008 Server platform.
You can use the SBM System Administrator that is installed by the suite installer on a 64-bit Windows 2008 R2 server to upgrade the SBM Application Engine database. As part of the upgrade, Serena recommends that you review and upgrade any scripts and APIs that were originally created on a 32-bit operating system to ensure that they also run on a 64-bit system. For example, if you have any SBM scripts that load .dll files, those dll files must be upgraded to run on a 64-bit machine.
Occasional User Product Access
Occasional User access allows the same set of privileges as the External User access type, but it also enables users to own items they submit, update items they own, and transition items they own. This access type is only available with the use of seat-based licenses.
Conditional Routing of Workflow Items
You can now use conditional routing to create application workflows that automatically route an item to a particular state based on visually designed rules. The rules are mapped to outgoing transitions from Decision steps in the workflow. The workflow evaluates the item data defined by the rules and determines which transition will be taken. One or more incoming transitions lead from a source state to a Decision step, and two or more outgoing transitions lead from the Decision step to their respective target states.
The values for the item data can be stored in application variables. Designers can change the value of any application variable, and all rules referencing that variable will use the new value.
New Report Types
The following report types are now available for end users in the SBM User Workspace:
- Drill-Through reports allow you to create a collection of reports that are linked together, meaning that you can have a high-level summary report and then 'drill-through' this high level report into the details. The 'drill-through' populates the linked reports with the data that you selected. For example, your high-level report could be a distribution of items based on severity, and your lower-level reports could be your distribution by developer and duration to close. This would allow you to select High severity items and see how the items are distributed among developers and how long the items take until they are closed.
- Elapsed Time reports help you to maintain and improve the service quality through a constant cycle of monitoring and reporting on the processes that are deployed within an organization. The elapsed time reports display the duration that items have remained in a state or a collection of states.
Rich Editable Grid
- Addition of two types of edit modes, Update Only and All Transitions edit mode. Update Only allows you modify items using the Update transition, similar to previous releases of the Edit Mode in Editable Grid. All Transitions mode allows you to submit and transition items.
- Ability to perform item actions, such as sending emails, adding notes, adding URLs, and attaching files (Update Only and All Transitions edit mode).
- Ability to transition items (All Transitions mode).
- Ability to submit new items (All Transitions mode).
- Ability to traverse through individual items when viewing them.
- Ability to move items between projects.
- Footer and search filter displayed in scrollable area below the results.
Custom Transition Controls
You can now add custom transition controls to a custom form. These controls can be used instead of or in addition to the standard transition buttons at the top of the form. Custom transition controls can be placed anywhere on the form, and their labels can be changed. The controls can be buttons, hyperlinks, or images. You can duplicate controls on other parts of a long form so users do not have to scroll to click the controls.
On a custom state form, you can use a single control for multiple transitions by using a "transition name" placeholder for the control label. The label changes to the name of the outgoing transition associated with the current state. The label also changes if the name of the transition in the application workflow changes.
Swimlanes
You can now add swimlanes to an application workflow. Swimlanes are a way to visually group states in a workflow, so others can quickly understand the workflow design. A swimlane typically represents either the activities performed by the same role or participant, or a distinct phase of the process defined by the workflow.
Relationships Bar
The new Relationships bar provides visibility into design elements, such as forms, that are used by an application workflow. Visual cues in the application workflow and the Relationships bar quickly demonstrate the relationship between the workflow and the design elements. If you need to modify a design element, you can open its editor and Property Editor from the Relationships bar.
SBM Application Engine Web Services API Enhancements
- The existing Web services has been split by functionality into two
separate WSDLs:
- sbmappservices72.wsdl – This WSDL contains methods for the typical application developer (including all of the methods that deal with SBM items).
- sbmadminservices72.wsdl – This WSDL contains administrative methods for tasks like project creation and retrieving user privileges.
- New Identifier elements have replaced the arguments and responses
that were previously used to identify various objects in
SBM.
The Identifiers combine generic identification information with one or more
elements to completely describe an
SBM
object. The following new Identifiers are available in both sets of Web
services:
- ApplicationIdentifier
- ContactIdentifier
- FieldIdentifier
- GroupIdentifier
- ItemIdentifier
- ProjectIdentifier
- ReportIdentifier
- SolutionIdentifier
- StateIdentifier
- TableIdentifier
- TransitionIdentifier
- UserIdentifier
- WorkflowIdentifier
- A significant number of Web service calls have been removed in favor of more flexible calls that provide the same functionality while providing more detailed response data. For example, CreatePrimaryItemWithName and CreatePrimaryItemsWithName have been removed in favor of a new verison of CreatePrimaryItems.
- All the UpdateItem calls (UpdateItem, UpdateItemWithName, UpdateItems, UpdateItemsWithName, UpdateItemsExtended) have been replaced by TransitionItem and TransitionItems, which let you perform all the same functions in addition to using any transition (not just the built-in Update transition).
- All Create, Get, and Transition multiple-item calls now feature a multiOption argument that enables you to specify if the service should stop on failure or return an error message and continue processing (with error messages interspersed throughout the response).
- All Create, Get, and Transition item calls now feature a LimitedField argument that enables you to reduce the return data based on one or more fields that you specify. Instead of returning the entire TTItem, you can have the service only return the fields that you list.
- New administrative services that enable you to add, update, and delete users and groups have been added. The following calls are now available: CreateUsers, GetUsers, UpdateUsers, CreateGroups, GetGroups, UpdateGroups.
For detailed information about all of the calls, arguments, and responses available in SBM Web services version 7.2, see the Serena® Business Manager Web Services Developer's Guide.
Enhanced Auto-Logout Timed-Out Users Feature
Improved Notification Server Performance
SBM Application Engine Notification Server performance has been improved. For example, e-mail messages are now processed more quickly by the Notification Server.
Supported Configurations
Detailed information about supported platforms and software configuration is available in the Supported Platform Matrix.
Server Operating Systems
The following operating systems are now supported:
- Windows Server 2008 R2 Enterprise Edition (64-bit)
Client Operating Systems
The following operating systems are now supported for SBM Composer and the SBM User Workspace.
- Windows 7 (64-bit)
Database Management Systems
The following database management systems are now supported:
- Microsoft SQL Server 2008 R2
- Oracle 11.1.0.7
- Oracle 11.2.0.x
Database Client Connectors
Oracle ODBC connections that use the Oracle driver are no longer supported.
For Oracle systems, you must connect to the SBM Application Engine database using either the Mashup2009 DSN that is installed with SBM or a system DSN that uses the "Oracle for SBM" driver that is installed with SBM. The "Oracle for SBM" driver is now the only supported Oracle driver for SBM Application Engine database connections.
Web Browser
- Mozilla Firefox 3.6.x (Older versions are no longer supported.)
Serena License Manager
Serena License Manager 2.1.5 is now supported.
Web Services
SBM Web services version 7.2 is now supported. The latest application Web service calls can be found in the sbmappservices72 WSDL. The latest administrative Web service calls can be found in the sbmadminservices72 WSDL. All TeamTrack Web services and earlier SBM Web services (including ttwebservices, aewebservices70, and aewebservices71) are still compatible with this release. However, these WSDLs have been deprecated and will not contain any of the new calls or parameters found in SBM Web services version 7.2. For new Web service implementations, use SBM Web services version 7.2.
Additional Changes
The following sections describe additional features that have been added to Serena Business Manager 2009 R4.
Installation and Configuration Changes
- Microsoft .NET Framework 3.5.1 is now required instead of .NET 3.5 on all server and client machines. If it is not detected, .Net Framework 3.5.1 is installed by SBM (except on Windows 2008 R2 servers, which require manual installation). To save download and installation time, you may want to install version 3.5.1 prior to running the SBM installer. Also, if you will not have Internet access during the installation, you should download and install 3.5.1 beforehand.
- Server settings for the SBM Application Engine Notification Server and Mail Client can now be configured using the SBM Configurator.
- The SBM Configurator now features a Collect Log Files button that gathers and saves important log files in a .zip file for troubleshooting purposes. The logs that are gathered can be used by Serena Customer Support for troubleshooting problems in SBM. For a list of the log files that are gathered, see solution S138027.
- SBM Configurator now enables you to establish Secure Sockets Layer (SSL) for IIS and JBoss connections. This secures end-user connections into SBM as long as the request is sent using HTTPS. To configure these SSL settings, run SBM Configurator in utility mode and select Security from the Advanced Settings menu. (The Single Sign-On (SSO) tab has been renamed to Security). In the SSL sub-tab, you can generate, import, or remove SSL certificates for the IIS and JBoss components that are installed on the server.
SBM User Workspace Changes
-
Additional options have been added to the Display Options under the user's profile. These include:
- Show Confirmation Alerts when exiting forms
- Restore Saved Form Data
- Show Legend
- Show Focus Helper
- Default to 'All Transitions' Mode
- Confirm Quick Transitions
- The Export to Excel functionality has been enhanced to better handle report formatting and field formats. For example, date fields are now imported into Microsoft Excel as dates. The data is now passed using XML.
- On Submit, the project selection screen is now bypassed when users have a single project. When users only have one preferred project in an application or their application only has one project, clicking the Submit link on the navigation pane will take them directly to the Submit form for that project. The project selection screen is now bypassed.
- The functionality to save a submit form as a favorite has been enhanced to eliminate some inconsistencies in behavior of the favorite URLs themselves (differences in how they were invoked and saved) and the save/restore of the values (differences between Web browsers and data types).
- Advanced distribution reports have been enhanced to allow graphical outputs.
- A new System Report enables you to track administrative changes to user accounts. The Users Change History report shows when user accounts have been created, modified, deleted, undeleted, disabled, or enabled. The name of the administrator who made the change and the date and time of the change are also provided. Only changes made since the upgrade to version 2009 R4 are available.
- The SourceBridge installer and documentation have been removed from the Product Information tab in the SBM User Workspace. You can download SourceBridge from http://www.serena.com/support, however, and make it available to users as needed.
- External users now appear as potential selections in the To: field when you send an e-mail from an item in the SBM User Workspace.
- Application icons now appear in the SBM User Workspace. These are defined for applications in SBM Composer, and they appear on the application tabs and on the start page for each application.
-
Many user preferences are now stored in the database instead of as cookies. These include the expansion of the navigation panel, using an accessible interface, and the number of tabs to display.
SBM Composer Changes
- In the application editor, you can associate an image with an application. The image will appear on the application tab in the SBM User Workspace.
-
The
Workflow Palette now has the following
sections:
- Common Items contains the following objects: Swimlane, State, Decision, Transition, and Annotation.
- States contains the following state types: Active, Completed, Rejected, and Pending. The latter three states are "inactive" states. Their titles represent common inactive states, but can be changed. The Active state type is identical to the State object in the Common Items section.
- Transitions contains transition types. The Quick transition type is new, and is configured to not show a form to users. The Regular transition type is identical to the Transition object in the Common Items section.
-
There are new keyboard shortcuts that let you
navigate through the user interface without using the mouse. A new
Find dialog box supports searching for items
without using the mouse. The name of the previous
Find dialog box is now
Find Items.
Note: The "Shortcut Keys" topic in the SBM Composer Guide and online Help lists the keyboard shortcuts. There is also a link to this topic from the Composer Start Page.
- You can double-click a state in the Workflow Palette to add it to a workflow. The state is added to the right of a selected state, on the right side of a selected transition, or to the center of the workflow editor if no state or transition is selected. For most transitions, the transition is placed between the two most recently selected states, and points from the first state that was selected to the second state.
- The AddRadioCallback event method is now included in the SBM Javascript Library. This method is called when a user clicks a radio button in the SBM User Workspace.
- The Twitter widget is no longer supported, and was removed from the Form Palette.
- The system Deleted state can no longer be a destination state for Regular transitions.
Application Administrator Changes
- The Bookmarks view has been removed.
- A new tab in the Common Log view enables you to select the environment for which you want to view messages. If you have multiple environments, point the Common Log for each environment to a unique database. This ensures that Common Log messages you see are specific to each environment.
SBM Application Engine Changes
- For Oracle systems, you must connect to the database using either the Mashup2009 DSN that is installed with SBM or a system DSN that uses the "Oracle for SBM" driver that is installed with SBM. If you attempt to use a DSN other than the Mashup2009 DSN provided by SBM, the SBM System Administrator prompts you to either use the Mashup2009 DSN or to modify or create a DSN that uses the "Oracle for SBM" driver. The "Oracle for SBM" driver is now the only supported driver for Oracle database connections from SBM System Administrator.
- Administrative logging is now enabled by default. To support this change, the Enable Database Logging check box has been removed from the Database tab of the Settings dialog box in SBM System Administrator.
Orchestration Changes
- On the Data Mapping tab in the Property Editor for orchestration workflows or Service steps, icons for data elements that cannot be changed now have a small lock icon on them. Previously, these icons were displayed in gray. You cannot rename, change type, or change child data elements for data elements that come from a Web service.
Miscellaneous Changes
- The sso_endorser user account has been deprecated. This account is no longer used by the Single Sign-On engine to endorse a user ID that does not have an associated password. Instead, these user accounts are now endorsed automatically by way of certificates that are presented to the STS (Security Token Server) with each authentication call. For new installations, this account is no longer automatically added to your database nor is it included in the sample database. On upgrade, this account is not removed from the database; however, you can delete the sso_endorser user account yourself if you do not use it.
-
The jakarta virtual directory name has been changed to sbmconnector. The virtual directory name was changed to avoid naming conflicts that occur when SBM and Version Manager are installed on the same server.
- The internal name for the Serena Common JBoss service is now "SERENAJBOSSSVC." This affects scripts running tools that require the internal name (for example, SC.exe).
Web Services Changes
- Several improvements have been made to the SBM Application Engine Web Services API in this release. See What's New for more information.
Licensing Changes
- Seat licenses, which determine the number of users that can be active in a SBM system, are now available for External User, Occasional User, Regular User, and Managed Administrator product access types. Seat licenses ease administration because you do not need to assign a license to each individual user, as you must with named licenses. This new licensing model is available for both new and upgrading customers. Also note that this new licensing model does not apply to other Serena products, such as PVCS Version Manager or Dimensions CM. For details on seat licensing, refer to the Serena® Business Manager Installation and Configuration Guide.
- An "auto add" feature is available for systems that use LDAP authentication and seat licenses. When a new user attempts to log in for the first time, SBM will query your LDAP directory and attempt to authenticate the user. If authentication succeeds, the user will be granted a seat license, added to SBM, and allowed to log in. Any LDAP groups this user belongs to can optionally be created in SBM at this time as well. This feature is only enabled with the use of seat-based licenses. For more information, see the "Managing User Accounts via LDAP" section of the SBM System Administrator Guide.
- Concurrent license timeout is now fixed at 60 minutes, and the option to administer this value has been removed. License timeout is now standardized for all customers to the default value that was shipped with previous releases. In addition, concurrent licenses for users who click Exit to log out of the system are now released at 5-minute intervals.
Documentation Changes
- When users click the main help icon on the SBM User Workspace toolbar, the help system now opens to a page that provides guidance for common tasks, such as submitting and searching for items.
- A "What's New" section has been added to the SBM Composer Guide and help system. This section provides a description of new features added to SBM Composer.
Issues Fixed in Version 2009 R4
A list of defects fixed in this release can be found in the Knowledgebase at serena.com.