Release Notes (Version 1.5) Skelta BPM.NET 2007 (Service Pack 1)

Transcription

1 (Version 1.5) Skelta BPM.NET 2007 (Service Pack 1) Version: Date: May 08 th, 2008

2 Table of Contents OVERVIEW... 3 Introduction... 3 RELEASE SUMMARY... 3 Enhancements in this release... 3 Issues fixed in this release... 9 This release does not support the following Known Issues Solutions for Better Usage Skelta Software

3 Overview Introduction This document provides what s new information for the release of the Skelta BPM.NET 2007 product. Release summary Product: Skelta BPM.NET 2007 Version: < > Date: May 08 th, 2008 Enhancements in this release This release of Skelta BPM.NET 2007 includes the following enhancements: Skelta engine auto recovery mechanism for FE and EP workflows: Resuming Execution Pending (EP): Resuming EP Workflow instances by the engine for every one hour without restarting the engine. Every one hour engine will check the workflow instances that are in EP status and will try to resume those workflows. Note: Every one hour Engine will try to resume only 20 Execution pending workflows. Resuming Finished with Error (FE): Resuming FE Workflow instances by the engine for every three Hours. Engine will try resuming for three times and if still the workflow instance is in FE, then an will be sent to the admin. The resuming will be tried thrice on the same workflow instance, so the Workflow can be further processed. Note: Only 5 workflow instances that are in FE status will be resumed for every three Hours. The workflow instances that have finished with errors are updated in the SWFECount table (New table added in this patch), while trying to resume these workflows. The users can keep a track on the FE workflows from this table. Note: A new property Last Updated Datetime has been added in Skelta Engine Settings in farm configuration wizard. Engine will resume only those workflows which are executed after the specified Last Updated Datetime. Localization changes: New locale keys have been added in this build. These locale keys are defined in new files. The new file names are NewKeysBPM.txt and NewkeysSharePoint.txt. Queue system variable: New system variable for assigning queues to Human Activities instead of setting the queue through Assign Queue property. The variable should be declared as "^"+ CurrentActivity.Name + "_QueueVariable". Example: If the activity name is Approval1 then declare the variable as ^Approval1_QueueVariable in the Start activity with the Type as String. Using the Update Variable activity, assign the queue-id (GUID) for this variable in the workflow. To assign multiple queues, specify the queue-ids with semicolon (;) Skelta Software

4 separator. Skelta.HWS.Queue.QueueCollection class can be used to retrieve queue information. Wrong: Correct: Change in adding Workitem list control: Load the Workitem list control through Panel, instead of dragging it directly on an aspx page. The code for adding the Workitemlist control to the panel should be done at the Page Oninit() method rather than the Page Onload() method. protected void Page_Load(object sender, EventArgs e) { Skelta.HWS.WorkListChannel.Web.WorkItemListControl.WorkItem Control wictrl = new Skelta.HWS.WorkListChannel.Web.WorkItemListControl.WorkItem Control(); wictrl.applicationname = "Skelta3"; wictrl.useridstring= "activedirectory::bob"; wictrl.id = "workitemcontrol"; panel1.controls.add(wictrl); } protected override void OnInit(EventArgs e) { Skelta.HWS.WorkListChannel.Web.WorkItemListControl.WorkItem Control wictrl = new Skelta.HWS.WorkListChannel.Web.WorkItemListControl.WorkItem Control(); wictrl.applicationname = "Skelta3"; wictrl.useridstring= "activedirectory::bob"; wictrl.id = "workitemcontrol"; panel1.controls.add(wictrl); } Intersoft grid assembly dlls updated: The Intersoft grid assembly dlls have been upgraded because of component issues listed below: Sorting in Saved Layout. Grouping in Saved Layout. After doing Best Fit, sorting the header is not displayed correctly. Whenever a grid refresh is done there is a filter problem. User id property has been added to Worklist Layout control: Worklist Layout control can be used to define Global Layout and Workflow Layout at the actor level using this property. The layout for a workflow or for an application can be saved at the actor level by dragging the Worklist Layout control in an aspx page and setting the User id property. Setting at actor level Workflow Layout: <cc1:worklistlayoutcontrol ID="WorkListLayoutControl1" ApplicationName="Default" WorkflowName="Default" UserIdString="activedirectory::bob" runat="server" /> Skelta Software

5 Setting at actor level Global Layout: <cc1:worklistlayoutcontrol ID="WorkListLayoutControl1" ApplicationName="Default" GlobalLayout="true" UserIdString "activedirectory::bob" runat="server" /> Decimal type included in Work Item Fields: An option to create a Decimal type Work Item Field, like Price (10.50). WorkItemCollection API for completed Workitems for an actor: This API provides history of Workitem acted by an actor. All tasks except the open ones (Awaiting, Acknowledged and Hold) will be returned by this API. Example: Skelta.Core.ApplicationObject app = new Skelta.Core.ApplicationObject("Skelta Training"); Skelta.HWS.Actor actor = new Skelta.HWS.Actor(app, new Guid("C99B4110-C8CC-410B-BF70-93F3A7E34EDF")); Skelta.HWS.WorkItemCollection wcollection = new Skelta.HWS.WorkItemCollection(app, actor); System.Data.DataSet dataset = wcollection.getrecords(); This API can also be used to set custom filter on the tables used in the query. The tables used and alias name provided are SWExecute SWE, SKHWSActivity SKHWS, SKWorkItem SKW, SKVirtualActor SKV, SKWorkItemData SKWD, and SKWorkItemFields SKWF. Example: System.Data.DataSet datasetforexecutionid = wcollection.getmatchingrecords(" AND SWE.Id = 0", null); Workitem control layouts: A new property ShowFilterBarAlways has been added in Workitem control. This property can be set for displaying or hiding filter bar. ExecutionContext information when QueryEntity method on DataSourceProvider is Called: Providing the executing context information when QueryEntity() method is called. Runtime execution context information can be retrieved by using the below API EntityExecutionContextInfo.Skelta.Entity.EntityExecutionContextIn fo objentityexecutioncontextinfo = Skelta.Entity.EntityExecutionContext.GetEntityExecutionContext(); This information gets filled from the engine before the method object[] QueryEntityItem(string filter, string query, string fullyprocessedquery, object[] dataparams) in IEntityDataSourceProvider interface is called. Change in Log file naming convention: Log file naming convention has been changed to pad char 0, if the month or day is single digit (<10). This will avoid the confusion with older naming convention for Jan 11 and Nov 1 dates. Activation & Deactivation of User Pack License: This version supports user based license. Activation of user based license can be done from command prompt. Below are the steps. 1. Activating the license for user pack Skelta Software

6 2. Licensemanager.net2 /Serial:<serialKey> /App:<AppCode> <Enter> (CMD:3) Licensemanager.Net2 /App:<AppCode> (CMD:2) 3. Deactivating the license for user pack: Licensemanager.Net2 /Serial:<SerialKey> /Deactivate /App:<AppCode> (CMD:3) It is also possible to change the user status (Active/Inactive) from Central Config site to manage consumed user license keys. User Property synchronizing: A new option in Central Config site to synchronize the user properties with the data source provider (Manual /Scheduled). Resume/ Aborted/Paused Actor Info in the Graphical Execution View: When a workflow instance is aborted by an actor, the actor details get displayed in the Graphical Execution view. Scenarios in which abort is done programmatically, the user context will be blank. Custom Branding: An option to customize images and contents in Skelta Farm Wizard, License Manager. To change background images in Skelta Farm requires a new registry at HKEY_LOCAL_MACHINE\SOFTWARE\ Step 1: Add a new Key SkeltaSilentInstallation Step 2: Within SkeltaSilentInstallation add three new String Values 1. ConfigPopUpWizardImage 2. ConfigWizardSmallImage 3. ConfigWizardImage To change background images in Activation and Deactivation screen, add a new registry at HKEY_LOCAL_MACHINE\SOFTWARE\ Step 1: Add a new Key SkeltaSilentInstallation Step 2: Within SkeltaSilentInstallation add 2 New- String Values 1. ImagePath 2. ProductNamePath For more details refer Building custom installer for Skelta BPM.NET 2007 section in the SkeltaBPMNET2007DeveloperGuide.chm Skelta Software

7 List of modified files: The following table lists files that have been modified in this release: Modified file (s) EXEs DLLs NotfnEng.NET2.exe WFEngine.NET2.exe TaskSked.NET2.exe All DLLs are updated. BPMUITemplates BPMUITemplates\Default\WorkItemList\JavaScripts\WorkItemControlJs.js BPMUITemplates\Default\WorkItemList\UserControls\WorkItemControl.ascx Reason for change: Added two functions EnableGroupCheckBox() and DisableGroupCheckBox(). Modified EnablecheckGroupUI() function in workitemcontroljs.js and added client side events for oncolumngroup and oncolumnungroup in the workitemcontrol.ascx for hiding and showing the Selectallwithingroup checkbox on the selection of multi select. BPMUITemplates\Default\Common\StyleSheet\global.css Reason for change: Changes made in the workitemcontrol.ascx for stylesheets and added the stylesheet class WLHeader and WLTable in global.css. BPMUITemplates\Default\WorkitemList\Workitemdetailview.aspx Reason for change: Javascript change in Workitemdetailview page. Skelta Software

8 New images has been added Inbox,Queue Actions.xml BPMUITemplates\Default\WorkitemList\Images Reason for change: In the folder, new images have been added for the Workitem control. Images will be different for each view of and Manager View in the Workitem control. New images for Workflow View.gif, Queue View.gif and Manager View.gif have been added. Updated choice property with DispalyName:Value format for all the properties. Changed description for For Loop activity from For Next Loop to For-Loop. Changed description for ForEach-Loop activity from For Next Loop to ForEach-Loop. Changed the text Day:Hours:Minutes in helpstring attribute to Day.Hours.Minutes for timespan property for all the properties. Added a new tag for wizards <Wizards> </Wizards> SharePointActions.xml Updated choice property with DispalyName:Value format for all the properties. Changed the activity description for List Operations and Move Copy Item activity. List Operations Description: Enables operations to be performed on the List Items of a SharePoint site's list. Move Copy Item Description: To Move or Copy an Item across physical location and SharePoint library/list. DB Scripts DatabaseScripts\SQLServer\Workflow.NET.sql (SQL Server) DatabaseScripts\Oracle\Workflow.NET.sql (Oracle) DatabaseScripst\SQLServer\FarmScripts.sql (SQL Server) DatabaseScripst\Oracle\FarmScripts.sql (Oracle) You can find these updated scripts in the instruction document. Skelta Software

9 Issues fixed in this release The following issues have been taken care in this release of Skelta BPM.NET 2007 product: Decision Activity And Operator: The decision activity has condition AND but the operator was behaving like an OR operator at run time (Workflow Execution). Decision Activity Publishing: The decision activity having multiples of four routing conditions fails while deploying. Decision Activity: The decision activity fails to check conditions with large numbers like Invoke WebService Activity: New validation has been added for secured Web Services to provide user credentials. While importing Web Service by using Import/Export option in Process Designer, the Web Service mapping/setting are not getting retained. While trying to make a Web Service call, the result value is not storing into a string variable. WorkItem Inbox: If the filter is used on a Workitem loaded with more than 4000 tasks a java script error is thrown on refreshing the grid. Loading the script activity references: The script activity fails if the custom dll is called. Calling custom dll from script activity requires the folder path of custom dlls to be shadow copied. The property Custom Application Folder at repository level can be used for setting the dll folder path (if it is not exists in Skelta bin) from Central Configuration site. This property is available while adding or editing repositories. Exceptional Mail: The exception mail body has been formatted for better readability. Adding roles in ASP.NET membership provider: If provider is ASP.NET membership then the Role configuration doesn't work. Add Roles" button in Queue settings Returns null if the ASP.NET application name is different from Repository name. Validation for exceeding WorkItemfield count: If the Work Item Field count increases certain limit then the values are replaced by NULL. SelectAllwithinGroup checkbox while enabling multi select: The checkbox SelectAllwithinGroup is not displayed automatically, when multi select is enabled. This checkbox will get displayed only when grouping is done on the grid after enabling multi select. Checklist questions order: The Checklist questions are not getting displayed in the order they are added. Skelta Software

10 Validation for creation of new instance for disabled Workflow: Workflow instance creation for disabled Workflows is not allowed. SharePoint related issues: 1. Drop down is not enabled in Launch Skelta Workflow option provided in SharePoint site settings. 2. Creation of list with special characters is not allowed. 3. Unmapping of across providers in SharePoint central admin for a SharePoint site was not working. 4. SharePoint explorer shows error page, while selecting a list name with special characters. Wizards related issues: 1. If user selects any font-style, html tag gets displayed in subject and body property. 2. If user selects any font-style in Escalation page, html tag gets displayed in subject and body property. 3. If user selects any font-style in Reminder page, html tag gets displayed in subject and body property. 4. Special character single quote (') is not allowed in Editor Window. Actor selection filter in ResourceSet (Human Activity): The property "Actor Selection Filter" is set as a mandatory field. ASPNET member login in EC: User authentication fails if the user is not part of the Role. Workflow for the moved Item/Document fails: An error occurs occasionally for the Workflows associated with item added event whenever an item is moved to a list or a library. Displaying default activities under Other Actions category: Process Designer does not display activity, if the custom activity is added without category name tag in a separate xml file in the same folder as Actions.XML [WorkflowElements\Default\en- US\Actions\XML]. Format exception while alerting a Workflow on item delete event: Getting format exception, while alerting a Workflow which is associated to item deleting event using WaitForSharePoint event activity. Value does not Fall error while saving a Skelta event association:an error Value does not fall occurred whenever an association in site template is saved. This happened after a SharePoint list is deleted that had event association. Error in multiple event association: Removing the first event association of a workflow which is associated to multiple events removes all associations (event does not get triggered). Reconnecting a SharePoint site to a Repository fails: Reconnecting a SharePoint site which is already connected to a Repository causes Repository mapping mismatch. Launch Skelta Workflow association page: An error while clicking on the bread crumb from Launch Skelta Workflow Association page. Selected SharePoint explorer values are appended multiple times in Workflow memo property: Odd behavior while selecting the values from SharePoint explorer. Skelta Software

11 Vertical scrollbar not available for Workflow dropdown list in launch Skelta Workflow association page: In dropdown list, vertical scrollbar is not provided for Launch Skelta Workflow association page. No mandatory property for "BlockingOutput" activity: For BlockingOutput, mandatory property is provided and also Help File is provided. No option to start a Wizard from Integration/Engine/Scheduler activities: Provided "Start a Wizard Option in context menu for Integration/ Engine/ Scheduler / Communication Activities. Not able to save the Wizard as template if contains special character: Wizards are not getting saved as template if the content has special characters. Error page is displayed when a Workflow name is entered manually which is not in the lookup from the Launch Skelta Workflow association page: Validation if invalid workflow name is entered. Tree view does not get loaded in summary page for wizards: Provided a tool tip in the summary Page for all wizards. Adding additional AD attribute for Skelta: There was no option to add additional resource attribute from Skelta Central Config modify repository screens. The definitionxml of SKEntity table and SKEntityDataSourceProvider can now be edited directly from Repository-Provider List. Information activity s Not Enough Resources to Acknowledge output fails: Information activity fails to give Not Enough Resources to Acknowledge output even if the assigned resources are not available. Error displayed while restoring the event association from a site template: An error is displayed when restoring the event association from a site template for SharePoint lists or libraries which contains special characters. SharePoint- If a Queue user is deleted from SP Site, option to open the existing Queue fails: SharePoint manager issue: Assigning the task for the SharePoint user's manager fails. Setting of alternate actor from the Process Designer control: Unable to set the alternate actor from the Process Designer control. Custom document view: Custom document view fails to load even after adding the details in the skaddinprovider table. MoveCopy - support for special character for List name: If List name or Library name contains special character, the MoveCopy activity fails. If existing List or Library name is changed the MoveCopy activity fails. SharePoint provider - support for multiple SP group: To assign activity for more than one SharePoint Group users, use IN operator with group names. To assign multiple SharePoint group users, specify Group names with comma separated. In To Property, to search for multiple groups use IN operator. For Example: SP Group IN group1, group2. Skelta Software

12 This release does not support the following Items not supported in this release of Skelta BPM.NET 2007 product: Known Issues Repository name cannot be edited or provider cannot be changed. This has to be done directly in Database server if required. Repository name should not be set as Default. A repository configured using multiple providers. While editing the repository, this won t display both the provider details in the edit repository. Only one provider gets displayed in the drop down. Resource Set and InfoPath Human Activity is not supported for Mail Channel. Undo option in tool bar in the Process Designer doesn t retain the properties set by the user and it would only retain the structure of an activity from where the activity was deleted. Characters not supported for workflow name in EC are (#,~,&,+,\,",',<,>, ) Check List Activity does not support special characters, while using the mail channel module. Characters allowed in Variable name are (^_-). Characters not supported for Activity Output Property are (* ). Characters not supported for SharePoint Document Library name and List Name are (\ ~ # $). Site Columns (all data types) in SharePoint does not support (<> - ->). To Property for (Variable.SubmittedBy.SPGroup) is null for SharePoint Users. The following are the known issues in this release of Skelta BPM.NET 2007 product: InfoPath Task activity that is displayed in the Workitem doesn t have Take Ownership drop down and Body. The error outputs are not available for InfoPath task activity, if invalid data specified, while configuring SharePoint details like Site URL, List Name, and List Item Name. Validation for User Base License before: All user pack licenses should be deactivated manually (using LicenseManagerNet2) before the product is uninstalled from the machine. The Update Parent Variable action property cannot be set after localization. When a file is moved from a physical location to a folder in the document library that contains special characters, the action output Folder not found occurs on the workflow execution. While moving a list to Document Library which contains special characters an output Destination List Not found occurs on the workflow execution. In Create List Activity, newly created lists are not displayed in the Quick Launch Bar, if Inherit Template properties is set as Yes. Create List and Update List SharePoint Actions Content types are not getting added for template in Document Library. Workitem Control Layouts: The order of Left grid menu in the Workitem list gets changed depending on saving of layouts. Suppose, if the queue layout is saved first and then the layout for Inbox is saved. The Queues will appear first and then Inbox will follow after that in the tree structure of Workitem. Skelta Software

13 Solutions for Better Usage Adding Workitem fields in the Process Designer has a predefined validation. String Type- 18 Decimal Type-10 DateTime Type-9 Number Type-10 Note: To overcomethe above validations, do the following changes manually. Do the following steps manually to increase the count: In your Datasource DB, open skworkitemfieldtypecounts table which stores column count for each data type. The count for each data type can be varied in the column ColumnCount of this table. If you want to increase the number of columns you have to increase the number of count here. Based on this skworkitemfieldtypecounts table, mappingfield gets filled in skworkitemfieldsdefinition table. Now add the corresponding new columns in the Skworkitemfields table. For example, If the count of datetime is increased by two then two extra columns (datetime10, datetime11) have to be added in the Skworkitemfields table. Now the work item fields should be set from the process designer. If the fields were already set before modifications then reset it again. Skelta Software