다음을 통해 공유

작업 항목 형식 정의 xml을 통해 작업 항목 양식에 확장 추가

  • 아티클

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

작업 항목 양식의 레이아웃을 포함하는 도구를 사용하여 witadmin 작업 항목 형식을 xml로 내보낼 수 있습니다. 이 예제의 일부로 페이지, 그룹화 및 컨트롤 기여 레이아웃에 추가합니다. 또한 Agile "User Story" 작업 항목 유형에 컨트롤을 추가합니다. 자세한 내용은 WebLayout xml 참조를 참조하세요.

참고 항목

xml을 통한 작업 항목 양식 사용자 지정은 Azure DevOps Services가 아닌 Azure DevOps Server에서만 지원됩니다.

작업 항목 양식에 확장 추가

  1. Azure DevOps Server에 작업 항목 양식 확장을 설치합니다.

  2. Developer Command Prompt 파일을 엽니다. 다음 명령을 사용하여 xml 파일을 바탕 화면으로 내보냅니다.

    witadmin exportwitd /collection:CollectionURL /p:Project /n:TypeName /f:FileName

    지정한 디렉터리에 파일이 만들어집니다.

  3. 이 파일 내에서 WebLayout 섹션으로 이동합니다. WebLayout 섹션 내에서 주석 Blob은 컬렉션에 대해 설치된 확장 대상 작업 항목 양식을 지정합니다. 각 확장에 대해 기여 모든 양식이 ID 및 입력과 함께 나열됩니다(Control 기여인 경우). 다음 예제에서 주석은 컬렉션에 설치된 color-control-dev 확장을 보여줍니다. 확장에는 두 개의 입력을 사용하는 하나의 컨트롤 기여도가 있습니다.

         <!--**********************************Work Item Extensions***************************

 Extension:
     Name: color-control-dev
     Id: example.color-control-dev

     Control contribution:
         Id: example.color-control-dev.color-control-contribution
         Description:
         Inputs:
             Id: FieldName
             Description: The field associated with the control.
             Type: Field
             IsRequired: true

             Id: Colors
             Descriptions: The colors that match the values in the control.
             Type: String
             IsRequired: false

  4. 작업 항목 확장 섹션에서 확장 ID를 찾습니다.

         <!--**********************************Work Item Extensions*************************** 

 Extension:
     Name: color-control-dev
     Id: example.color-control-dev
     ...

  5. 다음과 같이 작업 항목 확장 섹션 아래에 확장 태그를 추가하여 작업 항목 양식에서 확장을 사용할 수 있도록 합니다. 폼 내에 기여를 배치하려면 섹션에 Extensions 해당 확장을 지정해야 합니다.

         <!--**********************************Work Item Extensions***************************
     ...

     Note: For more information on work item extensions use the following topic:
     https://go.microsoft.com/fwlink/?LinkId=816513
     -->

     <Extensions>
         <Extension Id="example.color-control-dev" />
     </Extensions>

  6. xml에서 확장을 지정하면 양식 내의 확장에 정의된 페이지와 그룹 기여 자동으로 배치됩니다. 다음 예제에서 기여 이동할 수 있습니다.

페이지 기여 추가

    <Page Id="Details">
    <PageContribution Id="<page contribution id>" />
    ...

그룹 기여 추가

    <Page Id="Details">
    ...
        <Section>
        ...
            <GroupContribution Id="<group contribution id>" />
            ...

페이지 기여 및 그룹 기여는 다른 레이아웃 요소를 사용할 수 없습니다.

컨트롤 기여 추가

페이지 및 그룹 기여 달리 xml에서 확장을 지정해도 컨트롤 기여 자동으로 배치되지는 않습니다. 이러한 기여 양식에 추가하려면 양식 내에 기여 태그를 사용하여 추가합니다. 다음 예제에서는 ControlContribution을 계획 그룹에 추가합니다.

컨트롤 기여에 필요한 입력이 정의된 경우 사용자는 해당 입력에 대한 값을 제공해야 합니다. 필수가 아닌 입력의 경우 사용자는 값을 입력으로 설정할지 여부를 결정할 수 있습니다. 다음 예제 FieldName 에서는 입력 및 Colors 입력이 설정됩니다.

    <Page Id="Details">
    ...
        <Section>
        ...
            <Group Id="Planning">
            ...
                <ControlContribution Label="Priority" Id="example.color-control-dev.color-control-contribution">
                    <Inputs>
                        <Input Id="FieldName" Value="Microsoft.Azure DevOps Services.Common.Priority" />
                        <Input Id="Colors" Value="red;green" />
                    </Inputs>
                </ControlContribution>

                <Control Label="Risk" Type="FieldControl" FieldName="Microsoft.Azure DevOps Services.Common.Risk" />

  1. 를 사용하여 witadmin이 xml 파일을 가져옵니다.

    witadmin importwitd /collection:CollectionURL /p:Project /f:FileName

확장은 작업 항목 양식을 통해 구성됩니다.