Udostępnij za pośrednictwem

Dostosowywanie pliku mapowania pola projektu Microsoft

  • Artykuł

Można dostosować sposób pracy elementu pola który są definiowane w Team Foundation mapy do pól w Microsoft Project, i można zmienić sposób określonych pól zostały opublikowane.Microsoft Projectzawiera wstępnie zdefiniowane pola, takie jak nazwa zadania i pola niestandardowe.Podczas publikowania lub odświeżania danych elementów roboczych w Microsoft Project, Określa mapowanie pola pola w bazie danych elementów roboczych, które pasują do pól w Microsoft Project.

Informacji na temat korzystania z projektem i TFS śledzenie pracy, zobacz Tworzenie zaległości i zadań za pomocą programu Project.

Aby zmodyfikować mapowania pól dla projektu zespołowego, możesz wyeksportować, a następnie zaimportować Microsoft mapowania pliku projektu za pomocą narzędzia wiersza polecenia TFSFieldMapping.

Mapowanie elementu

Aby określić mapowanie pola elementu pracy i kolumnę projektu, należy użyć Mapping elementu.

Użyj następującej składni XML do określenia mapowania między polem typu elementu roboczego i Microsoft Project pole.Mapping Elementu następnie używanego do określania mapowanie pola.

<Mapping WorkItemTrackingFieldReferenceName="" 
         ProjectField=""
         ProjectName=""
         ProjectUnits=""
         PublishOnly="">
         IfSummaryRefreshOnly=""/>

Atrybuty

W poniższej tabeli przedstawiono atrybuty, które mogą być używane z Mapping elementu.

Atrybut

Opis

WorkItemTrackingFieldReferenceName

Parametr wymagany.Nazwa odwołania pola w typu elementu roboczego.

ProjectField

Parametr wymagany.Określa nazwę pola w Microsoft Project.Określ pola wstępnie zdefiniowane nazwy prefiksu "uzyskać" na nazwę, takich jak pjTaskName dla kolumny Nazwa zadania.Określ pola niestandardowe jako pjTaskText z numerem, takich jak pjTaskText11.

ProjectName

Parametr opcjonalny.Określa nazwę wyświetlany jako nazwa kolumny w Microsoft Project.Jeśli ten atrybut nie zostanie określony, jest używana nazwa pola typu elementu roboczego.

ProjectUnits

Parametr opcjonalny.Określa typ jednostek do użycia podczas mapowania typu pola z Microsoft Project.Można określić następujące wartości: pjMinute, pjHour, pjDay, pjWeek, i pjMonthUnit.

[!UWAGA]

ProjectUnits można określić tylko dla pól, które określają czas trwania lub innych jednostek czasu.

PublishOnly

Parametr opcjonalny.Jeśli wartość true, wskazuje, czy pole jest opublikowany w bazie danych elementów roboczych, ale nie jest odświeżenie.Ta wartość jest zazwyczaj używana w przypadku pól obliczeniowych, które nie powinny być aktualizowane w Team Explorer.Jeśli wartość false, wskazuje, że pole jest zarówno opublikowane i odświeżyć.Wartość domyślna to false.

W pliku mapowania domyślne, dwóch pól którego PublishOnly ma ustawioną wartość atrybutu true są Data rozpoczęcia i Data zakończenia.

IfSummaryRefreshOnly

Parametr opcjonalny.Jeśli wartość true, wskazuje, że pole nigdy nie został opublikowany w bazie danych elementów roboczych, ale są odświeżane z bazy danych elementów roboczych, gdy spełnione są również następujące:

  • Wiersz dla pola jest zadaniem podsumowania w Office Project.

  • Zadania podsumowania ma publikowanie i odświeżanie wartości ustawiane na Yes.

  • Zadania podsumowania zawiera co najmniej jedno zadanie podrzędne jest powiązana z Team Foundation Server.

Wszystkie aktualizacje i obliczenia który Microsoft Project powoduje, że można zastąpić wartość, która zostanie odświeżona z bazy danych elementów roboczych w planie projektu. Jednak zmodyfikowane wartość nigdy nie jest zapisywany w bazie danych elementów roboczych.Ten atrybut jest zazwyczaj używana w przypadku pól podsumowań, które, jeśli opublikowany w bazie danych elementów pracy, mogą prowadzić do niespójności danych.

Jeśli wartość false, wskazuje, że pole może być zarówno opublikowane i odświeżyć.Określona wartość domyślna, gdy nie jest false.

[!UWAGA]

Wartość, która jest przypisana do IfSummaryRefreshOnly atrybutu zastępuje wartość, która jest przypisana do PublishOnly.Aby uzyskać więcej informacji, zobacz pól tego wpływa na publikowanie i odświeżanie poniżej w tym temacie.

W pliku mapowania domyślny IfSummaryRefreshOnly ma ustawioną wartość atrybutu true dla pierwotne oszacowanie, pozostałą pracę, i ukończyć pracy pól.

Poniższy przykład przedstawia sposób mapowania pole Typ elementu pracy zawierającego tytuł, aby nazwa zadania Microsoft Project pola:

<Mapping WorkItemTrackingFieldReferenceName="System.Title" 
         ProjectField="pjTaskName"/>

Następującej składni XML przedstawiono przykład bardziej złożonych sposób mapowania pole typu elementu roboczego, które zawiera Data początkowa data rozpoczęcia Microsoft Project pola.Ponieważ pola jest obliczane, jest on określony do publikowania i nie Odśwież w celu uniknięcia błędów z wprowadzeniem przez Team Explorer aktualizacji.

<Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.StartDate" ProjectField="pjTaskStart" PublishOnly="true"/>

[!UWAGA]

Najlepszym rozwiązaniem, należy zmapować pól obliczeniowych w Microsoft Project do pola tylko do odczytu w Team Foundation.Dzięki temu oznaczenia, tak aby członkowie zespołu nie można zmieniać pól obliczeniowych.

ReservedField Element

ReservedField Elementu działa obsługę łączy hierarchiczne zdefiniowane między zadaniami i jest element opcjonalny.

Jeśli ten element nie określono mapowania, następnie Microsoft Project używa domyślnie pjNumber20 pola.

SyncField Element

Pole synchronizacji umożliwia sterowanie Publikuj i Odśwież zachowanie każdego zadania.W polu wyświetlany jako kolumnę z tytułu publikowania i Odśwież przy użyciu Arkusz zadań systemu zespołu widoku.

Musisz określić pole synchronizacji w Microsoft Project pliku mapowania pola.Użyj następującej składni XML, aby określić, które pole jest polem synchronizacji.Aby określić pole synchronizacji, należy użyć SyncField elementu.ProjectField Atrybut musi mieć wartość prawidłowej Office Project pola.

<SyncField ProjectField="" />

Poniższy przykład przedstawia sposób określić pjTaskText25 jako pole synchronizacji:

<SyncField ProjectField="pjTaskText25" />

Aby uzyskać więcej informacji dotyczących sposobu korzystania z pola synchronizacji w Office Project, zobacz Publikowanie lub odświeżanie elementów roboczych w programie Project [redirected].

ResourceNameSeparator Element

Można użyć ResourceNameSeparator do definiowania znak, który będzie wyróżniania nazw zasobów, które znajdują się w ciągu.Team FoundationUżytkownicy i zasoby są synchronizowane z użytkowników z usługi katalogowej Active Directory.Nazwy użytkowników i zasoby mogą obejmować ogranicznik, takie jak przecinek, do oddzielania nazwisko, imię i imienia zasobu.

To jest opcjonalne.Jeśli ten element nie zostanie określona w mapowaniu, następnie Microsoft Project dzieli przy użyciu zdefiniowanych w poniższej tabeli przedstawiono domyślne mapowania nazw zasobów:

Jeśli usługa Active Directory i zespół projektu separatora listy

Następnie w programie Office Project zastąpić

,

;

;

:

.

:

Jeśli chcesz określić inny znak niż wymienione w powyższej tabeli, a następnie można zdefiniować ResourceNameSeparator przy użyciu następującej składni:

<ResourceNameSeparator WorkItemTrackingCharacter="" ProjectCharacter=""/>

Poniższy przykład przedstawia sposób określenia znak "*" jako separatora do użycia w Office Project po Team Foundation jest znak "-":

<ResourceNameSeparator WorkItemTrackingCharacter="-" ProjectCharacter="*"/>

Typ łącza hierarchii

Podczas tworzenia zadania podsumowania w Microsoft Project, tworzone jest połączenie drzewa między zadania podsumowania, element nadrzędny i podrzędny lub podrzędny zadania.Office Projectużywa domyślnie System.LinkTypes.Hierarchy do utworzenia łącza.

Typ łącza zależności

Podczas tworzenia łączy między zadaniami w Microsoft Project, Utwórz zależne łącze między zadania.Z poprzednikiem jest przypisane łącze wcześniejszej wersji i następne zadanie jest przypisane łącze następców.Są to nazwy domyślne zdefiniowane dla typu łącze System.LinkTypes.Dependency.

Mapowanie atrybutów, które mają wpływ na publikowanie i odświeżanie

Następujące pola mapowania i Microsoft Project wartości pól należy określić wartość dla elementu roboczego jest opublikowany czy odświeżyć:

  • Wartość publikowania i Odśwież wartość dla każdego elementu pracy.

  • Wartość PublishOnly atrybutu dla pola określonego mapowania.

  • Wartość IfSummaryRefreshOnly określone mapowanie pola.

  • Klasyfikacja zadania jako zadania Podsumowanie lub nadrzędnej.

    Zadaniem nadrzędnym jest zadanie, które ma co najmniej jedno zadanie podrzędne opublikowanego w Team Foundation Server.

Dla elementów pracy, które nie są zadania podsumowania

Poniższa tabela wskazuje, czy pozycja robocza nie będący podsumowanie lub nadrzędnej zadanie jest opublikowany lub odświeżenia na podstawie atrybutów pola mapowania i przypisania, które zostanie wykonane publikowania i Odśwież wartość elementu.

Publikowanie i Odśwież

(poziom zadania)

Atrybut PublishOnly

Pole jest opublikowany?

Pole zostanie odświeżona?

Nie

Wartość TRUE lub False

Nie

Nie

Odśwież tylko

Wartość TRUE lub False

Nie

Tak

Tak

TRUE

Tak

Nie

Tak

False

Tak

Tak

Dla elementów pracy, które są zadania podsumowania

Jeśli są spełnione kryteria zadania podsumowania i IfSummaryRefreshOnly jest true, jego wartość zastępuje PublishOnly wartość.Poniższa tabela przedstawia Określa, czy zadanie podsumowanie lub nadrzędnej jest opublikowany lub odświeżyć opartej na przypisanie, które zostanie wykonane jego publikowania i Odśwież wartość i mapowanie pola atrybutów.

Publikowanie i Odśwież

(poziom zadania)

Atrybut PublishOnly

IfSummaryRefreshOnly

Atrybut

Pole jest opublikowany?

Pole zostanie odświeżona?

Nie

Wartość TRUE lub False

Wartość TRUE lub False

Nie

Nie

Odśwież tylko

TRUE

TRUE

Nie

Tak

Odśwież tylko

TRUE

False

Nie

Tak

Odśwież tylko

False

Wartość TRUE lub False

Nie

Tak

Tak

Wartość TRUE lub False

TRUE

Nie

Tak

Tak

TRUE

False

Tak

Nie

Tak

False

False

Tak

Tak

Zobacz też

Koncepcje

Odwołania do elementu typów łączy

Dodanie lub zmiana sposobu mapowań pól Project do pól TFS