Dostosowywanie mapowania pola pomiędzy TFS a Project Server

Artykuł
06/10/2015

Aby zsynchronizować dane między plan projektu przedsiębiorstwa i projektu zespołowego, należy skojarzyć pola elementu roboczego w Visual Studio Team Foundation Server (TFS) z pól w programie Microsoft Project Server.Można dodać pola i określić, jak synchronizować dostosowując mapowania pól.Możesz utworzyć mapę zarówno wbudowanych i niestandardowych pól w projekcie.Na przykład można udostępniać dane, które nie odnoszą się do harmonogramów (takie jak centra kosztów, nazwy team lub stanu kondycji) Jeśli dodasz pól przechowujących te typy danych do mapowania.

Obsługa się jeden zestaw mapowań pól dla każdej kolekcji projektów zespołowych hosty zespołu projektów, które ma zostać zsynchronizowany z programem Project Server.Należy zdefiniować mapowania pól dla każdej kolekcji projektów zespołowych zmapowania do wystąpienia programu Project Web Access lub projektu aplikacji sieci Web (PWA).Możesz przekazać domyślne mapowania, możesz również dostosować pliku mapowania i go przekazać.Aby przesłać domyślne mapowania, zobacz przekazać mapowania poniżej w tym temacie.

[!UWAGA]

Mapowania integracji TFS i Project Server różnią się od pliku mapowania dla Microsoft Project.Aby uzyskać więcej informacji, zobacz Dostosowywanie pliku mapowania pola projektu Microsoft.

Jak pokazano na poniższej ilustracji, można dostosować mapowania w pięć kroków:

Dostosowywanie mapowania pól między Team Foundation Server i Project Server

Przepływ pracy dostosowywania mapowanie pola PS TFS

[!UWAGA]

Jak chcesz, aby można zaktualizować pliku mapowania dowolnie często.Pola, które znajdują się w Project Server kartę są aktualizowane dla każdego typu elementu roboczego uczestniczy w synchronizacji danych.Nie można ręcznie zmienić definicje Project Server karty.Aby uzyskać więcej informacji, zobacz dostosować karcie Project Server poniżej w tym temacie.

W tym temacie:

Domyślne mapowania
Dodatkowe pola do mapowania
Pobierz mapowania do pliku
Mapowania aktualizacji
Przekaż mapowania
(Opcjonalnie) Dostosować karcie Project Server

[!UWAGA]

Dla pokaz wideo, znaleźć na następującej stronie w witrynie sieci Web firmy Microsoft: Zarządzanie mapowania pól integracji programu Team Foundation Server i Project Server.

Wymagania

Aby ukończyć procedury w tym temacie, musi mieć integracji administrowania Project Server uprawnienie ustawione na Zezwalaj.Ponadto konta usługi dla Team Foundation Server musi otrzymać integracji administrowania Project Server.Aby uzyskać więcej informacji, zobacz Przypisywanie uprawnień do obsługi integracji TFS-Project Server.

Domyślne mapowania

Mapowania określenia, które pola Pobierz zsynchronizowane, gdy użytkownik aktualizuje informacje zawarte w Team Foundation lub Project Server.Każdy z następujących typów synchronizacji ma swój własny zestaw mapowań:

Dla publikowania synchronizacji, dane w programie Project Server aktualizuje dane w Team Foundation.Możesz użyć targetToTfs elementu, aby określić pola w programie Project Server, która aktualizuje pola w Team Foundation.
Dla stanu synchronizacji, dane w Team Foundation jest przesłane do kolejki stanu w programie Project Server.Możesz użyć tfsToTarget element, aby określić pole, która aktualizuje pola Stan kolejki w programie Project Server.

Aby uzyskać więcej informacji na temat tych dwóch typów synchronizacji, zobacz Omówienie procesu synchronizacji dla integracji TFS-Project Server.

W poniższej tabeli przedstawiono domyślny zestaw pól, które są mapowane między Team Foundation i Project Server.Tabela wskazuje także rodzajów pozycje robocze, używając pól z domyślnych szablonów procesu udostępniające TFS w oparciu o.Jeśli mapowanie do projektu zespołowego, który został utworzony na podstawie szablonu procesu, który bazuje na Zwinne Wytwarzanie oprogramowania lub możliwości płatności modelu integracji (CMMI) Process Improvement te mapowania nie należy modyfikować.Jeśli mapowanie do projektu zespołowego, który został utworzony na podstawie szablonu procesu Scrum, należy wprowadzić niektóre zmiany jako wymagane zmiany należy podczas mapowania do zespołu projektu który został utworzony z szablonu procesu Scrum opisano w dalszej części tego tematu.

Aby uzyskać więcej informacji dotyczących mapowania i proces synchronizacji, zobacz Mapowanie pól odwołania do elementu XML dla integracji TFS-Project Server.

Team Foundationpole	Pole Serwer projektu	Stan kolejki pola	Elementu roboczego typów w Agile	Elementu roboczego typów w CMMI	Elementu roboczego typów w Scrum
Tytuł	Nazwa zadania	Tytuł	Wszystkie	Wszystkie	Wszystkie
Przypisane do	Resources	Resources	Wszystkie	Wszystkie	Wszystkie
Praca wykonana	Rzeczywista praca zadania	Rzeczywista praca zasobu	Zadanie	Zadanie	Brak
Pozostała praca	Zadanie pozostałą pracę	Praca pozostała zasobu	Zadanie	Zadanie	Zadanie
Pierwotne oszacowanie	Podstawy pracy		Zadanie	Usterki, żądania zmiany, problem, wymagania, ryzyka i zadania	Brak
Data rozpoczęcia	Rozpoczęcie zadania	Rozpoczęcie pracy zasobu	Historia użytkownika i zadania	Zadanie i wymagania	Brak
Data zakończenia	Zakończ zadanie	Zakończ zasobu	Historia użytkownika i zadania	Zadanie i wymagania	Brak

Wymagane zmiany, aby podczas mapowania do projektu zespołowego, który został utworzony na podstawie szablonu procesu Scrum

Istnieją dwie zmiany, należy wykonać, aby umożliwić przepływ danych z projektu zespołowego utworzone na podstawie programu Microsoft Visual Studio Scrum szablonu procesu.Należy dodać pola ukończyć pracy i pierwotne oszacowanie, aby zadanie typ elementu pracy i należy usunąć elementy, które wymagają pozostałej pracy pole będzie puste, gdy członka zespołu zmienia stan na gotowe lub usunięte.

Do aktualizacji definicji typu zadanie Scrum

Otwórz okno wiersza polecenia, w którym jest zainstalowany program Visual Studio lub Team Explorer, i wprowadź:
```
cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE
```
W przypadku 32-bitowej wersji systemu Windows, zastępuje %programfiles(x86)% z %programfiles%.
Aby wyeksportować definicja typu zadania, wpisz następujące polecenie, zastępując dane dotyczące argumentów, które są wyświetlane w tym miejscu, gdzie CollectionURL Określa adres URL kolekcji projektów zespołowych NazwaProjektu Określa nazwę projektu zespołowego zdefiniowane w kolekcji, a "DirectoryPath\FileName.xml" Określa nazwę i lokalizację pliku eksportu.Następnie wybierz Enter.
```
witadmin exportwitd /collection: /p:"ProjectName" /n:"Task" /f:"DirectoryPath\FileName.xml"
```
W edytorze tekstu lub w programie Visual Studio Otwórz plik, który zostanie wyeksportowany.

W ramach FIELDS definicja sekcji, Dodaj następujący fragment kodu przed elementem pozostałej pracy:

<FIELD name="Completed Work" refname="Microsoft.VSTS.Scheduling.CompletedWork" type="Double" reportable="measure" formula="sum">
   <HELPTEXT>The number of units of work that have been spent on this task</HELPTEXT>
</FIELD>
<FIELD name="Original Estimate" refname="Microsoft.VSTS.Scheduling.OriginalEstimate" type="Double" reportable="measure" formula="sum">
   <HELPTEXT>Initial value for Remaining Work - set once, when work begins. </HELPTEXT>
</FIELD>

W ramach <WORKFLOW> sekcji, należy usunąć następujące wstawkę kodu z obu <STATE value="Done"> i <STATE value="Removed"> definicje:
```
<FIELD refname="Microsoft.VSTS.Scheduling.RemainingWork">
   <EMPTY />
</FIELD>
```

W ramach <FORM> sekcji, Dodaj następujący Control elementy:

<Control FieldName="Microsoft.VSTS.Scheduling.OriginalEstimate" Type="FieldControl" Label="Original Estimate:" LabelPosition="Left" />
<Control FieldName="Microsoft.VSTS.Scheduling.CompletedWork" Type="FieldControl" Label="Completed:" LabelPosition="Left" />

Zapisz i zamknij plik.

Zaimportuj plik, zastępując dane dotyczące argumentów, które są wyświetlane.

witadmin importwitd /collection: /p:"ProjectName" /f:"DirectoryPath\FileName.xml"

Odśwież projektu zespołowego i pracować elementy strony, aby zweryfikować zmiany.

Aby uzyskać więcej informacji, zobacz Eksportowanie i importowanie typów elementów roboczych [redirected], Definiowanie pól elementu pracy i Projektowanie i dostosowywanie formularza elementu roboczego [redirected].

Dodatkowe pola do mapowania

Należy określić następujące informacje dla każdego pola, który chcesz synchronizować oprócz pól domyślnych:

Nazwa odwołania pola w Team Foundation.Jeśli chcesz synchronizować pola w programie Project Server z pole, do którego należy utworzyć w Team Foundation, najpierw utworzyć pole w każdego typu elementu roboczego synchronizowanego.Aby uzyskać więcej informacji, zobacz Odwołania pola elementu pracy dla Visual Studio ALM i Definiowanie pól elementu pracy.
Nazwa pola w programie Project Server, która zaktualizuje pola w Team Foundation.Aby uzyskać listę dostępnych pól, zobacz Ograniczenia związane z mapowaniem pól programu Project Server dla integracji TFS-Project Server.
Nazwa pola w aktualizacji programu Project Server i nazwy pola w programie Project Server, który zostanie zaktualizowany pola odbicie lustrzane w Team Foundation Server zostanie zaktualizowany.
Określa, czy mają być wyświetlane w polach na formularzu elementu pracy.Ustaw wartość displayTfsField atrybutu do true dla pól, które mają być wyświetlane w formularzu elementu roboczego.Ustaw wartość displayTfsMirror atrybutu do true dla elementu roboczego formularza.
Czy Rozwiązywanie konfliktów danych przez stosowanie wartości pola w Team Foundation zastąpienie wartości pola w programie Project Server lub obsługa obu wartości.Niniejsza decyzja określa wartość onConflict atrybutu.Gdy onConflict=”PsWins” jest ustawiona wartość pola w programie Project Server zastępuje wartość pola w Team Foundation.Aby uzyskać więcej informacji, zobacz pola elementów i atrybutów.
Dodatkowe wartości, które należy zdefiniować w celu obsługi pobranie listy lub tabele przeszukiwania niestandardowych w programie Project Server.

Ograniczenia danych, które można mapować

Po określeniu pola, które chcesz zmapować, należy zwrócić uwagę na następujące ograniczenia:

Tylko informacje na poziomie zadania, pjTask * pola, mogą być przesyłane z serwera projektu do Team Foundation Server.
Informacje tylko poziom zasobów, pjResource * pola, mogą być przesyłane z Team Foundation Server do kolejki stanu serwera Project Server.
Pole Tytuł jest jedynym polem, które można wysłać zarówno do Team Foundation Server i do kolejki stanu.
Zestawienie jest obliczany automatycznie w polach przypisany do ukończyć pracy i pozostałą pracę.Nie można zmapować dodatkowe pola i mają pakiet zbiorczy obliczane dla nich.Aby uzyskać więcej informacji, zobacz Praca z listą zasobów w projektach w przedsiębiorstwie zmapowanych na projekt zespołowy.
Należy się upewnić, że typy danych lub jednostek każdego pola, które można mapować spełniają kryteria mapowania pola dla pól standardowych i niestandardowych organizacji.Aby uzyskać więcej informacji, zobacz "Danych typów i pola mapowania kryteria" w Ograniczenia związane z mapowaniem pól programu Project Server dla integracji TFS-Project Server.
Możesz utworzyć mapę pola, które są skojarzone z listami wyboru w Team Foundation.Jednak należy utworzyć tabele odnośników w programie Project Server, aby dopasować listami wyboru.Nie można automatycznie synchronizować listy wyboru lub tabele przeszukiwania.

Aby uzyskać więcej informacji, zobacz Ograniczenia związane z mapowaniem pól programu Project Server dla integracji TFS-Project Server.

Przykład: mapowania nazwy team się pojawić w projekcie

W poniższym przykładzie niestandardowy ciąg pola w Team Foundation, MyCompany.MyOrg.DevTeamName, jest zamapowana na enterprise niestandardowe pole tekstowe w programie Project Server, Moja nazwa zespołu firmy.W tym przykładzie służy do wyświetlenia w programie Project Professional Nazwa zespołu, który jest skojarzony z zadaniem.

<field tfsName="MyCompany.MyOrg.DevTeamName" tfsMirrorName="Mirror.MyCompany.MyOrg.DevTeamName" displayTfsField="false" displayTfsMirror="false" onConflict="DoNothing">
   <tfsToTarget>
   <target provider="ProjectServerStatusQueue" name=" My Company Team Name" />
   </tfsToTarget>
   <targetToTfs>
      <target provider="ProjectServerPublished" name=" My Company Team Name" />
   </targetToTfs>
</field>

Żadne z tych pól pojawia się w formularzu elementu pracy.Ponadto wartości nie są zgodne, każde pole zachowuje własnej wartości.

Powrót do początku

Przykład: ścieżek obszaru i iterację są wyświetlane w projekcie

Możesz utworzyć mapę obszaru (System.AreaPath) i iteracji (System.IterationPath) pola w Team Foundation będą wyświetlane w planów projektów.Ponieważ często zmieniać te pola ścieżka drzewa, należy zmapować je jako pola tekstowego w projekcie.Obszar Pełna ścieżka lub ścieżkę iteracji, menedżerów projektów, korzystających z tych pól należy wprowadzić ręcznie.

Ważne
Bieżącej implementacji Team Foundation Server i integracji Project Server nie obsługuje automatycznej synchronizacji z listy dozwolonych wartości, wybierz list, globalne listy lub drzewa ścieżki listy, które są definiowane dla Zmapowane pola między produktami dwóch serwera.Aby uzyskać najlepsze wyniki, należy wybrać ręczne wpisów w planie projektu, które odpowiadają identyfikatorom w Team Foundation.Jeśli określono nieprawidłowy wpis, zostanie wyświetlone okno dialogowe sprawdzania poprawności, podczas publikowania planu.

Bieżącej implementacji Team Foundation Server i integracji Project Server nie obsługuje automatycznej synchronizacji z listy dozwolonych wartości, wybierz list, globalne listy lub drzewa ścieżki listy, które są definiowane dla Zmapowane pola między produktami dwóch serwera.Aby uzyskać najlepsze wyniki, należy wybrać ręczne wpisów w planie projektu, które odpowiadają identyfikatorom w Team Foundation.Jeśli określono nieprawidłowy wpis, zostanie wyświetlone okno dialogowe sprawdzania poprawności, podczas publikowania planu.

Aby dodać pola obszaru i iterację do planu projektu, należy wykonać następujące czynności:

Dodaje dwa pola organizacji klienta na serwerze Project Server, a ich jako etykietę obszaru (TFS) i iteracji (TFS).

Aby uzyskać więcej informacji, zobacz następującą stronę w witrynie sieci Web firmy Microsoft: tworzenia tabel odnośników i niestandardowe pola organizacji.
Eksportuj mapowania pól z kolekcji projektów zespołowych, gdzie są zdefiniowane projektów zespołowych.

Aby uzyskać więcej informacji, zobacz Pobierz mapowania do pliku poniżej w tym temacie.

Dodaj następujący kod do pliku:

<field tfsName="System.AreaPath" tfsMirrorName="Mirror.System.AreaPath" displayTfsField="true" displayTfsMirror="true">
        <tfsToTarget>
          <target provider="ProjectServerStatusQueue" name="Area (TFS)" />
        </tfsToTarget>
        <targetToTfs>
          <target provider="ProjectServerPublished" name="Area (TFS)" />
        </targetToTfs>
      </field>
      <field tfsName="System.IterationPath" tfsMirrorName="Mirror.System.IterationPath" displayTfsField="true" displayTfsMirror="true">
        <tfsToTarget>
          <target provider="ProjectServerStatusQueue" name="Iteration (TFS)" />
        </tfsToTarget>
        <targetToTfs>
          <target provider="ProjectServerPublished" name="Iteration (TFS)" />
        </targetToTfs>
      </field>

Importuj plik mapowania zaktualizowane pole jako przekazać mapowania opisano w dalszej części tego tematu.
Synchronizuj planu projektu z programu Project Server.
Dodaj dwa nowe kolumny w przypadku pól nowego obszaru (TFS) i iteracji (TFS) do planu projektu

Zmiany wprowadzone w obszaru i iteracji pól w Team Foundation zostaną zsynchronizowane z tych pól w planie projektu.Ponadto można zaktualizować te pola w projekcie i opublikować zmiany do Team Foundation w przypadku określenia wartości, które zostały zdefiniowane w Team Foundation.

Powrót do początku

Pobierz mapowania do pliku

[!UWAGA]

Możesz pobrać mapowania tylko z kolekcji projektów zespołowych, do którego zostały przekazane.Jeśli chcesz pobrać domyślne mapowania do pliku, musisz najpierw je domyślne mapowania, zgodnie z opisem w można przekazać domyślne mapowania poniżej w tym temacie.Alternatywnie możesz skopiować zawartość domyślne mapowania.Aby uzyskać więcej informacji, zobacz Mapowanie pól odwołania do elementu XML dla integracji TFS-Project Server.

Aby pobrać mapowania do pliku

Aby uruchomić TfsAdmin wiersza polecenia narzędzie, Otwórz okno poleceń gdzie albo Visual Studio lub Team Explorer jest zainstalowany, a następnie wprowadź:
```
cd %programfiles%\Microsoft Visual Studio 11.0\Common7\IDE
```
W przypadku 64-bitowej wersji systemu Windows, zastępuje %programfiles% z %programfiles(x86)%..
Wpisz następujące polecenie, a następnie wybierz Enter.
```
TfsAdmin ProjectServer /DownloadFieldMappings /collection:tpcUrl /filePath:MappingFile
```
Zastąp tpcUrl z zasobem jednolite adresem URL zespołu projektu zbierania i Zastąp MappingFile z ścieżkę i nazwę pliku, który będzie można dostosować.
Zaczekaj, aż do wyświetlenia następujące komunikaty:

DownloadingMappingFileto Team Project CollectiontpcUrl.

You have successfully downloaded field mapping fileMappingFileto Team Project CollectiontpcUrl.

Aktualizowanie mapowania

Dla każdego pola, które mają zostać dodane w pliku mapowania, należy określić field elementu i jego podelementów i atrybutów.Aby uzyskać więcej informacji, zobacz Mapowanie pól odwołania do elementu XML dla integracji TFS-Project Server.

Przekaż mapowania

Przekaż mapowania za pomocą UploadFieldMappings polecenia.Możesz przekazać domyślne mapowania za pomocą /usedefaultfieldmapping opcji.W przeciwnym razie należy określić plik, który zawiera elementy mapowania.

Można przekazać domyślne mapowania

W wierszu polecenia wpisz następujące polecenie, a następnie wybierz ENTER.
```
TfsAdmin ProjectServer /UploadFieldMappings /collection:tpcUrl /usedefaultfieldmappings
```
Zastąp tpcUrl z adresem URL kolekcji projektów zespołowych.
Zaczekaj, aż do wyświetlenia następujące komunikaty:

Uploading default field mappings toCollectionUri.

You have successfully uploaded field mappings to collectionCollectionUri.

Można przekazać mapowania z pliku

W wierszu polecenia wpisz następujące polecenie, a następnie wybierz ENTER.
```
TfsAdmin ProjectServer /UploadFieldMappings /collection:tpcUrl /filePath:MappingFile /force
```
Zastąp tpcUrl z adresem URL kolekcji projektów zespołowych i zamieniania MappingFile z ścieżkę i nazwę pliku mapowania niestandardowe.Określ /force aktualizowania istniejących mapowań.
Zaczekaj, aż do wyświetlenia następujące komunikaty:

UploadingMappingFileto Team Project CollectiontpcUrl.

You have successfully uploaded field mapping fileMappingFileto Team Project CollectiontpcUrl.

Dostosuj kartę Project Server

Gdy plan projektu przedsiębiorstwa można skojarzyć z projektu zespołowego, na karcie Project Server dodawanej do formularza elementu pracy, jak na poniższej ilustracji pokazano.Karta zostanie dodana do tylko te typy elementów pracy, które określają brać udziału w synchronizacji danych.Na tej karcie można dostosować przez ustawienie displayTfsField lub displayTfsMirror atrybuty do true dla tych pól, które mają zostać mają pojawiać się na formularzu.

Karta serwera projektu

Karta serwera domyślne pola projektu

Ważne
Mapowania pól, które są definiowane dla kolekcji projektów zespołowych określenia pola, które znajdują się w Project Server karty.Po tej karcie został dodany do typu elementu roboczego dla projektu zespołowego, można zaktualizować go dostosować przez zmodyfikowanie mapowania pól dla kolekcji.Jeśli ręcznie dostosować formularza elementu pracy przez dodanie pola do Project Server kartę lub zmianę lokalizacji na formularzu, karty może nie uzyskać automatycznie aktualizowane z przyszłych zmian powodujących, że do mapowania pól.Jeżeli ten stan występuje, można zmienić ustawienia na karcie ręcznie.Aby uzyskać więcej informacji, zobacz Elementy XML dodane do definicji dla typu elementu pracy.

Mapowania pól, które są definiowane dla kolekcji projektów zespołowych określenia pola, które znajdują się w Project Server karty.Po tej karcie został dodany do typu elementu roboczego dla projektu zespołowego, można zaktualizować go dostosować przez zmodyfikowanie mapowania pól dla kolekcji.Jeśli ręcznie dostosować formularza elementu pracy przez dodanie pola do Project Server kartę lub zmianę lokalizacji na formularzu, karty może nie uzyskać automatycznie aktualizowane z przyszłych zmian powodujących, że do mapowania pól.Jeżeli ten stan występuje, można zmienić ustawienia na karcie ręcznie.Aby uzyskać więcej informacji, zobacz Elementy XML dodane do definicji dla typu elementu pracy.

Aby uzyskać więcej informacji na temat każdego pola domyślny, który pojawi się po Project Server kartę, zobacz Dodano pola Project Server do TFS w celu obsługi synchronizacji danych.

Zobacz też

Zadania

Konfigurowanie integracji TFS-Project Server

Koncepcje

Określenie typów elementów pracy do synchronizacji

Administrowanie integracją programów Team Foundation Server i Project Server

Udostępnij za pośrednictwem