Практическое руководство. Создание отчетов о развертывании

Обновлен: Ноябрь 2007

В конструкторе схем развертывания можно задать свойства для отчета о развертывании, а затем из схемы развертывания создать отчет о развертывании. Отчеты о развертывании призваны помочь в создании сценария установки из структурированных XML-данных отчета. Отчет содержит необходимые параметры конфигурации приложения и центра данных, а также список всех метаданных модели определения системы (SDM), составляющих проверку развертывания. Эти метаданные SDM предоставляются уровнями приложения и размещения приложения и описывают большую часть сведений, необходимых для развертывания приложения. Дополнительные сведения см. в разделе Общие сведения об отчетах о развертывании.

Примечание.

Подготовка определения развертывания из схем развертывания или отчетов о развертывании, созданных из систем по умолчанию, не рекомендуется. Системы по умолчанию подходят для быстрой оценки развертывания отдельных приложений в центре данных, но не должны использоваться для окончательного развертывания. Дополнительные сведения см. в разделе Определения развертывания, созданные из диаграмм приложения и системы.

Чтобы задать свойства отчета о развертывании

1. Щелкните внутри схемы развертывания, чтобы выбрать ее.

2. В окне свойств задайте значение свойства Конечный путь.

   Совет.
   Если окно свойств не открыто, нажмите F4 или выберите в меню Вид пункт Окно свойств.

   Этот путь указывает, куда копируются файлы проекта, если свойствам Включить файлы содержимого, Включить исходные файлы или Включить двоичные файлы присвоено значение True.

   Примечание.
   Свойство Конечный путь необходимо задать, если только свойствам Включить файлы содержимого, Включить исходные файлы или Включить двоичные файлы присвоено значение True. Свойство Конечный путь не имеет значения по умолчанию.

3. Задайте свойство Включить файлы содержимого.

   Это свойство указывает, какие файлы содержимого будут включены в отчет о развертывании и скопированы в каталог конечного пути для создания сценария.

   Если выбрано значение True, то будут включены следующие типы файлов.

   • Веб-проекты: файлы кода, файлы проекта, файлы ресурсов, файлы CONFIG, ссылочные сборки, SDM-файлы, и другие файлы, не содержащие код, и не двоичные файлы. В их число входят файлы XSD, DISCO и WSDL.

   • Проекты Windows: SDM-файлы, сборки, существующие в папке решения и все другие не связанные с кодом и не двоичные файлы.

   • Проекты Office: SDM-файлы, сборки, существующие в папке решения и все другие не связанные с кодом и не двоичные файлы.

4. Задайте свойство Включить исходные файлы.

   Это свойство указывает, какие исходные файлы будут включены в отчет о развертывании и скопированы в каталог конечного пути.

   Если выбрано значение True, то будут включены следующие типы файлов.

   • Веб-проекты: нет.

   • Проекты Windows: файлы кода, файлы проекта, файлы ресурсов и файлы CONFIG.

   • Проекты Office: файлы кода, файлы проекта, файлы ресурсов и файлы CONFIG.

5. Задайте свойство Включить двоичные файлы.

   Это свойство указывает, какие двоичные файлы будут включены в отчет о развертывании и скопированы в каталог конечного пути.

   Если выбрано значение True, то будут включены следующие типы файлов.

   • Веб-проекты: нет.

   • Проекты Windows: исполняемые файлы и файлы App.config, которые также включаются, если свойство Включить исходные файлы имеет значение True.

   • Проекты Office: созданные сборки и файлы App.config, которые также включаются, если свойство Включить исходные файлы имеет значение True.

6. Чтобы включить изображения схемы в отчете о развертывании в формате HTML, свойству Включить схемы присвойте значение True (по умолчанию).

7. Чтобы приглашение для перезаписи файлов не появлялось, свойству Переопределить действия для файлов присвойте значение Да.

8. Присвойте значению Идентификация ошибок значение Приглашение, Пропустить или Прервать.

   При создании отчета о развертывании с помощью автоматизации, установите свойство Пропустить, если отчет необходимо создать несмотря на ошибки. Если в случае ошибки отчет не удается создать, задайте свойство Прервать.

9. Свойству Только ошибки присвойте одно из следующих значений.

   • True

     Отчет в формате HTML будет содержать только список ошибок и предупреждений проверки.

   • False

     Отчет HTML будет содержать список вместе со всем остальным содержимым (конечные точки, параметры, ресурсы и т.д.).

     Примечание.
     В некоторых случаях текст ошибок в отчете о развертывании отличается от текста ошибок в окне списка ошибок.

Теперь все готово к созданию отчета о развертывании.

Чтобы создать отчет о развертывании

1. После того, как все параметры отчета о развертывании установлены, в меню Схема выберите команду Создать отчет о развертывании.

   Совет.
   Можно также щелкнуть рабочую область схемы развертывания и выбрать команду Создать отчет о развертывании.

2. Если отчет для схемы развертывания уже существует и свойство Переопределить действия для файлов имеет значение Да, будет предложено перезаписать существующий отчет.

   Примечание.
   Перезаписываются только существующие отчеты. Структура остальных файлов и каталогов остается без изменений. При этом сохраняются все дополнительные файлы, которые могли бы записаны в структуру каталогов. Чтобы приглашение для перезаписи файлов в структуре не появлялось, свойству Переопределить действия для файлов присвойте значение Да.

   По запросу выберите один из следующих вариантов.

   • Да – Перезапись текущего файла и отображение приглашения, если возникает такая же ситуация.

   • Нет – Отсутствие перезаписи текущего файла и отображение приглашения, если возникает такая же ситуация.

   • Отмена – Прерывание процесса создания отчета.

   Конструктор развертывания создает два отчета о развертывании в обозревателе решений – один в формате HTML (.html), а другой в формате XML (.xml). По завершении процесса создания отчета, оба файла HTML и XML добавляются в папку решения системы, связанной со схемой развертывания.

Оба отчета в формате HTML и XML содержат, в основном, одинаковые сведения. Однако отчет HTML также содержит изображения схем в решении и список владельцев. Кроме того, отчет HTML не содержит ресурсы, в которых значениям по умолчанию присвоено NULL, и которые не были изменены, в то время как в XML-файле эти ресурсы для целей написания сценариев отсутствуют.

Эти отчеты можно также создать при помощи автоматизации в Visual Studio или из командной строки. Дополнительные сведения см. в разделах Практическое руководство. Использование автоматизации с отчетами о развертывании и Практическое руководство. Создание отчетов о развертывании из командной строки.

Примечание.

При выполнении приложения выполняется поиск параметров в файле с именем <appname>.exe.config. Если этот файл отсутствует, приложение может работать неверно. Отчет о развертывании не копирует и не выводит файл <appname>.exe.config – в нем содержится только app.config, который является копией <appname>.exe.config. Чтобы решить эту проблему убедитесь, чтобы сценарий развертывания переименовывал app.config соответствующим образом.

Безопасность

Данные отчета о развертывании могут содержать закрытые, конфиденциальные или относящиеся к учреждениям сведения. Рекомендуется учитывать это перед распространением или удалением отчета.

Примечание.
Когда свойству Включить исходные файлы или Включить файлы содержимого присвоено значение True, выводится предупреждение о том, что выходной каталог может быть небезопасным.

См. также

Задачи

Практическое руководство. Настройка отчетов о развертывании

Основные понятия

Общие сведения об отчетах о развертывании