K2 November 2008 User Groups

Hey – there are two user groups for K2 and both are having meeting on Nov. 11. Both seem really interesting and you can attend virtually if you like.

• Project Server Automation – very interested to see what can be done here…
• Event Bus by the infamous Anthony Petro!

Also note that if you miss these, Chris Geier has been posting past user group presentations.

Denver K2 User group Home and Greater Texas User Group Home

The SmartObject intro I gave last month is posted on the Denver's User Group site.

Microsoft Project Server Automation Presentation

Many companies use Microsoft Project Server to assist in the management of complex projects of all sorts. However, often these complex projects need to follow customer specific processes around project creation, issue and risk management that Project Server doesn't provide out of the box. Using a Business Process Management suite such as K2 BlackPearl, customer project management processes can be automated so that the project owners and project managers can ensure that the correct policies are enforced and are auditable. Join this presentation to see how K2 BlackPearl was extended through its SmartObject technology to allow integration with Project Server 2007 and see demonstrations of how customers might use this type of integration.

Tim Knechtel has been with K2 for 4 years as a Technical Specialist working with customers and partners to help automate their business processes. Prior to working for K2 Tim worked at Microsoft for 9 years as a Technical Specialist focusing on Project Server, SharePoint and Exchange. With over 15 years of industry experience as a infrastructure specialist and software developer Tim enjoys getting software to work as the users would expect it to. In his free time Tim enjoys spending time with his family, playing hockey and running.

Meeting Agenda:
11-11:15 Networking/Refreshments
11:15-11:30 Announcements/Intros of New people
11:30-11:45 Tips & Tricks
11:45-12:45 Technical Presentation
12:45-1:00 Meeting Wrapup

For Virtual Attendees:

Note: please keep your phone on mute until you are ready to speak.

Audio Information

Telephone conferencing
Choose one of the following:

• Start Live Meeting client, and then in Voice & Video pane under Join Audio options, click Call Me. The conferencing service will call you at the number you specify. (Recommended)
  
• Use the information below to connect:
  Toll-free: +1 (888) 296-6500
  

  Toll: +1 (913) 227-1219
  

  Participant code: 224648
  

First Time Users:

To save time before the meeting, check your system to make sure it is ready to use Microsoft Office Live Meeting.
Troubleshooting
Unable to join the meeting? Follow these steps:

1. Copy this address and paste it into your web browser:
   https://www.livemeeting.com/cc/scna/join?id=72G7CQ&role=attend&pw=W6M%23pHJ
   
2. Copy and paste the required information:
   Meeting ID: 72G7CQ
   
   Entry Code: W6M#pHJ
   
   Location: https://www119.livemeeting.com/cc/scna
   
   

Event Bus Presentation

This month, Anthony Petro will present an introduction to the K2 Event Bus. The K2 Event Bus provides the infrastructure and tools to allow business users to model notifications and custom actions based on events in K2 workflow processes, SmartObjects, line- of- business (LOB) systems, and single or recurring schedules. The events are configured to evaluate and execute policies independent of the context of a workflow process or LOB system activity, such as a SmartObject Create method. The policies can range from simple e-mail notifications configured in the K2 Workspace to fully customized .NET code.

Anthony Petro is the Technical Product Manager for K2. He started his professional career in the consulting world 14 years ago and has always remained focused on Microsoft technologies and solutions. He joined Microsoft in 2001 and spent the next 5 years heavily immersed in SharePoint Joint Development Programs bridging the gap between the product development teams in Redmond and the enterprise customers around the world. He was a strong contributor to the SharePoint community in its infancy focused on teaching the masses about the complexities of search and enterprise scale and using products such as K2 filling the enterprise workflow gaps of SharePoint. He joined K2 in 2006 to help bring K2 blackpearl to market through early adopter programs that spanned the alpha and beta cycles through to RTM. Anthony remains actively involved in early adopter programs for K2 blackpoint and K2 connect and planning the future releases of all product lines.

Agenda:

6:00 - 6:15 Networking/Refreshments

6:15 - 6:30 Announcements

6:30 - 7:45 Presentation by Anthony Petro from K2

7:45 - 8:00 Meeting Wrap-up

Start Time:	Tuesday, Nov 11, 2008 6:00 PM MDT
End Time:	Tuesday, Nov 11, 2008 8:00 PM MDT
Occurrence:	Recurring meeting
Meeting Lobby:	Not enabled
Attendee URL:	https://www.livemeeting.com/cc/scna/join?id=CK6G4W&role=attend&pw=F59%3EKcr
Meeting ID:	CK6G4W
Attendee Entry Code:	F59>Kcr
Location:
Audio:	Two way computer audio conferencing: Off One way computer audio broadcasting: Off Telephone conferencing: On Audio conferencing provider: Other Toll free: +1 (913) 227-1219 Participant code: 994729

K2 blackpearl 0807 Update Installer

I received word that a bunch of new updates are now available for the 0807 build…

--------------------

We have release the Update Installer (KB000320 - K2 blackpearl 0807 Update (4.8210.2.320)) and is available on the Customer Portal for download. This Update will include all patches (hence forth known as Hotfixes) to date for K2 blackpearl 0807 and can be used to update on ANY version of K2 blackpearl 0807.

This first Update Installer contains the following fixes (documented in the corresponding Knowledge Base Articles):

• KB000320 - K2 blackpearl 0807 Update (4.8210.2.320)
  
• KB000301 - Patch: Error opening Document View enabled process
  
• KB000302 - Patch: Error in Reports from Process Overview
  
• KB000303 - Patch: Exception when an InfoPath form calls a SmartObject's load method
  
• KB000304 - Patch: Active Directory Query Locks Server and Returns No Results
  
• KB000305 - Patch: InfoPath form opens in IP instead of Forms Services
  
• KB000311 - Patch: Out of Office Search Screen Error
  
• KB000312 - Patch: Special Characters Error in User Search in K2 Designer for Visual Studio
  
• KB000313 - Patch: Using InfoPath with Form Services causes an error
  
• KB000316 - Patch: Error occurs on SmartObject properties of DateTime type when set as return property
  
• KB000317 - Patch: Valid SharePoint Site URL not accepted in the SharePoint Events Process Wizard
  
• KB000321 - Hotfix: K2 Tasklist disturbs the page layout for the K2 Web Part
  

Deploy InfoPath as a Feature

12/11/2009 - Update for Managed Code.

1.0 Introduction
For some time now I have been pretty unhappy with InfoPath deployment. I really did not know of a way to deploy InfoPath forms other than publishing them using the InfoPath Designer. I was even more frustrated with having to go to SharePoint Central Administration to deploy a form when I had to give the form Full Trust. Sometimes I had to give Full Trust to InfoPath sometimes for making data connections. As well, I would purposely avoid adding managed code at all cost to my InfoPath forms (still if I have to put in managed code into my InfoPath form, I should use ASP.net - InfoPath and ASP.net considerations).

Well someone made a comment to my blog which showed me the light – YES you can deploy an InfoPath form as a Feature. Awesome! Totally Awesome! Some may say this is old news, but I really just wanted to share the knowledge on this one.

I am excited about deploying InfoPath as a Feature for the following reasons:

• The InfoPath form will be deployed as a content type. I have many scenarios where I have to publish an InfoPath form to many form libraries. For instance I have business process where the InfoPath form will be initiated in one Form Library and archived in a different one. Now I do not have to go to each form library and redeploy. Since it is a content type that will be added to a Form Library, when I redeploy the form with updates, all of the form libraries are updated.
• The form gets installed into Central Admin requiring me less clicking and less steps.
• I can now automate the deployment of my InfoPath forms and package them up in .wsp!!! That is really where I wanted to get to.

2.0 Feature
Getting to the fun stuff first, the following is a feature that will deploy your InfoPath form for you.

2.1 Feature file

<?xml version="1.0" encoding="utf-8" ?>
<Feature xmlns="http://schemas.microsoft.com/sharepoint/"
        Id="DE7C8197-4FF3-41f5-B13A-6ACB94FA0C77"
        Title="New User Request Form"
        Description="This feature deploys the browser enabled New User Request InfoPath Form."
        Version="12.0.0.0"
        Scope="Site"
        DefaultResourceFile="ipfscore"
        ReceiverClass="Microsoft.Office.InfoPath.Server.Administration.XsnFeatureReceiver"
        ReceiverAssembly="Microsoft.Office.InfoPath.Server, Version=12.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c" >
    <ActivationDependencies>
        <ActivationDependency FeatureId="C88C4FF1-DBF5-4649-AD9F-C6C426EBCBF5"/>
    </ActivationDependencies>
    <ElementManifests>
        <ElementManifest Location="element.xml"/>
        <ElementFile Location="NewUserRequestForm.xsn"/>
    </ElementManifests>
</Feature>

2.2 Element File

<?xml version="1.0" encoding="utf-8" ?>
<Elements xmlns="http://schemas.microsoft.com/sharepoint/">
    <Module Name="XSN" Url="FormServerTemplates" RootWebOnly="TRUE">
        <File Url="NewUserRequestForm.xsn"
              Name="NewUserRequestForm.xsn"
              Type="GhostableInLibrary"/>
    </Module>
</Elements>

Notes:

• The key to this whole thing is the receiver class XsnFeatureReceiver.
• In the Feature File the Enterprise Feature is turned on by creating an activation dependency on C88C4FF1-DBF5-4649-AD9F-C6C426EBCBF5.
• The name of the InfoPath form is an ElementFile in the Feature.xml and is a Module in the Element.xml.

3.0 Create Project
The following is what I had to do create a project for the InfoPath form.

3.1 Visual Studio

• I created a Visual Studio C# project. Yes, I still believe in being able to do some of this stuff from scratch.
• In the project I added a TEMPLATE, FEATURE and a feature Folder called K2Distillery.IP.NewUserForm. In the Feature folder I put the element.xml and feature.xml. The InfoPath form will be published to Feature Form later. I explain why I do this a little farther down.
• In the project, I deleted the default class that was created and I added the InfoPath form into the root of the project.
• I created a file called WSP.ddf in the root of the project. This will be used to create a solution package to deploy and InfoPath Feature.
• I then finally added a manifest.xml file to the project.
• In the properties of the project, in the Post Build Events, I added the following which will create my deployment package when the project is built:
  cd $(ProjectDir)
  MakeCAB /D outputDir=$(OutDir) /f "WSP.ddf"
  

The following is what the project solution looked like when I was completed.

3.2 manifest.xml File
The manifest.xml file is used by the WSP solution package to deploy the Feature.

<Solution xmlns="http://schemas.microsoft.com/sharepoint/"
          SolutionId="F9D4D78A-06AA-4625-9676-0A27E6299E05">
    <FeatureManifests>
        <FeatureManifest Location="K2Distillery.IP.NewUserForm\feature.xml"/>
    </FeatureManifests>
</Solution>

3.3 WSP.ddf File
This file is used create the WSP file that will be deployed into SharePoint. The great thing about doing this is if there are other Features I need to deploy along with this InfoPath Form Feature, I can package them up in this single solution and all of the files will be deployed across the entire farm. For instance, if I really want to get slick, I could create a different feature to create a Form Library and then write a Feature receiver to get the content type for the InfoPath form and associate it to the Form Library on the fly.

I highly recommend that you get into this habit. It is not that hard once you learn it.

.OPTION Explicit
.Set CabinetNameTemplate="K2Distillery.IP.NewUserForm.wsp"
.Set DiskDirectory1="C:\K2Distillery\IP\K2Distillery.IP\K2Distillery.IP.NewUserForm"

manifest.xml

.Set DestinationDir="K2Distillery.IP"

.Set DestinationDir="K2Distillery.IP.NewUserForm"
TEMPLATE\FEATURES\K2Distillery.IP.NewUserForm\element.xml
TEMPLATE\FEATURES\K2Distillery.IP.NewUserForm\feature.xml
TEMPLATE\FEATURES\K2Distillery.IP.NewUserForm\NewUserRequestForm.xsn

.Delete outputDir

4.0 Deployment Steps
The next step is to deploy the solution. I have two steps.

4.1 InfoPath Deployment
You may have noticed in my project I have the InfoPath form in the root of the project and in the Feature folder. You will see what I did this in a moment.

• Open the InfoPath form in the root of the project in InfoPath Designer.
• Select File >> Publish:
• To Network Location
• In the next step, navigate to the \\TEMPLATE\FEATURES\K2Distillery.IP.NewUserForm folder.
• In this step of the publishing process, clear this text box and press the Next button. This is the reason why I have two different copies of the InfoPath form in the project. The first one is the Form I make modifications to and the second one is the form that will actually be deployed to MOSS.
  
  
• Then Finish the wizard and close InfoPath.

4.2 Solution Deployment

• Since the manifest.xml and WSP.ddf files have been added to the project and I have added Post Build commands to generate the WSP file, the only thing I need to do is build Project. Easy.
• Once the project has been built a file called K2Distillery.IP.NewUserForm.wsp should have be created. The location of it is in the WSP.ddf file.
• Then all I need to do is deploy this using stsadm.exe:

stsadm.exe -o addsolution -filename C:\K2Distillery\IP\K2Distillery.IP\K2Distillery.IP.NewUserForm\K2Distillery.IP.NewUserForm.wsp

stsadm.exe -o deploysolution -name K2Distillery.IP.NewUserForm.wsp -immediate -force

stsadm.exe -o execadmsvcjobs

• Then finally I need to activate the Feature on the site:

stsadm.exe -o activatefeature -filename K2Distillery.IP.NewUserForm\feature.xml -url %SITEURL% -force

All of these steps could have been done through Central Administration and in Site Settings however, going down this path you will be able to create one touch deployment command files that can deploy your entire solution into a production environment.

4.3 Verifying Deployment
There are several places for you to verify that everything went well:

• Go to Central Administration and you will see that you form has been added there.
• Go to the site/FormServerTemplates/ and you will see the form there.
• Go to Site Settings and you should find a new Content Type called NewUserRequestForm has been created. The InfoPath form will be set up as the document template for the Content Type.

4.4 Adding the Form to a Form Library
It is pretty common knowledge on how to add Content Type for a List, Document Library or Form Library. Well the steps have not changed. Create a Form Library, go to the form settings, go to advanced settings, allow management of content types and then add the content type for the form to the Form Library.

4.5 Promoted Fields
If you are wondering where are the Promoted Fields? Well they are there, however they are not added as a column to the Form Library when you associate the Content Type. At first I did not know where they were because I was accustomed to having promoted fields added as columns of the Form Library automatically because when I publish a form using InfoPath Designer. To add them, all you need to do is:

• Go to the Form Library settings.
• Scroll down to the Views section at the bottom.
• Click on a view.
• Check the promoted InfoPath form field which will be listed as a column. That is it.

Yes, I could probably create another Feature to do this for me too, but at this point, I need to move on J

4.6 Managed Code
Read the following posting I wrote after writing this blog.

5.0 Conclusions
Some may say you had to do just as much effort, if not more, to deploy the solution in this manner versus deploy the form using InfoPath Designer or through Central Administration. It really comes down to following a true publishing model with SharePoint. Many say if you cannot deploy something as a Feature it should not be deployed at all. I agree with this sentiment in many respects (and why I avoid using SharePoint Designer). I do agree there is a point where some manual configuration is required to deploy between SharePoint environments.

References
Deploy InfoPath Form as a Feature – Yes, I had a little help here J

MOSS State Workflow Email Escalation Part 2

Scenario

The scenario I have is that I have a state workflow that I am building in Visual Studio and deploying to MOSS. In this human workflow I need to incorporate the concept of raising an escalation email event so when a user has not completed a task in a period of time. I was doing an early proof of concept and found issues with DelayActivity requiring me to install a hotfix. Well I thought I would have everything working and it would be really simple to just throw on an email activity after the delay activity. However I was terribly wrong.

Design

I was basically following a simple pattern where I would add two event driven activities, one that would wait for an action to be taken on the task, and another where a delay activity would wait for a period of time to pass.

Here is what I had for the escalation. Basically after a period of time the delay would end, an email would be sent and then a log would be made. Hey that should be simple?Error Message

At first, I was getting no error messages; nothing in the ULS logs and nothing in the event viewer. Then after doing some playing around I noticed if I disabled the email activity everything would work. So I something was wrong there.

After playing with it a bunch more and I started to get "The e-mail message cannot be sent. Make sure the outgoing e-mail settings for the server are configured correctly." in the workflow log. This was extremely annoying because emails are working in task lists and other places throughout the workflow the SendEmail activity was absolutely working, just not in my escalation.

Well there were numerous things going wrong with using the EmailActivity. After doing some searching I saw that many had given up and just used SPUtilities.SendEmail() or just wrote their own wrapper to use System.Net.Mail but to tell you the truth the SendEmail activity was MOCKING ME. I know that there must be a way to send an email.

Resolution

I was able to find out some of this has to do with the way DelayActivity worked with MOSS and specifically state workflows. All of the issues I was experiencing would not occur in a sequential workflow. When configuring a SendEmail activity that occurs after a DelayAcitivty you need to make sure the it is configured correctly.


A few notes:

• The CorrelationToken must be correctly set. It is possible that you may have many tokens in your workflow. You will have on for the token for the WorkflowActivated activity and you may have a different tokens tied to the CreateTask activity (such as my case). Make sure you use the token that is from the WorkflowActivated activty. Otherwise you will get no errors and the workflow will throw an error into the log and give you no information.
• If you are trying to set any of the properties of the SendEmail activities in code, stop as you will run into tons of problems. Check out the references below. What you will need to do is create new workflow properties and bind to them like the above screenshot. Then in an event handler you can set the values. If you create an event handler and then try to set SendEmail object directly none of the values will be set and you will get an empty email throwing errors.
• Finally in the code of the onSendEmail event handler, you will have limited access to data. I was not able to narrow down why this is occurring (partly because I just do not care anymore). For instance, you may want to put the title of the task into the body of the email. So you may have a SPWorkflowTaskProperties object where you will want to get this data from. Well, I was getting ton null exceptions when trying to do this. I did find that I could use the SPWorkflowActivationProperties and that was good enough at this point.

The following is some code from the onSendEmail handler. Here you will see where I set the attributes I have bound to the SendEmail activity. You will see that I have an object that I use to get data from the InfoPath that is being routed around (beyond scope of this blog entry).

        private void onSendEmail(object sender, EventArgs e)
        {
            this.EmailTo = _infoPath.ManagerEmail;
            this.EmailSubject = "Reminder - New User Request Task";
            this.EmailBody = "A New User Request for " + _infoPath.FirstLastName +
                "was assigned to you but not completed. " +
                "Please go to the following Task list to complete your assigned task: " +
                NewUserRequestWorkflowProperties.WebUrl + NewUserRequestWorkflowProperties.TaskListUrl;
        }

References

• http://spschris.blogspot.com/2008/03/e-mail-message-cannot-be-sent-make-sure.html
• http://social.msdn.microsoft.com/Forums/en-US/sharepointworkflow/thread/43f48e67-02d9-42d2-b51a-d10c06213783/
• http://social.msdn.microsoft.com/forums/en-US/sharepointworkflow/thread/163d513b-e709-4e44-9ea3-850d4b879a13/

Debug MOSS Workflow in Visual Studio

This blog is very late to be publishing at this point (given I ran into this a long time ago) as many know how to debug a MOSS workflow. All you need to do is:

• Make sure that you get a debug build in the gac.
• Restart IIS or recycle the SharePoint app pool, which ever you prefer.
• In Visual Studio >> Debug >> Attach to Processes… >> select the w3wp.exe.

Now, do not forget to Attach to only the Workflow Code Type.

Apparently you cannot debug workflow and managed code at the same time. Otherwise, you will find yourself closing Visual Studio, bouncing IIS and re-opening Visual Studio just to debug your workflow… Doh!

Denver K2 User Group SmartObjects

Update 4/16/2009 - here is a link to the recorded presentation.

I have been asked to speak about SmartObjects at the Denver K2 User Group. I will be doing it virtually. If you like to attend, please tune in. It will be a nice intro into all of the aspects of SmartObjects and if you have any questions, please come with them.

----------------------------

Hello everyone,

The next K2 User Group meeting in Denver is fast approaching and will be held on October 7th from 6pm to 8pm.

The meeting will again be hosted at Baxa located at 14445 Grasslands Dr, Englewood, CO 80112. Here is a map to the Baxa office. There is plenty of parking available around the building and it's fairly close to E470, so please join us in person, if possible. For those of you who cannot attend in person, we will have a Live Meeting session available. This information is located at the bottom of this e-mail.

Please RSVP to me by Friday, October 3rd whether you will be attending in person (so we can plan for food) or via the Live Meeting. If you are interested in receiving these notifications in the future, please register for the Denver User Group on the K2 Underground. If you would prefer to not be contacted again, please let me know so I can remove your name from the list.

Agenda:

6:00 - 6:15 Networking/Refreshments

6:15 - 6:30 Announcements

6:30 - 7:15 Presentation by Jason Apergis from RDA Corporation

7:30 - 7:45 Round Table Discussion

7:45 - 8:00 Meeting Wrap-up

Presentation Summary:
Jason will be talking about the beauty and power of K2 SmartObjects. During this session Jason will be going into the SmartObject basics but will also show you how to create them and their associated ServiceObjects.

Jason Apergis is a software consultant who has lived in the Washington, DC area his entire life. Jason currently works for a Microsoft Gold Partner named RDA Corporation as a technical project manager and has worked for various other consulting firms like BearingPoint and AMS. One of Jason's solutions was nominated as a finalist for a Microsoft solution of the year award in 2006 which integrated K2, BizTalk, SharePoint and InfoPath. Jason completed both his undergraduate and graduate degrees in Information Technology from Virginia Tech. Jason plays ice hockey weekly basis and is both an avid Washington Capitals and Virginia Tech Football fan.

Bring your questions or challenges for a round table discussion after the presentation to discuss with the others in the User Group. Have you used SmartObjects yet? How are you using them? What challenges have you faced?

Live Meeting Information:

Start Time: Tuesday, Oct 7, 2008 6:00 PM MDT End Time: Tuesday, Oct 7, 2008 8:00 PM MDT Occurrence: Recurring meeting Meeting Lobby: Not enabled Attendee URL: https://www.livemeeting.com/cc/scna/join?id=CK6G4W&role=attend&pw=F59%3EKcr Meeting ID: CK6G4W Attendee Entry Code: F59>Kcr Location: Audio: Two way computer audio conferencing: Off One way computer audio broadcasting: Off Telephone conferencing: On Audio conferencing provider: Other Toll free: +1 (913) 227-1219Toll: +1 (888) 269-6500 Participant code: 994729 Note: please keep your phone on mute until you are ready to speak.

K2 blackpearl 0807 Released

Important news 0807 build of K2 blackpearl, that I previewed here, has been released. There are major changes and bug fixes that have been addressed. Below is the announcement.

K2 blackpearl™ 0807 (4.8210.1.0) is now available!

Greetings K2 Customers!

K2 blackpearl™, the centerpiece of the new K2 platform, has the K2 blackpearl 0807 (4.8210.1.0) release now available.

The 0807 release focused on greater stability and better performance than ever before. It includes various enhancements and performance increases for the K2 Workspace, the K2 Designer for Microsoft Visual Studio 2005, and the K2 blackpearl Workflow Server to name but a few. It also includes post-0803 patches and bug fixes. New exciting features included in this release are Out of Office functionality and K2 Interop!

OUT OF OFFICE The K2 Out of Office feature enables a user to share specific worklist items or their entire worklist with other users. The user, the out of office participant, will be able to share current and future work items with designated colleagues, and redirect all remaining items to others by creating exception rules. The additional column on the K2 Worklist allows users to differentiate between their own and the absent colleague's worklist items. This functionality ensures that important and urgent work items receive prompt attention, regardless of someone being away from their desk.

K2 INTEROP (Moving Process Definitions from K2.net 2003 to K2 blackpearl – CLIENT SIDE) K2 Interop (short for interoperability) is the ability for K2.net 2003 process (.kpr) files to be opened in the K2 Designer for Visual Studio that ships with K2 blackpearl. It is a client-side, design-time functionality that allows converted K2.net 2003 and hybrid (K2.net 2003 and blackpearl) processes to be deployed to K2 blackpearl. With the release of K2 blackpearl, organizations with an investment in K2.net 2003 may want to leverage the advantages of the new platform and migrate their existing business processes from the old platform to the new. From a technology perspective, K2.net 2003 is distinctively different to K2 blackpearl, and K2 blackpearl offers a whole new feature set however still supporting the same K2.net 2003 features moving forward. As a result the divide between K2 blackpearl and K2.net 2003 is bridged by supporting K2.net 2003 features within the K2 blackpearl environment using K2 Interop MIGRATION (Moving existing K2.net 2003 Process Instances to K2 blackpearl – SERVER SIDE) K2 blackpearl 0807 is now migration-ready. The migration utility will be released in the next few weeks and is NOT available immediately. It is important to note that you will require K2 blackpearl 0807 to use the Migration Utility. The Migration capability should not be confused with K2 Interop. Migration is the physical migration of data from K2.net 2003 to K2 blackpearl. This is a server-side, runtime functionality enabled by a separate utility that migrates database records from K2.net 2003 to K2 blackpearl.

NEW ACTIVE DIRECTORY SERVICE The New Active Directory Service provides new objects and methods to access information from Active Directory for easy access and use of information to help create business processes and workflows in K2 blackpearl. This service surfaces information from AD and has a great number of performance enhancements and added functionality along with the functionality contained in the original Service, however it does not replace the original one.

PERFORMANCE ENHANCEMENTS Numerous performance enhancements have been implemented. Some of the highlights are as follows. Workflow Server Performance > Improved processes execution > Worklist & Worklist Item performance > Worklist enhanced paging and filtering capabilities > More granular selection on Workflow Reporting SmartObjects > Improved memory usage on K2 Designer for Visual Studio > Improved memory usage when starting processes and finishing work list items > Improved batch execution of K2 processes > SmartObject Performance (runtime execution) > SmartObject Server data handling enhancements

ENHANCEMENTS ON K2 WIZARDS Some changes have been made to the functionality which resides behind the scenes of the K2 Wizards – specifically the items used for Microsoft SharePoint Server integration. These wizards now leave a smaller footprint on the process definition (.kprx) files, resulting in smaller file sizes and better memory management in the different designers available for K2 blackpearl.

DOCUMENTATION Several additions and enhancements have been made to the K2 blackpearl Documentation. The key areas of improvement are as follows.

OVERALL DOCUMENTATION Certain topics of the K2 blackpearl documentation has been updated and new topics added. New or updated topics are marked with an asterisk image in the Table of Contents

The following sections contain new or updated information: > K2 Concepts - Content Fields > K2 Wizards - Chaining wizards > Mail Event > IPC Event > SharePoint Records Management Wizard > Deploy Project Wizard > K2 SmartObject Integration - SmartObject Association > K2 for Visual Studio - K2 Design Canvas > K2 Interop > K2 Workspace - Management Console > Out of Office > Standard Reports > User Preference > K2 Developer Reference - Architecture of K2 Platform > Users > Extending the K2 Platform

Please take the time to review the latest K2 blackpearl 0807 (4.8210.1.0) Release Notes and product documentation before installing 0807 to ensure you understand the enhancements, fixed issues, and outstanding known issues. For installation, we urge you to look at the Release Notes prior to Installation! There are two issues that you should be aware of before installing 0807 that may, depending on your current blackpearl installation, overwrite custom configurations.

DOWNLOAD K2 BLACKPEARL 0807 (4.8210.1.0) K2 blackpearl 0807 (4.8210.1.0) is available at https://portal.k2workflow.com/downloads/bp/Default.aspx. License keys can be obtained at https://portal.k2workflow.com/licensekey/Default.aspx. The page can also be found via the Support > License Key Request > License Key menu on portal. The 0807 installer is slipstreamed, so if K2 blackpearl is not already present, the installer will install K2 blackpearl with the 0807 updates.