English:

Few month ago I have introduced RemoteStsAdm, a PowerShell module that enable you to execute StsAdm.exe remotely. StsAdm.exe is a command line administration tools for SharePoint. Unfortunately to run StsAdm, one must log-in to SharePoint server member – since the tool can not be executed remotely. RemoteStsAdm is to answer this problem, allowing admin to execute StsAdm remotely. You can download the source code from MSDN Galery here or read the original article in previous post here. 

Yesterday, I have released ImportPSModule that will easy PowerShell module distribution, allow update notification and configuration. The RemoteStsAdm PowerShell module is now available via NuGet, so that you don’t need to download and extract manually. All will be done seamlessly, and whenever we got script update – you will get notified as soon as you open PowerShell session.

So what do you wait for, open PowerShell session and type following:

Import-PSModule RemoteStsAdm 

English

The STSADM.exe is command-line tool for administration of Office SharePoint Server (SharePoint 2007, SharePoint 2010). It is installed on the same location as SharePoint Products and Technologies location: %COMMONPROGRAMFILES%\Microsoft Shared\Web Server Extensions\12\bin (for SharePoint 2007) or %COMMONPROGRAMFILES%\Microsoft Shared\Web Server Extensions\14\bin (for SharePoint 2010). You must be Farm Administrator to be able to run the tool.

By default, the STSADM.exe must be executed locally since it will access SharePoint Object Model. It is also necessary for the tools to connect to the SQL Database using credential of the user who executes it. Therefore, normally the Administrator must remote-login to the SharePoint server before he/she can run the tools.

Remote execution of STSADM.exe using PowerShell Invoke-Command cmdlet faces double-hop challenges. This occurs when SQL Database for the farms is installed on different machine than the SharePoint server. The credential in theInvoke-Command session can not pass through to the SQL Database without configuring delegation in the WinRM services.This module solve double-hop problem without configuring CredSSP.

Download the module here:
http://code.msdn.microsoft.com/Remote-StsAdm-in-6fec24b8

English

If you have read my comments on the Writing Custom Web Service for SharePont, Is it supported here (http://blog.libinuko.com/2011/02/16/sharepoint-writing-custom-web-service-for-sharepoint-is-it-supported/) ; you may have already created standard ASPNET web services. It is working, but with some limitation:

1. You can not have path virtualization

   Virtualization is one of SharePoint’s technique provided by SPVirtualPath provider, that enable virtualization of your web service path. For example, list.asmx will be available for http://mysite.com/_vti_bin/lists.asmx , or http://mysite.com/sites/myothersitecollection/_vti_bin/lists.asmx. The site collection has been virtualized by SharePoint.

   Without virtualization any web service consumer will have to access to the same path, usually in the root; for example /_services/mywebservice.asmx">/_services/mywebservice.asmx">http://<webapps>/_services/mywebservice.asmx

2. You can not have SPContext

   SPContext is very powerful object in SharePoint development. Using this context, we can retrieve current SharePoint context without having to instantiate it. For example, you can get current SPWeb by calling SPContext.Current.Web – and you don’t need to dispose it (in fact you’re not suppose to dispose it). Still using SPContext you can have direct access to list and everything under SharePoint.

   Without having direct access to SPContext, you have to instantiate SPWeb or SPSite using normal constructor with URL as parameter. It means new SPSite/SPWeb thread in the server memory, and you have to dispose it once you’ve done working with it.

So, how can we write custom web service for SharePoint in supported mode?

Before we start, we have to understand SharePoint architecture and how does the processing works for web services. I take following picture from SharePoint Architecture in MSDN. It describe how SharePoint process our request. There is SPHttpApplication which has SPRequestModule and any additional ASP.NET Module; and before the request returned back to the user SPHttpHandler is doint the job.

How SharePoint process web services?

If we dig into into the process on how SharePoint process request to web services in _vti_bin.

There are 3 scenarios of http request to the web services,

1. Disco request, identified by suffix ?DISCO in the web service address. For example, */_vti_bin/list.asmx?Disco
2. WSDL request, identified by suffix ?WSDL in the web service address. For example, */_vti_bin/list.asmx?Wsdl
3. Web service post request. For example, */_vti_bin/list.asmx?op=GetListItems

Every request will be processed by SPHttpHandler (SharePoint) and ScriptHandlerFactory (system.web.extension), but the SPHttpHandler will be selective only for Disco and Wsdl request.

On disco/wsdl request, SPHttpHandler will transfer the request to wsdisco.aspx or wswsdl.aspx using Server.Execute operation. This operation ensure that wsdisco.aspx/wswsdl.aspx is receiving same request object. wsDISCO.aspx or wsWSDL.aspx will then instantiate SharePoint Context object. Any *.aspx will be successfully instantiate SharePoint context object because they are managed by SPHttpApplication and hence it also impacted by SPVirtualPath provider from SharePoint which will activate path virtualization.

Next, wsDISCO.aspx will transfer the request to the <service>DISCO.aspx and wsWSDL.aspx will transfer to the <service>WSDL.aspx – using Server.Execute operation. So here we have seen 2 transfer operation. At the end, the result is correct WSDL/DISCO request. The correct WSDL/DISCO will point to the correct virtual path of the request. (Remember how do you create <service>disco.aspx / <service>wsdl.aspx)

When a consumer use the contract and tries to consume it. The SPHttpHandler will no longer intercept the request, but the normal ScriptHandlerFactory from System.Web.Extensions. However with the correct path in disco/wsdl, now the asmx now have the ability to look into current context from SharePoint. And hence you will be able to use SPContext.Current.Web in custom web services.

Part-2 is how to start create custom web services. I will need help from my buddy Denni , he will code for me. –

References

1. Writing Custom Web Services for SharePoint Products and Technology (http://msdn.microsoft.com/en-us/library/dd583131(v=office.11).aspx)

2. SharePoint Architecture (http://msdn.microsoft.com/en-us/library/bb892189(v=office.12).aspx )

3. Architectural Overview of Windows SharePoint Services (http://msdn.microsoft.com/en-us/library/dd583133(v=office.11).aspx)

4. Modifying Built-In SharePoint Files (http://msdn.microsoft.com/en-us/library/bb803457(v=office.12).aspx)

English:

Some of you may be not aware that we can use SharePoint List for Visio Diagram data source. So how can we configure SharePoint List for Visio Diagram data source?

Following steps demonstrate how to do it using SharePoint 2010 and Visio 2010, however it also applies to SharePoint 2007 or Visio 2007.

Step-by-step

1. Open Visio (.vsd) file.
2. On Data tab, and  Link Data to Shapes.

   

3. On  Data Selector window, choose Microsoft SharePoint Foundation list.

   

4. Type SharePoint website URL

   

   Note: Enter username and password combination if necessary.

   

5. Choose SharePoint list that you want to use, then click Next and Finish.
   
   
6. You will return to the main Visio diagram with data table from SharePoint list. Then you can use the table (linked-to-SharePoint List) as data source for your diagram.

   

Source: http://social.technet.microsoft.com/wiki/contents/articles/4225.aspx

English

There are some webcast about Microsoft Project 2010 Solution Starters. It demonstrate the power and extensibility of SharePoint 2010 and Project 2010. Find out yourself on user experience series and code walkthrough here:

User experience series:

1. Microsoft Project 2010 Solution Starters – User Experience #1
2. Microsoft Project 2010 Solution Starters – User Experience #2

Code walkthrough:

1. Microsoft Project 2010 Solution Starters Drilldown & Code Walkthrough #1
2. Microsoft Project 2010 Solution Starters Drilldown & Code Walkthrough #2
3. Microsoft Project 2010 Solution Starters Drilldown & Code Walkthrough #3
4. Microsoft Project 2010 Solution Starters Drilldown & Code Walkthrough #4

So , are you dare to take the challenge and move to the new platform?

English

A few days ago, Microsoft has released Service Packs 1 for SharePoint 2010. As usual, the installation must follow general rules of installation order:

1. SharePoint Foundation
2. SharePoint Foundation Language Packs
3. SharePoint Server 2010
4. SharePoint Server 2010 Language Packs

And if you have SharePoint Server 2010, you can run SharePoint Configuration Wizard after completing installation of all service packs. You can skip SharePoint Configuration Wizard on installation order 1-3.

If you have multiple servers in a farm, make sure that you have perform the installation in all servers before kicking-in SharePoint Configuration Wizard in the server.

More information from the team blog : http://sharepoint.microsoft.com/blog/Pages/BlogPost.aspx?pID=984

English:

Conditional formatting now becomes easier using SharePoint Designer 2010. We can create intelligent view which able to highlight some important pointer in the display. There are 3 types of conditional formatting:

1. Show content , show content based on the pre-specified conditions
2. Hide content , hide content based on the pre-specified conditions
3. Apply formatting , apply formatting based on the pre-specified conditions.

Visual Touch for Easy Reading

Imagine, that you have developed a workflow that uses task list to assign task to the users. The standard task list, may look like this:

Actually there is nothing wrong with the task list web-part. However, since there isn’t any pointer on important information in the task list – then the message may not be conveyed efficiently to the reader.

Using conditional formatting, we will be able highlight overdue tasks, so that the task will get more attention from the user. In the picture below, we add red hand icon, if the task is overdue.

So, how would we do that?

Following step-by-step will show how to create conditional formatting using SharePoint Designer 2010. I will demonstrate how to add red-hand icon to the overdue task.

1. Open original task list view in SharePoint Designer 2010.

2. Select Title column tag and then create conditional formatting by selecting Apply formatting….

3. Define formatting condition as follows:

Due Date  <  [Current Date]     And

Status      <>  ‘Completed’

and then click Set Style.

4. I have uploaded the icon in Site Assets gallery, so that I can use it as background-image.

And finally I have configure my style to:

background-image: url(‘../../SiteAssets/Pointer_red_22x17.gif’); background-repeat: no-repeat; background-position: left bottom; text-indent: 20px

5. Save the changes, and you’ve done with the conditional formatting.

Finally, adding visual touch using conditional formatting is also adding more value to the user. It will make the information more knowledgeable than plain presentation.

English:

So what is the largest number in SharePoint numeric column?

Before we can answer this question, let take a look how SharePoint store the data in SQL table. By design, SharePoint will map specific column type in SharePoint into SQL data type; they are nvarchar, ntext, sqlvariant, int, float and bit. For example, true/false column will be mapped to bit and numeric column will be mapped to float.

There are two types of float data type in SQL, 7 digits or 15 digits precisions (http://msdn.microsoft.com/en-us/library/ms173773.aspx). And of course, Microsoft’s engineer will choose the larger precision 15 digits – using 8 bytes storage. (See table below)

n is the number of bits that are used to store the mantissa of the float number in scientific notation.

The nvalue represent the number of bits that are used to store the mantissa of the float number. Therefore the maximum value of the float number is 2^53 =  9.00719925 × 10¹⁵ .

Precision represent the length of significant digit to which a number can be represented. When a number contains digits more than max precision digits, then it will be rounded up/down to the precision digits. For example, 12345 will be seen as 1.2345 x 10⁴ in 5 digits precisions or 1.235 x 10⁴ in 4 digits precisions. Hence bigger precision is desirable to represent the exact number, otherwise it will only represents approximation value.

Since SQL Server specifies 15 digits precision for its floating point, then you must be-careful for any number with more than 15 digits. For example, the 999,999,999,999,999 is maximum exact value based on 15 digits precision. Any number above that, even with different as small as 0.1 will be an approximate value; for example 999,999,999,999,999.1 is same as 999,999,999,999,999 . And if you do arithmetic operation – then you may end-up with big floating error.

So what is the impact?

1. Storage Boundaries (2^53)
   This boundaries limits the maximum value which can be stored in a numeric column. You can’t save 9.007199256 x 10¹⁵ without rounding. And everything beyond this storage boundaries will be ignored and saved as 2^53 value.
2. Precision Boundaries (15 digits)
   This boundaries limit the number of digits before SQL starts to round-up/round-down. Remember floating data is approximate , and therefore not all value can be represented as is.  As you may guess, if you try to save 999,999,999,999,999.5 – you will end-up with 1,000,000,000,000,000 value.

The good news is, we have used SQL floating data type without any problem; so we put the same faith to SharePoint numeric column. However, if you want to use SharePoint or SQL table, please ensure that you have enough precision for your data.

English

In previous post I have demonstrated “How to create cascading lookup field” in SharePoint 2010 using InfoPath. I will extend the possibility by utilizing Client Object Model and SharePoint Designer; therefore we don’t need InfoPath to have the cascading lookup field.

Using same scenario where City is cascading lookup field from the selected Country, we’ll see together how Client Object Model solve the problem. In this solution we need to create JS referral to SP.js for Client Object Model and JQuery to help us working with DOM.

Some key points in the video:

1. Put JQuery distribution in 14hive\Layouts.

2. Add Javascript link referral in the AdditionalPageHead place holder.

   1: <SharePoint:ScriptLink Language="Javascript" Localizable="False" runat="server" Name="jquery-1.4.4.min.js"/>

   2: <SharePoint:ScriptLink Name="SP.js" runat="server" OnDemand="true" Localizable="false"/>

3. Add Javascript code to modify cascading selector and create Client Object Model call to retrieve cascaded value in Main conten place holder.

   1: <script type="text/javascript">

   2: // JQuery_Script

   3: 

   4: var spListItems;

   5: 

   6: // Cascading lookup main function

   7: function FilterLookup(filterSource,lookupList)

   8: {

   9:    var filterElement = $("select[title='" + filterSource + "'] option:selected");

  10:    if(filterElement.length == 0) return;

  11: 

  12:    var selectedFilterText =  filterElement.text();

  13:    var selectedFilterValue = filterElement.value;

  14:

  15:    var clientCtx = new SP.ClientContext.get_current();

  16:    var spList = clientCtx.get_web().get_lists().getByTitle(lookupList);

  17:

  18:    var camlQuery = new SP.CamlQuery();

  19:    camlQuery.set_viewXml('<View><Query><Where><Eq><FieldRef Name=\''+ filterSource +'\'/>' +

  20:         '<Value Type=\'Text\'>'+ selectedFilterText +'</Value></Eq></Where></Query></View>');

  21:

  22:    this.spListItems = spList.getItems(camlQuery);

  23:    clientCtx.load(spListItems);

  24:    clientCtx.executeQueryAsync(Function.createDelegate(this, this.onQuerySucceeded), Function.createDelegate(this, this.onQueryFailed) );

  25:

  26: } // 

  27: 

  28: function onQuerySucceeded(sender, args) {

  29: 

  30:    alert(this.selectedFilterText);

  31:    // Get CityElement Select or Input

  32:    var cityElement = $("select[title='City']");

  33:    if(cityElement.length == 0) { alert('Unknown'); }

  34: 

  35:     var options = '';

  36:     var listItemEnumerator = spListItems.getEnumerator();

  37:

  38:     while (listItemEnumerator.moveNext()) {

  39:         var oListItem = listItemEnumerator.get_current();

  40:         options += '<option value="' + oListItem.get_id() + '">' + oListItem.get_item('Title') +'</option>';

  41:     }

  42:    cityElement.html(options);

  43: }

  44: 

  45: function onQueryFailed(sender, args) {

  46:     alert('Request failed. ' + args.get_message() + '\n' + args.get_stackTrace());

  47: }

  48: 

  49: 

  50: // Attach function on document ready

  51: $(document).ready(

  52:    function() {

  53:       ExecuteOrDelayUntilScriptLoaded(FilterLookup,"sp.js");

  54:       //FilterLookup("Country","City");

  55:

  56:        // Get CountryElement Select or Input

  57:       var countryElement = $("select[title='Country']");

  58:       if(countryElement.length == 0)

  59:       {

  60:            countryElement = $("input[title='Country']");

  61:       }

  62:       if(countryElement.length != 0) {

  63:        if(countryElement[0].optHid) {

  64:           $("input[id='" + countryElement[0].optHid + "']").bind("propertychange", function() { FilterCity(); });

  65:

  66:        } else{

  67:           $("select[title='Country']").change(function() { FilterLookup("Country","City"); });

  68:

  69:        }

  70:

  71:    }

  72:

  73: 

  74:    }); // Document ready

  75: 

  76: </script>

4. Finally save and set the new form as default form.

English

Either you’re SharePoint geeks or newbie, intellisense is always helpfull to provide inline guidance. Previously we need to configure Visual Studio environment manually to get very basic information about CAML schema.

After all, we always need better and better tools for the job.  Thanks to John F. Holliday , that provides free Visual Studio 2010 add-ins for more sophisticated CAML intellisense - the CAML.Net.Intellisense. You can download the bits in Visual Studio Gallery ( Gallery > Tools > caml.net.intellisense). Nice job John.