WSSAdmin Guide
Russian

Download <= Last Version!!!     Version-2007 Top

Free Website Counter Free Website Counter

 Windows SharePoint Services & Windows SharePoint Portal

Admin Tool

 


1.     Purpose

Management of objects Windows SharePoint Portal (Windows SharePoint Services). Allows looking through hierarchy of objects in the form of a tree, to carry out viewing and editing of properties of objects, copying and removal of objects.

The program works in the console of a server on which it is installed SharePoint Services. It is required MS .NET v.2.0. If you use WSS only, add this files into program directory.

2.     Functionality

2.1.          Viewing of hierarchy of objects

Viewing is carried out in the form of a tree of objects in the two-panel form. The left panel gives initial data for administrative actions, right gives target objects.

 

 

After start of the program the uppermost units of hierarchy of objects open:

  • Server – computer on which the program is started
    • SharePoint Services – hierarchy from the point of view of object SPGlobalAdmin.
    • SharePoint Portal – hierarchy from the point of view of object TopologyManager.

Activization of units of a tree (by mouse or by keyboard), representing objects, leads to sample of data for formation of a following level of hierarchy. For convenience of perception the same objects at one level of hierarchy are collected in groups (the name of group is deduced by a green font). The information on the allocated object is deduced on unit of a tree, in a status line of the form and in the tooltip of a status line. The volume of the deduced information depends on type of object (the type is deduced in the left floor of a status line).

Disclosing and closing of subtree (if it is) is carried out by pressing a corresponding element to the left of unit of a tree of objects.

For performance of operations objects should be noted [1] by mouse in a floor of a mark the corresponding unit. The mark of all subtree is carried out at pressed key Ctrl.

Performance of operations is initialized through items of the menu of the form, hot keys or through items of the context menu. The size and position of the form are kept in the user file of a configuration and restored in next session.

Refreshing of the information is carried out by a choice of item of the menu «Refresh» or by pressing of keys Ctrl-R. Subtree of objects is formed anew since allocated (on which pressing by the mouse is executed).

2.2.          Copying of objects (F5)

It is carried out by a choice of the menuitem «Copy» or pressing of a key F5.

The objects marked on the left panel are copied in marked objects on right.

Following operations of copying can be executed:

Source object

Target object

Result of copying

Features of algorithm

Top-level site.

Type - SPSite



Simple WSS site.

Type - SPWeb[2]

Virtual server WSS
Type –
SPVirtualServer

The requested quantity of new top-level sites with structure and contents of initial object, including lists, libraries and subsites (objects of type SPWeb).

The new object is formed with a new name (at presence same on target object). The new object is formed with a new name (at presence same on target object). Copying is carried out with intermediate preservation in a template of a site and the subsequent restoration.

At success temporary objects (the pattern and a file on a disk) leave.

Before the beginning of copying the desirable quantity of cycles of performance is requested [3].

At copying on portal area the type of target object is requested.

Top-level site

Type – SPSite

The requested quantity of new subsites with structure and contents of initial object, including lists, libraries and subsites (objects of type SPWeb).

Simple WSS site

Type – SPWeb

Portal area
Type
Area

The requested quantity new subsites on a site of area with structure and contents of initial object and the same quantity of subareas with references to corresponding sites (through "listings" on subareas).

Portal area

Type - Area

Portal area
Type
- Area

New subarea with page default.aspx, as at initial area, including lists, libraries and web-parts.

The name of the area, being unique at the moment of performance of operation steals up. The opportunity to edit a name is given to the user.

File

Type - SPFile

Top-level site

Type - SPSite

New file in the root folder of root object of type SPWeb

Binary copying a file («as is») is carried out; the type and purpose of a file are not analyzed. Same files are replaced.

Simple WSS site

Type - SPWeb

New file in the root folder of site

Folder on site

Type - SPFolder

New file in the target folder.

List

Type - SPList

Top-level site

Type - SPSite

New list[4] in target[5].

 

The structure of the list, data of records and the attached files are copied.

At presence in the receiver of the same list records of both lists are united.

Simple WSS site

Type - SPWeb

Portal area
Type
- Area

Web part

Type – descendants of a class WebPart

File

Type – SPFile

New web-part in target zone.

The web-part is copied with all available adjustments[6].

Web parts zone

Type - WebPartZone

 

2.3.          Deleting (F8)

It is carried out by a choice of the menuitem «Delete» or by pressing of key F8.

Objects of following types can be deleted[7]:

Top-level site[8], simple site WSS[9], portal area[10], file, list and web-parts (Types - SPSite, SPWeb[11], Area, SPFile, SPList, and descendants of WebPart).

 

2.4.          Viewing of properties (F3)

It is carried out by a choice of the menuitem «Properties» or by pressing of key F3.

Displaying of properties is carried out for the allocated object irrespective of the panel where it is, and from a condition of marks of other objects.

Viewing of properties is made in the separate panel. Properties which can be changed, selected semi boldface.

For text files (types aspx, ascx, htm, html, txt, etc.) there is an opportunity of change of the text of a file.

For lists there is an opportunity of editing of contents (at presence of those).

 

For a web-parts there is an opportunity of editing of parameters.

After editing properties of objects the button of saving of results of editing becomes more active («Save»).

The size and position of the form at the moment of closing are kept in the user file of a configuration and restored at following start of the form.

2.5.          Plugins.

The program allows to use the classes realizing interface WssTree.IPlugin (successors of class Plugin). The list of loaded plug-ins should contain in a file of a configuration.

 

3.     Configuration file.

The file “Wss Admin.exe.config” is used for management of work of the program. The file has following structure:

<?xml version="1.0" encoding="utf-8" ?>

<configuration>

<applicationSettings>

      <WssTree.Properties.Settings>

            <setting name="OwnerLogin" serializeAs="String">

                  <value>domain\user</value>

            </setting>

            <setting name="OwnerEmail" serializeAs="String">

                  <value>user@company.mail</value>

            </setting>

            <setting name="DefaultSitesRoot" serializeAs="String">

                  <value>sites</value>

            </setting>

            <setting name="CopySiteAlerts" serializeAs="String">

                  <value>False</value>

            </setting>

            <setting name="CopySiteSubWebs" serializeAs="String">

                  <value>True</value>

            </setting>

            <setting name="DelimiterInUrl" serializeAs="String">

                  <value>-</value>

            </setting>

            <setting name="TextFileExtensions" serializeAs="String">

                  <value>aspx,ascx,htm,html,txt</value>

            </setting>

            <setting name="Plugins" serializeAs="String">

                  <value>NullPlug.dll;CViz.dll</value>

            </setting>

      </WssTree.Properties.Settings>

</applicationSettings>

<userSettings>

      <WssTree.Properties.Settings>

            <setting name="NumberOfCopy" serializeAs="String">

                  <value>1</value>

            </setting>

            <setting name="PropFormSize" serializeAs="String">

                  <value>400, 300</value>

            </setting>

            <setting name="PropFormLocation" serializeAs="String">

                  <value>10, 10</value>

            </setting>

            <setting name="MainFormSize" serializeAs="String">

                  <value>650, 550</value>

            </setting>

            <setting name="MainFormLocation" serializeAs="String">

                  <value>-1, -1</value>

            </setting>

            <setting name="MainFormSplitterPos" serializeAs="String">

                  <value>325</value>

            </setting>

      </WssTree.Properties.Settings>

</userSettings>

</configuration>

Секция Plugins содержит перечень загружаемых плагинов.

Секция cviz содержит параметры плагина Vizualize.

The section applicationSettings contains the parameters used in the basic program:

  • OwnerLogin – the user appointed by the owner of new formed sites (SPWeb)
  • OwnerEmail – e-mail of that user.
  • DefaultSitesRoot – Name of a root of a tree of sites (by default – «sites»).
  • CopySiteSubWebs – Whether it is required to copy subsites.
  • DelimiterInUrl – The divider used in new urls.
  • TextFileExtensions – comma delimited list of extensions of names of text files.
  • Plugins – comma delimited list of plugins.
  • CopySiteAlerts – reserved.

The section userSettings contains the parameters specific to each user of the program:

  • NumberOfCopy – Quantity of spears at copying a web-sites (SPWeb). Value «0» causes inquiry of value in the user before the beginning of operation of copying. In the main menu of the program the parameter can be changed by item Tools/Settings.
  • MainFormSize, MainFormLocation and  MainFormSplitterPos – the size and position of the main form, and also position of a divider of windows of the form.
  • PropFormSize, PropFormLocation – the size and position of the form for viewing and editing of properties of objects.

 

4.     The working report.

Work of the program is recorded in daily files with a name of a kind «YYY-MM-DD.WSSAdmin.log».

The moments of start/finish and the basic actions which are carried out by the user with objects SharePoint are marked.

The file can be viewed in any text editor.

Intermediate messages show also in a status line of the main form.



[1]Objects of a tree, representing groups (which name are deduced by a green font), at performance of actions are not considered.

[2] Object SPWeb should be opened from structure «SharePoint Services»

[3]At the setting in a config-file for parameter NumberOfCopy of value 0.

[4]In a situation of the connected lists (one list uses data of another) the result can depend on the order of copying of lists. High-grade copying is possible only at copying in structure of a site.

[5]For numerical fields MinimumValue and MaximumValue are not transferred owing to incorrect realization of properties of object SPFieldNumber.

[6]The web-part for display of lists is copied without the user representation. High-grade copying is possible only at copying in structure of a site.

[7]In case of successful removal objects can remain in a tree. Execute updating higher unit.

[8] After removal a site, depending on speed of system, some time can be visible in a tree of objects.

[9]Leave also all subsites.

[10]Subareas leave also all.

[11] Object SPWeb may be opened from «SharePoint Services» structure