Устранение проблем с интеграцией Azure DevOps и Office
Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019
Если лента команды отсутствует в Microsoft Excel, как показано на следующем рисунке, выполните действия, описанные в этой статье, чтобы устранить проблему.
Примечание.
Интеграция Azure DevOps Office завершена, и дальнейших обновлений или улучшений не планируется. Будущие инвестиции сосредоточены на собственном инструменте для массового импорта или обновления рабочих элементов с помощью CSV-файлов. При возникновении проблем с интеграцией Office рекомендуется использовать эту альтернативу. Для всех задач интеграции Office требуется установленная версия Visual Studio или бесплатная версия Azure DevOps Office Integration 2019, которая устанавливает надстройку интеграции Azure DevOps Office. Предварительные требования см. в статье Об интеграции с Azure Boards и Office.
Внимание
Интеграция Microsoft Project и TFSFieldMapping
команда не поддерживаются для:
- Visual Studio 2019 и Azure DevOps Office Integration 2019.
- Azure DevOps Server 2019 и более поздних версий, включая Azure DevOps Services.
Поддерживается полная поддержка интеграции Microsoft Excel, что позволяет выполнять массовый импорт и обновление рабочих элементов. К альтернативным вариантам использования Microsoft Project относятся:
- Планы выполнения
- Расширения Marketplace, такие как Project Connect или диаграмма GANTT
Установка Azure DevOps Integration 2019
Это средство позволяет подключаться к Azure Boards из Excel. Чтобы установить средство Azure DevOps Integration 2019, выполните следующие действия.
Установите средство, запустив скачанный файл.
Перезапустите Excel, чтобы просмотреть ленту команды .
Если лента команды по-прежнему не отображается, выполните действия, описанные в следующих разделах.
Включение надстройки Azure DevOps
В Excel выберите Файл>Параметры.
Выберите надстройки>COM-надстройки в раскрывающемся меню Управление, затем нажмите >Перейти.
Убедитесь, что в поле надстройки Team Foundation установлен флажок.
Перезапустите Excel.
Лента Команды отображается.
Если лента команды не отображается при следующем запуске, поведение загрузки надстройки может быть изменено, поэтому выполните следующие действия.
Обновление реестра
Запустите редактор реестра из меню "Пуск" Windows, введя
regedit
в поле поиска или запуска.Перейдите к одному из следующих путей, содержащих папку TFCOfficeShim.Connect.[version]:
Примечание.
Если имеется несколько папок с одинаковым именем, выберите один с самым высоким номером версии.
HKEY_CURRENT_USER\SOFTWARE\Microsoft\Office\Excel\Addins
(если этот ключ не существует, попробуйте один из следующих вариантов)HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\Excel\Addins
HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Office\Excel\Addins
Дважды щелкните, чтобы открыть LoadBehavior и задать для поля данных значение
3
. Если значение равно0
, лента команды не загружается.Нажмите кнопку "ОК " и перезапустите Excel.
Дополнительные сведения о записи LoadBehavior см. в разделе записи реестра для надстроек VSTO, значения LoadBehavior.
Проверьте, отключена ли надстройка
В меню "Файл Excel" выберите "Параметры".
Выберите надстройки, в раскрывающемся меню Управление выберите Отключенные элементы и нажмите Перейти.
Если в списке отображается добавление Azure DevOps, выберите его и нажмите кнопку "Включить".
Надстройка Office не загружается или не открывается в Excel при сбое Visual Studio
Чтобы подключиться к Azure Boards, перейдите на ленту команды и выберите "Создать список". Если диалоговое окно "Новый список" не открывается или вы получаете TF86001 или аналогичное сообщение об ошибке, возможно, потребуется восстановить Visual Studio.
Эта ошибка обычно возникает при установке Visual Studio до Office Excel или Project. В этом случае среда выполнения Visual Studio Tools for Office настроена неправильно. Чтобы устранить эту ошибку, восстановите установку Visual Studio.
Примечание.
Для получения сведений о проблемах с проверкой подлинности, таких как TF31003
и TF30063
, см. статью "Учетная запись пользователя не имеет разрешений".
Предварительные условия
Установите Visual Studio, чтобы убедиться, что у вас есть доступ к командной строке Visual Studio и Gacutil.exe (средство глобального кэша сборок). Если у вас нет Visual Studio, вы можете бесплатно установить выпуск Visual Studio Community.
Запуск средства Gacutil
Откройте командную строку Visual Studio и выберите запуск от имени администратора.
Выполните следующие команды на основе программного обеспечения:
Программное обеспечение. Команды 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 и 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
После успешного выполнения команд
GACUTIL
, перезапустите Excel и найдите надстройку для интеграции Azure DevOps с Office.
Если предыдущие шаги не помогают, попробуйте выполнить следующие действия:
- Ремонт Офиса.
- Удалите Office и переустановите Office.
- Обратитесь в корпорацию Майкрософт через Сообщество разработчиков.
Пользователь не может войти в Azure DevOps из Excel после изменения пароля
Если вы изменили сетевой пароль и начали получать ошибки проверки подлинности с информацией о новой учетной записи, возможно, возникла известная проблема. Маркер, хранящийся в Visual Studio, больше не действителен, но система не распознает необходимость его обновления. Вам не нужно предпринимать никаких действий; Срок действия маркера истекает в конечном итоге, и проверка подлинности начинает работать снова, хотя задержка непредсказуема. Используйте следующий обходной путь, чтобы вручную удалить токен.
Удаление маркера из реестра
Закройте все открытые экземпляры Excel.
Сохраните и снимите путь к реестру, выполнив следующие команды из командной строки с повышенными привилегиями (запуск от имени администратора):
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
Откройте Excel, и он запросит вход при подключении к Azure DevOps.
Подождите, пока срок действия токена не истечет, или удалите этот регистрационный ключ при каждом изменении пароля, если он настроен таким образом, что возникает эта проблема.
Периодические проблемы с обновлением и публикацией
Если во время обновления или публикации возникает ошибка, в идентификаторе Microsoft Entra может быть политика условного доступа. Чтобы устранить эту проблему, очистите содержимое папки: %LOCALAPPDATA%\.IdentityService
Не удается преобразовать COM-объект типа Microsoft.Office.Interop.Excel.ApplicationClass
При открытии списка рабочих элементов в Excel может появиться сообщение об ошибке, активированное в Team Explorer. Дополнительные сведения см. в статье "Не удалось выполнить преобразование COM-объекта типа Microsoft.Office.Interop.Excel.ApplicationClass" в тип интерфейса "Microsoft.Office.Interop.Excel._Application".
Устранение конфликтов данных при публикации или обновлении данных Excel
Конфликт данных возникает при попытке опубликовать рабочий элемент из Excel, а версия этого рабочего элемента отличается от версии в базе данных рабочих элементов. В следующем примере показано, как два члена команды могут создать такой конфликт:
- Участник группы открывает копию рабочего элемента в списке рабочих элементов в Excel или Project.
- Участник команды А изменяет рабочий элемент и вносит один набор изменений.
- Член группы B редактирует тот же рабочий элемент и делает другой набор изменений и публикует эти изменения.
- Член команды А завершает редактирование рабочего элемента и пытается опубликовать изменения в рабочем элементе.
- В Excel или Project отображается диалоговое окно ошибки публикации рабочих элементов, в котором отображаются элементы, которые не удалось опубликовать.
Устранение конфликта данных
- В диалоговом окне ошибок публикации рабочих элементов для каждого рабочего элемента в поле неопубликованные рабочие элементы, у которых в столбце вопросы указано конфликт, выполните следующие действия.
- В поле неопубликованные рабочие элементы выберите рабочий элемент.
В области подробности отображается список конфликтов для выбранного рабочего элемента. Столбец Конфликтующего поля показывает имя поля, в котором возникает конфликт. Столбцы локальной версии и серверной версии отображают локальные и серверные данные соответственно, а флажок появляется рядом с данными в каждом из этих столбцов. - Для каждой строки в поле Сведения поставьте флажок напротив правильного значения.
При выборе локальной версии данные в Office Excel или Office Project перезаписывают данные на сервере. Если выбрать версию сервера, данные сервера заменят данные в Office Excel или в Office Project. - Выберите Опубликовать.
Примечание.
На этом шаге публикуются только исправленные рабочие элементы. Если вы не устраните все ошибки проверки данных, связанные с рабочим элементом, этот рабочий элемент не будет опубликован.
Устранение ошибок проверки данных, возникающих при публикации из Excel
Ошибка проверки данных возникает, когда изменение списка рабочих элементов или плана проекта нарушает правило типа рабочего элемента. В следующих примерах показаны распространенные ошибки проверки данных:
- Кто-то назначает рабочий элемент участнику группы, имя которого не включено в список разрешенных значений
- Кто-то создает рабочий элемент, но забывает завершить обязательное поле, например тип рабочего элемента.
Если при попытке опубликовать изменения возникает ошибка проверки данных, появится диалоговое окно ошибки публикации рабочих элементов, а в списке неопубликованных рабочих элементов в столбце Проблема отображается ошибка проверки или другое выражение, содержащее недопустимый.
Устранение ошибки проверки данных
Чтобы устранить ошибку проверки данных, можно использовать диалоговое окно "Ошибки публикации рабочих элементов".
В диалоговом окне Ошибки публикации рабочих элементов для каждого рабочего элемента, который отображается с ошибкой проверки данных, выполните следующие действия.
Примечание.
Если ошибка проверки данных является недопустимым типом рабочего элемента, кнопка изменить рабочий элемент не отображается, а форма рабочего элемента не отображается. Необходимо исправить ошибку в листе Office Excel или плане проекта Office. Сведения о том, как устранить ошибку в Office Excel, см. в следующей процедуре в этой статье.
В поле неопубликованные рабочие элементы выберите рабочий элемент, а затем выберите изменение рабочего элемента.
Появится форма рабочего элемента.
В форме рабочего элемента просмотрите сведения и исправьте значение.
Выберите Закрыть, чтобы сохранить изменения и закрыть форму рабочего элемента.
После исправления ошибок проверки данных выберите Опубликовать, чтобы опубликовать исправленные рабочие элементы.
Примечание.
На этом шаге публикуются только исправленные рабочие элементы. Если не устранить ошибку проверки данных, этот рабочий элемент не опубликован.
Выберите Закрыть, чтобы закрыть диалоговое окно Ошибки публикации рабочих элементов.
Устранение ошибки проверки данных с помощью проверки ошибок в Excel
Средства Office Excel можно использовать для поиска и устранения ошибки в списке рабочих элементов. Дополнительные сведения об использовании средств проверки ошибок Office Excel см. в справке по Office Excel.
Устранение ошибки проверки данных с помощью проверки ошибок в Excel 2007
- В Microsoft Excel выберите вкладку Формулы.
- В группе аудита формул выберите проверку ошибок .
Если инструмент проверки ошибок находит ошибку, появится диалоговое окно проверки ошибок . - Основные сведения об ошибке см. в тексте, который описывает ошибку в диалоговом окне Проверка ошибок. Чтобы узнать больше об ошибке, осмотрите справку по этой ошибке.
- В списке рабочих элементов выберите ячейку, содержащую ошибку, а затем исправьте значение.
- В диалоговом окне Проверка ошибок выберите Продолжить, чтобы найти следующую ошибку проверки данных.
- Если в диалоговом окне проверка ошибок отображается другая ошибка, повторите предыдущие два шага, чтобы устранить эту ошибку.
- Если появится сообщение, указывающее, что проверка ошибок завершена, нажмите кнопку ОК, чтобы закрыть это сообщение и диалоговое окно проверки ошибок.