Riferimento agli elementi XML WebpageControlOptions

Articolo
08/11/2011

È possibile visualizzare il contenuto definito per una pagina Web o all'interno di un tag CDATA su un form elemento di lavoro tramite l'elemento WebpageControlOptions. È possibile includere Link o gli elementi figlio Content per specificare un URL o un HTML affinché il contenuto appaia nel form.

L'elemento WebpageControlOptions è un elemento figlio di CONTROL.

Gerarchia dello schema

<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>

Attributi ed elementi

Nelle sezioni seguenti vengono illustrati attributi, elementi figlio e padre.

Elementi figli e attributi

Elemento	Attribute	Oggetto di descrizione
WebpageControlOptions		Elemento Control facoltativo quando type="WebpageControl". Elemento del contenitore per la definizione di un URL il cui contenuto verrà sottoposto a rendering nel form elemento di lavoro. Elemento LINK facoltativo. Obbligatorio quando UrlPath è specificato. Specifica un valore da utilizzare per determinare l'URL del collegamento ipertestuale quando UrlPath viene specificato. Il tipo di elemento è complesso: WebpageControlOptionsType.
	AllowScript	Attributo WebpageControlOptions facoltativo. Specifica se JavaScript all'interno della pagina Web può eseguire (true) o meno (false). Il tipo dell'attributo è xs:boolean. Tutte le altre impostazioni quale ActiveX si basano sulle impostazioni Internet Explorer definite per il client.
	ReloadOnParamChange	Attributo WebpageControlOptions facoltativo. Specifica se ricaricare (true) il contenuto della pagina Web quando viene modificato un parametro nel form elemento di lavoro (true) o meno (false). Il tipo dell'attributo è xs:boolean. Il valore predefinito è true.
Link		Elemento WebpageControlOptions facoltativo. Questo elemento e l'elemento Content si escludono a vicenda. Specifica l'URL per la pagina Web da sottoporre a rendering nel form elemento di lavoro. Per ulteriori informazioni, vedere Riferimento agli elementi XML Link e Param.
Content		Elemento WebpageControlOptions facoltativo. Questo elemento e l'elemento Link si escludono a vicenda. Specifica il contenuto HTML il cui rendering deve essere eseguito dal controllo pagina Web. Il contenuto viene specificato all'interno di un tag CDATA. Di seguito è riportato un esempio. <![CDATA[Click here for detailed <b><a href="http://www.microsoft.com">Process Guidance</a></b>]]> Il tipo di elemento è xs:string. Nota Il contenuto HTML non viene convalidato prima dell'esecuzione del rendering nel form elemento di lavoro.

Elementi padre

Elemento	Oggetto di descrizione
Controllo	Elemento padre obbligatorio. Definisce un campo, un testo, un collegamento ipertestuale o un altro elemento di controllo da visualizzare nel form dell'elemento di lavoro.
Testo	Elemento LabelText facoltativo. Elemento del contenitore per le informazioni o l'etichetta da visualizzare nel form dell'elemento di lavoro. Per ulteriori informazioni, vedere Riferimento agli elementi XML LabelText e Text.

Controllo

Elemento padre obbligatorio. Definisce un campo, un testo, un collegamento ipertestuale o un altro elemento di controllo da visualizzare nel form dell'elemento di lavoro.

Testo

Elemento LabelText facoltativo.

Elemento del contenitore per le informazioni o l'etichetta da visualizzare nel form dell'elemento di lavoro.

Per ulteriori informazioni, vedere Riferimento agli elementi XML LabelText e Text.

Note

Gli elementi Link e Content si escludono reciprocamente.

Gli attributi AllowScript e ReloadOnParamChange non sono consentiti quando si utilizza l'elemento Content.

Quando il controllo della pagina Web è configurato per visualizzare HTML non elaborato, lo scripting viene disabilitato. Qualsiasi collegamento ipertestuale nel contenuto su cui si fa clic viene aperto nel browser Web di Visual Studio se il form elemento di lavoro viene mostrato in Visual Studio o in Internet Explorer.

Diversi pulsanti della barra degli strumenti vengono aggiunti al form elemento di lavoro per una scheda che contiene WebpageControl. Queste opzioni includono le seguenti funzioni:

Navigazione indietro e in avanti
Interrompere il caricamento del contenuto e aggiornare il contenuto
Ritorna alla home page del contenuto
Aprire il contenuto in una nuova finestra o in un browser esterno

Inoltre, se la pagina Web da caricare contiene contenuto non attendibile, l'icona è bloccata e viene visualizzata.

L'elemento WebpageControlOptions viene riconosciuto solo dai client che eseguono la versione più recente di Team Explorer. Per le versioni precedenti, viene visualizzata un'area rossa e un messaggio viene visualizzato indicando che il controllo non è stato trovato. Per ulteriori informazioni, vedere Fornitura di Testo della guida, Linee guida per il processo, contenuto Web e collegamenti a pagine Web in un form elemento di lavoro.

Esempio

Nell'esempio seguente viene mostrato come caricare un form elemento di lavoro con HTML definito in un tag CDATA.

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

Definizioni dello schema

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>

Informazioni sull'elemento

Spazio dei nomi	https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/typedef
Nome di schema	Definizione del tipo di elemento di lavoro
File di convalida	WorkItemTypeDefinition.xsd
Tipo di elemento	WebpageControlOptionsType
Può essere vuoto	Non applicabile

Vedere anche

Concetti

Specifica dei controlli dei form elemento di lavoro

Progettazione e personalizzazione di un form elemento di lavoro

Altre risorse

Fornitura di Testo della guida, Linee guida per il processo, contenuto Web e collegamenti a pagine Web in un form elemento di lavoro

Cronologia delle modifiche

Data	Cronologia	Motivo
Maggio 2011	Sono state corrette le maiuscole/minuscole di diversi elementi e attributi della sintassi XML. La definizione dello schema per la gestione degli elementi di lavoro definisce tutti gli elementi figlio dell'elemento FORM come maiuscole-minuscole camel e porta in maiuscolo tutte le lettere nei nomi degli altri elementi.	Correzione di bug nel contenuto.
Gennaio 2011	Rimosso collegamenti a argomenti rimossi.	Miglioramento delle informazioni.

Maggio 2011

Sono state corrette le maiuscole/minuscole di diversi elementi e attributi della sintassi XML. La definizione dello schema per la gestione degli elementi di lavoro definisce tutti gli elementi figlio dell'elemento FORM come maiuscole-minuscole camel e porta in maiuscolo tutte le lettere nei nomi degli altri elementi.

Correzione di bug nel contenuto.

Gennaio 2011

Rimosso collegamenti a argomenti rimossi.

Miglioramento delle informazioni.

Condividi tramite