Code Eater (Wael A. Kabli) : Wss

Business Process Automation, a story to tell

Wael A. Kabli — Tue, 28 Oct 2008 09:00:08 GMT

eFroms solution Components

The eForms solution is a result of collaborating the following components all together:

· Microsoft Office SharePoint Server 2007 Infrastructure.

· Form Site (Portal): a SharePoint Site that hosts the whole solution and enabling this kind of integration.

· Email: a mail services that will send notifications within the workflows.

· Forms Template: This is the from that contains the target process. This is were you usually take a paper form or a manual process analyze, break-down and make an e-form out of it. In this solution we use Microsoft Office InfoPath 2007 in implement eForms or you can use APS.NET forms.

· Workflow: a component that is installed in the SharePoint that will contain the actual business process.

· Workflow Tasks: This is a SharePoint list that contains the tasks created by the workflow. A Task simply replaces a stage of a human task in the process (like an approval, signatures or a configuration).

· Security: to provide non-repudiation, data integrity and origin.

· Workflow History: This is a SharePoint list that stores the workflow logs. This includes cancellations, rejections, approvals and other workflow state transitions.

· Web Services: are set of services that will aid the solution in performing certain tasks such as getting user profiles from Active Directory and get the workflow logs to show a workflow history and maybe getting integrated with other services like Primavera for example.

· Other Lists: some forms depend on few SharePoint List to do some lookups on them.

· Archive: This is where the submitted form get stored which is basically a document or form library.

The flow of a workflow!

The story begins when a user find a link on the portal saying ( click here to fill XYZ form ). The link is actually pointing to the form template (which has the extension xsn) if you are using InfoPath. When he clicks on it, he will be redirected to the InfoPath Forms Server 2007 that is in Microsoft Office SharePoint Server2007 and it will render the form template (xsn) to be displayed on the web browser.

As soon as the form opens, the form had few rules inside it that will communicate with a web service to get the current user credentials from AD.

The user now will fill the form and submit which will actually will save this form in (XML) format in a document library or a form library for archiving.

As soon as this form is submitted, a workflow will run to follow the business process creating tasks to the people who are suppose to process that form (like a manager task to approve that form) and sending emails to the corresponding people to perform their tasks. the workflow will leave its foot prints on the history, so any time the user (or any body) can open the history and look what happened to the process, which task has been completed and what tasks are still pending.

The security model in SharePoint is taking care of who should see what and who can do something. Once the workflow is finished, it will indicate its state such as (Approved or Rejected by Manager or just completed).

Workflow "Failed on Start (retrying)"

Wael A. Kabli — Fri, 11 Jan 2008 05:12:44 GMT

Oh!! its SharePoint again :). One of these small things in this beast which makes you bang your head and pull your hear again and again if you don't get it right. Now lucky you you can search this issue and find the solution.

Debugging in SharePoint is very tricky sometimes because you get all of these levels to run around (GAC + IIS + Deployment Folder under the feature + Feature.xml + Workflow.xml + SharePoint itself + InfoPath the main form template + InfoPath the workflow forms and Web Services) so after this, it is not strange that you would start pulling your hear after a while.

Problem Description:

if you try any workflow (including OOB WF and Custom WF) and when you try to start it, it will show the message Workflow "Failed on Start (retrying)". You may also see that some tasks in the WF are created and even so it fails.

Tip: whenever you are stuck with your custom workflow, try having the OOB, if it doesn't run, its not your problem. (i spent one complete day almost 20H just to discover its not my fault).

One Proof that this thing its not your custom code problem, if you attach the WF process to Visual Studio, it will not catch any exception.

Reasoning:

In WSS/MOSS the workflow engine will report back 'a workflow failed to start' even if the workflow did start.

The reason why is that - the workflow will be sent the 'OnWorkflowActivated' event (start command) and essentially as far as MOSS is concerned - it's starting.

When the workflow for e.g. writes a task item and then waits (handleExternal Event) for the OnTaskChanged event. At this point if it failed - a different error other than 'failed to start' would be reported.

Resolution:

First and importantly check all your correlation tokens. make sure that each task (Creation, Updating and Completing) has its own Token not the workflow token.
Then compare the dll you have with theone in the workflow.xml and the one in the GAC. simply they all should be the same.
Try this on the command prompt: Lodctr "c:\Windows\Microsoft.Net\Framework\v3.0\Windows Workflow Foundation\perfcounters.ini"
And if it doesn't work for you try: Lodctr /R "c:\Windows\Microsoft.Net\Framework\v3.0\Windows Workflow Foundation\perfcounters.ini"

Some Links might Help:

http://forums.microsoft.com/MSDN/ShowPost.aspx?PostID=2268844&SiteID=1

Some errors you might see in logs:

The requested Performance Counter is not a custom counter, it has to be initialized as ReadOnly.
Failed on Start (retrying).
Unexpected Load Workflow Class: System.Reflection.TargetInvocationException: Exception has been thrown by the target of an invocation. ---> System.InvalidOperationException: The requested Performance Counter is not a custom counter, it has to be initialized as ReadOnly. at System.Diagnostics.PerformanceCounter.Initialize() at System.Diagnostics.PerformanceCounter..ctor(String categoryName, String counterName, String instanceName, Boolean readOnly) at System.Workflow.Runtime.PerformanceCounterManager.CreateCounters(String name) at System.Workflow.Runtime.Hosting.DefaultWorkflowSchedulerService.OnStarted() at System.Workflow.Runtime.Hosting.WorkflowRuntimeService.HandleStarted(Object source, WorkflowRuntimeEventArgs e) at System.EventHandler`1.Invoke(Object sender, TEventArgs e)...
01/11/2008 03:33:24.79* w3wp.exe (0x12B4) 0x0E9C Windows SharePoint Services Workflow Infrastructure
Unexpected    ...     at System.Workflow.Runtime.WorkflowRuntime.StartRuntime()     at Microsoft.SharePoint.Workflow.SPWinOeHostServices..ctor(SPSite site, SPWeb web, SPWorkflowManager manager, SPWorkflowEngine engine)     --- End of inner exception stack trace ---     at System.RuntimeMethodHandle._InvokeConstructor(Object[] args, SignatureStruct& signature, IntPtr declaringType)     at System.RuntimeMethodHandle.InvokeConstructor(Object[] args, SignatureStruct signature, RuntimeTypeHandle declaringType)     at System.Reflection.RuntimeConstructorInfo.Invoke(BindingFlags invokeAttr, Binder binder, Object[] parameters, CultureInfo culture)     at System.RuntimeType.CreateInstanceImpl(BindingFlags bindingAttr, Binder binder, Object[] args, CultureInfo culture, Object[] activationAttributes)     at System.Ac...
01/11/2008 03:33:24.79*    w3wp.exe (0x12B4)                           0x0E9C    Windows SharePoint Services       Workflow Infrastructure           72fu    Unexpected    ...tivator.CreateInstance(Type type, BindingFlags bindingAttr, Binder binder, Object[] args, CultureInfo culture, Object[] activationAttributes)     at System.Reflection.Assembly.CreateInstance(String typeName, Boolean ignoreCase, BindingFlags bindingAttr, Binder binder, Object[] args, CultureInfo culture, Object[] activationAttributes)     at Microsoft.SharePoint.Workflow.SPWorkflowManager.LoadPluggableClass(String classname, String assembly, Object[] parameters)
01/11/2008 03:33:24.80     w3wp.exe (0x12B4)                           0x0E9C    Windows SharePoint Services       Workflow Infrastructure

Roadmap to using SharePoint Server 2007

Wael A. Kabli — Sun, 06 Jan 2008 16:54:56 GMT

Finally we have END USERS TRAINING :D finally

Use this roadmap as a starting point to learn about the broad capabilities of Office SharePoint Server 2007 and how to complete common tasks as a contributor to a SharePoint site. You can also find links to site owner tasks, such as setting up permissions and doing some basic customization.

http://office.microsoft.com/en-us/sharepointserver/HA102486841033.aspx

WSS Coding Best Practices

Wael A. Kabli — Sun, 02 Sep 2007 00:45:00 GMT

WSS Coding Best Practices

(http://msdn2.microsoft.com/en-us/library/bb418735.aspx)\

Best Practices: Common Coding Issues When Using the SharePoint Object Model
Best Practices: Using Disposable Windows SharePoint Services Objects
Creating a Windows SharePoint Services 3.0 Web Part Using Visual Studio 2005 Extensions
Development Tools and Techniques for Working with Code in Windows SharePoint Services 3.0 (Part 1 of 2)
Development Tools and Techniques for Working with Code in Windows SharePoint Services 3.0 (Part 2 of 2)
Working with ASP.NET 2.0 Web Parts and Windows SharePoint Services 3.0

SharePoint @ CodePlex !!!

Wael A. Kabli — Sat, 01 Sep 2007 10:31:00 GMT

many were asking me wehre to find free features, web parts, solutions, kits and different experiences,,,

also they want to share thier parts too with the community!!

here you go all of you :)

http://www.codeplex.com/Project/ProjectDirectory.aspx?TagName=Sharepoint

its from the open source site from microsoft www.codeplex.com ,,,,

till the time i have posted thisd post the library contains 81 projects!!

What is CodePlex?

CodePlex is Microsoft's open source project hosting web site. You can use CodePlex to create new projects to share with the world, join others who have already started their own projects, or use the applications on this site and provide feedback. A word about Microsoft’s role: Microsoft does not control, review, revise, endorse or distribute the third party projects on this site. Microsoft is hosting the CodePlex site solely as a web storage site as a service to the developer community.

To Create Workflow Association and Initiation Forms (Windows SharePoint Services) :

Wael A. Kabli — Tue, 28 Aug 2007 15:21:00 GMT

To Create Workflow Association and Initiation Forms (Windows SharePoint Services) :

1. Specifying Association Forms

You specify a workflow's association form in the workflow template definition XML. To do this, set the value of the AssociationURL attribute of the Workflow Element (Elements) element to the custom form page you want to use for workflow association. For example:

AssociationURL="MyWkflAssociationPage.aspx"

2. Association Form Processing

When an administrator selects a workflow to associate with a given list, library, or content type, Windows SharePoint Services displays the Add a New Workflow page. The administrator can use this page to specify settings common to all workflows, such as the workflow definition, initiation conditions, and whether the workflow runs on items, folders, or both.

Because the workflow association is not created until the custom association form is submitted, Windows SharePoint Services also passes the following query parameters to the custom association form:

<input type="hidden" name="WorkflowDefinition" value=<% _STSWriteHTML(Request.Form["WorkflowDefinition"]); %>>
<input type="hidden" name="WorkflowName" value=<% _STSWriteHTML(Request.Form["WorkflowName"]); %>>
<input type="hidden" name="AddToStatusMenu" value=<% _STSWriteHTML(Request.Form["AddToStatusMenu"]); %>>
<input type="hidden" name="AllowManual" value=<% _STSWriteHTML(Request.Form["AllowManual"]); %>>
<input type="hidden" name="RoleSelect" value=<% _STSWriteHTML(Request.Form["RoleSelect"]); %>>
<input type="hidden" name="AutoStartCreate" value=<% _STSWriteHTML(Request.Form["AutoStartCreate"]); %>>
<input type="hidden" name="AutoStartChange" value=<% _STSWriteHTML(Request.Form["AutoStartChange"]); %>>
<input type="hidden" name="GuidAssoc" value=<% _STSWriteHTML(Request.Form["GuidAssoc"]); %>>

The workflow developer is responsible for programming what happens when the administrator submits changes to the form. In general, the custom workflow association form must perform the following actions:

Examine the value of the GuidAssoc parameter to determine whether the user is adding a new workflow association or editing an existing workflow association.
If the user is adding a new workflow association, call the AddWorkflowAssociation method to create a new workflow association.
If the user is editing an existing workflow association, call the Update method to update that workflow association.
Create the task list for the workflow, if it does not already exist.
Use the data collected from the user to set properties of the SPWorkflowAssociation object, as appropriate.
Create the workflow history list, if necessary.

3. Specifying Initiation Forms
If you want your workflow to have an initiation form, you must set the InstantiationURL of the Workflow Element (Elements) element in the workflow template definition. Set this element to the form you want to use to collect the workflow initiation data, as shown in the following example.
<Instantiation_URL>MyWorkflowInitiationPage.aspx</Instantiation_URL>
4. Initialization Form Processing
When a user starts a workflow on a specific item, Windows SharePoint Services examines the InstantiationURL of the Workflow Element (Elements) element, in the workflow template definition, to determine the proper form to load.
Windows SharePoint Services loads the specified form, passing the form the following query parameters in the URL:
List The GUID of the list to which the item belongs.
ID An incremental ID that represents the order in which items are added to the list.
Source The page from which the user started the workflow.
TemplateID The GUID of the workflow template.
In addition, if you have stored custom data in the AssociationData Element (Workflow) element of the workflow definition, you can program your form to load this information as well. For example, you could use this element to store default values you want to pass to the association form when it is displayed. The AssociationData Element (Workflow) element can contain any valid XML.
The workflow developer is responsible for programming what happens when the user submits changes to the page. In general, the form must perform the following actions:
Locate the SPWorkflowManager object for the current site.
Create a new SPWorkflowEvent instance.
Set the EventData property of that SPWorkflowEvent object to the data collected from the user.
Start the workflow by calling the StartWorkflow method, passing the appropriate ListItem object, SPWorkflowTemplate object, and the new SPWorkflowEvent as arguments.
Return the user to the source page from which they started the workflow
When the M:Microsoft.SharePoint.Workflow.SPWorkflowManager.StartWorkflow(Microsoft.SharePoint.SPListItem,Microsoft.SharePoint.Workflow.SPWorkflowAssociation,System.String) method is called, the workflow manager creates an instance of the workflow on the SharePoint item. The workflow manager then passes the data gathered using the initiation form to the OnWorkflowActivation event of the workflow itself.
Any Windows SharePoint Services workflow must start with an OnWorkflowActivation event. The OnWorkflowActivated activity contains a property, WorkflowProperties, that returns an SPWorkflowActivationProperties object that represents the initial properties of the workflow as it starts, such as the user who added the workflow and the list and item to which the workflow was added. In addition, the SPWorkflowActivationProperties.CreationData property returns a System.Collections.Hashtable object that represents the custom data provided by the workflow initiation form.

Procedure to create ASPX Workflow Forms

Wael A. Kabli — Tue, 28 Aug 2007 14:39:00 GMT

Types of Workflow Forms

Three types of forms are used in Microsoft Windows SharePoint Services 3.0 workflows:

note: you can use InfoPath Forms instead if you have Forms Server or MOSS!!

Association and Initialization Forms   Association and initialization forms are displayed for users to fill out before any workflow is actually started. You can use these forms to enable users to set parameters and other information for the workflow before it starts.

Modification Forms   Modifications are options you present to users to change the workflow as it's running on an item. You can then create modification forms that enable users to specify the parameters of the modification.

Task Forms   You can also specify custom forms for the tasks in your workflow. Because tasks are SharePoint items that are assigned a content type, however, the content type actually determines the custom forms used with the task type.

How to change the view from userdisp.aspx to MySite View?

Wael A. Kabli — Sun, 01 Jul 2007 13:58:00 GMT

This is fairly simple and easy,,,

you need your MySite URL, e.g. mysite url is http://sharepointserver:8085

now, go to your site collcetion --> site actions --> modify all site settings --> under Site Collection Administration: Portal site connection

here go and paste your URL and give it a name,,,

result: whenever you click on user, it will redirect you to mysite

enable proxy settings in SharePoint web.config to view RSS Viewer Web Part

Wael A. Kabli — Sun, 01 Jul 2007 11:57:00 GMT

Open your web.config on the site you want

to do this just tell the web.config that you have an internet access with a proxy:

Kit Kai's Tech Blog:

http://community.sgdotnet.org/blogs/kitkai/archive/2007/04/04/Consuming-RSS-Feeds-using-RSS-WebPart-.aspx

i have few notes here:

- you cannot have authenticated RSS feeds unless you enable Kerberos

- if you have your proxy as IP address like 192.168.1.3 and port 8080, your node still looks like

- you need to retart iis

Microsoft Office SharePoint Server 2007 - Arabic edition

Wael A. Kabli — Thu, 19 Apr 2007 16:56:00 GMT

if you are seeking for an Arabic Implementation for MOSS or WSS, you need to read this document first,,,

http://www.microsoft.com/middleeast/arabicdev/office/office2007/SharePoint.aspx
Introduction

What is the Arabic language support?

Adding Arabic support to the Environment

3.1 Adding Arabic language support to Windows XP/2003 server

3.2 Adding Arabic language support to Internet Explorer

3.3 Adding Arabic support in SQL Server

3.4 Office SharePoint Arabic language pack

Arabic support Level in Microsoft Office SharePoint Server 2007

4.1 Central Administration page "الادارة المركزية"

4.2 Shared Services Administration page "ادارة الخدمات المشتركة"

4.3 Create page "أنشاء"

4.4 Create New Site page "أنشاء موقع جديد"

4.5 The Site Settings page "اعدادات الموقع"

4.6 Regional settings available for Office SharePoint Server 2007 sites

Adding more items to the site

5.1 Discussions "المناقشات"

5.2 Calendar "التقويم"

5.3 Documents "المستندات"

5.4 Tasks "المهام"

5.5   Search Feature in Microsoft Office SharePoint Server 2007

5.6   What are the system requirements for SharePoint Server?

6.6   Q & A

if you want some instructions to deploye Language Packs on MOSS, read the following article:
http://technet2.microsoft.com/Office/en-us/library/26c07867-0150-463d-b21a-a6d42aecf05a1033.mspx?mfr=true

• About language IDs and language packs

• Preparing your front-end Web servers for language packs

• Installing language packs on your front-end Web servers

Start Learning Workflows!!

Wael A. Kabli — Thu, 12 Apr 2007 16:32:00 GMT

Wow such an exciting topic to learn!! its nice and fun yet its a bit difficult to grasp easily,,,

Workflow Concepts:

Developer Introduction to Workflows for Windows SharePoint Services 3.0 and SharePoint Server 2007

http://msdn2.microsoft.com/en-us/library/ms406057.aspx

Hands On Practise:

This is a very good course that our colleage of us Eilene Hao, he works as a Program Manager for SharePoint Workflows....

hear is an outline:

"So You Want to Develop Custom Workflows in Visual Studio..." - The Blog Series

Developing Workflows in VS: Part 1 - Workflow Objects and A Crash Course on Mechanics

Developing Workflows in VS: Part 2 - Planning Your Workflow: Two Things to Keep in Mind

Developing Workflows in VS: Part 4 - Design and Bind Your Forms

Developing Workflows in VS: Part 5 - Code Your Workflow

Developing Workflows in VS: Part 6 - Deploy and Debug your workflow

Developing Workflows in VS: Part 7 - Summary and Final Thoughts

Learning MOSS!!

Wael A. Kabli — Thu, 12 Apr 2007 16:22:00 GMT

i am trying to summarize a page that will include good materials for MOSS,,,

so if aqny body find cool things you may add it in the comments part :)

allow me to start:

TechNet: http://www.microsoft.com/technet/traincert/virtuallab/office.mspx

• What's New in Microsoft Office SharePoint Server 2007 Feature Walkthrough

• Microsoft Office SharePoint Server 2007 Installation and Configuration

• Microsoft Office SharePoint Server 2007 Records Management Deployment and Configuration

• Microsoft Office SharePoint Server 2007 Enterprise Features Administration Windows SharePoint Services 3.0

• What's New in Windows SharePoint Services Feature Walkthrough

• Microsoft Windows SharePoint Services Installation and Configuration

MSDN: http://msdn.microsoft.com/virtuallabs/office/default.aspx

• Creating Workflows for Windows SharePoint Services

• Introducing Content Types for Windows SharePoint Services

• Understanding the 2007 Microsoft Office System User Experience and Interface Design

• Programmatic Manipulation of the Microsoft Office Open XML Formats

Learning: https://www.microsoftelearning.com/eLearning

Course 5386: Working with Server and Site Objects in Microsoft Windows SharePoint Services 3.0

Course 5387: Programmatically Securing Microsoft Windows SharePoint Services 3.0 Sites

Course 5388: Programming Lists and List Events in Microsoft Windows SharePoint Services 3.0

Course 5389: Managing Documents and Libraries in Microsoft Windows SharePoint Services 3.0

Course 5390: Working with List Metadata and Content Types in Microsoft Windows SharePoint Services 3.0

Course 5391: Customizing Navigation and Layout in Microsoft Windows SharePoint Services 3.0

[Content Deployment] Authering, Staging, Deploying

Wael A. Kabli — Wed, 24 Jan 2007 14:39:00 GMT

I found a nice article on it (http://blogs.msdn.com/sharepoint/archive/2006/05/02/588140.aspx) written by (Tyler Butler, Program Manager for WCM) and I’ll try to summarize here.

“Basically there is something called Content Deployment which supports multi-topologies and its main purpose is enabling Authoring and Staging. The main idea here is Content Deployment usually goes from site collection to site collection. Through the “Central Administration Site”, Content Deployment can be configured to run and to be monitored. So you create a Job Object which is – an object that holds information of the contents needed to be deployed and a schedule (time and recurrence) – and associate a Path Object with it which is –an object contains source, authentication methods and distention. You can associate as many Jobs to a Path and the Content Deployment will deploy whatever changes were made since the last successful deployment even the dependant packages and layouts will be deployed too. The interesting part is having something called “Quick Deploy” which can be enabled on a job and then it will give the site owner to deploy a site instead of being the job of an administrator. Finally, a custom deployment can be written using the APIs.

Resources for learning Microsoft Office SharePoint Server

Wael A. Kabli — Wed, 24 Jan 2007 14:37:00 GMT

ok from now on you should know that Microsoft Office Sharepoint Server 2007 is MOSS 2007!! ok...

many people wnat to know much about MOSS it claim not find anything helpfull regarding it,,,

i'll try to list some materials and recources on Microsoft sites and others....

This Page is a great recource on MOSS: "Resources for learning Microsoft Office SharePoint Server"

http://office.microsoft.com/en-us/sharepointserver/HA101756051033.aspx?pid=CH100948731033

Resource	Description
Office SharePoint Server 2007 Developer Portal on MSDN	Information about planning, coding, building, deploying, and migrating solutions for Office SharePoint Server.
Office SharePoint Server 2007 Developer Map	Downloadable poster that shows the architecture of Office SharePoint Server 2007.
Windows SharePoint Services 3.0 Developer Center on MSDN	Technical articles, SDK information, screencasts, and community resources for SharePoint developers.
2007 Microsoft Office system Learning Portal	Training, e-learning, books, and skills assessments for 2007 Microsoft Office system products, including Office SharePoint Server 2007.
Office SharePoint Server TechCenter on TechNet	Technical articles, highlights, communities, and blogs about Office SharePoint Server.
Office SharePoint Server Technical Library on TechNet2	Additional technical resources for Office SharePoint Server.
Windows SharePoint Services TechCenter on TechNet	Technical articles, highlights, communities, and blogs about Windows SharePoint Services 3.0

[part 1] Upgrade Your Old Customized Templates from WSS2.0 to WSS3.0

Wael A. Kabli — Thu, 21 Dec 2006 22:21:00 GMT

Read this before you start: [Customization] from Wss2 to WSS3

By now you know you need an upgrade file or mapping file..

keep in mind this is an expesive option to choose and somehow it might involve a lot or effort...

Goal:

A site upgrade definition provides a means to transform sites customized in the previous version of Microsoft Windows SharePoint Services so that they take advantage of features in the new version. An upgrade definition file maps the files and list data of one build or version to a subsequent build or version, as well as specifying additional items that should be placed within upgraded Web sites.

Why Develop one?

The aim here is to upgrade you customized templates from WSS2.0 to WSS3.0. and when i say customized, i mean either you created a customized definition files or you created a customized templates.

Lets Go Step By Step!

Generaly, you need to :

- to have a customized site definition on Wss2 or a cutomized template

- create a new site definition on Wss3 based on the most related WSS3.0 template or definition to your custmized one.

- create an upgrade mapping file.

- run the config wizard

- migrated the site definition to 3.0

- do all modification I need

- All new functionalities works fine

- saved the template as .stp as Wss3 template

- registere the template in Wss3

i'll keep giving details on each one..

Recourses:

http://msdn2.microsoft.com/en-us/library/ms439232.aspx