Link 및 Param XML 요소 참조
업데이트: 2011년 5월
Link 요소를 사용하여 작업 항목 폼에서 필드 또는 독립 실행형 레이블에 하이퍼링크를 추가할 수 있습니다. Link 요소는 다음과 같은 경우에 사용합니다.
필드 레이블에 하이퍼링크 추가
독립 실행형 레이블 또는 정보 텍스트 일부에 하이퍼링크 추가
작업 항목 폼 내에 표시할 콘텐츠에 대한 URL을 지정합니다.
Link 요소는 Control 요소의 자식 요소 또는 WebpageControlTarget 또는 WebpageControlOptions 요소의 자식 요소입니다. 이러한 요소에 대한 자세한 내용은 Control XML 요소 참조 및 WebpageControlOptions XML 요소 참조를 참조하십시오.
스키마 계층 구조
<xs:element name="Link" type="HyperLinkType" minOccurs="0" maxOccurs="1" />
<xs:element name="Param" type="HyperLinkParamType" minOccurs="0" maxOccurs="unbounded"/>
<LINK URLRoot="URLRoot" URLPath ="URLPathWithParameters">
<Param index="IndexValue " value="ParamValue " type ="Original | Current"/>
</LINK>
특성 및 요소
다음 단원에서는 특성, 자식 요소 및 부모 요소에 대해 설명합니다.
자식 요소 및 특성
요소 |
특성 |
설명 |
|---|---|---|
Link |
|
type="FieldControl"인 경우 선택적 Control 요소입니다. 선택적 LabelText 요소입니다. 선택적 Text 요소입니다. 선택적 WebpageControlOptions 요소입니다. 하이퍼링크 또는 URL을 정의하는 컨테이너 요소입니다. 요소 형식은 복합 형식: HyperLinkType입니다. |
|
UrlRoot |
필수 Link 특성입니다. 레이블을 연결할 URL의 프로토콜과 서버 이름을 지정합니다. 지원되는 프로토콜은 HTTP, HTTPS 및 MAILTO입니다. 지정된 서버 이름을 하드코딩하거나 다음 매크로 중 하나를 사용하고 추가 주소 정보를 매크로에 선택적으로 추가할 수 있습니다. .gif "참고") 참고
Link 요소가 정의된 작업 항목 폼의 팀 프로젝트에 대해 정의되고 활성화된 URL의 각 매크로 링크입니다.리소스가 팀 프로젝트에 대해 프로비전되거나 사용되지 않는 경우 "페이지 찾을 수 없음" 오류가 나타납니다.
처음 두 매크로에 대해 하드 코드된 값을 확인하려면 팀 프로젝트의 프로젝트 포털 설정을 열 수 있습니다. 자세한 내용은 팀 프로젝트 포털 및 프로세스 지침 액세스을 참조하십시오. 특성 형식은 간단한 형식입니다: NonBlankString. |
|
UrlPath |
선택적 Link 특성입니다. 하이퍼링크의 URL 경로를 지정합니다. 이 특성을 사용하여 런타임에 확인된 변수 매개 변수를 지정할 수 있습니다. 특성 형식은 간단한 형식입니다: NonBlankString. |
Param |
|
선택적 Link 요소입니다. UrlPath를 지정할 때 필요합니다. UrlPath가 지정되어 있을 때 하이퍼링크의 URL을 결정하는 데 사용할 값을 지정합니다. 요소 형식은 복합 형식: HyperLinkParamType입니다. |
|
index |
필수 Param 특성입니다. URL 문자열에 값의 형식을 지정해야 하는 매개 변수의 인덱스를 지정합니다. 인덱스 값의 순서를 순차적으로 지정할 필요가 없습니다. 그러나 URLPath 문자열에 있는 인덱스의 수가 일치해야 합니다. 특성 형식은 PositiveInteger입니다. 첫 번째 인덱스 번호는 1이어야 합니다. |
|
value |
필수 Param 특성입니다. 하이퍼링크에 대한 URL 경로의 값과 관련된 번호를 지정합니다. URLPath 문자열로 형식을 지정해야 하는 값을 지정합니다. 값은 작업 항목 형식 정의에 사용되는 필드의 올바른 참조 이름이어야 합니다. @Me 변수가 지원됩니다. 작업 항목 폼을 보고 있는 현재 팀 멤버의 이름으로 대체됩니다. 값 항목은 대/소문자를 구분하지 않습니다. 특성 형식은 xs:string입니다. |
|
type |
선택적 Param 특성입니다. 필드의 원래 값을 매개 변수에 대해 사용해야 하도록 지정합니다. 특성 형식은 간단한 형식입니다:HyperLinkParamValueKind. 유효한 값은 다음과 같습니다.
이 특성을 지정하지 않을 경우 필드의 현재 값이 매개 변수로 사용됩니다. |
부모 요소
요소 |
설명 |
|---|---|
필수적 요소로서, 작업 항목 폼에 나타나는 필드, 텍스트, 하이퍼링크 또는 기타 컨트롤 요소를 정의합니다. |
|
선택적 Control 요소입니다. 작업 항목 폼에 표시할 레이블에 대한 컨테이너 요소입니다. |
|
선택적 LabelText 요소입니다. 작업 항목 폼에 표시할 정보 또는 레이블에 대한 컨테이너 요소입니다. |
|
선택적 Control 요소입니다. 웹 페이지 컨트롤에 대한 옵션을 지정하는 컨테이너 요소입니다. 자세한 내용은 Displaying Web Content within a Work Item Form: WebpageControlOptions Elements을 참조하십시오. |
설명
LINK 요소의 기본 동작은 작업 항목 폼 또는 웹 페이지의 하이퍼링크를 여는 것입니다. 하이퍼링크를 새 창에서 열도록 작성된 경우(target=”_blank”), 외부 브라우저가 열립니다.
LABELTEXT 요소에 여러 TEXT 요소를 추가하여 일반 및 하이퍼링크된 텍스트를 조합할 수 있습니다.
LABELTEXT 요소는 팀 탐색기의 최신 버전을 실행하는 클라이언트에서만 인식됩니다. 따라서 자식 LINK 요소를 지정할 때 CONTROL 요소에서 Label 특성을 지정해야 합니다. 최신 버전의 팀 탐색기를 실행하는 클라이언트의 경우 LABELTEXT 요소에서 제공하는 텍스트는 작업 항목 폼에 나타납니다. 이전 버전의 팀 탐색기를 실행하는 클라이언트의 경우 CONTROL 요소 Label 특성에 지정된 텍스트는 작업 항목 폼에 나타납니다.
예: 매개 변수를 사용하여 하이퍼링크 지정
설명
다음 예제에서는 반복 항목에 대한 프로세스 지침에 연결하는 하이퍼링크를 정의하는 방법을 보여줍니다.
https://serverName/sites/collectionName/projectName/render.aspx?wit=bug&topic=Iteration
프로젝트 이름은 System.Project 필드에 할당된 값에서 파생됩니다.
코드
<Link UrlRoot="https://serverName" UrlPath="sites/{0}/render.aspx?wit=bug&topic=Iteration">
<Param index="1 " value="System.Project"/>
</Link>
예: 독립 실행형 레이블에 하이퍼링크 추가
설명
다음 예제에서는 작업 항목 폼에 있는 "work item guidance"에 하이퍼링크를 할당하는 방법을 보여줍니다.
코드
<Control type="LabelControl">
<LabelText>
<Text>
<Link UrlRoot="https://www.msn.com" />
work item guidance
</Text>
</LabelText>
</Control>
예: 필드에 하이퍼링크 추가
설명
다음 예제에서는 작업 항목 폼에 있는 필드의 레이블에 하이퍼링크를 추가하는 방법을 보여줍니다.
코드
<Control Type="FieldControl" FieldName="System.Title" LabelPosition="Left" Label="This text comes from the Label attribute:">
<LabelText>
<Text>
<Link UrlRoot="http://www.live.com/" />
This text comes from the inner Label Text
</Text>
</LabelText>
</Control>
스키마 정의
HyperLinkType
NonBlankString
HyperLinkParamType
HyperLinkParamValueKind
복합 형식: HyperLinkType
<xs:complexType name="HyperLinkType" >
<xs:sequence>
<xs:element name="Param" type="HyperLinkParamType" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
<xs:attribute name="UrlRoot" type="NonBlankString" use="required" />
<xs:attribute name="UrlPath" type="NonBlankString" use="optional" />
</xs:complexType>
HyperLinkParamType
<xs:complexType name="HyperLinkParamType" >
<xs:attribute name="Index" type="PositiveInteger" use="required" />
<xs:attribute name="Value" type="xs:string" use="required" />
<xs:attribute name="Type" type="HyperLinkParamValueKind" use="optional" />
</xs:complexType>
NonBlankString
<xs:simpleType name="NonBlankString">
<xs:restriction base="xs:string">
<xs:pattern value=".*\S+.*"/>
</xs:restriction>
</xs:simpleType>
HyperLinkParamValueKind
<xs:simpleType name="HyperLinkParamValueKind">
<xs:restriction base="xs:string">
<xs:enumeration value="Original"/>
<xs:enumeration value="Current"/>
</xs:restriction>
</xs:simpleType>
요소 정보
Namespace |
https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/typedef |
스키마 이름 |
작업 항목 형식 정의 |
유효성 검사 파일 |
WorkItemTypeDefinition.xsd |
요소 형식 |
HyperLinkType, HyperLinkParamType |
비워 둘 수 있음 |
해당 없음 |
참고 항목
개념
기타 리소스
Elements (Work Item Type Definition Schema)
변경 기록
날짜 |
변경 내용 |
이유 |
|---|---|---|
|
2011년 5월 |
XML 구문의 여러 요소 및 특성의 케이스를 수정했습니다. 작업 항목 추적을 위한 스키마 정의는 FORM 요소의 모든 자식 요소를 카멜식으로 정의하고 다른 모든 요소의 이름은 모두 대문자로 정의합니다. |
콘텐츠 버그 수정 |
|
2011년 1월 |
제거된 항목에 대한 링크가 제거되었습니다. |
향상된 기능 관련 정보 |