XML-Elementreferenz für WebpageControlOptions

Sie können für eine Webseite oder in einem CDATA-Tag für ein Arbeitsaufgabenformular definierten Inhalt mit dem WebpageControlOptions-Element anzeigen. Sie können entweder das untergeordnete Link-Element oder das untergeordnete Content-Element einschließen, um entweder eine URL oder HTML für den Inhalt anzugeben, der im Formular angezeigt wird.

Das WebpageControlOptions-Element ist ein untergeordnetes Element des CONTROL-Elements.

Schemahierarchie

WITD

   WORKITEMTYPE

       FORM

           Layout

               Gruppe

               Spalte

               TabGroup

                  Registerkarte

                     Steuerelement

<xs:element name="WebpageControlOptions" type="WebpageControlOptionsType" minOccurs="0" maxOccurs="1" />
<xs:element name="Link" type="HyperLinkType" minOccurs="0" maxOccurs="1" />
<xs:element name="Param" type="HyperLinkParamType" minOccurs="0" maxOccurs="unbounded"/>

<WebpageControlOptions AllowScript="true | false" ReloadOnParamChange="true | false" >
   <Link UrlRoot="UrlRoot" UrlPath ="UrlPathWithParameters">
      <Param index="IndexValue " value="Param Value " type ="Original | Current"/>
   </Link>
   <Content>
      <![CDATA[Contents of HTML]]>
   </Content>
</WebpageControlOptions>

Attribute und Elemente

In den folgenden Abschnitten werden Attribute, untergeordnete Elemente und übergeordnete Elemente beschrieben.

Untergeordnete Elemente und Attribute

Element	Attribute	Beschreibungen
WebpageControlOptions		Optionales Control-Element, wenn type="WebpageControl". Containerelement zum Definieren einer URL, deren Inhalt im Arbeitsaufgabenformular gerendert wird. Optionales LINK-Element. Erforderlich, wenn UrlPath angegeben ist. Gibt einen Wert an, mit dem die URL des Links bestimmt wird, wenn UrlPath angegeben ist. Der Elementtyp ist der komplexe Typ WebpageControlOptionsType.
	AllowScript	Optionales WebpageControlOptions-Attribut. Gibt an, ob JavaScript innerhalb der Webseite ausgeführt (true) oder nicht (false) ausgeführt werden kann. Der Attributtyp ist xs:boolean. Alle anderen Einstellungen, z. B. ActiveX, basieren auf den für den Client definierten Internet Explorer-Einstellungen.
	ReloadOnParamChange	Optionales WebpageControlOptions-Attribut. Gibt an, ob (true) der Inhalt der Webseite erneut geladen werden soll, wenn ein Parameter im Arbeitsaufgabenformular (true) geändert wird, oder nicht (false). Der Attributtyp ist xs:boolean. Der Standardwert ist true.
Link		Optionales WebpageControlOptions-Element. Dieses Element schließt sich gegenseitig mit dem Content-Element aus. Gibt die URL für die Webseite an, die im Arbeitsaufgabenformular gerendert werden soll. Weitere Informationen finden Sie unter XML-Elementreferenz für Link und Param.
Content		Optionales WebpageControlOptions-Element. Dieses Element schließt sich gegenseitig mit dem Link-Element aus. Gibt den HTML-Inhalt an, der vom Webseiten-Steuerelement gerendert werden soll. Der Inhalt wird innerhalb eines CDATA-Tags angegeben. Beispiele: <![CDATA[Click here for detailed <b><a href="http://www.microsoft.com">Process Guidance</a></b>]]> Der Elementtyp ist xs:string. Hinweis Der HTML-Inhalt wird nicht vor dem Rendern im Arbeitsaufgabenformular überprüft.

Übergeordnete Elemente

Hinweise

Die Link- und Content-Elemente schließen sich gegenseitig aus.

Die AllowScript- und ReloadOnParamChange-Attribute sind nicht erlaubt, wenn Sie das Content-Element verwenden.

Wenn das Webseitensteuerelement dafür konfiguriert wird, unformatiertes HTML anzuzeigen, wird die gesamte Skripterstellung deaktiviert. Alle Links im Inhalt, auf die geklickt wird, werden im Visual Studio-Webbrowser geöffnet, wenn das Arbeitsaufgabenformular in Visual Studio oder im Internet Explorer angezeigt wird.

Mehrere Symbolleistenschaltflächen werden dem Arbeitsaufgabenformular für eine Registerkarte hinzugefügt, die WebpageControl enthält. Diese Optionen umfassen die folgenden Funktionen:

• Rück- und Vorwärtsnavigation

• Laden von Inhalt und Aktualisieren von Inhalt anhalten

• Zur Inhalts-Homepage zurückkehren

• Öffnen Sie den Inhalt in einem neuen Fenster oder in einem externen Browser

Außerdem, wenn die Webseite, die geladen werden soll, nicht vertrauenswürdigen Inhalt enthält, wird das Symbol blockiert, und das Symbol für die Blockierung wird angezeigt.

Das WebpageControlOptions-Element wird nur von Clients erkannt, die die neueste Version von Team Explorer ausführen. Bei früheren Versionen werden ein roter Bereich und eine Meldung angezeigt, die angibt, dass das Steuerelement nicht gefunden werden konnte. Weitere Informationen finden Sie unter Bereitstellen von Hilfetexten, Prozessleitfäden, Webinhalten und Links zu Webseiten auf einem Arbeitsaufgabenformular.

Beispiel

Im folgenden Beispiel wird gezeigt, wie ein Arbeitsaufgabenformular mit einem in CDATA-Tag definiertem HTML geladen wird.

<Control Type="WebpageControl">
   <WebpageControlOptions>
      <Content>
         <![CDATA[Click here for detailed <b><a href="https://www.microsoft.com">Process Guidance</a></b>]]>
      </Content>
   </WebpageControlOptions>
</Control>

Schemadefinitionen

WebpageControlOptionsType

<xs:complexType name="WebpageControlOptionsType">
   <xs:choice minOccurs="1" maxOccurs="1">
      <xs:element name="Link" type="HyperLinkType"/>
      <xs:element name="Content" type="xs:string"/>
   </xs:choice>
      <xs:attribute name="AllowScript" type="xs:boolean" use="optional" />
      <xs:attribute name="ReloadOnParamChange" type="xs:boolean" use="optional" />
</xs:complexType>

NonBlankString

<xs:simpleType name="NonBlankString">
   <xs:restriction  base="xs:string">
   <xs:pattern value=".*\S+.*"/>
   </xs:restriction>
</xs:simpleType>

Elementinformationen

Siehe auch

Konzepte

Angeben von Steuerelementen für Arbeitsaufgabenformulare

Entwerfen und Anpassen eines Arbeitsaufgabenformulars

Weitere Ressourcen

Bereitstellen von Hilfetexten, Prozessleitfäden, Webinhalten und Links zu Webseiten auf einem Arbeitsaufgabenformular

Änderungsprotokoll