Link 및 Param XML 요소 참조

아티클
06/09/2015

Link 요소를 사용하여 작업 항목 폼에서 필드 또는 독립 실행형 레이블에 하이퍼링크를 추가할 수 있습니다. 다음과 같은 경우에 Link 요소를 사용합니다.

필드 레이블에 하이퍼링크를 추가하는 경우
독립 실행형 레이블 또는 정보 텍스트의 일부에 하이퍼링크를 추가하는 경우
작업 항목 폼 내에 표시할 콘텐츠의 URL을 지정하는 경우

폼에 요소를 추가하려면 작업 항목 형식의 정의를 수정합니다. 사용자 지정 작업 항목 형식 수정 또는 추가(WIT)을 참조하세요.

Link 요소는 Control 요소의 자식 요소이거나 WebpageControlTarget 또는 WebpageControlOptions 요소의 자식 요소입니다. 이러한 요소에 대한 자세한 내용은 Control XML 요소 참조 및 WebpageControlOptions XML 요소 참조를 참조하세요.

스키마 계층 구조

<Link URLRoot="URLRoot" URLPath ="URLPathWithParameters">    <Param Index="IndexValue " Value="ParamValue " Type ="Original | Current"/> </Link>

특성 및 요소

다음 단원에서는 특성, 자식 요소 및 부모 요소에 대해 설명합니다.

자식 요소 및 특성

요소	특성	설명
Link		Control인 경우 선택적 type="FieldControl" 요소입니다. 선택적 LabelText 요소입니다. 선택적 Text 요소입니다. 선택적 WebpageControlOptions 요소입니다. 하이퍼링크 또는 URL을 정의하기 위한 컨테이너 요소입니다. 요소 형식은 복합 형식인 HyperLinkType입니다.
	UrlRoot	필수 Link 특성입니다. 레이블이 연결되는 URL의 서버 이름과 프로토콜을 지정합니다. 지원되는 프로토콜은 HTTP, HTTPS 및 MAILTO입니다. 지정한 서버 이름을 하드코드하거나 다음 매크로 중 하나를 사용하고, 필요한 경우 주소 정보를 매크로에 더 추가할 수 있습니다. 참고 각 매크로는 Link 요소가 정의된 작업 항목 폼의 팀 프로젝트에 대해 정의되며 사용하도록 설정된 URL에 연결됩니다.팀 프로젝트에 대해 이러한 리소스를 하나라도 프로비전하지 않거나 사용하도록 설정하지 않으면 "페이지를 찾을 수 없음" 오류가 표시됩니다. @PortalPage: 현재 팀 프로젝트의 SharePoint 사이트 URL입니다(예: https://serverName/sites/collectionName/TeamProjectName). @ProcessGuidance: 팀 프로젝트의 프로세스 지침을 제공할 SharePoint 사이트의 URL입니다. @ReportManagerUrl: 현재 팀 프로젝트에 대해 보고서 관리자를 호스트하는 서버의 URL입니다. 보고서의 폴더 뷰에 대한 링크를 제공합니다(예: https://serverName/Reports/Pages/Folder.aspx?ItemPath=/collectionName/teamProjectName). @ReportServiceSiteUrl: 현재 팀 프로젝트에 대해 SQL Server Reporting Services를 호스트하는 서버의 URL에 팀 프로젝트의 기본 경로가 결합된 형태입니다(예: https://serverName/Reports/Pages/reportservice.asmx?ItemPath=/collectionName/teamProjectName). 처음 두 매크로의 하드코딩된 값을 확인하려는 경우 팀 프로젝트의 프로젝트 포털 설정을 열면 됩니다. 자세한 내용은 프로세스 지침 구성 또는 리디렉션을 참조하십시오. 특성 유형은 단순 형식인 NonBlankString입니다.
	UrlPath	선택적 Link 특성입니다. 하이퍼링크의 URL 경로를 지정합니다. 이 특성을 사용하여 런타임에 결정되는 가변 매개 변수를 지정합니다. 특성 유형은 단순 형식인 NonBlankString입니다.
Param		선택적 Link 요소입니다. UrlPath를 지정할 경우 필수입니다. UrlPath를 지정할 때 하이퍼링크의 URL을 확인하는 데 사용할 값을 지정합니다. 요소 형식은 복합 형식인 HyperLinkParamType입니다.
	Index	필수 Param 특성입니다. 값의 서식을 URL 문자열로 지정해야 하는 매개 변수의 인덱스를 지정합니다. 인덱스 값은 순서대로 정렬해야 하는 것은 아니지만 URLPath 문자열의 인덱스 번호와 일치해야 합니다. 특성 형식은 PositiveInteger입니다. 첫 번째 인덱스 번호는 0이어야 합니다.
	Value	필수 Param 특성입니다. 하이퍼링크의 URL 경로 값과 연결된 번호를 지정합니다. URLPath 문자열로 서식을 지정해야 하는 값을 지정합니다. 값은 작업 항목 형식 정의에 사용되는 필드의 유효한 참조 이름이어야 합니다. @Me 변수가 지원됩니다. 작업 항목 폼을 확인 중인 현재 팀 멤버의 이름으로 바뀝니다. 값 항목은 대소문자를 구분하지 않습니다. 특성 형식은 xs:string입니다.
	Type	선택적 Param 특성입니다. 매개 변수에 대해 필드의 원래 값을 사용해야 함을 지정합니다. 특성 유형은 단순 형식인 HyperLinkParamValueKind입니다. 다음과 같은 값을 사용할 수 있습니다. Original: 원래 매개 변수 값을 사용하여 URL 경로를 확인하도록 지정합니다. Current: 현재 매개 변수 값을 사용하여 URL 경로를 확인하도록 지정합니다. 이 특성을 지정하지 않으면 필드의 현재 값이 매개 변수로 사용됩니다.

부모 요소

요소	설명
Control	필수 요소. 작업 항목 폼에 나타나는 필드, 텍스트, 하이퍼링크 또는 기타 컨트롤 요소를 정의합니다.
LabelText	선택적 Control 요소입니다. 작업 항목 폼에 표시할 레이블에 대한 컨테이너 요소입니다.
Text	선택적 LabelText 요소입니다. 작업 항목 폼에 표시할 정보 또는 레이블에 대한 컨테이너 요소입니다.
WebpageControlOptions	선택적 Control 요소입니다. 웹 페이지 컨트롤에 대한 옵션을 지정하는 컨테이너 요소입니다. 자세한 내용은 Displaying Web Content within a Work Item Form을 참조하십시오.

설명

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&amp;topic=Iteration">
   <Param Index="0" 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>

요소 정보

네임스페이스	https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/typedef
스키마 이름	작업 항목 형식 정의
유효성 검사 파일	WorkItemTypeDefinition.xsd
요소 형식	HyperLinkType, HyperLinkParamType
비워 둘 수 있음	해당 없음

참고 항목

개념

작업 항목 폼 컨트롤 지정

작업 항목 폼 디자인

다음을 통해 공유