다음을 통해 공유


WebpageControlOptions XML 요소 참조

업데이트: 2011년 5월

WebpageControlOptions 요소를 사용하여 작업 항목 폼에서 웹 페이지 또는 CDATA 태그 내에 정의된 콘텐츠를 표시할 수 있습니다. Link 또는 Content 자식 요소를 포함하여 폼에 나타나는 콘텐츠에 대해 URL 또는 HTML을 지정할 수 있습니다.

WebpageControlOptions 요소는 CONTROL 요소의 자식 요소입니다.

스키마 계층 구조

WITD

   WORKITEMTYPE

       FORM

           레이아웃

               Group

               

               TabGroup

                  Tab

                     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 콘텐츠는 작업 항목 폼을 렌더링하기 전에 확인할 수 없습니다.

부모 요소

요소

설명

Control

필수 부모 요소입니다. 작업 항목 폼에 나타나는 필드, 텍스트, 하이퍼링크 또는 기타 컨트롤 요소를 정의합니다.

Text

선택적 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월

제거된 항목에 대한 링크가 제거되었습니다.

향상된 기능 관련 정보