Рекомендации по работе с полученными доставками
Рекомендации по выгрузке файлов полученной доставки
Выгрузка полученной доставки является обязательным первым шагом к импорту ZIP-файлов пакетов.
• Чтобы увеличить скорость выгрузки при получении больших ZIP-файлов, сохраните ZIP-файлы на сервере
Windchill и выберите опцию
Вложить новое внешнее хранилище
.
• Если ваш сервер Windchill находится в кластерной среде, убедитесь, что полученные ZIP-файлы доступны для всех слоев кластера.
• Желательно проверять все файлы манифеста или автономные программы просмотра, предоставленные отправителем. Чтобы проверить автономную программу просмотра, следует извлечь ZIP-файлы в файловой системе перед импортом. Для выгрузки требуется исходный ZIP-файл. Чтобы проверить файл манифеста, следует выгрузить ZIP-файлы и проверить манифест из полученной доставки.
Рекомендации по использованию определений сопоставлений
Определения сопоставлений представляют собой полезный инструмент для перемещения информации системы-источника в допустимый объект целевой системы. Определения сопоставлений обеспечивают перемещение данных из атрибутов, предоставляемых в качестве инструкций (например, контекст, папка и шаблон жизненного цикла), а также из атрибутов, значимых для бизнеса, администрирование которых осуществляется локально в системе (например, владеющая организация, состояние жизненного цикла и метки безопасности).
• Прежде чем импортировать полученные данные доставки, установите определения сопоставлений с помощью действия Предварительный просмотр импорта полученной доставки.
• При параллельном использовании предварительного просмотра и определения сопоставления можно копировать информацию непосредственно из окна предварительного просмотра в информацию системы-источника в рамках определения сопоставления.
• Прежде чем устанавливать определения сопоставлений, проанализируйте и устраните несоответствия определения типа, определения атрибута и определения схемы управления версиями.
◦ Решите, что эффективнее: добавить информацию из системы-источника непосредственно в вашу конфигурацию (например, создать папку с тем же именем) или определить сопоставление.
◦ Рекомендуется использовать сопоставление шаблона жизненного цикла, поскольку оно представляет бизнес-процесс, которому объект следует сразу после импорта. Поскольку редко требуется, чтобы в целевой системе объект следовал тому же бизнес-процессу, что и в системе-источнике, лучше всего определить сопоставление с шаблоном жизненного цикла, не запускающим рабочий процесс в объектах.
▪ Если вы хотите сохранить корреляцию с шаблоном жизненного цикла системы-источника или просто использовать базовый жизненный цикл для информации, импортированной из отправляющей системы, определите сопоставление с базовым представлением шаблона жизненного цикла.
▪ В тех случаях, когда рабочий процесс должен запускаться в импортированном объекте, ограничьте сопоставление с шаблонами расширенных жизненных циклов.
▪ Расширенный жизненный цикл должен быть связан с рабочим процессом, который не вызывает изменения объекта, поскольку любые изменения в целевой системе перезаписываются, если объект импортируется еще раз.
• По возможности избегайте внесения изменений в сопоставление после импорта первой полученной доставки из конкретной системы-источника. Изменение определений сопоставлений может привести к проблемам организации данных.
• Чтобы указать информацию о системе-источнике для атрибутов сопоставления, используйте текст из поля "Исходное значение" в разделе Связанная с контекстом информация окна Предварительный просмотр импорта полученной доставки.
• Пользователю, который определяет сопоставление, необходима надлежащая авторизация в соответствующих объектах системы, таких как расположение папки, шаблон жизненного цикла и т. д.
• Регулярно проверяйте определения сопоставлений, удаляя или изменяя неправильные или устаревшие определения.
• Сохраняйте внесенные изменения на каждой вкладке, чтобы данные гарантированно не потерялись.
• Используйте параллельно действия Предварительный просмотр импорта полученной доставки и Определить сопоставление, поскольку при этом можно копировать информацию из окна Предварительный просмотр импорта полученной доставки и вставлять ее в информацию системы-источника в соответствующем определении сопоставления.
Рекомендации по импорту объектов полученной доставки
• Производительность импорта полученной доставки можно регулировать с помощью нескольких свойств. Свойства определяют, как управляется импорт полученной доставки. Импорт может обрабатываться последовательно или с использованием транзакций или потоков. Для максимального повышения производительности можно задать следующие свойства:
◦ wt.ixb.import.noOfParallelImportPaths: задает число транзакций, используемых для параллельного импорта.
Использование нескольких транзакций может способствовать повышению производительности импорта полученной доставки, поскольку возможен частично успешный импорт в случае появления каких-либо проблем в ходе импорта. Объекты, импортированные как часть успешных транзакций, доступны авторизованным пользователям. Неуспешные транзакции можно попытаться выполнить еще раз после внесения корректировок. По умолчанию для этого свойства задано значение 1. Если для свойства wt.ixb.tag.apply.TransactionTag.enableCount задано значение больше 75 000, для данного свойства задается значение 4.
◦ wt.ixb.tag.apply.TransactionTag.enableCount: задает пороговое значение для разделения на несколько транзакций в зависимости от числа объектов в полученных файлах доставки.
Если на сайте используются множественные транзакции для импорта полученных файлов доставки, необходимо задать значение для этого свойства, определяющее максимальное число объектов, которое может включать каждая транзакция. Значение измеряется в числе объектов, содержащихся в файле доставки, за исключением ссылок между объектами. Например, если вы задаете значение 3000, а доставка содержит 5500 объектов, то импорт разделяется на две транзакции. По умолчанию для этого свойства задано значение 75 000.
◦ wt.ixb.import.maxThreads: задает число потоков, используемых в транзакции.
Использование нескольких потоков существенным образом влияет на производительность импорта полученной доставки. Потоки совместно используют одно соединение с базой данных, что может сказаться на производительности при достижении порогового значения. Число объектов также может влиять на производительность - чем больше объектов, тем больше повышается производительность при использовании нескольких потоков. Как правило, для доставки инкрементального пакета достаточно одного потока. Начальная доставка пакета может заметно выиграть от использования нескольких потоков, особенно если для импорта отведено немного времени. По умолчанию для этого свойства задано значение 1.
| Значение свойства wt.ixb.import.maxThreads используется в сочетании со свойством wt.ixb.import.noOfParallelImportPaths, которое определяет число транзакций, используемых для импорта. • Сценарий с одной транзакцией: если для свойства wt.ixb.import.noOfParallelImportPaths задано значение 1, значение свойства wt.ixb.import.maxThreads определяет общее число потоков, используемых для импорта. • Сценарий с несколькими транзакциями: если для свойства wt.ixb.import.noOfParallelImportPaths задано значение больше 1, значение свойства wt.ixb.import.maxThreads определяет число потоков, используемых для каждой транзакции импорта. |
◦ wt.ixb.import.batchSize: задает размер пакета для потока.
Размер пакета не оказывает значительного влияния на производительность импорта полученной доставки. Задание свойства позволяет определить число объектов в каждом пакете импорта. По умолчанию для этого свойства задано значение 10 000.
• Во время импорта используйте ту же опцию Импортировать в, которую выбрали в окне Предварительный просмотр импорта полученной доставки.
• Используйте для сохранения решений при импорте опцию Сохранить последние решения, введенные вами во время этого процесса импорта, что позволит вам повторно использовать варианты при импорте другой полученной доставки из той же системы-источника.
• Выберите при импорте опцию Использовать ранее сохраненные решения, чтобы повторно использовать ранее сохраненные решения.
• После успешного завершения импорта полученной доставки просмотрите сводный отчет импорта.
• Для обработки импорта полученной доставки используется очередь RDImportExecutorQueue. Дополнительные сведения см. в разделе
Стандартные фоновые очереди.
• После успешного импорта полученной доставки можно удалить выгруженные ZIP-файлы, связанные с доставкой, чтобы повысить эффективность архивирования. Чтобы ZIP-файлы удалялись автоматически после успешного завершения импорта, задайте для свойства com.ptc.windchill.rd.cleanupFilesOnSuccessfulImport значение "Истина".
Рекомендации по проверке файлов журнала полученной доставки
Файлы журнала доступны на информационной странице полученной доставки и содержат подробные сведения о том, что происходило во время действий предварительного просмотра и импорта. С помощью файлов журнала можно исследовать предупреждения и ошибки, возникшие в процессе импорта, определить, какие объекты и ссылки были импортированы, и узнать, какие объекты импортированы с конфликтами или пропущены из-за конфликтов. Дополнительные сведения см. в разделе
Просмотр журнала импорта полученной доставки.
