Элемент 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, см. раздел определений.
Родительские элементы
Элемент |
Тип |
Описание |
---|---|---|
Содержит сведения, которые являются глобальными для надстройки. |
Дочерние элементы
Нет.
Атрибуты
Нет.