StartPage-Element (PropertiesDefinition complexType)

Artikel
04/08/2023

(SharePoint-Add-In-Manifest)

Gilt für: SharePoint-Add-Ins | SharePoint Foundation 2013 | SharePoint Server 2013

In der Regel die URL der Seite, die beim Starten des SharePoint-Add-Ins aufgerufen wird. Es kann sich jedoch auch um die URL einer Controllermethode oder um eine Webdienstmethode handeln, die beim Starten des Add-Ins aufgerufen wird.

Hinweis

Die Zeichenfolge app wird als Teil oder als teil aller Element-, Attribut- und Dateinamen angezeigt, da SharePoint-Add-Ins ursprünglich als "Apps für SharePoint" bezeichnet wurden. Um die Abwärtskompatibilität sicherzustellen, wurden die Schemas nicht geändert.

Wenn das untergeordnete Element des AppPrincipal-Elements nicht Internal ist, muss die im StartPage-Element angegebene Seite einen Dateityp aufweisen, der das POST-Verb (zusätzlich zu GET) unterstützt, damit das OAuth-Kontexttoken für den Textkörper der Anforderung gesendet werden kann.

Allgemeine Dateitypen, die in der Regel auf Webservern für die Unterstützung von POST konfiguriert werden, sind aspx, php und andere Typen, die serverseitigen Code unterstützen. Add-Ins, die über einen internen Add-In-Prinzipal verfügen, verwenden OAuth nicht. Daher kann die Startseite solcher Add-Ins ein Typ sein, der auf dem Zielwebserver nicht für die Unterstützung von POST konfiguriert ist. HTML-Dateien unterstützen z. B. post häufig nicht.

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

Wenn der Remotewebserver die Remotekomponente an einen anderen Port als 80 bindet, wenn das Protokoll HTTP ist, oder 443, wenn das Protokoll HTTPS ist, muss der Port explizit wie im folgenden Beispiel eingeschlossen werden.

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

Der Wert dieses Elements kann bestimmte Token enthalten, um Informationen darzustellen, die zur Entwicklungszeit nicht bekannt sind. Das obige "{StandardTokens}" ist ein Beispiel. Weitere Informationen finden Sie unter URL-Zeichenfolgen und Tokens in Add-Ins für SharePoint.

Beim Debuggen in Visual Studio verwenden die Microsoft Office Developer Tools für Visual Studio das Token ~remoteWebUrl" anstelle des Protokolls und der Domäne, wie im folgenden Beispiel gezeigt.

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

Das Token wird automatisch durch das tatsächliche Protokoll und die Domäne (und ggf. port) von den Office-Entwicklertools für Visual Studio ersetzt, wenn das Add-In mithilfe der Option Veröffentlichen im Kontextmenü für das SharePoint-Add-In-Projekt in Visual Studio gepackt wird. Wenn Sie den Veröffentlichungs-Assistenten nicht verwenden (oder tun, aber die Remotekomponente in Azure bereitgestellt wird), müssen Sie das Token vor dem Packen des SharePoint-Add-Ins manuell ersetzen.

Wenn das Add-In OAuth verwendet, muss der Domänenteil des StartPage-Werts genau mit der Add-In-Domäne übereinstimmen, die beim Registrieren des SharePoint-Add-Ins bei Microsoft Azure Access Control Service (ACS) angegeben wurde. Weitere Informationen finden Sie unter Registrieren von SharePoint-Add-Ins.

Wichtig

Azure ACS (Access Control), ein Dienst von Azure Active Directory (Azure AD), wird am 7. November 2018 eingestellt. Diese Deaktivierung hat keinen Einfluss auf das SharePoint-Add-In-Modell, das den Hostnamen https://accounts.accesscontrol.windows.net verwendet, der von der Deaktivierung nicht betroffen ist. Weitere Informationen finden Sie unter Auswirkungen der Deaktivierung von Azure Access Control für SharePoint-Add-Ins.

Informationen zu Elementen

Informationen	Standort
Elementtyp	UrlElementDefinition
Namespace	`http://schemas.microsoft.com/sharepoint/2012/app/manifest`
Schemadatei	appmanifest.xsd

Definition

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

Elemente und Attribute

Wenn das Schema bestimmte Anforderungen definiert, z. B. sequence, minOccurs, maxOccurs und choice, lesen Sie den Abschnitt definition.

Übergeordnete Elemente

Element	Typ	Beschreibung
Properties	PropertiesDefinition	Enthält Informationen, die global für das Add-In sind.

Untergeordnete Elemente

Keine.

Attribute

None.

Freigeben über