Загрузка спецификаций исполнений из электронной таблицы
Можно загрузить несколько спецификаций исполнений из электронной таблицы с помощью утилиты командной строки Windchill. Эта утилита работает на основе интерфейса API, который используется для программной загрузки спецификаций исполнений.
|
|
Чтобы можно было использовать эту возможность, необходимо выполнение следующих условий.
• Должен быть установлен модуль "Структуры платформ".
• Необходимо быть администратором сайта и участником группы "Структуры платформ".
|
Чтобы загрузить спецификации исполнений из электронной таблицы, выполните следующие действия.
1. Создайте электронную таблицу с помощью шаблона VariantSpecLoader1.xlsx, доступного в WT_HOME\loadFiles\ato\testdata\variantSpecLoader.
2. Выполните следующую утилиту командной строки Windchill:
Windchill com.ptc.windchill.option.variantspec.loader.VariantSpecLoader -d <My_Spreadsheet_Path>\<My_Spreadsheet>.xlsx -u <my_user> -p <my_password>
3. Просмотрите выходной файл, чтобы устранить все ошибки. Выходной файл находится в папке WT_HOME\logs.
Электронная таблица содержит 3 документа, в которых вводится информация, относящаяся к спецификациям исполнений и конфигурации структуры детали.
• Документ "Спецификация конфигурации детали" (Part Config Specs) - информация для этого документа аналогична информации, указываемой на вкладке Спецификация конфигурации окна Конфигурировать при конфигурировании детали. Этот документ содержит 5 полей: Наименование спецификации конфигурации, Представление, Состояние жизненного цикла, Опорная структура и Ограничения применимости по дате. Наименование - обязательный атрибут. Значения поля Представление должны быть допустимыми записями, соответствующими полю Представление в окне Конфигурировать. Значения, которые вводятся пользователем, проверяются системой.
• Документ "Спецификация конфигурации фильтра опций" (
Option Filter Config Specs) - этот документ определяет спецификации конфигурации для фильтра опций. Этот документ содержит 3 поля:
Спецификация базовой конфигурации для конфигурируемых структур,
Состояние жизненного цикла и
Ограничения применимости по дате. Информация, которая вводится, аналогична информации, указываемой в окне
Задать спецификации конфигурации для фильтра опций, доступном в окне
Фильтр опций, если щелкнуть значок
. Значения, которые вводятся пользователем, проверяются системой.
• Документ "Критерии навигации" (Navigation Criteria) - содержит информацию о правилах вариантов и выбранных вариантах, чтобы передавать этот выбор в фильтр опций. Документ содержит следующие поля.
◦ Раздел "Спецификации исполнения":
▪ Наименование - введите наименование, чтобы назначить спецификацию исполнения.
▪ Обозначение - используйте этот столбец, только если нужно изменить конфигурацию существующей спецификации исполнения. Если указано допустимое обозначение и спецификация исполнения с этим обозначением существует, используется сохраненное наименование.
| Необходимо указать одно из значений: либо Наименование, либо Обозначение, а не оба. |
▪ Описание - укажите описание спецификации исполнения (до 2000 символов).
▪ Расположение - укажите расположение для хранения спецификации исполнения. Если это поле пусто, утилита использует расположение по умолчанию. Если это поле пусто при создании спецификации исполнения, утилита выдает сообщение об ошибке.
▪ Создать исполнения - это логическое значение. Если задано значение true, система создает исполнения узла для спецификации исполнения. Поскольку создание исполнений узла выполняется асинхронно, утилита для каждого исполнения отмечает только статус "успешно/сбой" для создания записи очереди, а не фактического исполнения. Если для этого поля задано значение false, утилита создает только спецификацию исполнения.
◦ Раздел "Деталь" - в этом разделе указывается подробная информация о детали для конфигурирования с использованием спецификации исполнения. Для правильного выполнения утилиты необходимо, чтобы деталь имела назначенный набор опций. Строка не обрабатывается, если для нее нет назначенного набора опций.
▪ Обозначение - обозначение детали (например, Bicycle1).
▪ Ревизия - ревизия детали (например, "A").
▪ Итерация - итерация детали (например, "1"). В этом примере деталь - это Bicycle1 A.1.
| Если указана информация о детали, то информация о наборе опций является избыточной. Необходимо указать информацию для одного из полей: либо для поля Деталь, либо для поля Набор опций, а не для обоих. |
◦ Раздел "Набор опций" - спецификация исполнения создается с использованием набора опций. Такая спецификация исполнения создается с помощью утилиты, если для этой строки не определена деталь.
▪ Наименование - наименование набора опций.
▪ Ревизия - ревизия детали (например, "A").
▪ Итерация - итерация детали (например, "1").
◦ Раздел "Критерии навигации" - в этот раздел передается информация, указанная на вкладках Спецификация конфигурации и Фильтр опций интерфейса пользователя.
▪ Применить к объекту верхнего уровня - задание для этого атрибута значения true эквивалентно установке этого же флажка на вкладке Спецификация конфигурации в окне Конфигурировать. Если для атрибута Применить к объекту верхнего уровня задано значение true, система применяет спецификацию конфигурации к детали верхнего уровня в указанной структуре детали.
| Эта информация не нужна для спецификаций исполнений, которые создаются с помощью только наборов опций. Если указать эту информацию, программа проверки сообщит об ошибке. |
▪ Спецификация конфигурации детали - укажите список спецификаций конфигурации детали, которые уже были загружены с помощью документа 1. Можно указать несколько спецификаций конфигурации, разделив их запятой (,). Если деталь была определена в столбцах F-H, а этот столбец оставлен незаполненным, утилита загружает последнюю спецификацию конфигурации детали и использует ее для создания спецификации исполнения.
▪ Спецификации конфигурации Фильтр опций - укажите список спецификаций конфигурации фильтра опций, которые уже были загружены с помощью документа 2. Можно указать несколько спецификаций конфигурации, разделив их запятой (,). Если этот столбец оставлен незаполненным, утилита загружает последнюю спецификацию конфигурации фильтра опций и использует ее для создания спецификации исполнения.
▪ Выключить проверку правил - по умолчанию используется значение false. Задание значения true эквивалентно установке соответствующего флажка в окне Конфигурировать.
▪ Режим фильтра - значение аналогично значениям раскрывающегося списка на вкладке Фильтр опций (где можно выбрать режим Стандартный или Альтернативный).
◦ Столбец "Начальные опции" - пустой столбец соответствует началу определения вариантов, которые должны быть выбраны для фильтра опций.
◦ Дополнительные столбцы - укажите по одному столбцу для каждой опции, варианты которой нужно выбрать для фильтра опций.
Например: если нужно выбрать варианты ChoiceA, ChoiceB и ChoiceC в OptionA и ChoiceD в OptionB, необходимо создать два столбца, следующие за столбцом "Начальные опции" - OptionA и OptionB. В строке, в которой создается информация о спецификации исполнения, введите разделенный запятыми список, содержащий ChoiceA, ChoiceB и ChoiceC в OptionA и ChoiceD в OptionB. Если в следующей строке (т. е. для следующей спецификации исполнения) присутствуют варианты, выбранные для другой опции, создайте новый столбец с наименованием опции и соответствующих вариантов в ячейке этого столбца для строки, которую вы заполняете. Можно оставить для этой строки ячейки в столбцах OptionA и OptionB пустыми.
| Если в системе существует версия той же самой спецификации исполнения, необходимо сослаться на эту спецификацию исполнения по ее обозначению. |
◦ "Конечные опции" - последний столбец в документе. Он является конечной меткой выбора всех опций и вариантов для фильтра опций.
Выходной файл
При выполнении утилиты импорта электронной таблицы система создает выходной файл. Выходные файлы расположены в папке журнала WT_HOME\logs и имеют наименования VariantSpecLoaderReport_<random_generated_number>*.
В выходном файле содержится следующая информация.
• Номер строки в обрабатываемом документе критериев навигации.
• Статус операции: УСПЕШНО или СБОЙ.
• Обозначение спецификации исполнения (если спецификация исполнения успешно создана).
• СОЗДАНО - если создана новая спецификация исполнения, переменная СОЗДАНО имеет значение true. В других случаях переменная CREATED имеет значение false.
• ОБНОВЛЕНО - если спецификация исполнения уже существует, то переменная ОБНОВЛЕНО имеет значение true. Это означает, что конфигурация спецификации исполнения была изменена в соответствии с обозначением спецификации исполнения, указанном в электронной таблице.
• ОШИБКА - сообщает об ошибках, возникших во время проверки при обработке электронной таблицы, или ошибках, обнаруженных при создании объектов. При обнаружении ошибки утилита не обрабатывает эту строку, записывает сообщение об ошибке в отчет и переходит к следующей строке.
• ПРЕДУПРЕЖДЕНИЕ - если при обработке строки были сделаны предупреждения или предположения, они регистрируются в отчете как предупреждения.
Инструкции по использованию электронной таблицы для загрузки спецификаций исполнений
Необходимо учитывать следующие особенности.
• Используйте только формат электронной таблицы .xlsx (формат по умолчанию Microsoft Office Excel 2007) для загрузки спецификаций исполнений.
• Обратите внимание: в UNIX команда Windchill для загрузки спецификаций исполнений выполняется с учетом регистра. Используйте следующий синтаксис:
windchill com.ptc.windchill.option.variantspec.loader.VariantSpecLoader -d <My_spreadsheetpath>
• Если при изменении конфигурации спецификации исполнения с использованием электронной таблицы ввести Create Variants = True, будет создано новое исполнение (путем переопределения существующего исполнения) даже при отсутствии изменений в структуре спецификации исполнения и в выборе вариантов для нее.
• Невозможно изменить конфигурацию спецификации исполнения, созданной с использованием набора опций.
• Создание спецификации исполнения с помощью определяемого пользователем обозначения спецификации исполнения не поддерживается при использовании стандартного интерфейса API или электронной таблицы.
• Чтобы указать расположение папки для спецификации исполнения в электронной таблице, можно использовать все папки, созданные в кабинете /Default данного изделия, например /Default/ABC.
• Чтобы изменить конфигурацию существующей спецификации исполнения, необходимо указать деталь, с которой связана спецификация исполнения. В этих случаях не следует указывать набор опций.
• Изменение конфигурации спецификации исполнения в соответствии с ее версией не поддерживается. Для последней версии конфигурация всегда изменена.
• Выполняйте следующие инструкции для специальных символов.
◦ Вариантам, содержащим двойные кавычки в своих наименованиях, должна предшествовать обратная косая черта "\", например "\a"1\".
◦ Варианты, содержащие специальные символы в своих наименованиях, должны быть заключены в двойные кавычки, например "a_1".
Проверка электронной таблицы
Следующие проверки выполняются во время обработки электронной таблицы.
• Можно указать либо деталь, либо набор опций, но не оба объекта.
• Для детали должен существовать назначенный набор опций.
• Деталь должна существовать.
• Набор опций должен существовать.
• Папка должна существовать и должна быть указана при создании новой спецификации исполнения.
• Указанная спецификация конфигурации детали должна существовать.
• Указанная спецификация конфигурации фильтра опций должна существовать.
• Можно указать либо наименование спецификации исполнения, либо обозначение, но не оба параметра.
• Спецификация исполнения с указанным обозначением должна существовать.
• Чтобы изменить конфигурацию существующей спецификации исполнения, необходимо указать деталь, с которой связана спецификация исполнения. В этих случаях не следует указывать набор опций.
• Необходимо указать либо деталь, либо набор опций.
Выполнение утилиты в режиме отладки
Можно выполнить утилиту в режиме отладки, при котором создается файл log4j в папке wt_home\logs. Этот файл можно использовать для отладки ошибок. В файл журнала записываются ошибки для каждой строки обрабатываемой электронной таблицы.
Чтобы применить утилиту в режиме отладки, используйте следующий синтаксис:
Windchill --jap=wt.properties?com.ptc.windchill.option.variantload.java.args com.ptc.windchill.option.variantspec.loader.VariantSpecLoader -d <My_Spreadsheet_Path>\<My_Spreadsheet>.xlsx -u <my_user> -p <my_password>
