WSSAdmin Руководство

1. Назначение

Управление объектами Windows Sharepoint Portal (Windows Sharepoint Services). Позволяет просматривать иерархию объектов в виде дерева, выполнять просмотр и редактирование свойств объектов, копирование и удаление объектов.

Утилита работает в консоли сервера, на котором установлен Шарепойнт (Портал). Для работы требуется MS .NET v. 2.0. 

Если установлен Шарепойнт без портала, файлы из spsdll.zip положите в папку программы.

2. Функциональность

   1. Просмотр иерархии объектов

Просмотр выполняется в виде дерева объектов в двухпанельной форме. Левая панель предоставляет исходные данные для административных действий, правая – целевые объекты.

Сразу после старта программы открываются самые верхние узлы иерархии объектов:

 

• Server – компьютер, на котором запущена программа

  • Sharepoint Services – иерархия с точки зрения объекта SPGlobalAdmin.

  • Sharepoint Portal – иерархия с точки зрения объекта TopologyManager.

Активизация узлов дерева (мышью или при помощи клавиатуры), представляющих объекты, приводит к выборке данных для формирования следующего уровня иерархии. Для удобства восприятия однотипные объекты на одном уровне иерархии собраны в группы (имя группы выводится зелёным шрифтом). Информация о выделенном объекте выводится на узле дерева, в статусной строке формы и во всплывающей подсказке статусной строки. Объём выводимой информации зависит от типа объекта (тип выводится в левом поле статусной строки).

Раскрытие/закрытие поддерева (если оно есть) выполняется нажатием на соответствующий элемент слева от узла дерева объектов.

Для выполнения операций объекты должны быть отмечены¹ мышкой в поле отметки  соответствующего узла. Отметка всего поддерева выполняется при нажатой клавише Ctrl. Выполнение операций инициализируется через пункты меню формы, горячими клавишами или через пункты контекстного меню.

Размер и положение формы сохраняются в пользовательском файле конфигурации и восстанавливаются при следующем сеансе работы.

2. Обновление информации (Ctrl-R)

Выполняется выбором пункта меню «Refresh» или нажатием клавиш Ctrl-R.

Поддерево объектов формируется заново начиная с выделенного (на который выполнено нажатие мышью).

3. Копирование объектов (F5)

Выполняется выбором пункта меню «Copy» или нажатием клавиши F5.

Отмеченные на левой панели объекты копируются в отмеченные объекты на правой. Могут быть выполнены следующие операции копирования:

Исходный объект	Целевой объект	Результат копирования	Особенности алгоритма выполнения
Сайт верхнего уровня, обычный сайт WSS Типы - SPSite, SPWeb2	Виртуальный сервер WSS Тип – SPVirtualServer	Запрошенное количество новых сайтов верхнего уровня со структурой и содержимым исходного объекта, включая списки, библиотеки и подсайты (объекты типа SPWeb).	Новый объект формируется с новым именем (при существовании одноименного на целевом объекте). Копирование выполняется с промежуточным сохранением в шаблон сайта с последующим восстановлением. При копировании многостраничных сайтов дополнительно копируется содержимое списков на сайте. Перед началом копирования запрашивается желаемое количество циклов. При копировании на портальную область запрашивается тип целевого объекта.
	Сайт верхнего уровня WSS Тип – SPSite	Запрошенное количество новых подсайтов со структурой и содержимым исходного объекта, включая списки, библиотеки и подсайты (объекты типа SPWeb).
	Обычный сайт WSS Тип – SPWeb
	Область портала Тип – Area	Запрошенное количество новых подсайтов на сайте области со структурой и содержимым исходного объекта и такое же количество подобластей со ссылками на соответствующие сайты (через «включения» на подобластях).
		Запрошенное количество новых подсайтов на сайте области со структурой и содержимым исходного объекта и такое же ссылок на соответствующие сайты (через «включения» на целевой области).
Область портала Тип - Area	Область портала Тип - Area	Новая подобласть со страницей default.aspx, как у исходной области, включая списки, библиотеки и веб-части.	Подбирается имя области, являющееся уникальным на момент выполнения оперпции. Пользователю предоставляется возможность отредактировать имя. После создания в целевой области новой подобласти по шаблону исходной области выполняется копирование страницы default.aspx.
Файл Тип - SPFile	Сайт верхнего уровня WSS Тип - SPSite	Новый файл в корневом каталоге корневого объекта типа SPWeb	Выполняется бинарное копирование файла («как есть»), тип и назначение файла не анализируются. Имеющиеся одноименные файлы заменяются.
	Обычный сайт WSS Тип - SPWeb	Новый файл в корневом каталоге сайта
	Папка на сайте Тип - SPFolder	Новый файл в целевом каталоге.
Список Тип - SPList	Сайт верхнего уровня WSS Тип - SPSite	Новый список3 в указанном приёмнике.	Копируется структура списка, данные записей и присоединённые файлы. При наличии в приёмнике одноименного списка записи обоих списков объединяются.
	Обычный сайт WSS Тип - SPWeb
	Область портала Тип - Area
Веб-часть Тип – потомки класса WebPart	Файл Тип – SPFile	Новая веб-часть в указанной зоне файла.	Веб-часть копируется со всеми имеющимися настройками4.
	Зона веб-частей Тип - WebPartZone

4. Удаление объектов (F8)

Выполняется выбором пункта меню «Delete» или нажатием клавиши F8.

Удаляются⁵ объекты, отмеченные на левой панели. Могут быть удалены объекты следующих типов:

Сайт верхнего уровня⁶, обычный сайт WSS⁷, область портала⁸, файл, список и веб-часть (Типы объектов - SPSite, SPWeb⁹, Area, SPFile, SPList, потомки класса WebPart).

5. Просмотр свойств объектов (F3)

Выполняется при нажатии клавиши F3 или при выборе пункта меню «Propeties».

Показ свойств выполняется для выделенного объекта независимо от панели, где он находится, и от состояния отметок других объектов.

Просмотр свойств производится в отдельной панели. Свойства, которые могут быть изменены, выделены полужирным.

Для текстовых файлов (типов aspx, ascx, htm, html, txt и др.) предоставляется возможность изменения текста файла.

Для списков предоставляется возможность редактирования содержимого (при наличии такового).

Для веб-частей предоставляется возможность редактирования параметров.

После редактирования свойств объектов активизируется кнопка сохранения результатов редактирования («Save»).

Размер и положение формы на момент закрытия сохраняются в пользовательском файле конфигурации и восстанавливаются при следующем запуске формы.

6. Плагины.

Программа позволяет использовать классы, реализующие интерфейс WssTree.IPlugin (наследники класса Plugin). Перечень загружаемых плагинов должен содержаться в файле конфигурации.

3. Файл конфигурации

Файл "Wss Admin.exe.config" используется для управления работой программы. Файл имеет следующую структуру:

<?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</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 содержит перечень загружаемых плагинов.
Секция applicationSettings содержит параметры, использующиеся в основной программе:

• OwnerLogin – пользователь, назначаемый владельцем вновь формируемых сайтов (объектов типа SPWeb)

• OwnerEmail – e-mail этого пользователя.

• DefaultSitesRoot – имя корневого пути дерева сайтов (по умолчанию – «sites»).

• CopySiteSubWebs – требуется ли копировать подсайты при копировании сайтов (объектов типа SPWeb).

• DelimiterInUrl – разделитель, использующийся при формировании новых адресов.

• TextFileExtensions – перечень (через «,») расширений имён файлов, которые являются текстовыми.

• Plugins – перечень (через «;») загружаемых плагинов.

• CopySiteAlerts – зарезервировано.

Секция userSettings содержит параметры, специфичные для каждого пользователя программы:

• NumberOfCopy – количество копий при копировании веб-сайтов (объектов типа SPWeb). Указание значения «0» вызывает запрос значения у пользователя перед началом операции копирования. В главном меню программы параметр можно изменить выбором Tools/Settings.

• MainFormSize, MainFormLocation и MainFormSplitterPos – размер и положение главной формы, а также положение разделителя окон формы.

• PropFormSize, PropFormLocation – размер и положение формы для просмотра/редактирования свойств объектов.
  

5. Протокол работы.

Работа программы протоколируется в ежедневные файлы с именем вида «ГГГГ-ММ-ДД.WSSAdmin.log».

Отмечаются моменты старта/финиша и основные действия, выполняемые пользователем с объектами Sharepoint.

Файл может быть просмотрен любым текстовым редактором.

Промежуточные сообщения показываются также в статусной строке основной формы.