Azure DevOps ve Office tümleştirme sorunlarını çözme

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Azure DevOps, iş öğelerinin toplu olarak düzenlenmesini ve yönetilmesini sağlamak için öncelikle Excel ve Project olmak üzere Microsoft Office uygulamalarıyla tümleşir. Bu tümleştirme, Office uygulamalarınıza Ekip şeridi ekleyen Azure DevOps Office Tümleştirme eklentisine dayanır.

Important

Azure DevOps Office tümleştirme eklentisi artık desteklenmemektedir ve Office'in veya tarayıcıların geçerli sürümleriyle çalışmayabilir. Microsoft bu eklenti için güncelleştirmeler veya düzeltmeler sağlamaz. Toplu iş öğesi işlemleri için önerilen ve desteklenen yaklaşım olan CSV içeri/dışarı aktarma işlevini kullanın.

Tümleştirme sorunlarıyla karşılaşabileceğiniz yaygın senaryolar şunlardır:

• Eksik Ekip şeridi: Azure DevOps Ekibi şeridi Excel'de veya diğer Office uygulamalarında görünmüyor
• Eklenti yüklenmiyor: Azure DevOps eklentisi yüklenemedi veya devre dışı bırakıldı
• Kimlik doğrulama sorunları: Parola değişiklikleri veya kuruluş güncelleştirmeleri sonrasında oturum açma sorunları
• Yayımlama hataları: Office'ten iş öğelerini güncelleştirirken veri çakışmaları veya doğrulama hataları
• Yükleme çakışmaları: Office ve Visual Studio'yu farklı siparişlerde yüklemeden kaynaklanan sorunlar

Bu makalede, en yaygın Azure DevOps Office tümleştirme sorunları için adım adım çözümler sağlanır. Sorun gidermeden önce gerekli önkoşullara sahip olduğunuzdan emin olun ve Office tümleştirme desteğinin geçerli durumunu anlayın.

Important

Microsoft Project Tümleştirmesi artık desteklenmiyor

Microsoft Project Tümleştirmesi ve TFSFieldMapping komutu aşağıdakiler için sonlandırıldı:

• Visual Studio 2019 ve sonraki sürümleri (Azure DevOps Office Tümleştirmesi dahil)
• Azure DevOps Server 2020 ve sonraki sürümleri
• Azure DevOps Services

Hala çalışan şeyler: Microsoft Excel tümleştirmesi, iş öğelerini toplu içeri aktarma ve güncelleştirme için tam olarak desteklenmektedir.

Önerilen alternatifler:

• Teslim Planları - Proje planlama ve ekipler arası izleme için yerel Azure DevOps özelliği
• Proje yönetimi uzantıları - Geçerli Gantt grafiği ve proje yönetimi çözümleri için Azure DevOps Market'e göz atın
• Üçüncü taraf tümleştirmeleri - Birçok proje yönetim aracı sorunsuz iş akışı tümleştirmesi için Azure DevOps bağlayıcıları sunar

Azure DevOps Integration 2019'u yükleme

Bu araç, Excel'den Azure Boards'a bağlanmanızı sağlar. Azure DevOps Integration 2019 aracını yüklemek için şu adımları izleyin:

1. Azure DevOps Office Tümleştirmesi 2019 aracını indirin.

2. İndirilen dosyayı çalıştırarak aracı yükleyin.

3. Ekip şeridini görmek için Excel'i yeniden başlatın.

Ekip şeridini hala görmüyorsanız, aşağıdaki bölümlerdeki adımları uygulayın.

Azure DevOps eklentisini etkinleştirme

1. Excel'de Dosya>Seçenekler'i seçin.

2. Eklentiler> menüsünden COM Eklentileri seçeneğini Yönet açılır menüsünden seçin ve >Git düğmesine tıklayın.

   

3. Team Foundation Eklentisi kutusunda bir onay işareti olduğundan emin olun.

   

4. Excel'i yeniden başlatın.

Ekip şeridi gösteriliyor.

Bir sonraki başlatmada Ekip şeridi görünmüyorsa, eklentinin yükleme davranışı değiştirilebilir, bu nedenle sonraki adımları uygulayın.

Kayıt defterini güncelleştirme

1. Ara veya Çalıştır kutusuna girerek regedit Windows Başlat Menünüzü kullanarak Kayıt Defteri Düzenleyicisi'ni başlatın.

   

2. Aşağıdaki yollardan birine gidin ve TFCOfficeShim.Connect.[version] klasörünü bulun.

   Note

   Aynı ada sahip birden çok klasör varsa, en yüksek sürüm numarasına sahip olanı seçin.

   • HKEY_CURRENT_USER\SOFTWARE\Microsoft\Office\Excel\Addins (bu anahtar yoksa aşağıdaki seçeneklerden birini deneyin)

   • HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\Excel\Addins

   • HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Office\Excel\Addins

   

3. LoadBehavior'ı çift tıklayarak açın ve değer veri alanını olarak ayarlayın. Eğer değer 0 ise Takım şeridi yüklenmez.

4. Tamam'ı seçin ve Excel'i yeniden başlatın.

   LoadBehavior girdisi hakkında daha fazla bilgi için bkz . VSTO Eklentileri için Kayıt Defteri Girdileri, LoadBehavior değerleri.

Eklentinin devre dışı bırakılıp bırakılmadığını doğrulama

1. Excel Dosyası menüsünde Seçenekler'i seçin.

2. Eklentiler'i seçin ve Yönet açılır menüsünden Devre Dışı Öğeler'i seçin, sonra >.

   

3. Listede Azure DevOps Eklentisi görüyorsanız, bunu seçin ve Etkinleştir'i seçin.

   

Visual Studio başarısız olduğunda Office eklentisi Excel'de yüklenemiyor veya açılmıyor

Azure Boards'a bağlanmak için Ekip şeridine gidin ve Yeni Liste'yi seçin. Yeni Liste iletişim kutusu açılamazsa veya TF86001 veya benzer bir hata iletisi alırsanız Visual Studio'yu onarmanız gerekebilir.

Bu hata genellikle Visual Studio Office Excel veya Project'in öncesinde yüklendiğinde oluşur. Bu durumda, Office Çalışma Zamanı için Visual Studio Araçları doğru yapılandırılmaz. Bu hatayı düzeltmek için Visual Studio yüklemenizi onarın.

Note

TF31003 ve TF30063gibi kimlik doğrulama sorunları için bkz. Kullanıcı hesabınınizni yok.

Prerequisites

Visual Studio Komut İstemi'ne ve Gacutil.exe (Genel Bütünleştirilmiş Kod Önbelleği Aracı) erişiminiz olduğundan emin olmak için Visual Studio'yu yükleyin. Visual Studio'nuz yoksa Visual Studio Community sürümünü ücretsiz olarak yükleyebilirsiniz.

Gacutil aracını çalıştırma

1. Visual Studio Komut İstemi'ni açın ve yönetici olarak çalıştırmayı seçin.

   

2. Yazılımınıza göre aşağıdaki komutları çalıştırın:

   Software	Commands
   Microsoft 365	GACUTIL /I C:\Windows\assembly\GAC_MSIL\Policy.14.0.Microsoft.Office.Interop.Excel\15.0.0.0__71e9bce111e9429c\Policy.14.0.Microsoft.Office.Interop.Excel.dll GACUTIL /I C:\Windows\assembly\GAC_MSIL\Policy.14.0.office\15.0.0.0__71e9bce111e9429c\Policy.14.0.Office.dll
   Office 2016 ve Office 2013	GACUTIL /I C:\Windows\assembly\GAC_MSIL\Policy.12.0.Microsoft.Office.Interop.Excel\15.0.0.0__71e9bce111e9429c\Policy.12.0.Microsoft.Office.Interop.Excel.dll <\br>GACUTIL /I C:\Windows\assembly\GAC_MSIL\Policy.12.0.office\15.0.0.0__71e9bce111e9429c\Policy.12.0.Office.dll
   Office 2010	GACUTIL /I C:\Windows\assembly\GAC_MSIL\Policy.12.0.Microsoft.Office.Interop.Excel\14.0.0.0__71e9bce111e9429c\Policy.12.0.Microsoft.Office.Interop.Excel.dll <\br>GACUTIL /I C:\Windows\assembly\GAC_MSIL\Policy.12.0.office\14.0.0.0__71e9bce111e9429c\Policy.12.0.Office.dll

3. Komutları başarıyla çalıştırdıktan sonra Excel'i GACUTIL yeniden başlatın ve Office için Azure DevOps Tümleştirme Aracı eklentisini arayın.

Önceki adımlar yardımcı olmazsa, sonraki adımları deneyin:

1. Office'i onarın.
2. Office'i kaldırın ve ardından Office'i yeniden yükleyin.
3. Geliştirici Topluluğu aracılığıyla Microsoft'a başvurun.

Kullanıcı, parola değişikliğinden sonra Excel'den Azure DevOps'ta oturum açamıyor

Ağ parolanızı değiştirdiyseniz ve yeni hesap bilgileriyle kimlik doğrulama hataları almaya başladıysanız bilinen bir sorunla karşılaşmış olabilirsiniz. Visual Studio'da depolanan belirteç artık geçerli değil, ancak sistem, yenileme gereksinimini algılamıyor. Herhangi bir işlem yapmanız gerekmez; belirtecin süresi sonunda sona erer ve gecikme öngörülemez olsa da kimlik doğrulaması yeniden çalışmaya başlar. Belirteci el ile kaldırmak için aşağıdaki geçici çözümü kullanın.

Belirteci kayıt defterinden kaldır

1. Tüm açık Excel örneklerini kapatın.

2. Yükseltilmiş bir Komut İsteminden (yönetici olarak çalıştır) aşağıdaki komutları çalıştırarak kayıt defteri yolunu kaydedin ve temizleyin:

   reg export HKEY_CURRENT_USER\SOFTWARE\Microsoft\VSCommon\14.0\ClientServices\TokenStorage\VisualStudio\VssApp %TEMP%\oicreds.reg
   

   reg delete HKEY_CURRENT_USER\SOFTWARE\Microsoft\VSCommon\14.0\ClientServices\TokenStorage\VisualStudio\VssApp
   

3. Excel'i açtığınızda Azure DevOps'a bağlandığında oturum açma istenir.

Belirteç süresi dolana kadar bekleyin veya bu sorun ortaya çıkacak şekilde yapılandırıldıysa, her parola değiştiğinde bu kayıt defteri anahtarını silin.

Yenileme ve yayımlama sırasında aralıklı sorunlar

Yenileme veya yayımlama sırasında bir hata alırsanız, Microsoft Entra Id'de bir Koşullu Erişim İlkesi olabilir. Bu sorunu çözmek için klasörün içeriğini temizleyin: %LOCALAPPDATA%\.IdentityService.

Microsoft.Office.Interop.Excel.ApplicationClass türündeki COM nesnesi oluşturulamıyor

İş öğesi listesini Excel'de açarken Takım Gezgini'nden tetiklenen bir hata iletisi alabilirsiniz. Daha fazla bilgi için bkz 'Microsoft.Office.Interop.Excel.ApplicationClass' türündeki COM nesnesi 'Microsoft.Office.Interop.Excel._Application' arabirim türüne dönüştürülemedi nasıl çözülür?

Excel verilerini yayımladığınızda veya yenilediğinizde veri çakışmalarını çözme

Excel bir iş öğesi yayımlamaya çalıştığınızda veri çakışması oluşur ve bu iş öğesinin sürümü iş öğesi veritabanındaki sürümden farklıdır. Aşağıdaki örnekte, iki ekip üyesinin böyle bir çakışmayı nasıl oluşturabileceği gösterilmektedir:

1. Ekip üyesi, excel veya Project'teki iş öğesi listesinde bir iş öğesinin kopyasını açar.
2. Ekip üyesi A, iş öğesini düzenler ve bir değişiklik kümesi yapar.
3. Ekip üyesi B, aynı iş öğesini düzenler ve farklı bir değişiklik kümesi yapar ve bu değişiklikleri yayımlar.
4. Ekip üyesi A, iş öğesini düzenlemeyi tamamlar ve değişiklikleri iş öğesinde yayımlamaya çalışır.
5. Excel veya Project, yayımlayamadığı öğeleri gösteren İş Öğesi Yayımlama Hataları iletişim kutusunu görüntüler.

Veri çakışması çözme

1. İş Öğesi Yayımlama Hataları iletişim kutusunda, Sorun sütununda Çakışma bulunan Yayımlanmamış iş öğeleri kutusundaki her iş öğesi için aşağıdaki adımları izleyin.
2. yayımlanmamış iş öğeleri kutusunda iş öğesini seçin.
   Ayrıntıları alanında, seçili iş öğesi için çakışmaların listesi gösterilir. Çakışan alan sütunu, çakışmanın oluştuğu alanın adını gösterir. Yerel sürüm ve Server sürüm sütunları sırasıyla yerel ve sunucu verilerini gösterir ve bu sütunların her birinde verilerin yanında bir onay kutusu görüntülenir.
3. Ayrıntılar kutusundaki her satır için doğru değerin yanındaki onay kutusunu seçin.
   Yerel sürümü seçtiğinizde, Office Excel veya Office Project'teki veriler sunucudaki verilerin üzerine yazar. Sunucu sürümünü seçerseniz, sunucu verileri Office Excel veya Office Project'teki verilerin üzerine yazar.
4. Yayımla'yı seçin.

Note

Bu adım yalnızca düzelttiğiniz iş öğelerini yayımlar. Bir iş öğesiyle ilgili tüm veri doğrulama hatalarını çözmezseniz, bu iş öğesi yayımlanmaz.

Excel'den yayımladığınızda oluşan veri doğrulama hatalarını çözme

İş öğesi listesindeki veya proje planındaki bir değişiklik iş öğesi türünün kuralını ihlal ettiğinde veri doğrulama hatası oluşur. Aşağıdaki örneklerde yaygın veri doğrulama hataları gösterilmektedir:

• Birisi, adı izin verilen değerler listesine dahil olmayan bir ekip üyesine iş öğesi atar
• Birisi bir iş öğesi oluşturur ancak iş öğesi türü gibi gerekli bir alanı tamamlamayı unutur.

Değişiklikleri yayımlamaya çalıştığınızda veri doğrulama hatası oluşursa, İş Öğesi Yayımlama Hataları iletişim kutusu görüntülenir ve yayımlanmamış iş öğeleri listesinde Sorun sütununda Doğrulama hatası veya Geçersiziçeren başka bir tümcecik gösterilir.

Veri doğrulama hatalarını düzeltme

Veri doğrulama hatasını çözmek için İş Öğesi Yayımlama Hataları iletişim kutusunu kullanabilirsiniz.

1. İş Öğesi Yayımlama Hataları iletişim kutusunda, veri doğrulama hatasıyla görüntülenen her iş öğesi için şu adımları izleyin.

   Note

   Veri doğrulama hatası geçersiz bir iş öğesi türüyse, İş Öğesini Düzenle düğmesi görünmez ve bir iş öğesi formu görünmez. Office Excel çalışma sayfasında veya Office Proje planında hatayı düzeltmeniz gerekir. Office Excel'de bir hatayı düzeltme hakkında bilgi için bu makaledeki sonraki yordama bakın.

2. yayımlanmamış iş öğeleri kutusunda, iş öğesini seçin ve sonra İş Öğesini Düzenle'ni seçin.

   bir iş öğesi formu görüntülenir.

3. İş öğesi formunda bilgileri gözden geçirin ve değeri düzeltin.

4. Değişikliklerinizi kaydetmek ve iş öğesi formunu kapatmak için Kapat'ı seçin.

5. Veri doğrulama hatalarını düzeltdikten sonra, düzeltilen iş öğelerini yayımlamak için Yayımla'ı seçin.

   Note

   Bu adım yalnızca düzelttiğiniz iş öğelerini yayımlar. Veri doğrulama hatalarını çözmezseniz, bu iş öğesi yayımlanmaz.

6. İş Öğesi Yayımlama Hataları iletişim kutusunu kapatmak için Kapat'ı seçin.

Excel'de hata denetimini kullanarak veri doğrulama hatalarını çözme

İş öğesi listesindeki bir hatayı bulmak ve çözmek için Office Excel araçlarını kullanabilirsiniz. Office Excel hata denetimi araçlarını kullanma hakkında daha fazla bilgi için Office Excel Yardımı'na bakın.

Excel 2007'de hata denetimini kullanarak veri doğrulama hatalarını düzeltme

1. Microsoft Excel'de Formüller sekmesini seçin.
2. Formül Denetimi grubunda Hata Denetimiseçin.
   Hata denetleme aracı bir hata bulursa Hata Denetimi iletişim kutusu görüntülenir.
3. Hata hakkında temel bilgiler için Hata Denetimi iletişim kutusundaki hatayı açıklayan metne bakın. Hata hakkında daha fazla bilgi için bu hatayla ilgili yardımseçin.
4. İş öğesi listesinde, hatayı içeren hücreyi seçin ve değeri düzeltin.
5. Hata Denetimi iletişim kutusunda, sonraki veri doğrulama hatasını bulmak için Sürdür'yi seçin.
   • Hata Denetimi iletişim kutusu başka bir hata gösteriyorsa, hatayı çözmek için önceki iki adımı yineleyin.
   • Hata denetiminin tamamlandığını belirten bir ileti görüntülenirse, bu iletiyi ve Hata Denetimi iletişim kutusunu kapatmak için tamam seçin.

TF80070 çözme: İşlem gerçekleştirilirken bir hata oluştu

TF80070 hatası genellikle Azure DevOps Office tümleştirmesi ve diğer yüklü uygulamalar tarafından kullanılan Newtonsoft.Json kitaplığının farklı sürümleri arasındaki derleme bağlama çakışmalarından kaynaklanır.

Belirti -leri

Aşağıdaki durumlarda bu hatayla karşılaşabilirsiniz:

• Excel'den Azure DevOps'a bağlanma girişimi
• Excel'de iş öğesi listelerini açma veya yenileme
• Değişiklikleri Excel'den Azure DevOps'a yayımlama

Çözüm

Derleme bağlamalarını Newtonsoft.Json kitaplığının doğru sürümüne yönlendiren bir yapılandırma dosyası oluşturarak bu sorunu çözün.

1. Excel yükleme klasörünüzü bulun. Tipik yollar şunlardır:

   • Microsoft 365/Office 2016-2021: C:\Program Files\Microsoft Office\root\Office16\
   • Office 2013: C:\Program Files\Microsoft Office\Office15\
   • Office 2010: C:\Program Files\Microsoft Office\Office14\

2. Excel yükleme klasöründe yeni bir metin dosyası oluşturun ve olarak adlandırın excel.exe.config.

   Important

   Office yükleme dizininde dosya oluşturmak için yönetici ayrıcalıklarına sahip olmanız gerekir. Not Defteri'ne sağ tıklayın ve dosyayı oluşturmadan önce Yönetici olarak çalıştır'ı seçin.

3. Dosyaya aşağıdaki XML içeriğini excel.exe.config ekleyin:

   <?xml version="1.0" encoding="utf-8"?>
   <configuration>
     <runtime>
       <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
         <dependentAssembly>
           <assemblyIdentity name="Newtonsoft.Json" publicKeyToken="30AD4FE6B2A6AEED" culture="neutral"/>
           <bindingRedirect oldVersion="0.0.0.0-12.0.0.0" newVersion="13.0.0.0"/>
         </dependentAssembly>
       </assemblyBinding>
     </runtime>
   </configuration>
   

4. Dosyayı kaydedin ve adın tam olarak excel.exe.config (değil excel.exe.config.txt) olduğundan emin olun.

5. Tüm Excel örneklerini kapatın ve Excel'i yeniden başlatın.

6. Excel'den Azure DevOps'a yeniden bağlanmayı deneyerek bağlantıyı test edin.

Önceki sorun giderme adımlarını tamamladıktan sonra sorun devam ederse, kullanıcının profilini onarmayı ve bozuk sistem dosyalarını denetlemeyi göz önünde bulundurun.

1. Komut İstemi'ni veya PowerShell'i Yönetici olarak açın.

2. Windows görüntüsünü onarmak için DISM aracını çalıştırın:

   DISM.exe /Online /Cleanup-Image /RestoreHealth
   

3. DISM tamamlandıktan sonra Sistem Dosyası Denetleyicisi'ni çalıştırın:

   sfc /scannow
   

Office tümleştirme sorunlarını gidermek için yapay zekayı kullanma

Copilot Sohbeti için aşağıdaki örnek istem, Azure DevOps ve Office tümleştirme sorunlarını gidermenize yardımcı olur. Bu istemi kopyalayıp Copilot Chat'e yapıştırın ve yer tutucuları kendi bilgilerinizle değiştirin.

En iyi yapay zeka yardımı için tam hata iletisi, Office sürümü, Azure DevOps eklenti durumu ve Office uygulamalarınızda Ekip şeridinin görünür olup olmadığı gibi belirli ayrıntıları ekleyin.

I'm having this Azure DevOps Office integration issue: [PASTE YOUR ERROR MESSAGE OR DESCRIBE THE PROBLEM]

Office integration details:
- Office version: [Microsoft 365/Office 2021/2019/2016/2013]
- Excel/Project version: [SPECIFIC VERSION NUMBER if known]
- Azure DevOps add-in status: [Enabled/Disabled/Missing/Not visible]
- Team ribbon visibility: [Visible/Missing/Grayed out]
- Error code: [ERROR CODE like TF86001, TF80070, TF31003 if applicable]
- Visual Studio version: [VERSION if installed]
- Installation order: [Office first or Visual Studio first]
- Recent changes: [Password change, Office update, etc.]

Can you help me troubleshoot this issue? Please provide step-by-step instructions to:
1. Identify the root cause of the Office integration problem
2. Fix the add-in installation, registry settings, or authentication issue
3. Verify the Azure DevOps Team ribbon appears and functions correctly

Context: This is for Azure DevOps Office integration with Excel or Project. The issue might be related to add-in loading, COM registration, authentication, assembly conflicts, or installation problems.

Copilot yapay zeka ile desteklendiğinden sürprizler ve hatalar mümkündür. Daha fazla bilgi için bkz. Copilot sıkça sorulan sorular.

İlgili içerik

• İş öğelerini toplu olarak değiştirme (web portalı)
• CSV dosyalarını kullanarak iş öğelerini toplu içeri aktarma veya güncelleştirme
• SSS: Azure Boards'a Bağlı Excel'de Çalışma
• Eklenti ekleme veya kaldırma