Sharepoint изнутри : SharePoint customization

Использование javascript в schema.xml. Некоторые особенности Calculated и Computed полей.

tvsmetanina — Thu, 16 Jul 2009 21:48:00 GMT

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

Все начиналось с простой задачи. Сделать индикатор в виде светофора. Это должно быть после списка в котором отображается картинка (красная, зеленая или желтая). Если документ просрочен, то отображается красная картинка, если до срока осталось 3 дня -то желтая, иначе зеленая.

Сначала решили сделать в списке Calculated поле. Сделать формулу труда не составило. Все условия есть, функций для работы с числами и датами много. Только вот одно но. Не рекомендуется использовать Today. А следовательно в реальном времени (без пересохрания элемента списка) сменить картинку индикатора нам не удастся при наступлении следующих суток картинка останется прежняя не зависимо от дат.

Бросила я затею с Calculated полем и решила сделать на основе Computed. В нем можно использовать Today. Поле перерисовыввается без пересохранения элемента списка, то есть в реальном времени. Только вот одно но (да, опять и еще одно). Нету у него нормальной работы с условиями. Можно проверять только на "=", а вот например на ">=" или "<=" нельзя.

И тут пришла идея поместить в тэг <HTML><![CDATA[ ]]></HTML> самый настоящий javascript, который бы проводил все рассчеты с датами и выводил бы картинку.

Когда это первый раз заработало описание поля в schema.xml выглядело следующим образом:

<Field ID="{FC9947C8-F094-45ff-854D-A6F7E9E5CF4C}"

Name="Indicator"

StaticName="Indicator"

Type="Computed"

ReadOnly = "TRUE"

DisplayName="$Resources:dplists, dpincdocfieldindicator;"

Required="TRUE" Filterable="FALSE">

</FieldRefs>

<HTML><![CDATA[if(enddate >= today && enddate <= threedaysafter ) { ]]></HTML>

<HTML><![CDATA[if(enddate > today ) {]]></HTML>

</DisplayPattern>

</Field>

В результате получилась вот такая вот штуковина:

Ссылки:

Calculated Field Formulas: http://msdn.microsoft.com/en-us/library/bb862071.aspx

Schema.xml: http://msdn.microsoft.com/en-us/library/ms459356.aspx

Field Element: http://msdn.microsoft.com/en-us/library/ms437580.aspx

Веб-части для Sharepoint

tvsmetanina — Wed, 22 Apr 2009 22:02:00 GMT

Одной из наиболее распространенных и повседневных задачь разработчика для платформы Sharepoint является разработка веб-частей. Это наиболее гибкий и доступный способ расширения функционала платформы. Несмотря на то, что в интернете сейчас достаточно статей про разработку веб-частей, не многие знают про все возможности и ньюансы.

Кому и зачем это надо?

Разрабатывая интернет сайт или внутренний корпоративный портал программисты стремятся к эллегантности кода и повторному использованию. Вы знаете, что Sharepoint – это платформа и для того, чтобы ваше решение было успешным - необходимо разрабатывать дополнительный функционал, будь то сервис новостей на сайте или сложные системы отчетности и документооборота, который будет обладать легкой и гибкой настройкой. Итак, основные преимущества веб-частей – это повторное использование и возможность добавления\настройки\использования через веб-интерфейс пользователями, которые могут не являться разработчиками и вообще могут не иметь отношения к IT. С элементами управления и пользовательскими элементами управления это сделать сложнее.

Веб-части прекрасно отчуждаемы от вашего решения и переносимы.

В данный момент тендернция разработки для Sharepoint заключается в том, что из всех компанентиков, элементов управления и т.д. создаются веб-части и могут быть добавлены в любых комбинациях на любую страницу и настроены администратором\редактором.

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

Основы основ

Для разработки нам понадобятся

· Microsoft^® Visual Studio^® 2005 или Microsoft^® Visual Studio^® 2008

· Visual Studio Extensions for Windows SharePoint Services 3.0 (для VS2005 или VS 2008).

В принципе можно разрабатывать и без экстеншна, создавая проект типа Class Library. Но установив extension вам станут доступны новые шаблоны проектов. Один из них – для разработки веб-частей.

Для того, чтобы создать веб-часть надо написать класс в Visual Studio .Net - наследник от одного из стандартных классов веб-частей.

Так исторически сложилось, что Sharepoint поддерживает два вида веб-частей.

Веб-части ASP.NET - наследуются от класса веб частей из System.Web.dll. Импортируются в .webpart файлы. Это наиболее рекомендуемый вариант.
Веб-части Windows SharePoint Services - наследуются от класса веб частей из Microsoft.Sharepoint.dll. Импортируются в .dwp файлы. Поддерживается для обратной связи с Sharepoint v2.

Наша первая веб часть может выглядеть следующим образом:

Для того, чтобы веб часть можно было поместить на страницу страница должна содержать зоны веб-частей, а мастер страница менеджер веб-частей. Страница Sharepoint на которой можно размещать веб-части выглядит следующим образом.

Установка веб-части на Sharepoint тоже не является непосильной задачей. Для этого необходимо:

· Положить сборку с кодом веб-части (.dll файл) в GAC (C:\Windows\assembly) или в bin папку в IIS веб-сайта

· Прописать веб-часть в web.config

· Добавить в библиотеку веб-частей Sharepoint. Для этого на коллекции узлов надо зайти в библиотеку веб-частей и перейти на страницу добавления веб-части. Если в веб конфиге всё было прописано правильно вы должны увидеть namespace вашей веб-части и сможете её добавить в библиотеку

С основами покончено. Пошаговую инструкцию как создать веб-часть можно найти здесь. Но это не всё, что я хочу рассказать вам про веб-части. Продолжение последует в ближайшие несколько дней.

Разгоняем Sharepoint до скорости Highload интернет сайта

tvsmetanina — Tue, 31 Mar 2009 10:17:00 GMT

Как известно, одиним из не очень приятных моментов при разработке интернет сайта на Sharepoint является его производительность. Но это не вердикт и с этим можно бороться.

В этой статье я коротко опишу основные возможности по кэшированию, используя которые можно существенно ускорить работу портала.

· Во-первых можно включать механизмы кеширования страниц Sharepoint через веб интерфейс

· Возможно включать кэширование объектов и использовать кэширование в разработанных вами веб-частях и элементах управления

· Существует BLOB cache и сжатие средствами IIS

· Необходимо делать оптимизацию страниц и мастер страниц, то есть отключать core.js и core.css там, где они не нужны, убирать ненужные элементы управления и т.д. Помещать ваши собственные сборки в GAC и обязательно подписывать их. Использовать <SharePointWebControls:ScriptLink runat="server"/> и <SharePoint:CssLink ID="CssLink1" runat="server" /> для подключения css и js вместо аналогов из html.

Теперь давайте по-порядку.

Кэширование возвращаемой страницы (Output caching)

Управляется на уровне коллекции узлов sharepoint. Кэширование вывода страницы может быть прервано для мастер страниц и дочерних узлов. Вы можете иметь разные настройки кэширования для ананимных и аутентифицированных пользователей. В стандартной поставке содержит 4 профиля, которые подходят для большинства сценариев. Страница применения профиля кэширования к коллекции сайтов выглядит следующим образом:

А теперь представим, что нам необходимо, чтобы при изменении какого-либо параметра в строке адреса (query string) страница бралась не из кэша, а отображалась и получала информацию заново. Этого можно достичь написав в поле Vary by Query String Parameters символ “*”

Что делать, если на странице должны быть элементы управления с динамической информацией при этом вся остальная страница должна кэшироваться? Нужно использовать Post-Cache Substitution control (http://www.nikhilk.net/PostCacheSubstitution.aspx)

Кэширование файлов (Blob cache)

Blob Cache помещает элементы SharePoint на диск на сервере. Опция отключена. Для включения необходимо отредактировать web.config.

Кэширование запросов и объектов (Object cache)

Активирован по умолчанию. Используется для быстрого доступа к элементам:

· Навигация и структура портала

· Поля и элементы списков

· Данные отображаемые в Content by Query web part

По умолчинию кэш объектов составлет 100MB и это можно изменить через веб-интерфейс.

Сжатие IIS

Добавить сжатие для JS и CSS можно выполнив в командной строке на сервере:

cscript adsutil.vbs set w3svc/filters/compression/gzip/hcfileextensions "htm" "html" "txt" "js" "css"

cscript adsutil.vbs set w3svc/filters/compression/deflate/hcfileextensions "htm" "html" "txt" "js" "css"

iisreset

IHttpModule и жесткая оптимизация

Совет для тех, кого просто бесит много лишнего текста в возвращаемой браузером странице потому что он эстет или гик (ненужное зачеркнуть), или стоит задача сделать страницы совсем маленькими и легкими. Для этого пишется IHttpModule в котором в методе Init страницы убирается из возвращаемого результата всё лишнее. Только убрать надо именно лишнее, т.е. то без чего ваша страница продолжит нормально работать ;)

Заключение

В подготовке статьи участвовали мозг, НЛО и материалы с MSDN:

Output Caching and Cache Profiles

Object Caching

Disk-based Caching for Binary Large Objects

Creating and Registering a Custom HTTP Module

Post-Cache Substitution

Утилита по экспорту\импорту настроек SSP в xml

tvsmetanina — Fri, 20 Mar 2009 17:44:00 GMT

На codeplex уже несколько месяцев как лежит утилита, умеющая выгружать в xml и загружать xml обратно на Sharepoint настройки SSP, такие как:

Managed Properties
Crawled properties
Content sources
Search scopes

Скачать утилиту можно тут: http://www.codeplex.com/SSSPPC/

Пример использования:

Экспорт: SSPC.exe -o export ManagedProperties -url http://moss/ssp/admin -file output_managedproperties.xml

Импорт: SSPC.exe -o import ManagedProperties -removeexcessmappings -url http://moss/ssp/admin -file output_managedproperties.xml

Создаём Фичу для изменения дизайна

tvsmetanina — Wed, 11 Mar 2009 03:05:00 GMT

Cегодня мы будем рассматривать один из способов смены дизайна портала Sharepoint – создание фичи.

Фичи (Features) – это не только основательно задокументированные баги, а еще и механизм, позволяющий добавлять новую функциональность, веб-части, страницы, элементы дизайна на сайт или коллекцию сайтов Sharepoint.

Для того, чтобы создать фичу, необходимо создать несколько файлов в формате xml. Основным из которых является feature.xml.

Более подробно о том, как создавать фичи и что они умеют можно прочитать на сайте Microsoft MSDN по адресу http://msdn.microsoft.com/en-us/library/ms475286.aspx

Создание фичи

Можно встретить различные рекомендации по разработке SharePoint Features из Visual Studio. Я предпочитаю использовать Visual Studio 2008, создавать проект по шаблону Class Library. Многим вероятно понравится VSeWSS - расширение для Visual Studio, позволяющее создавать уже практически готовые проекты для Sharepoint.

В итоге нам надо создать проект со структурой как на картинке слева.

То есть у нас должен быть сss файл, картинки и asp.net мастер страница.

Основным файлом, необходимым для работы Feature является файл feature.xml.

Каждая Feature имеет идентификатор, название, описание и область действия (сайт, коллекция сайтов и ферма).

Данная фича имеет еще один xml файл CopyFiles.xml в котором то и происходит копирование картинок, css и мастер страницы c диска на сервере на портал, то есть в базу данных портала.

Установка

Созданную Feature скопировать в папку C:\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\FEATURES. Там же можно посмотреть и изучить стандартные Features в Sharepoint.

Далее выполнить в командной строке: stsadm -o installfeature -name ExCustomDesign

Затем перейти на страницу активации возможностей и активировать её.

Далее надо применить установленную мастер страницу.

Избавляемся от ручной работы

А теперь, давайте избавимся от последнего шага, то есть выбора мастер страницы вручную. Для этого необходимо написать простенький FeatureReceiver:

И добавить в Feature.xml описание Receiver:

После активации фичи мы получили следующий результат.

На этом на сегодня всё. Про создание установочных пакетов и про шаблоны сайтов мы поговорим в следующих статьях.

Удачного сайтостроения!

Создание тем для сайтов Sharepoint используя CSS

tvsmetanina — Thu, 05 Mar 2009 00:50:00 GMT

Темы – самый простой и быстрый, но наименее гибкий способ изменения внешнего вида сайта Sharepoint. Поэтому, если задача стоит слегка перекрасить портал – сделайте это темами. Для того, чтобы создать свою первую тему не требуется глубоких знаний в сайтостроении или архитектуре Sharepoint. Достаточно будет знания CSS. Применить готовую тему можно через веб интерфейс Sharepoint. Страница с выбором темы выглядит следующим образом.

Темы применяются для каждого сайта Sharepoint отдельно и делается это действие администратором.

Давайте создадим первую в своей жизни тему. На сервере SharePoint перейдите в папку "C:\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\THEMES". В ней располагаются все стандартные темы Sharepoint. Скопируйте например папку с темой "SIMPLE". Переименуйте её на ваше усмотрение. Например "HABR".

В папке " HABR" удалите все изображения и переименуйте файл SIMPLE.INF в HABR.INF. Откройте HABR.INF и замените везде "Simple" на "HABR".

Перейдите в папку "C:\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\LAYOUTS\1033\" и отредактируете SPTHEMES.XML добавив выделенный текст:

Ну вот и всё. Мы создали тему. Теперь вооружаемся чем-нибудь типа Internet Explorer Developer Toolbar или любым другим add-on’ом для браузера, позволяющим работать с CSS. Кстати в IE8 есть встроенная консоль для разработчиков, обладающая нужными нам возможностями.

Итак, давайте изменим логотип и перекрасим выпадающее меню Site Action.

Напишем в theme.css следующее:

#siteactiontd div, .ms-siteactionsmenu div{

background-image: none !important;

background-color: #86C5EA !important;

font-family: Arial !important;

font-size: 12px;

}

td.ms-sitetitle {

width: 240px;

height: 130px;

background: 0 5px no-repeat url(habr_logo.gif);

}

h1.ms-sitetitle, td.ms-titleimagearea {

display: none;

}

Используйте !important, когда идет речь о переопределении.

Применим тему к сайту зайдя на страницу Site Actions / Site Settings / Site Theme.

Как видите, «раскрасить» портал – это просто! Спустя не более 20 минут у меня получился такой вот результат:

Состоялась веб-трансляция по разработке шаблонов узлов для Sharepoint

tvsmetanina — Thu, 26 Feb 2009 13:19:00 GMT

Всем присутствовавшим, спасибо!

Обещанные материалы, то есть запись, примеры кода и презентацию можно скачать тут: http://www.techdays.ru/videos/1233.html

Как исключить из индексирования страницы отдельные элементы управления и части контента?

tvsmetanina — Fri, 30 Jan 2009 21:01:00 GMT

Продолжаю делиться рецептами из личного опыта.

Возникла следующая проблема. Необходимо было при поисковой индексации страницы sharepoint исключить из индексирования баннеры и некоторые пользовательские элемены управления, расположенные на странице.

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

У меня получился вот такой элемент управления:

using System;

using System.Collections.Generic;

using System.Linq;

using System.Text;

using System.Web.UI;

namespace TestProject.WebControls

{

public class SearchCrawlTrimmedControl : Control

{

protected override void Render(HtmlTextWriter writer)

{

bool render = true;

if (this.Page.Request.UserAgent.ToLower().Contains("robot"))

{

render = false;

}

if (render)

{

base.Render(writer);

}

Использовать его можно следующим образом:

<XXX:SearchCrawlTrimmedControl runat=server >

</XXX:SearchCrawlTrimmedControl>

Находка дня

tvsmetanina — Mon, 26 Jan 2009 18:33:00 GMT

Столкнулась в очередной раз со следующей ошибкой при добавлении собственных пользовательских элементов управления на masterpage:

Server Error in '/' Application.
Parser Error
Description: An error occurred during the parsing of a resource required to service this request. Please review the following specific parse error details and modify your source file appropriately.
Parser Error Message: The page '/_catalogs/masterpage/Home.master' allows a limit of 11 direct dependencies, and that limit has been exceeded.

Смысл в том, что в web.config стоит ограничение на кол-во подключаемых элементов управления. За это отвечает параметр DirectFileDependencies и по умолчанию его значение = 10. То есть вы можете добавлять на master страницу 10 пользовательских элементов управления. В качестве решения проблемы можно отредактировать web.config поменяв значение на большее, или просмотреть вашу master страницу на наличие объявленных и не используемых пользовательских элементов управления и удалить их объявление (тэг <%@ Register ... %> ).

Изменение страницы Unhandled Exception (/_layouts/error.aspx)

tvsmetanina — Wed, 21 Jan 2009 21:22:00 GMT

В продолжение темы про интернет сайты создаваемые на MOSS 2007 и необходимость замены всех страниц, которые только могут увидеть пользователи, я покажу как можно переопределить стандартную страницу отображения ошибок error.aspx

Речь идет про переопределение вот этой, знакомой всем, страницы:

Переопределние производится в три шага:

1. Разработать IHttpModule и перекрыть событие Error

2. Создать страницу myerrorpage.aspx в папке 12\Template\Layouts. Создать можно скопировав и переименовав error.aspx

3. В web.config в секции httpmodules объявить модуль:

Ниже приведен код модуля:

using System;

using System.Web;

using System.Web.UI;

namespace MyProject

{

/// <summary>

/// Модуль для переопределения страницы Unhandled exception

/// </summary>

public class ExceptionEventHandler : IHttpModule

{

public void Init(HttpApplication context)

{

context.Error += new EventHandler(context_Error);

}

void context_Error(object sender, EventArgs e)

{

Exception[] unhandledExceptions = HttpContext.Current.AllErrors;

foreach (Exception ex in unhandledExceptions)

{

// логировать ошибки

}

HttpContext.Current.Server.ClearError();

HttpContext.Current.Response.Clear();

HttpContext.Current.Server.Transfer("/_layouts/myerrorpage.aspx");

}

public void Dispose()

{

}

Как закрыть доступ на просмотр системмных страниц и страниц списков Sharepoint для анонимных пользователей?

tvsmetanina — Tue, 20 Jan 2009 21:10:00 GMT

Несколько месяцев назад, рассматривая публичные сайты сделанные на MOSS 2007, меня удивляла одна вещь. Как на этих сайтах закрывают пользователю доступ к старницам просмотра списка, элементов списка, а так же к странице "Просмотр содержимого узла". Страницы эти как правило выбиваются из общего дизайна и для публичного сайта давать их на просмотр пользователям не очень хорошо.

Все оказалось очень просто. Есть стандартная фича ViewFormPagesLockdown которая и закрывает анонимным пользователям доступ на системмные страницы и страницы работы со списками типа http://<адрес>/_layouts/viewlsts.aspx, http://<адрес>/Lists/News/DispForm.aspx ..

Фича активируется для коллекции узлов. Сделать это можно используя stsadm, или добавив в секцию SiteFeatures в файле onet.xml шаблона узла.

Удачного сайтостроения!

Публикация и версионность в списках и библиотеках документов

tvsmetanina — Fri, 16 Jan 2009 23:04:00 GMT

Опытным путем было выяснено что механизм публикации (утверждения) с выключенной версионностью в списках и библиотеках документов работает не совсем корректно.

При попытке получить данные из списка, зайдя на портал под пользователем с правом на просмотр или вообще под ананимным пользователем, в результирующем наборе будут видны, например, элементы в статусе "Ожидает утверждения", чего быть никак не должно. Это повторяется только для элементов которые были утверждены хотябы один раз.

Проблема в том, что версионность в SP отключается только на интерфейсе, то есть перестают отображаться страницы и кнопки касающиеся версионности. Внутри же она продолжает использоваться при утверждении. Вот и происходит что при утверждении элемента списка создаётся еще одна версия, а при повторном изменении элемента списка он становится виден всем даже будучи не утвержденным, потому что в результирующий набор попадает первая утвержденная версия.

Вывод: чтобы не иметь проблем включайте публикацию и версионность в паре.

Веб каст по брендингу Sharepoint

tvsmetanina — Fri, 07 Nov 2008 11:01:00 GMT

В прошлый четверг я проводила веб трансляцию по брендингу Sharepoint.

Теперь эти материалы доступны в записи и со всеми примерами.

Посмотреть можно нажав на картинку или по ссылке: http://www.techdays.ru/Lecture.aspx?LID=5a858c4a-a428-49ce-937b-fafe7a392ba1

Веб каст по Брендингу Sharepoint

tvsmetanina — Thu, 30 Oct 2008 13:54:00 GMT

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

Обещанные исходники примеров на создание темы, мастер страниц, а так же Stapling фичу можно скачать тут

Веб трансляция по брендингу Sharepoint

tvsmetanina — Sun, 26 Oct 2008 22:31:00 GMT

В этот четверг 30 октября 2008 г. в 12.00 провожу небольшую веб трансляцию по брендингу Sharepoint. Кому интересно, присоединяйтесь.

Подробнее здесь: http://www.microsoft.com/Rus/events/detail.mspx?eventid=1032393590