Управляемая навигация в SharePoint
Сведения о функции управляемой навигации на основе таксономии в SharePoint.
Общие сведения об управляемой навигации
Хорошо спланированная навигация поможет пользователям узнать о вашем предприятии, продукции и службах, предоставляемых веб-сайтом. Обновив таксономию навигации, предприятия могут стимулировать и подстраиваться под перемены, не переделывая навигацию своего сайта. Функция управляемой навигации в SharePoint позволяет разработать навигацию сайта на основе управляемых метаданных и создавать оптимизированные для поисковых систем URL-адреса, основанные на структуре управляемой навигации. Управляемая навигация является альтернативой традиционной (структурированной) навигации SharePoint, основанной на структуре SharePoint. Так как управляемая навигация основана на таксономии, ее можно использовать, чтобы разработать навигацию сайта с учетом важных бизнес-концепций, не меняя структуру сайтов и их компонентов.
Принцип работы управляемой навигации
Управляемая навигация предоставляет платформу для динамически создаваемых страниц и связанного URL-адреса, оптимизированного для поисковых систем. Каждая созданная страница представлена в иерархии навигации. Чтобы для каждой категории таксономии не требовалось создавать отдельные страницы, эта платформа предоставляет механизм шаблонов и наследования, который создает страницы для каждой навигационной ссылки. Вы можете использовать функцию тематических страниц, чтобы настраивать внешний вид этих страниц.
Интерфейсы API управляемой навигации встроены в компоненты таксономии и публикации SharePoint. Такие компоненты управляемых метаданных, как наборы терминов и банк терминов, используются, чтобы сайт поддерживал навигацию на основе таксономии. В библиотеке классов сервера .NET пространство имен Microsoft.SharePoint.Publishing.Navigation содержит термин, набор терминов и другие объекты классов, которые отражают класс Term и класс TermSet в пространстве имен навигации Microsoft.SharePoint.Taxonomy , предоставляя методы и свойства, специально предназначенные для связывания этих элементов метаданных с элементами навигации. Другие классы, например TaxonomySiteMapNode , позволяют предоставлять метаданные с различными элементами навигации сайта, например узлами карты сайта и другими элементами навигации сайта. Другие классы позволяют использовать кэширование и контекст для управляемой навигации.
В глобальной навигации могут отображаться ссылки навигации на основе таксономии. Глобальная навигация — это уровень навигации с одним или несколькими слоями, который всегда присутствует, обычно отображается в верхней части сайта и отображает категории контента верхнего уровня. Эти ссылки также могут отображаться в текущем элементе управления навигации, который часто отображается в левой части страницы. Текущий элемент управления навигации представляет следующий уровень иерархии для категории, выбранной в глобальной навигации, или набор ссылок, принадлежащих к этой категории.
Полнотекстовые URL-адреса и поставщик управляемой навигации
Посетив сайт SharePoint в первый раз, вы можете заменить, что формат URL-адресов изменился. Вместо адреса с расширением /Pages/default.aspx URL-адрес страницы заканчивается только /. Управляемая навигация предоставляет схему для полнотекстовых URL-адресов, согласованную на страницах сайтов, категорий и элементов.
Управляемая навигация позволяет создать такую среду. При переходе на корневую страницу любого сайта, использующего поставщика управляемой навигации, загружаемой страницей и ее внешним видом в браузере управляет параметр "Начальная страница сайта", но формат отображаемого URL-адреса (также показываемого в результатах поиска) меняется на более понятный.
У любой страницы, включая начальную страницу вашего сайта, может быть полнотекстовый URL-адрес. В зависимости от конфигурации сайта большинство страниц автоматически получают полнотекстовый URL-адрес. Полнотекстовые URL-адреса невозможно локализовать.
Интерфейсы API управляемой навигации
API таксономии предоставляет несколько новых методов и свойств в SharePoint, которые можно использовать для настройки терминов, наборов терминов и других элементов метаданных в банке терминов, используемых в сценариях навигации сайта. Эти интерфейсы API доступны в моделях программирования клиента .NET, сервера .NET, Silverlight и JavaScript.
Пример кода. Настройка управляемой навигации с API клиентской объектной модели .NET (CSOM)
При использовании клиентской объектной модели .NET для таксономии вы можете создать новый набор терминов навигации, если для текущего семейства веб-сайтов существует банк терминов, или преобразовать имеющийся набор терминов в набор, поддерживающий управляемую навигацию.
public class NavigationTermSetTests
{
public void CreateNavigationTermSet()
{
ClientContext clientContext = new ClientContext(TestConfig.ServerUrl);
TaxonomySession taxonomySession = TaxonomySession.GetTaxonomySession(clientContext);
taxonomySession.UpdateCache();
clientContext.Load(taxonomySession, ts => ts.TermStores);
clientContext.ExecuteQuery();
if (taxonomySession.TermStores.Count == 0)
throw new InvalidOperationException("The Taxonomy Service is offline or missing");
TermStore termStore = taxonomySession.TermStores[0];
clientContext.Load(termStore,
ts => ts.Name,
ts => ts.WorkingLanguage);
// Does the TermSet object already exist?
TermSet existingTermSet;
// Handles an error that occurs if the return value is null.
ExceptionHandlingScope exceptionScope = new ExceptionHandlingScope(clientContext);
using (exceptionScope.StartScope())
{
using (exceptionScope.StartTry())
{
existingTermSet = termStore.GetTermSet(TestConfig.NavTermSetId);
}
using (exceptionScope.StartCatch())
{
}
}
clientContext.ExecuteQuery();
if (!existingTermSet.ServerObjectIsNull.Value)
{
Log("CreateNavigationTermSet(): Deleting old TermSet");
existingTermSet.DeleteObject();
termStore.CommitAll();
clientContext.ExecuteQuery();
}
Log("CreateNavigationTermSet(): Creating new TermSet");
// Creates a new TermSet object.
TermGroup siteCollectionGroup = termStore.GetSiteCollectionGroup(clientContext.Site,
createIfMissing: true);
TermSet termSet = siteCollectionGroup.CreateTermSet("Navigation Demo", TestConfig.NavTermSetId,
termStore.WorkingLanguage);
termStore.CommitAll();
clientContext.ExecuteQuery();
NavigationTermSet navTermSet = NavigationTermSet.GetAsResolvedByWeb(clientContext,
termSet, clientContext.Web, "GlobalNavigationTaxonomyProvider");
navTermSet.IsNavigationTermSet = true;
navTermSet.TargetUrlForChildTerms.Value = "~site/Pages/Topics/Topic.aspx";
termStore.CommitAll();
clientContext.ExecuteQuery();
NavigationTerm term1 = navTermSet.CreateTerm("Term 1", NavigationLinkType.SimpleLink, Guid.NewGuid());
term1.SimpleLinkUrl = "http://www.bing.com/";
Guid term2Guid = new Guid("87FAA433-4E3E-4500-AA5B-E04330B12ACD");
NavigationTerm term2 = navTermSet.CreateTerm("Term 2", NavigationLinkType.FriendlyUrl,
term2Guid);
NavigationTerm childTerm = term2.CreateTerm("Term 2 child", NavigationLinkType.FriendlyUrl, Guid.NewGuid());
childTerm.GetTaxonomyTerm().TermStore.CommitAll();
clientContext.ExecuteQuery();
}
}
Пример кода. Настройка управляемой навигации с API серверной объектной модели .NET
Для создания нового набора терминов навигации можно использовать классы и методы таксономии сервера .NET в пространствах имен Microsoft.SharePoint.Taxonomy и Microsoft.SharePoint.Publishing.Navigation .
///Create a navigation term set.
using (SPSite site = new SPSite(TestConfig.ServerUrl))
{
using (SPWeb web = site.OpenWeb())
{
TaxonomySession taxonomySession = new TaxonomySession(site, updateCache: true);
/// Use the first TermStore object in the list.
if (taxonomySession.TermStores.Count == 0)
throw new InvalidOperationException("The Taxonomy Service is offline or missing");
TermStore termStore = taxonomySession.TermStores[0];
/// Does the TermSet object already exist?
TermSet existingTermSet = termStore.GetTermSet(TestConfig.NavTermSetId);
if (existingTermSet != null)
{
Log("CreateNavigationTermSet(): Deleting old TermSet");
existingTermSet.Delete();
termStore.CommitAll();
}
Log("CreateNavigationTermSet(): Creating new TermSet");
/// Create a new TermSet object.
Group siteCollectionGroup = termStore.GetSiteCollectionGroup(site);
TermSet termSet = siteCollectionGroup.CreateTermSet("Navigation Demo", TestConfig.NavTermSetId);
NavigationTermSet navTermSet = NavigationTermSet.GetAsResolvedByWeb(termSet, web,
StandardNavigationProviderNames.GlobalNavigationTaxonomyProvider);
navTermSet.IsNavigationTermSet = true;
navTermSet.TargetUrlForChildTerms.Value = "~site/Pages/Topics/Topic.aspx";
NavigationTerm term1 = navTermSet.CreateTerm("Term 1", NavigationLinkType.SimpleLink);
term1.SimpleLinkUrl = "http://www.bing.com/";
Guid term2Guid = new Guid("87FAA433-4E3E-4500-AA5B-E04330B12ACD");
NavigationTerm term2 = navTermSet.CreateTerm("Term 2", NavigationLinkType.FriendlyUrl,
term2Guid);
/// Verify that the NavigationTermSetView is being applied correctly.
Assert.AreEqual(web.ServerRelativeUrl + "/term-2", term2.GetResolvedDisplayUrl(null).ToString());
string expectedTargetUrl = web.ServerRelativeUrl
+ "/Pages/Topics/Topic.aspx?TermStoreId=" + termStore.Id.ToString()
+ "&TermSetId=" + TestConfig.NavTermSetId.ToString()
+ "&TermId=" + term2Guid.ToString();
Assert.AreEqual(expectedTargetUrl, term2.GetResolvedTargetUrl(null, null).ToString());
NavigationTerm childTerm = term2.CreateTerm("Term 2 child", NavigationLinkType.FriendlyUrl);
Assert.AreEqual(web.ServerRelativeUrl + "/term-2/term-2-child", childTerm.GetResolvedDisplayUrl(null).ToString());
/// Commit changes.
childTerm.GetTaxonomyTerm().TermStore.CommitAll();
}
}