StartPage 要素 (PropertiesDefinition complexType)

(SharePoint アドイン マニフェスト)

適用対象: SharePoint アドイン |SharePoint Foundation 2013 |SharePoint Server 2013

通常、SharePoint アドインの起動時にアクセスしたページの URL。 ただし、アドインの起動時に呼び出されるコントローラー メソッドまたは Web サービス メソッドの URL を指定することもできます。

AppPrincipal 要素の子要素が Internal でない場合、StartPage 要素で指定されたページは、要求の本文で OAuth コンテキスト トークンを送信できるように、POST 動詞 (GET に加えて) をサポートするファイルの種類である必要があります。

POST をサポートするように Web サーバーで通常構成される一般的なファイルの種類は、aspx、php、およびサーバー側コードをサポートするその他の種類です。 内部アドイン プリンシパルを持つアドインは OAuth を使用しないため、このようなアドインの開始ページは、POST をサポートするようにターゲット Web サーバーで構成されていない型にすることができます。 たとえば、HTML ファイルは POST をサポートしていません。

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

リモート Web サーバーが、プロトコルが HTTP の場合は 80 以外のポート、プロトコルが HTTPS の場合は 443 以外のポートにバインドする場合は、次の例のようにポートを明示的に含める必要があります。

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

この要素の値には、開発時に不明な情報を表す特定のトークンを含めることができます。 上記の "{StandardTokens}" は例です。 詳しくは、「 SharePoint アドインの URL 文字列とトークン」をご覧ください。

Visual Studio でデバッグする場合、次の例のように、Microsoft Office Developer Tools for Visual Studio では、プロトコルとドメインの代わりに トークン ~remoteWebUrl' が使用されます。

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

トークンは、Visual Studio の SharePoint アドイン プロジェクトのコンテキスト メニューの [発行 ] オプションを使用してアドインをパッケージ化すると、Office Developer Tools for Visual Studio によって実際のプロトコルとドメイン (および必要に応じてポート) に自動的に置き換えられます。 発行ウィザードを使用しない場合 (または、リモート コンポーネントが Azure にデプロイされている場合)、SharePoint アドインをパッケージ化する前に、トークンを手動で置き換える必要があります。

アドインで OAuth を使用する場合、StartPage 値のドメイン部分は、SharePoint アドインが Microsoft Azure Access Control Service (ACS) に登録されたときに指定されたアドイン ドメインと完全に一致している必要があります。 詳細については、「 SharePoint アドインの登録」を参照してください。

要素の情報

定義

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

要素と属性

スキーマで sequence、minOccurs、maxOccurs、choice などの具体的な要件が定義されている場合は、定義のセクションを参照してください。

親要素

子要素

なし。

属性

なし。