Udostępnij za pośrednictwem

Zarządzanie mapowaniami pól dla integracji TFS-Project Server

  • Artykuł

Można dostosować sposób synchronizowania danych między Visual Studio Team Foundation Server (TFS) i serwera Microsoft Project Server, modyfikując plik mapowania pól.Ten plik definiuje pola danych, które są synchronizowane i jak są synchronizowane do wspierania integracji TFS i serwera Project Server.Ten plik można zarządzać przy użyciu następujących opcji z TfsAdmin ProjectServer narzędzia wiersza polecenia:

  • /DownloadFieldMappings: Pliki do pobrania pliku mapowania pola, który jest zdefiniowany dla Kolekcja projektów zespołu.

  • /UploadFieldMappings: Sprawdza poprawność składni XML pliku mapowania pól i przekazuje go do kolekcji.Aby sprawdzić poprawność składni, ale nie przekazać plik, można użyć /validateonly opcji.

[!UWAGA]

Plik mapowania pola integracji Team Foundation Server i Project Server różni się od pola pliku mapowania dla Microsoft Project.Aby uzyskać informacje dotyczące sposobu pobierania lub przekazywania drugiego pliku zobacz Przekazywanie i pobieranie pliku mapowania programu Microsoft Project [TFSFieldMapping].

Aby uzyskać więcej informacji na temat zawartości pliku mapowania pól i dostosowywania go, zobacz Mapowanie pól odwołania do elementu XML dla integracji TFS-Project Server i Dostosowywanie mapowania pola pomiędzy TFS a Project Server.

Aby użyć narzędzia wiersza poleceń TfsAdmin ProjectServer otwórz okno poleceń, w którym Visual Studio lub Team Explorer jest zainstalowany i wprowadź:

cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE

W 32-bitowej wersji systemu Windows należy zastąpić %programfiles(x86)% elementem %programfiles%.

Wymagania

Aby użyć tych poleceń, z integracji administrowania serwera Project Server należy ustawić uprawnienie Zezwalaj dla Kolekcja projektów zespołu.Ponadto konto usługi dla Team Foundation Server musi mieć uprawnienia niezbędne do interakcji z wystąpienia programu Project Web Access lub programu Project Web App (PWA) które biorą udział w synchronizacji danych.Aby uzyskać więcej informacji, zobacz Przypisywanie uprawnień do obsługi integracji TFS-Project Server.

Składnia

TfsAdmin ProjectServer /DownloadFieldMappings /collection:tpcUrl /filepath:mappingFile [/encoding:encoding]

TfsAdmin ProjectServer /UploadFieldMappings /collection:tpcUrl /filePath:mappingFile [/encoding:encoding] [/validateOnly] [/useDefaultFieldMappings] [/force]

Parametry

Parametr

Opis

/collection:tpcURL

Określa adres uniform resource locator (URL) zbioru zespołu projektu.Należy określić identyfikator URL w następującym formacie:

http://ServerName:Port/VirtualDirectoryName/CollectionName

Jeśli nie określisz katalog wirtualny, można określić identyfikator URI w następującym formacie:

http://ServerName:Port/CollectionName

/filePath:mappingFile

Określa ścieżkę i nazwę pliku definicji XML, który zawiera mapowania pól.

[!UWAGA]

Jeśli używasz Windows Vista, nie masz uprawnień dostępu do niektórych folderów.Jeśli próbujesz eksportować typ elementu roboczego do lokalizacji, w której nie posiadasz uprawnień, technologia wirtualizacji rejestru automatycznie przekierowuje eksportowany pliku i zapisuje go do magazynu wirtualnego.Aby uniknąć tego przekierowania, możesz eksportować plik do lokalizacji, w której masz uprawnieniaAby uzyskać więcej informacji, zobacz następujące strony w witrynie sieci Web firmy Microsoft: Wirtualizacja rejestru i Typowe problemy wirtualizacji plików i rejestru w systemie Windows Vista.

/encoding:encoding

Określa nazwę formatu kodowania dla programu.NET Framework 2.0.Polecenie wywozu lub przywozu danych XML w format kodowania, który określisz.Na przykład, /e:utf-7 Określa kodowanie Unicode (UTF-7).Jeżeli ten parametr nie jest określony, polecenie próbuje wykryć kodowanie i używa UTF-8, jeśli wykrywanie nie powiedzie się.

/validateOnly

Sprawdza poprawność plików mapowania, ale nie powoduje wysłania.

/useDefaultFieldMappings

Przekazanie domyślne mapowania pól zamiast pliku mapowania niestandardowe.Aby uzyskać więcej informacji, zobacz Mapowanie pól odwołania do elementu XML dla integracji TFS-Project Server.

/force

Zastąpienie istniejącego pliku mapowania.Należy określić tę opcję, jeśli określisz /useDefaultFieldMappings przełączanie podczas zastępowania istniejących mapowań innego mapowania.

Uwagi

Tylko pola niestandardowe przedsiębiorstwa lub pól, które są wbudowane można mapować na serwerze Project Server.Należy określić nazwę prawidłowe pola w programie Project.Aby określić nazwę pola wbudowane, Usuń wszystkie spacje z przyjazną nazwę, a prefiks wynik z "pj".Na przykład nazwa pola dla Menedżera stanu jest pjStatusManager, a nazwa pola niestandardowe 01 jest pjCustom01.Istnieją ograniczenia na jak można mapować wbudowanych i niestandardowych pól, a musi odpowiadać typy danych pól.Aby uzyskać więcej informacji, zobacz Ograniczenia związane z mapowaniem pól programu Project Server dla integracji TFS-Project Server.

Po uruchomieniu TFSAdmin ProjectServer polecenia, komunikat wskazuje akcję, która jest wykonywana i dotkniętych obiektu.Na przykład następujący komunikat pokazuje, że trwa pobieranie pliku mapowania pól:

Download field mappings from DefaultCollection

Po zakończeniu działania polecenia pojawi się kolejny komunikat.Na przykład następujący komunikat o błędzie pojawia się po pobraniu pliku mapowania pól:

You have downloaded field mappings to C:MappingFile. . . Done.

Uwagi na temat przesyłania mapowania pól

Jeśli plik mapowania pola jest przesłany pomyślnie, są wprowadzone następujące zmiany:

  • Każde pole dublowanie w Team Foundation jest skonfigurowany do wykonania zmapowanych polach.

  • W przypadku typów elementów pracy, które zostały zmapowane do kolekcji lub zespołu projektu, nowe mapowania pojawiają się na Serwera Project Server kartę formularza elementu pracy.

Ważna uwagaWażne

Kiedy należy mapować pole z Team Foundation Server na serwerze Project Server, upewnij się, że zgodne typy danych z tych pól.W przeciwnym razie następującego błędu mogą pojawić się podczas próby przekazania mapowania pól:

Indeks (podstawie zero) musi być większa lub równa zero i mniejszą niż rozmiar listy argumentów.

Aby uzyskać więcej informacji, zobacz Typy danych i kryteria mapowania pól.

Przykłady

Pobierz plik mapowania pola, który jest zdefiniowany w Kolekcja projektów zespołu

Poniższy przykład pobiera mapowania pól, które są zdefiniowane dla AdventureWorksCollection do AWMappingFile.xml.

TfsAdmin ProjectServer /DownloadFieldMappings /collection:http://AdventureWorksServer:8080/AdventureWorksCollection /filePath:"C:AWMappingFile.xml"

Przekaż plik mapowania pól dla Kolekcja projektów zespołu

Poniższy przykład przekazuje AWMappingFile.xml do AdventureWorksCollection.

TfsAdmin ProjectServer /UploadFieldMappings /collection:http://AdventureWorksServer:8080/AdventureWorksCollection /filePath:"C:AWMappingFile.xml"

Zobacz też

Zadania

Konfigurowanie integracji TFS-Project Server

Koncepcje

Mapowanie pól odwołania do elementu XML dla integracji TFS-Project Server

Ograniczenia związane z mapowaniem pól programu Project Server dla integracji TFS-Project Server

Składniki integracji mapy [TfsAdmin ProjectServer]

Inne zasoby

Dostosowywanie mapowania pola pomiędzy TFS a Project Server