WebpageControlOptions XML 요소 참조
WebpageControlOptions 요소를 사용하여 웹 페이지에 대해 정의된 콘텐츠 또는 작업 항목 폼의 CDATA 태그 내에 정의된 콘텐츠를 표시할 수 있습니다. Link 또는 Content 자식 요소를 포함하여 폼에 표시할 콘텐츠에 대해 URL 또는 HTML을 지정할 수 있습니다.
폼에 요소를 추가하려면 작업 항목 형식을 수정합니다. 사용자 지정 작업 항목 형식 수정 또는 추가(WIT)를 참조하세요.
WebpageControlOptions 요소는 CONTROL 요소의 자식 요소입니다.
스키마 계층 구조
<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>
특성 및 요소
다음 단원에서는 특성, 자식 요소 및 부모 요소에 대해 설명합니다.
자식 요소 및 특성
요소 |
특성 |
설명 |
|---|---|---|
WebpageControlOptions |
|
Control인 경우 선택적 type="WebpageControl" 요소입니다. 작업 항목 폼에서 해당 콘텐츠를 렌더링할 URL을 정의하는 컨테이너 요소입니다. 선택적 Link 요소입니다. UrlPath를 지정할 경우 필수입니다. UrlPath를 지정할 때 하이퍼링크의 URL을 확인하는 데 사용할 값을 지정합니다. 요소 형식은 복합 형식인 WebpageControlOptionsType입니다. |
|
AllowScript |
선택적 WebpageControlOptions 특성입니다. 웹 페이지 내에서 JavaScript를 실행할 수 있는지 여부를 지정합니다(true 또는 false). 특성 형식은 xs:boolean입니다. ActiveX와 같은 기타 모든 설정은 클라이언트에 대해 정의된 Internet Explorer 설정을 기반으로 합니다. |
|
ReloadOnParamChange |
선택적 WebpageControlOptions 특성입니다. 작업 항목 폼의 매개 변수를 변경할 때(true) 웹 페이지의 콘텐츠를 다시 로드할지(true) 아니면 다시 로드하지 않을지(false)를 지정합니다. 특성 형식은 xs:boolean입니다. 기본값은 true입니다. |
Link |
|
선택적 WebpageControlOptions 요소입니다. 이 요소는 Content 요소와 함께 사용할 수 없습니다. 작업 항목 폼에서 렌더링할 웹 페이지의 URL을 지정합니다. 자세한 내용은 Link 및 Param XML 요소 참조를 참조하세요. |
Content |
|
선택적 WebpageControlOptions 요소입니다. 이 요소는 Link 요소와 함께 사용할 수 없습니다. 웹 페이지 컨트롤을 통해 렌더링할 HTML 콘텐츠를 지정합니다. 콘텐츠는 CDATA 태그 내에서 지정됩니다. 예: <![CDATA[Click here for detailed <b><a href="http://www.microsoft.com">Process Guidance</a></b>]]> 요소 형식은 xs:string입니다. 참고 HTML 콘텐츠를 작업 항목 폼에서 렌더링하기 전에 해당 유효성을 검사하지 않습니다. |
부모 요소
요소 |
설명 |
|---|---|
필수 부모 요소입니다. 작업 항목 폼에 나타나는 필드, 텍스트, 하이퍼링크 또는 기타 컨트롤 요소를 정의합니다. |
|
선택적 LabelText 요소입니다. 작업 항목 폼에 표시할 정보 또는 레이블에 대한 컨테이너 요소입니다. 자세한 내용은 LabelText 및 Text XML 요소 참조를 참조하세요. |
설명
Link 및 Content 요소는 함께 사용할 수 없습니다.
AllowScript 요소를 사용할 때는 ReloadOnParamChange 및 Content 특성을 사용할 수 없습니다.
웹 페이지 컨트롤이 원시 HTML을 표시하도록 구성된 경우 모든 스크립팅이 사용하지 않도록 설정됩니다. 작업 항목 폼이 Visual Studio 또는 Internet Explorer에서 표시되는 경우 콘텐츠에서 클릭하는 모든 하이퍼링크는 Visual Studio 웹 브라우저에서 열립니다.
WebpageControl을 포함하는 탭에 대해 여러 도구 모음 단추가 작업 항목 폼에 추가됩니다. 이러한 옵션에는 다음과 같은 기능이 포함됩니다.
뒤로/앞으로 탐색
콘텐츠 로드 중지 및 콘텐츠 새로 고침
콘텐츠 홈 페이지로 돌아가기
새 창이나 외부 브라우저에서 콘텐츠 열기
또한 로드할 웹 페이지에 신뢰할 수 없는 콘텐츠가 포함되어 있으면 아이콘이 차단되며 차단된 아이콘이 표시됩니다.
WebpageControlOptions 요소는 최신 버전의 팀 탐색기를 실행하는 클라이언트에서만 인식됩니다. 이전 버전의 경우에는 빨간색 영역이 표시되며 컨트롤을 찾을 수 없다는 메시지가 나타납니다. 자세한 내용은 작업 항목 폼에서 도움말 텍스트, 하이퍼링크 또는 웹 콘텐츠 제공을 참조하세요.
예제
다음 예제에서는 CDATA 태그에 정의된 HTML을 사용하여 작업 항목 폼을 로드하는 방법을 보여 줍니다.
<Control Type="WebpageControl">
<WebpageControlOptions>
<Content>
<![CDATA[Click here for detailed <b><a href="https://www.microsoft.com">Process Guidance</a></b>]]>
</Content>
</WebpageControlOptions>
</Control>
스키마 정의
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>
요소 정보
네임스페이스 |
https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/typedef |
스키마 이름 |
작업 항목 형식 정의 |
유효성 검사 파일 |
WorkItemTypeDefinition.xsd |
요소 형식 |
WebpageControlOptionsType |
비워 둘 수 있음 |
적용할 수 없음 |