Dostosowywanie pliku mapowania pola projektu Microsoft

Artykuł
09/13/2015

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 Project zawiera 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 pola. 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.
Nazwa projektu	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 Publikuj i ustawić wartości odświeżania 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 Publikuj lub odświeżaj elementy robocze w projekcie.

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 Foundation Uż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 Project uż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 dla pola określonego mapowania.
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żanie (poziom zadania)	Atrybut PublishOnly	Pole jest opublikowany?	Pole zostanie odświeżona?
Nie	Wartość TRUE lub False	Nie	Nie
Tylko odświeżanie	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żanie (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
Tylko odświeżanie	True	True	Nie	Tak
Tylko odświeżanie	True	False	Nie	Tak
Tylko odświeżanie	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

Udostępnij za pośrednictwem