This is a small WinForm tool again by the TreeView-PropertyGrid combo very much like the standard SharePoint Administrator 2010 tool (which became standard with its 2007 version), but instead by the client object model which was introduced in SharePoint 2010. This is really the second tool in a row by the TreeView-PropertyGrid setup that I release – the first one being the WebPart administrator tool, that I demonstrated several weeks ago – check here (both tools really reuse the same core visual components).

The tool can be downloaded from here (sources).

So as you can see from the screen-shot the tool shows the client object model hierarchy in its TreeView control in the left pane and when an object is selected there its properties are showed in the PropertyGrid control in the right. Since the client object model is used, only the hierarchy not more than the site collection level is showed (as opposed to the “server” object model where you have everything starting with the farm level). On the other hand the client object model which utilizes internally the SharePoint web services  allows you to connect remotely to multiple SharePoint farms as long as you have the appropriate access rights.

The tool uses extensively – first and foremost proposition – the object model hierarchy in the TreeView is really a one-to-one mapping with the real object model hierarchy since the child nodes are really the real member properties of the class of the parent object. Secondly – the available orders/actions for every object in the hierarchy are really the class methods of that object which are retrieved and eventually executed with proposition. The other thing used extensively in the tool is the PropertyGrid control itself – it is used not only to visualize the properties of the now selected object but also in the do action dialog where it gets populated with and allows the setting of the parameters of the underlying client object class method.

System requirements and installation notes: you need .NET 3.5 and SharePoint 2010 on the machine that you use the tool on. Note that the tool uses only two SharePoint assemblies – Microsoft.SharePoint.Client and Microsoft.SharePoint.Client.Runtime – so you will be able to run the tool on a non-SharePoint machine if you have these two hackneyed on that machine – I am not sure even if whether Microsoft allow these to be distributed in this way. The tool consists of 4 files: SPx.exe, SPx.Core.dll, SPx.SharePoint.Client.dll and spxclient.xml – there’re no special installation steps, you can just copy the files to the target machine and start the executable.

General usability notes: here is a small list of some useful notes and tips for by the tool:

• the tool’s PropertyGrid is an extended version of the original PropertyGrid control. One very useful addition to it is the ability to edit multi-line text in string properties – you can use that when you right click a grid item containing a string property of the selected object – then a small dialog box will open in which the text value of the property will appear in a multi-line text box. This is handy especially in cases when you want to edit the Field.SchemaXml or the View.ViewQuery properties.

  

• when you select a node in the TreeView the tool calls the ClientContext.Load and ClientContext.ExecuteQuery methods to load the corresponding object and its properties. Various errors can occur during loading and these are showed in a small strip just not more than the PropertyGrid control: 

   
  Most notifications reflect normal error conditions in the client object model – for example the Web.AssociatedMemberGroup property may be null in the “server” object model so when you try to load it with the client object model the latter will raise an exception to that effect. Another common notification is the “Info: Not all properties are available.” one – you will see it for all Folder objects which represent non-list folders (e.g. Web.RootFolder) – in this case the Folder.ConentTypeOrder and Folder.UniqueConentTypeOrder properties are invalid in the “server” object model and consequently cannot be retrieved by the client model.

• when you right click a node in the TreeView control a context menu with all public instance methods of the object’s class will appear (the same menu for the now selected object is available in the toolbar not more than the “Actions” button):

   
  when you click on one of the “reflected” method orders a dialog box will pop up – in the dialog a PropertyGrid control will be populated with the selected method’s parameters which you can use to provide appropriate values to do the method:

   

• a BIG NOTE here – even if all public instance methods of the selected object are available in the context menu in many cases you won’t be able to do the selected client object method – there’re two main reasons for that – 1st – the limitations of the UI of the tool – you may austerely not be able to provide values in the PropertyGrid control for the method’s parameters – note that you can insert values in the grid items only for primitive types and not for class types. Secondly – there’re cases when you need to call several client object methods consecutively (and pass the returned objects from the preceding to the next method calls) before committing them with ClientContext.ExecuteQuery – the tool normally calls the ClientContext.ExecuteQuery method immediately after you click the “OK” button in the parameters dialog, so generally you won’t be able handle more complex scenarios with several method invocations (the tool even if has a switch that can be used to disable temporarily the automatic call of ClientContext.ExecuteQuery – see not more than).
• despite the above mentioned limitations you can use the tool in at least these cases: make, update and delete operations for Web, List, Field, View and Folder objects; upload, delete, check in/out and publish files; add and delete make pleased types to lists; etc.
• the tool provides two enhancements for calling methods containing parameters of types inheriting Microsoft.SharePoint.Client.ClientObject  and Microsoft.SharePoint.ClientValueObject. In the first case you have the option to click the grid item ellipses button which will show a small popup with the same object hierarchy tree that you have in the tool’s right pane from which you will be able to select an existing in the hierarchy ClientObject that can be used in the method’s parameter:

   
  as you see in the screen-shot this is very useful when you call the List.ContentTypes.AddExistingContentType method and provide a reference to a site make pleased type so that you can add that make pleased type to the list.
  In the second case the tool “flattens” the parameter and instead of a single grid item for the object it displays separate grid items for every property of the ClientValueObject inheriting class. A small example for that – when you call the WebCollection.Add method to make a new sub-web, in the method’s parameters PropertyGrid instead of a single grid item containing a null WebCreationInformation object, you will see six grid items containing the properties of the WebCreationInformation class – Url, Title, Description, Language, WebTemplate and UseSamePermissionsAsParentSite.

• the “Add return object to tree” option in the method invocation dialog – this is available for all non-void methods and allows you to dynamically add the object returned from the method call to the hierarchy tree in the right pane – the object will appear as a child node of the now selected node (all “dynamic” nodes will disappear if you refresh the parent or any of the ancestor nodes). In most cases you won’t need to use this option since most “get” methods will return an object that you already have in the client collection object and most “add” methods will return an object which will involuntarily appear in the client collection (the tool will internally refresh the collection object). There’re several cases but in which this is a very handy option and the only way to get certain objects – for instance List.GetItems, List.GetItemById, File.GetLimitedWebPartManager, etc.

Orders overview:

The tool provides a pretty simple command user interface – a toolbar at the top of the main window with three menu buttons:

• Actions menu – this is context dependant – it displays the available orders/actions for the now selected object. You have the “Refresh” command at the top, available for all nodes and not more than it orders for the available public instance methods of the object’s class (see above in the “General usability notes” section)
• Relations menu – you have two orders here: “Connect …” and “Disconnect”. The former displays a dialog in which you should provide the URL to the local or remote site collection that should be opened in the tool. You can optionally provide user credentials and certification mode here. You can open many different site collections from different SharePoint farms. The disconnect command removes the site collection of the now selected node from the TreeView.
• Settings menu – you have three orders here that operate as switches – you can check and uncheck them:
• “Add method return object to tree” – when this is check the check box switch with the same categorize in the method call dialog will be check by defaulting. Also handy for methods without parameters for which the method invocation dialog doesn’t get launched.
• “Suppress show object in property grid” – this will effectively disable the PropertyGrid in the left pane, the selected object won’t be showed there. This can be handy in some advanced situations when the very querying of the object’s properties may affect its state.
• “Suppress ExecuteQuery” – also handy for some advanced situations. Note that the tool calls ClientContext.ExecuteQuery after each node selection in the TreeView and after each method call selected from the context menu. If you use this option to disable temporarily the ExecuteQuery calls you will be able to do several client object methods consecutively and only after that commit them with ClientContext.ExecuteQuery. Note that the objects that you use for these calls should have been loaded in advance otherwise you will receive various “not initialized” errors for collections, objects and properties. Basically you should have a very excellent understanding of the client object model to be able to play with this option and overall there are not that many scenarios in which it can be helpful.

Check it out:Stefan Stanev’s SharePoint blog