WebpageControlOptions XML 요소 참조
업데이트: 2011년 5월
WebpageControlOptions 요소를 사용하여 작업 항목 폼에서 웹 페이지 또는 CDATA 태그 내에 정의된 콘텐츠를 표시할 수 있습니다. Link 또는 Content 자식 요소를 포함하여 폼에 나타나는 콘텐츠에 대해 URL 또는 HTML을 지정할 수 있습니다.
WebpageControlOptions 요소는 CONTROL 요소의 자식 요소입니다.
스키마 계층 구조
<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>
특성 및 요소
다음 단원에서는 특성, 자식 요소 및 부모 요소에 대해 설명합니다.
자식 요소 및 특성
요소 |
특성 |
설명 |
---|---|---|
WebpageControlOptions |
|
type="WebpageControl"인 경우 선택적 Control 요소입니다. 작업 항목 폼에서 내용을 렌더링할 URL을 정의하는 컨테이너 요소입니다. 선택적 LINK 요소입니다. UrlPath를 지정할 때 필요합니다. UrlPath가 지정되어 있을 때 하이퍼링크의 URL을 결정하는 데 사용할 값을 지정합니다. 요소 형식은 복합 형식: WebpageControlOptionsType입니다. |
|
AllowScript |
선택적 WebpageControlOptions 특성입니다. 웹 페이지 내에서 JavaScript를 실행(true) 또는 실행하지 않을지(false) 여부를 지정합니다. 특성 형식은 xs:boolean입니다. ActiveX 같은 다른 모든 설정은 클라이언트에 대해 정의된 Internet Explorer 설정을 기반으로 합니다. |
|
ReloadOnParamChange |
선택적 WebpageControlOptions 특성입니다. 작업 항목 폼에 있는 매개 변수가 변경(true) 또는 변경되지 않았을 때(false) 웹 페이지의 내용을 다시 로드할지(true) 여부를 지정합니다. 특성 형식은 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>
요소 정보
Namespace |
https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/typedef |
스키마 이름 |
작업 항목 형식 정의 |
유효성 검사 파일 |
WorkItemTypeDefinition.xsd |
요소 형식 |
WebpageControlOptionsType |
비워 둘 수 있음 |
해당 없음 |
참고 항목
개념
기타 리소스
도움말 텍스트, 프로세스 지침, 웹 콘텐츠 및 작업 항목 폼의 웹 페이지 링크 제공
변경 기록
날짜 |
변경 내용 |
이유 |
---|---|---|
2011년 5월 |
XML 구문의 여러 요소 및 특성의 케이스를 수정했습니다. 작업 항목 추적을 위한 스키마 정의는 FORM 요소의 모든 자식 요소를 카멜식으로 정의하고 다른 모든 요소의 이름은 모두 대문자로 정의합니다. |
콘텐츠 버그 수정 |
2011년 1월 |
제거된 항목에 대한 링크가 제거되었습니다. |
향상된 기능 관련 정보 |