Поделиться через


Элемент StartPage (PropertiesDefinition complexType)

(Манифест надстройки SharePoint)

Область применения: надстройки SharePoint | SharePoint Foundation 2013 | SharePoint Server 2013

Как правило, URL-адрес страницы, посещенной при запуске надстройки SharePoint. Однако это также может быть URL-адрес метода контроллера или метода веб-службы, который вызывается при запуске надстройки.

Примечание.

Строка app отображается как часть или все имена элементов, атрибутов и файлов, так как надстройки SharePoint изначально назывались приложениями для SharePoint. Чтобы обеспечить обратную совместимость, схемы не были изменены.

Если дочерний элемент элемента AppPrincipal не является Внутренним, страница, указанная в элементе StartPage , должна иметь тип файла, поддерживающий команду POST (в дополнение к GET), чтобы маркер контекста OAuth можно было отправить в текст запроса.

Распространенные типы файлов, которые обычно настраиваются на веб-серверах для поддержки POST, — aspx, php и другие типы, поддерживающие код на стороне сервера. Надстройки с внутренним субъектом надстройки не используют OAuth, и, следовательно, начальная страница таких надстроек может быть типом, который не настроен на целевом веб-сервере для поддержки POST. Например, HTML-файлы часто не поддерживают POST.

    <StartPage>http://domain_of_remote_component/Home.aspx?{StandardTokens}</StartPage>

Если удаленный веб-сервер привязывает удаленный компонент к порту, отличному от 80, если протокол http, или 443, если протокол HTTPS, порт должен быть явно включен, как показано в следующем примере.

    <StartPage>http://domain_of_remote_component:3333/Home.aspx?{StandardTokens}</StartPage>

Значение этого элемента может содержать определенные маркеры для представления сведений, которые не известны во время разработки. Примером является "{StandardTokens}". Для получения дополнительных сведений см Строки URL и маркеры в надстройках для SharePoint.

При отладке в Visual Studio средства разработчика Microsoft Office для Visual Studio используют токен ~remoteWebUrlвместо протокола и домена, как показано в следующем примере.

    <StartPage>~remoteWebUrl/Home.aspx?{StandardTokens}</StartPage>

Маркер автоматически заменяется фактическим протоколом и доменом (и портом, если это необходимо) средствами разработчика Office для Visual Studio, когда надстройка упаковается с помощью параметра Опубликовать в контекстном меню для проекта надстройки SharePoint в Visual Studio. Если вы не используете мастер публикации (или делаете это, но удаленный компонент развертывается в Azure), необходимо вручную заменить маркер перед упаковкой надстройки SharePoint.

Если надстройка использует OAuth, доменная часть значения StartPage должна точно соответствовать домену надстройки, указанному при регистрации надстройки в службе microsoft Azure контроль доступа (ACS). Дополнительные сведения см. в статье Регистрация надстроек SharePoint.

Важно!

Служба контроля доступа Azure (ACS), которая входит в состав Azure Active Directory (Azure AD), будет упразднена 7 ноября 2018 г. Это не влияет на модель надстроек SharePoint, использующую имя узла https://accounts.accesscontrol.windows.net (на который также не влияет это прекращение работы службы). Дополнительные сведения см. в статье Влияние упразднения службы контроля доступа Azure на надстройки SharePoint.

Сведения об элементе

Информация Расположение
Тип элемента UrlElementDefinition
Namespace http://schemas.microsoft.com/sharepoint/2012/app/manifest
Файл схемы appmanifest.xsd

Определение

    <xs:element name="StartPage" type="UrlElementDefinition" minOccurs="1" maxOccurs="1" >
         </xs:element>

Элементы и атрибуты

Если в схеме определяются конкретные требования, например sequence, minOccurs, maxOccurs и choice, см. раздел определений.

Родительские элементы

Элемент

Тип

Описание

Properties

PropertiesDefinition

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

Дочерние элементы

Нет.

Атрибуты

Нет.