Share via


TFS-Project Server tümleştirmesi için alan eşleme XML öğesi başvurusu

Alan eşlemelerini özelleştirerek hangi alanlarını tanımlayabilirsiniz Visual Studio Team Foundation Server (TFS) ve Microsoft Project Server tutulan eşitlenen ve hangi alanların durum sırada Project Server ve güncelleştirilmiş Team Foundation.

[!NOT]

TFS Project Server ile tümleştirme için alan eşlemelerini eşleme dosyasındaki ayrı Microsoft Project.İkinci dosyası hakkında daha fazla bilgi için bkz Microsoft Project alanı eşleme dosyası.

Alan eşlemelerini konakları ekip Project Server ile eşitlemek için istediğiniz projelerinin her takım projesi koleksiyonu için bir kümesi bakımını yapar.Alan eşlemelerini almak için bunları bir dosyaya koleksiyondan yükleyebilirsiniz.Dosya değiştirdikten sonra koleksiyona karşıya yükleyebilir ve değişiklikleri o koleksiyon için tanımlanan tüm takım projeleri için geçerli olacaktır.Karşıdan veya alan eşlemeleri karşıya yükleme hakkında daha fazla bilgi için bkz: TFS ve Project Server arasında alan eşlemeyi özelleştirme.

Bu konuda

  • Gerekli alanlar

  • Varsayılan eşlenmiş alanları

  • Eşleme öğeleri ve öznitelikleri

  • Varsayılan alan eşlemeleri

Gerekli alanlar

Veri Eşitleme desteklemek için aşağıdaki alanlar eşlenmesi gerekir.İş zamanlamak için kullanılan alanlar özelleştirilmiş varsa, kullandığınız alanları başvurmak için alan eşlemelerini özelleştirmeniz gerekir.

  • System.Title için ön ekini eşlenmesi gerekir.

  • System.AssignedTo pjResourceNames için eşlenmesi gerekir.

  • İş'in başlangıcını izlemek için kullandığınız alan Team Foundation pjTaskStart için eşlenmesi gerekir.Bu alan varsayılan olarak, Microsoft.VSTS.Scheduling.StartDate bağlıdır.

  • Tamamlanan izlemek için kullandığınız alan iş Team Foundation pjTaskFinish için eşlenmesi gerekir.Bu alan varsayılan olarak, Microsoft.VSTS.Scheduling.FinishDate bağlıdır.

Varsayılan eşlenmiş alanları

Her bir TFS alanı için iki eşlemeleri belirtebilirsiniz.İlk eşleme içinde durum sırada TFS alanı güncelleştirir proje alanında belirtin.İkinci eşlemede TFS alanı güncelleştirir proje alanında belirtin.Ayrıca, TFS alanı iş öğesi formu ve güncellemeler başvurmak için nasıl yapılır ve yansıtılmış alanlarda görünüp görünmeyeceğini belirtebilirsiniz.

Varsayılan olarak, eşlenen tüm proje alanları Ayrıca, değerlerine TFS içinde depolanan anlamına gelir yansıtılır.

Önemli notÖnemli

Eşitleme işlemi gerektirdiğinden çoğu yapılandırmasında, varsayılan alan eşlemelerini kaldırmalısınız değil.Örneğin, Kurumsal Proje planınızı ya da Microsoft Çözüm Çerçevesi (MSF üzerinde) Çevik Yazılım Geliştirme veya Kapasite Olgunlaştırma Model Entegrasyonu (CMMI) işlem geliştirme için temel bir işlem şablonu oluşturulduğu bir takım projesi için eşleniyorsa varsayılan eşlemeleri kaldırmaz.

Bir takıma, planı maps, proje ancak kullanılarak oluşturulmuş Visual Studio Scrum süreç şablonunu, bazı varsayılan eşlemeleri kaldırmanız gerekebilir.Projeniz Scrum şablonu kullanılarak oluşturulan takım projeleri içeriyorsa, iki server ürünlerinin yapılandırdığınızda, bir hata alabilirsiniz.En iyi sonucu almak için iş (Microsoft.VSTS.Scheduling.CompletedWork) tamamlandı ve özgün tahmin (Microsoft.VSTS.Scheduling.OriginalEstimate) eşlemek için düşündüğünüz çalışma öğelerini ekleyin.Ayrıca, çok kaldırmanız gerekecek <EMPTY /> iş akışı ifadeleri görevden tanımı yazın.Daha fazla bilgi için olun, eşleme bir takım projesi emin idi oluşturulan öğesinden Scrum süreç şablonunu için gerekli değişiklikleri.

Aşağıdaki tablo alanları atanan varsayılan eşlemeleri açıklar Team Foundation.Nasıl başvuru istediğiniz ve güncelleştirilecek alanları yansıtan belirtebilirsiniz.Ayarlayabilirsiniz OnConflict için PSWins değerinde üzerine yazmak için Team Foundation projesi sunucusundan değerine sahip.Bırakır OnConflict özniteliği belirtilmezse, alanları korumak farklı değerleri.Daha fazla bilgi için gözden alan öğeleri ve öznitelikleri daha sonra bu konudaki tabloda.

Yansıtılmış alanları ve eşitleme işlemi hakkında daha fazla bilgi için bkz: Belirli alan güncelleştirmelerinin nasıl yönetildiğini anlama.

Team Foundationalan

Proje alanı

İş öğesi formunun Project Server sekmesinde görüntüleme alanı (displayTfsField)

İş öğesi formunun Project Server sekmesinde görüntüleme yansıtılmış alanı (displayTfsMirror)

Alan güncelleştirmeler (OnConflict)

Başlık

Görev adı

Hayır

Hayır

Project Server değerinde değerinde değiştirir Team Foundation.

Atanan

Kaynaklar

Hayır

Hayır

Project Server değerinde değerinde değiştirir Team Foundation.

Kalan İş

Kalan işi (durum sırası) kaynak

Kalan işi (Project Server) görevi

Evet

Evet

Her bir değer korunur.

Tamamlanan çalışma

Kaynak fiili çalışma (durum sırası)

Görev fiili çalışma (Project Server)

Evet

Evet

Her bir değer korunur.

Özgün tahmin

Temel çalışma

Hayır

Evet

Project Server değerinde değerinde değiştirir Team Foundation.

Başlangıç tarihi

Kaynak başlangıç (durum sırası)

Görev Başlangıç (Project Server)

Hayır

Hayır

Project Server değerinde değerinde değiştirir Team Foundation.

Bitiş tarihi

Kaynak bitiş (durum sırası)

Görev Bitiş (Project Server)

Hayır

Hayır

Project Server değerinde değerinde değiştirir Team Foundation.

Daha fazla proje alanları görüntüleyebilirsiniz Project Server bir iş öğesi formunda sekmesini Team Foundation için alan eşlemelerini eklerseniz.Bu sekme hakkında daha fazla bilgi için bkz Veri eşitlemeyi desteklemek için TFS'ye eklenen Project Server alanları.

Eşleme öğeleri ve öznitelikleri

Kullandığınız bir field öğesi başvurusu alanında belirtmek için Team Foundation eşitlemek için.Tüm field öğeleri içerdiği mappingFile, persistables, ve Microsoft.TeamFoundation.Sync.Mapping.Impls.FieldMapping kapsayıcı öğeler.

Önemli notÖnemli

TFS alandan Project Server eşleştirirken, veri türleri bu alanların eşleştiğinden emin olun.Aksi takdirde, alan eşlemelerini karşıya yüklemeye çalışırken aşağıdaki hata görünebilir:

Dizin (sıfır tabanlı) sıfırdan büyük veya sıfıra eşit ve bağımsız değişken listesi boyutundan küçük olmalıdır.

Daha fazla bilgi için bkz. TFS-Project Server tümleştirmesinde Project Server alanlarını eşleme ile ilgili kısıtlamalar.

Aşağıdaki örnek, XML öğelerine iç içe geçen yapısını gösterir.Varsayılan eşlemeleri görüntülemek için bkz Varsayılan eşleme dosyası中管理我的环境.

<mappingFile>
   <persistables>
      <Microsoft.TeamFoundation.Sync.Mapping.Impls.FieldMapping>
         <field tfsName="System.Title" tfsMirrorName="Mirror.System.Title" displayTfsField="false" displayTfsMirror="false" onConflict="PSWin">
            <tfsToTarget>
               <target provider="ProjectServerStatusQueue" name="pjTaskName" />
            </tfsToTarget>
            <targetToTfs>
               <target provider="ProjectServerPublished" name="pjTaskName" />
            </targetToTfs>
         </targetToTfs>
      </field>

         . . .

    </Microsoft.TeamFoundation.Sync.Mapping.Impls.FieldMapping>
  </persistables>
</mappingFile>

Alan öğesi sözdizimi

Aşağıdaki sözdizimini özniteliklerini tanımlar field öğe:

<field tfsName="FieldName" tfsMirrorName="FieldMirrorName" displayTfsField="true | false" displayTfsMirror=" true | false" onConflict="PSWin">

Hedef öğe sözdizimi

Aşağıdaki sözdizimini özniteliklerini tanımlar target öğe:

<target provider="ProviderName" name="ProjectFieldName" />

Alan adı belirlemek için "pj" birleştirilmiş kolay ad önek.Örneğin, alan için durum Yöneticisi pjStatusManager adıdır ve alan özel 01 pjCustom01 adıdır.

Alan öğeleri ve öznitelikleri

Aşağıdaki tablo alt öğelerini ve özniteliklerini açıklayan field öğesi.Harita, bir Team Foundation alan değeri durum eşitleme sırasında güncelleştirmek istediğiniz bir proje kaynak alanı.Harita, bir Team Foundation alan değeri güncelleştirecekseniz bir proje görev alanı için Team Foundation Server eşitleme sırasında yayımlama.Ayrıca, eşleme alanlar birimlerini yerleşik ölçütlere uyması gerekir.Daha fazla bilgi için bkz. TFS-Project Server tümleştirmesinde Project Server alanlarını eşleme ile ilgili kısıtlamalar.

Öğe

Öznitelik

Açıklama

field

Alanını belirtir Team Foundation eşlenmesi ve alan nasıl eşlenmesi gerekir.

tfsName

Alanın başvuru adını belirtir Team Foundation eşitlemek için.Takım projesi koleksiyonunda tanımlanmış bir alanı belirtmeniz gerekir.Çalıştırarak koleksiyonundaki tüm alanları verebileceğinizi witadmin listfields komutu.Daha fazla bilgi için bkz. İş öğesi alanlarını yönetme [witadmin].

tfsMirrorName

Gerekli.Project Server alanının değeri depolanacağı altında başvuru adını belirtir Team Foundation Server.Başvuru adı "Yansıtma." ile önek Örneğin, System.Title için Mirror.System.Title belirtebilirsiniz.

[!NOT]

Belirttiğiniz yansıtma alanlar otomatik olarak oluşturulur.Yansıtma alanları eklemek için bir iş öğesi türü tanımı gerekmez.

displayTfsField

İsteğe bağlı.Varsayılan olarak, bu öznitelik ayarlamak true.Bu öznitelik ayarlanmışsa true, alanı görüntülenir Project Server iş öğesi formunda sekmesini Team Foundation.Bu öznitelik ayarlanmışsa false, alanın formda görünmüyor.Varsayılan olarak, yalnızca tamamlanan çalışma ve kalan çalışma alanları formda görünür.

displayTfsMirror

İsteğe bağlı.Varsayılan olarak, bu öznitelik ayarlamak true.Bu öznitelik ayarlanmışsa true, alanı görüntülenir Project Server iş öğesi formunda sekmesini Team Foundation.Bu öznitelik ayarlanmışsa false, alanın formda görünmüyor.

onConflict

İsteğe bağlı.Eşitleme altyapısı başvuru alanı nasıl güncelleştirdiği belirtir.Yalnızca geçerli değer PSWin.

Bu öznitelik ayarlandığında PSWin, yansıtma değerinde projesi sunucusundan yayımlanan geçerli değeri farklı başvuru alanının değeri güncelleştirilir.

Bu öznitelik tanımlanmamışsa, iki kümesi defterleri tutulması gösterir.Diğer bir deyişle, proje değerinde değerinden farklı olabilir Team Foundation.Varsayılan olarak, proje değerleri her zaman başlık, atanan için başlangıç tarihi ve bitiş tarihi alanlarının değerlerini değiştirin.Varsayılan olarak, yalnızca tamamlanan çalışma ve kalan çalışma alanları iki kümesi defterleri ile korunur.Daha fazla bilgi için alanlarına, içeren saat güncelleştirir.

tfsToTarget

Alanın adını belirtir, proje Team Foundation güncelleştirir.

target

Güncelleştirmeleri almak için hedef belirtir Team Foundation.

provider

Güncelleştirme sağlayıcının adını belirtir.İçin tfsToTarget, yalnızca geçerli değer ProjectServerStatusQueue.

name

Değer güncelleştirilecek proje alanının adını belirtir Team Foundation.Yalnızca yerleşik veya Kurumsal özel alanları Project Server eşleyebilirsiniz.Kullanılabilir alanların bir listesi için bkz TFS-Project Server tümleştirmesinde Project Server alanlarını eşleme ile ilgili kısıtlamalar.

targetToTfs

Güncelleştirmeleri Project Server ile eşitlemek için alan eşlemesini belirtir Team Foundation Server.

target

Projesi sunucusundan güncelleştirmeleri almak için hedef belirtir.

provider

Güncelleştirme sağlayıcının adını belirtir.İçin targetToTfs, yalnızca geçerli değer ProjectServerPublished.

name

Alanın adı alanına güncelleştiren proje belirtir Team Foundation.Yalnızca yerleşik veya Kurumsal özel alanlar eşleyebilirsiniz.Kullanılabilir alanların bir listesi için bkz TFS-Project Server tümleştirmesinde Project Server alanlarını eşleme ile ilgili kısıtlamalar.

transforms

İsteğe bağlı.İçin kapsayıcı öğe transform öğesi.

transform

transformType

Alana uygulanacak dönüşüm türünü belirtir.Yalnızca belirtebilirsiniz transformType için bir targetToTfs ve yalnızca sayısal alan türleri için.Yalnızca geçerli değer ClearValueIfParent.

Eşitleme altyapısı Project Server ile eşitlenmiş bir iş öğesi altında bir hiyerarşi algıladığında, bir toplama iş ve proje sunucusuna göndermek için atamaları için gerçekleştirir.Ancak, transformType ayarlanan ClearValueIfParent, çalışma alanları üst iş öğesi eşitleme altyapısı temizler Team Foundation Server standart yanlış verinin oluşturulmasını önlemek için Team Foundation Server raporlar.

Varsayılan eşlemeleri

Aşağıdaki kod, çalıştırdığınızda, tanımlanan varsayılan alan eşlemelerini listeler TfsAdmin ProjectServer /UploadFieldMappings belirtin ve komutu /useDefaultFieldMappings seçeneği.Bu eşlemeler bir dosyaya indirin ve ardından öğeleri eklemek veya listelenen alanların özniteliklerini değiştirin.

Katılmak için bu türdeki veri eşitleme eklediğinizde, iş öğesi türü için eklenen tüm alanları listesi için bkz Veri eşitlemeyi desteklemek için TFS'ye eklenen Project Server alanları.

<mappingFile>
  <persistables>
    <Microsoft.TeamFoundation.Sync.Mapping.Impls.FieldMapping>
      <field tfsName="System.Title" tfsMirrorName="Mirror.System.Title" displayTfsField="false" displayTfsMirror="false" onConflict="PSWin">
        <tfsToTarget>
          <target provider="ProjectServerStatusQueue" name="pjTaskName" />
        </tfsToTarget>
        <targetToTfs>
          <target provider="ProjectServerPublished" name="pjTaskName" />
        </targetToTfs>
      </field>
      <field tfsName="System.AssignedTo" tfsMirrorName="Mirror.System.AssignedTo" displayTfsField="false" displayTfsMirror="false" onConflict="PSWin">
        <tfsToTarget>
          <target provider="ProjectServerStatusQueue" name="pjTaskResourceNames" />
        </tfsToTarget>
        <targetToTfs>
          <target provider="ProjectServerPublished" name="pjTaskResourceNames" />
        </targetToTfs>
      </field>
      <field tfsName="Microsoft.VSTS.Scheduling.CompletedWork" tfsMirrorName="Mirror.Microsoft.VSTS.Scheduling.CompletedWork" displayTfsField="true" displayTfsMirror="true">
        <tfsToTarget>
          <target provider="ProjectServerStatusQueue" name="pjResourceActualWork" />
        </tfsToTarget>
        <targetToTfs>
          <target provider="ProjectServerPublished" name="pjTaskActualWork" />
            <transforms>
               <transform transformType="clearValueIfParent">
            </transforms>
        </targetToTfs>
      </field>
      <field tfsName="Microsoft.VSTS.Scheduling.RemainingWork" tfsMirrorName="Mirror.Microsoft.VSTS.Scheduling.RemainingWork" displayTfsField="true" displayTfsMirror="true">
        <tfsToTarget>
          <target provider="ProjectServerStatusQueue" name="pjResourceRemainingWork" />
        </tfsToTarget>
        <targetToTfs>
          <target provider="ProjectServerPublished" name="pjTaskRemainingWork" />
            <transforms>
               <transform transformType="clearValueIfParent">
            </transforms>
        </targetToTfs>
      </field>
      <field tfsName="Microsoft.VSTS.Scheduling.OriginalEstimate" tfsMirrorName="Mirror.Microsoft.VSTS.Scheduling.OriginalEstimate" displayTfsField="false" displayTfsMirror="true" onConflict="PSWin">
        <targetToTfs>
          <target provider="ProjectServerPublished" name="pjTaskBaselineWork" />
        </targetToTfs>
      </field>
      <field tfsName="Microsoft.VSTS.Scheduling.StartDate" tfsMirrorName="Mirror.Microsoft.VSTS.Scheduling.StartDate" displayTfsField="false" displayTfsMirror="false" onConflict="PSWin">
        <tfsToTarget>
          <target provider="ProjectServerStatusQueue" name="pjResourceStart" />
        </tfsToTarget>
        <targetToTfs>
          <target provider="ProjectServerPublished" name="pjTaskStart" />
        </targetToTfs>
      </field>
      <field tfsName="Microsoft.VSTS.Scheduling.FinishDate" tfsMirrorName="Mirror.Microsoft.VSTS.Scheduling.FinishDate" displayTfsField="false" displayTfsMirror="false" onConflict="PSWin">
        <tfsToTarget>
          <target provider="ProjectServerStatusQueue" name="pjResourceFinish" />
        </tfsToTarget>
        <targetToTfs>
          <target provider="ProjectServerPublished" name="pjTaskFinish" />
        </targetToTfs>
      </field>
    </Microsoft.TeamFoundation.Sync.Mapping.Impls.FieldMapping>
  </persistables>
</mappingFile>

Ayrıca bkz.

Başvuru

TFS-Project Server tümleştirmesi için alan eşlemelerini yönetme

Kavramlar

TFS-Project Server tümleştirmesinde Project Server alanlarını eşleme ile ilgili kısıtlamalar

Veri eşitlemeyi desteklemek için TFS'ye eklenen Project Server alanları

Team Foundation Server ve Project Server tümleştirmesini yönetme

Diğer Kaynaklar

TFS ve Project Server arasında alan eşlemeyi özelleştirme