Plik mapowania pola Microsoft Project

Można dostosować sposób działania pola, które są zdefiniowane dla elementów w Team Foundation mapy do pól w Microsoft Project, i określić sposób pola można zmieniać są publikowane.W pliku mapowania pola dla Microsoft Project, można zdefiniować mapowania między polami w Team Foundation i w Microsoft Project.Microsoft Projectzawiera wstępnie zdefiniowane pola, na przykład nazwę zadania i pola niestandardowe.Kiedy publikujesz lub odświeżanie danych elementu pracy w Microsoft Project, mapowanie pola określa, które pola w bazie danych elementu pracy pasują do pól w Microsoft Project.

W pliku mapowania można określić pola dla każdego zespołu projektu.Aby pobrać plik mapowania, możesz go pobrać z zespołu projektu.Po zmodyfikowaniu pliku przesłać go do zespołu projektu, a zmiany dotyczą wszystkich użytkowników tego zespołu projektu.Zobacz Zmiana sposobu pola są mapowane do Microsoft Project.

W tym temacie

• Mapowanie elementu

• ReservedField Element

• SyncField Element

• ResourceNameSeparator Element

• Typ łącza hierarchii

• Typ łącza współzależności

• Mapowania atrybutów, które wpływają na publikowanie i odświeżanie

Mapowanie elementu

Aby określić mapowanie między polem elementu pracy i kolumny projektu, należy użyć Mapping element.

Możesz określić mapowanie między polem Typ elementu pracy należy użyć następującej składni XML i Microsoft Project pole.Mapping Element jest następnie używany do określenia mapowania pól.

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

Atrybuty

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

Atrybut	Opis
WorkItemTrackingFieldReferenceName	Wymagane.Określa nazwę odwołania, pola w typ pozycji roboczej.
ProjectField	Wymagane.Określa nazwę pola w Microsoft Project.Za tworzenie prefiksu "pj" do nazwy, takie jak pjTaskName dla kolumny Nazwa zadania, należy określić nazwy wstępnie zdefiniowanych pól.Jako pjTaskText z numerem, takich jak pjTaskText11, należy określić pola niestandardowe.
NazwaProjektu	Opcjonalne.Określa nazwę, którą są wyświetlane jako nazwy kolumny w Microsoft Project.Jeśli ten atrybut nie jest określony, jest używana nazwa pola Typ pozycji roboczej.
ProjectUnits	Opcjonalne.Określa typ jednostek do użycia podczas mapowania typu pola, aby Microsoft Project.You can specify the following values: pjMinute, pjHour, pjDay, pjWeek, and pjMonthUnit. Uwaga ProjectUnits można określić tylko dla pól, które określają czas trwania lub innych jednostek czasu.
PublishOnly	Opcjonalne.Jeśli ustawiona na true, wskazuje, że pole jest opublikowany w bazie danych elementu pracy, ale nie jest odświeżona.Wartość ta jest zazwyczaj używana dla pól obliczeniowych, które nie powinny zostać uaktualnione w Team Explorer.Jeśli ustawiona na false, wskazuje, że pole jest zarówno opublikowane i odświeżane.Wartością domyślną jest false. W pliku mapowania domyślne dwóch pól którego PublishOnly atrybut jest ustawiony na true są Data rozpoczęcia i Data zakończenia.
IfSummaryRefreshOnly	Opcjonalne.Jeśli ustawiona na true, wskazuje, że pole nigdy nie jest opublikowany w bazie danych elementu pracy, ale są odświeżane z bazy danych elementu pracy, gdy spełnione są również następujące: Wiersz dla pola jest zadaniem sumarycznym w Office Project. Zadanie sumaryczne Publikuj a odświeżania wartości ustawione na Yes. Zadania sumarycznego zawiera co najmniej jedno zadanie podrzędne, który jest powiązany z Team Foundation Server. Wszystkie aktualizacje i obliczeń, Microsoft Project sprawia, że można zastąpić tę wartość, która jest odświeżany na podstawie bazy danych elementu pracy w planie projektu. Zmodyfikowane wartości nie jest zapisywany w bazie danych elementu pracy.Ten atrybut jest zazwyczaj używany dla pól podsumowań, które, jeśli w opublikowanej bazie elementu pracy mogą prowadzić do niespójności danych. Jeśli ustawiona na false, wskazuje, czy dane pole może być zarówno publikowane, odświeżane.Wartość domyślna, gdy nie określony, jest false. Uwaga Wartość, która jest przypisana do IfSummaryRefreshOnly atrybut zastępuje wartość, która jest przypisana do PublishOnly.Aby uzyskać więcej informacji, zobacz pól, że wpływają na publikowanie i odświeżanie dalszej części tego tematu. Domyślna wersja pliku mapowania IfSummaryRefreshOnly atrybut jest ustawiony na true dla Oryginalnego oszacowania, Pracy pozostałej, i Pracę wykonaną pól.

Poniższy przykład pokazuje, jak mapować pole typu elementu pracy, które zawiera tytuł, aby nazwa zadania Microsoft Project pola:

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

Następująca składnia XML przedstawiono bardziej złożonym przykładem sposobu mapowania pola Typ elementu pracy, zawierającego daty rozpoczęcia do daty rozpoczęcia Microsoft Project pole.Ponieważ pola jest obliczana, zostanie określona do publikowania i nie Odśwież, aby zapobiec wystąpieniu błędów w celu uniemożliwienia przez Team Explorer aktualizacje.

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

[!UWAGA]

Najlepszym rozwiązaniem, należy wykonać mapowanie pól obliczeniowych w Microsoft Project na pola tylko do odczytu w Team Foundation.Pomoże to uniknąć zamieszania, tak aby członkowie zespołu nie należy próbować zmienić pola obliczeniowe.

Powrót do początku

ReservedField Element

ReservedField Element programu works do obsługuje hierarchiczny łączy zdefiniowane między zadaniami i jest opcjonalne.

Jeśli ten element nie jest określony w mapowaniu, następnie Microsoft Project użyto domyślnej pjNumber20 pole.

Powrót do początku

SyncField Element

Pole synchronizacji umożliwia sterowanie Publikuj i odświeżyć zachowanie każdego zadania.W polu jest wyświetlany jako kolumna z tytułu Publikuj i odświeżania podczas korzystania z Arkusz zadań zespołu systemu widok.

Musisz określić pole synchronizacji w Microsoft Project pliku mapowania pól.Aby określić, które pole jest polem synchronizacji, należy użyć następującej składni XML.Aby określić pole synchronizacji, należy użyć SyncField element.ProjectField Atrybut musi być ustawiony na nieprawidłową Office Project pole.

<SyncField ProjectField="" />

Jak określić pjTaskText25 jako pole synchronizacji można znaleźć w poniższym przykładzie:

<SyncField ProjectField="pjTaskText25" />

Aby uzyskać więcej informacji na temat korzystania z pola synchronizacji w Office Project, zobacz Publikowanie lub odświeżyć elementów pracy w Office Project.

Powrót do początku

ResourceNameSeparator Element

Można użyć ResourceNameSeparator Aby zdefiniować znak, który ma odróżniać nazw zasobów, które są w ciągu.Team FoundationUżytkownicy i zasoby są synchronizowane z użytkownikami usługi katalogowej Active Directory.Nazwy użytkowników i zasobów mogą obejmować ogranicznikiem, takie jak przecinek, do oddzielenia nazwisko, imię oraz inicjał drugiego imienia zasobu.

To jest opcjonalne.Jeśli ten element nie jest określony w mapowaniu, następnie Microsoft Project oddziela nazw zasobów przy użyciu domyślne mapowania, które są zdefiniowane w tabeli poniżej:

Jeśli usługa Active Directory i zespół projektu separator listy jest	Następnie w programie Office Project zastąpić
,	;
;	:
.	:

Jeśli chcesz określić inny znak niż te 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 pokazuje, jak określić znak "*" jako separatora do użycia w Office Project po Team Foundation jest znak "-":

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

Powrót do początku

Typ łącza hierarchii

Podczas tworzenia zadań sumarycznych w Microsoft Project, tworzone jest połączenie drzewa między zadania sumarycznego, nadrzędny i podrzędny lub dziecko zadania.Office Projectużyto domyślnej System.LinkTypes.Hierarchy, aby utworzyć te łącza.

Powrót do początku

Typ łącza współzależności

Podczas tworzenia łączy między zadaniami w Microsoft Project, podczas tworzenia zależnych łącze między zadaniami.Łącze poprzednika zostanie przydzielone zadanie poprzednika i łącze następca zostanie przydzielone zadanie następnika.Są to nazwy domyślne zdefiniowane dla typu łącze System.LinkTypes.Dependency.

Powrót do początku

Mapowania atrybutów, które wpływają na publikowanie i odświeżanie

Następujące pola mapowania i Microsoft Project wartości pola określają, czy wartość dla elementu pracy jest opublikowane lub odświeżane:

• Wartość Publikuj i odświeżania 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, która jest publikowana w usłudze Team Foundation Server.

Elementów roboczych, które nie są zadania sumaryczne

Poniższa tabela wskazuje, czy element pracy, który nie jest krótki opis lub nadrzędny zadania jest publikowane ani nie odświeżył żadnej oparty na atrybuty mapowania pól i przypisanie, które dokonuje się do Publikuj i odświeżania wartość elementu.

Publikowanie i Odśwież (poziom zadania)	Atrybut PublishOnly	Pole jest publikowana?	Pole jest odświeżana?
Nie	Wartość PRAWDA lub FAŁSZ	Nie	Nie
Odśwież tylko	Wartość PRAWDA lub FAŁSZ	Nie	Tak
Tak	True	Tak	Nie
Tak	False	Tak	Tak

Elementów roboczych, które są zadania sumaryczne

Jeśli kryteria zadania sumarycznego i IfSummaryRefreshOnly jest true, jej wartość zastępuje PublishOnly wartość.Poniższa tabela wskazuje, czy zadania Podsumowanie lub nadrzędny jest opublikowane lub odświeżane w oparciu o przypisanie, które dokonuje się do jego Publikuj i odświeżania wartości i mapowanie pola atrybutów.

Publikowanie i Odśwież (poziom zadania)	Atrybut PublishOnly	IfSummaryRefreshOnly Atrybut	Pole jest publikowana?	Pole jest odświeżana?
Nie	Wartość PRAWDA lub FAŁSZ	Wartość PRAWDA lub FAŁSZ	Nie	Nie
Odśwież tylko	True	True	Nie	Tak
Odśwież tylko	True	False	Nie	Tak
Odśwież tylko	False	Wartość PRAWDA lub FAŁSZ	Nie	Tak
Tak	Wartość PRAWDA lub FAŁSZ	True	Nie	Tak
Tak	True	False	Tak	Nie
Tak	False	False	Tak	Tak

Powrót do początku

Zobacz też

Koncepcje

Odwołania do elementu typów łączy

Dostosowywanie mapowań pól Microsoft Project