Определение проблем с документами

Интеграция с другими приложениями > Введение в Windchill ESI > Интеграция Windchill ESI с SAP > Устранение неисправностей > Определение проблем с документами

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

• Не удается создать документ (документ не отображается в SAP)

• Не удается создать ссылку на документ (ссылка не отображается в SAP)

• Ссылка на документ остается в SAP даже после ее удаления в Windchill из одного или нескольких производств ESITarget

• Судя по всему, операция создания документа выполнена успешно, но появились предупреждающие сообщения (40433)

• Судя по всему, операция изменения документа выполнена успешно, но появились предупреждающие сообщения (40445)

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

• Ссылка на документ не появляется в графическом интерфейсе пользователя для материалов

• При попытке посмотреть документ или ведомость материалов, созданные в SAP, отображается пустое поле описания

• Будущая дата ограничения применимости для детали не отображается в SAP, а дата ограничения применимости документа отображается

• Получено сообщение "Статус "Изменение мастера" 02 не разрешает изменения"

• Документ, связанный с деталью, не опубликован во всех связанных получателях данных

• Справочные документы, связанные с деталями, не отправлены вместе с откликом ESI

• Документ не публикуется при установке его состояния жизненного цикла "Выпущен"

• Не удалось опубликовать пользовательский IBA-атрибут для подтипа документа в отклике ESI

Не удается создать документ (документ не отображается в SAP)

Возможные причины:

• Обозначение документа находится вне диапазона

• Ошибочные или отсутствующие атрибуты

• Ошибочный URL

• Детали назначено неверное или ошибочное производство (или несколько производств) ESITarget

• Пользователь ищет в ошибочном производстве (или производствах) ESITarget в SAP

• Документ не связан с деталью в Windchill, поэтому не опубликован при выпуске детали

• Документ связан с деталью в Windchill, но атрибут получателя данных Опубликовать связанные документы имеет значение Нет

• Ведущие нули были усечены в обозначении документа

Не удается создать ссылку на документ (ссылка не отображается в SAP)

Возможные причины:

• Документ не связан с деталью в Windchill, поэтому не опубликован при выпуске детали

• Деталь не существует в SAP

Ссылка на документ остается в SAP даже после ее удаления в Windchill из одного или нескольких производств ESITarget

Флаг конфигурации промежуточного программного обеспечения указывает, что ссылки документов должны создаваться в таблице MARA для ссылок документов, зависящих от конкретного производства (ESIFlags/EnableDocumentLinksToMARA). Если этот флаг имеет значение "истина", ссылки на документы создаются в таблице MARA системы SAP автоматически для всех ссылок на документы производства, переданных из Windchill. Ссылки, зависящие от конкретного производства, также создаются в таблице MARC. Ссылки удаляются из таблицы MARA только в том случае, если Windchill отправляет запрос на удаление ссылки на документ, не относящийся к производству.

Судя по всему, операция создания документа выполнена успешно, но появились предупреждающие сообщения (40433)

40433: "При вызове BAPI_DOCUMENT_CREATE2 SAP возвратил функциональную ошибку, что документ уже существует. Предполагается функциональный успех, и обработка документа продолжается."

Судя по всему, операция изменения документа выполнена успешно, но появились предупреждающие сообщения (40445)

40445.*.*= не удалось изменить документ в SAP

В системах SAP документы не зависят от конкретного производства, поэтому при отправке документов в несколько производств ESITarget в одной и той же системе SAP и одном клиенте Windchill ESI отправляет в SAP лишние сообщения, которые можно игнорировать. После изменения документа в производстве ESITarget Windchill ESI устанавливает для него статус "Выпущен", который блокирует последующие изменения.

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

Флаг конфигурации промежуточного программного обеспечения указывает, что ссылки документов должны создаваться в таблице MARA для ссылок документов, зависящих от конкретного производства (ESIFlags/EnableDocumentLinksToMARA). Если этот флаг имеет значение "истина", ссылки на документы будут созданы в таблице MARA системы SAP автоматически для всех ссылок на документы производства, переданных из Windchill. Ссылки, зависящие от конкретного производства, также создаются в таблице MARC. Если ссылки созданы в таблице MARA, ссылка на документ видима во всех производствах, в которых существует объект, в GUI материалов, но используется только в производстве, заданном для определенных бизнес-целей.

Ссылка на документ не появляется в графическом интерфейсе пользователя для материалов

Если ссылки не созданы в таблице MARA, ссылка на документ невидима в GUI материалов, но может использоваться производством, указанным для определенных бизнес-целей. Ссылка видима только в GUI документов.

При попытке посмотреть документ или ведомость материалов, созданные в SAP, отображается пустое поле описания

В SAP для каждого пустого текстового поля предусмотрен соответствующий ключ языка.

Когда пользователь входит в SAP, в поле "Описание" на вкладке "Данные документа" подставляется описание документа на языке, назначенном пользователю. На вкладке "Данные документа" интерфейса пользователя для документов находятся все описания. Если описание документа не отображается на вкладке "Данные документа", оно указано на вкладке "Описания документов". Ключ языка описания документа задается при создании документа. Это значение отправлено в интерфейсе API. Это значение задается как значение по умолчанию в файле ESIDefaults.properties. Это настраиваемое значение.

Когда пользователь входит в SAP, рядом с обозначением ведомости материалов отображается только описание ведомости материалов на языке, назначенном пользователю. Ключ языка описания ведомости материалов (материала) задается при создании материала. Это значение отправлено в интерфейсе API. Это значение задается как значение по умолчанию в файле ESIDefaults.properties. Это настраиваемое значение.

С вопросами относительно конфигурации ESI в вашей компании обращайтесь к администратору ESI.

Будущая дата ограничения применимости для детали не отображается в SAP, а дата ограничения применимости документа отображается

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

Получено сообщение "Статус "Изменение мастера" 02 не разрешает изменения"

При попытке выпустить добавленную или удаленную ссылку на документ (взаимосвязь между деталью и документом) из Windchill в SAP в журнале транзакций Windchill ESI появляется сообщение "Статус "Изменение мастера" 02 не разрешает изменения" и ссылки на документ не изменяются в SAP.

В Windchill ESI можно настроить разрешение или запрет на обновление ссылок на документы без изменения версии документа. Этой конфигурацией управляет глобальная переменная в TIBCO, которая называется ESIFlags/EnableDocumentECNLock.

Если ESIFlags/EnableDocumentCNLock имеет значение "истина", информация об изменении мастера записывается в объект документа в SAP при создании или изменении документов. После выпуска версии документа в SAP изменение документа невозможно, пока не создана его новая ревизия. В этом случае SAP выведет сообщение "Статус "Изменение мастера" 02 не разрешает изменения".

Если ESIFlags/EnableDocumentCNLock имеет значение "ложь", информация об изменении мастера не записывается в объект документа в SAP при создании или изменении документов. В этом случае изменения ссылок на документы и получателей данных запрещены, но их можно внести в ту же самую версию документа без создания для него новой ревизии.

Изменения данных документа, отличных от ссылок на документ, всегда влекут изменение версии вне зависимости от значения глобальной переменной. В ориентированной на деталь среде глобальная переменная не применяется и ссылки на документы и получатели данных могут быть изменены без создания новой ревизии документа.

Такое поведение наблюдается, если глобальная переменная имеет значение "истина" и пользователь пытается изменить версию уже выпущенного документа.

Также эта проблема может возникнуть, если среда Windchill ESI настроена таким образом, что управление изменениями с использованием ревизий не включено в SAP.

С вопросами относительно конфигурации Windchill ESI в вашей компании обращайтесь к администратору Windchill ESI.

Документ, связанный с деталью, не опубликован во всех связанных получателях данных

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

Для публикации документа в дополнительных получателях эти получатели необходимо связать с деталью либо публиковать документ как автономный объект или как результирующий объект в извещении об изменении.

Справочные документы, связанные с деталями, не отправлены вместе с откликом ESI

Это может произойти в любом из следующих случаев.

• Настройка ESI Опубликовать справочные документы в Windchill имеет значение Нет.

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

Документ не публикуется при установке его состояния жизненного цикла "Выпущен"

Это может произойти в любом из следующих случаев.

• Настройка Автоматически запускать рабочий процесс ESI имеет значение Нет.

• У настройки Состояния жизненного цикла, вызывающие публикацию документа CAD (или Состояния жизненного цикла, вызывающие публикацию CAD-документа) отсутствует маркер ВЫПУЩЕН в качестве одного из значений.

Убедитесь, что эти настройки заданы надлежащим образом.

Не удается опубликовать пользовательские IBA-атрибуты для подтипа документа в отклике ESI

Пользовательские IBA-атрибуты для подтипов документов не публикуются в отклике ESI. Это может произойти в следующих случаях:

• Если в файле метаданных отклика ESI (ESIResponseMetaInfo.xml) атрибут и подтип документа не определены в элементе MapInformation.

Решение. Убедитесь, что повторно используемый атрибут и подтип документа добавлены в информационный файл метаданных отклика ESI для публикации пользовательского IBA для подтипа документа. См. следующий пример, чтобы понять предложенное решение.

1. В окне Управление типами и атрибутами перейдите в раздел Управление повторно используемыми атрибутами и создайте строковый атрибут следующим образом:

◦ Отображаемое наименование: string1

◦ Внутреннее наименование: string1

2. Создайте подтип документа следующим образом:

◦ Отображаемое наименование: Subtype_Document

◦ Внутреннее наименование: com.ptc.ptcnet.sub_Doc

3. Создайте IBA-атрибут (используя повторно используемый атрибут, созданный на шаге 1) в подтипе документа (созданный на шаге 2) со следующими данными:

◦ Внутреннее наименование: string1

◦ Отображаемое наименование: string1

4. В информационном файле метаданных отклика ESI (ESIResponseMetaInfo.xml) обновите разделы, как описано ниже.

a. В разделе  добавьте повторно используемый атрибут в подтип string1 документа, подсвеченный желтым цветом.

b. В разделе  обновите <esi:typedef>, добавив подтип документа (созданный на шаге 2) с базовым типом документа, отделенный символом "|", как показано ниже, или такой как wt.doc.WTDocument|com.ptc.ptcnet.sub_Doc

Если атрибут ID элемента сопоставления изменен, элемент mapRef должен быть изменен с тем же самым значением.

5. Сохраните как XML-файл отклика ESI с другим именем в расположении WT_HOME\codebase\com\ptc\windchill\esi. Перезапустите сервер методов.

6. Создайте документ подтипа (созданного на шаге 2) и задайте значение для атрибута string1. Свяжите этот сохраненный документ с соответствующим получателем данных.

7. Опубликуйте этот документ, используя действие Отправить получателю данных. Убедитесь, что значение атрибута string1 опубликовано в файле отклика ESI.

Дополнительные сведения об изменении файла метаданных отклика ESI см. в разделах "Modify the ESI Response Information File" и "Points to note while modifying the ESI response information file" руководства Windchill ERP Connector Customizer’s Guide (Руководство по настройке соединителя Windchill ERP). Это руководство можно найти на странице Reference Documents (Справочная документация).