Probleme mit Dokumenten erkennen

Integration mit anderen Anwendungen > Einführung in Windchill ESI > Integration von Windchill ESI mit SAP > Fehlerkorrektur > Probleme mit Dokumenten erkennen

Dieser Abschnitt beschreibt häufige Probleme und mögliche Ursachen für Dokumente. In der nachfolgenden Aufzählung sind häufige Probleme aufgeführt. Mithilfe der Links gelangen Sie direkt zu den Informationen für das jeweils aufgetretene Problem. Wenden Sie sich an Ihren Systemadministrator, wenn das aufgetretene Problem in der Aufzählung nicht enthalten ist oder mit den empfohlenen Schritten nicht vollständig gelöst werden kann.

• Dokument kann nicht erstellt werden (wird in SAP nicht angezeigt)

• Dokumentlink kann nicht erstellt werden (wird in SAP nicht angezeigt)

• Ein Dokumentlink bleibt in SAP vorhanden, obwohl er in Windchill für die ESITarget-Betriebe gelöscht wurde

• Die Operation zum Erstellen eines Dokuments schien erfolgreich zu sein, aber es wurden Warnmeldungen (40433) ausgegeben

• Die Operation zum Ändern eines Dokuments schien erfolgreich zu sein, aber es wurden Warnmeldungen (40445) ausgegeben

• Ein Dokumentlink erscheint in allen Betrieben, der Link wurde jedoch nur in einem Betrieb erstellt.

• Ein Dokumentlink wird nicht in der Material-Benutzeroberfläche angezeigt

• Beim Anzeigen eines in SAP erstellten Dokuments bzw. einer Stückliste ist das Beschreibungs-Feld leer

• Ein zukünftiges Gültigkeitsdatum für ein Teil wird nicht in SAP R/3 angezeigt; allerdings wird das Dokument-Gültigkeitsdatum angezeigt

• Änderungsstammdatensatz-Status 02 lässt den Empfang von Änderungsmeldungen nicht zu

• Ein Dokument, das einem Teil zugeordnet ist, wird nicht zu allen zugeordneten Übergabezielen publiziert

• Teilen zugeordnete Referenzdokumente werden nicht mit der ESI-Antwort gesendet

• Ein Dokument wird nicht publiziert, nachdem sein Lebenszyklusstatus auf "Freigegeben" festgelegt wurde

• Benutzerdefinierte IBA für Dokument-Untertyp in der ESI-Antwort kann nicht publiziert werden.

Dokument kann nicht erstellt werden (wird in SAP nicht angezeigt)

Mögliche Fehlerursachen sind:

• Dokumentnummer liegt außerhalb des zulässigen Bereichs.

• Ungültige oder fehlende Attribute.

• Ungültiger URL.

• Falsche oder ungültige dem Teil zugewiesene ESITarget-Betriebe.

• Benutzer sucht in SAP in falschen ESITarget-Betrieben.

• Dokument ist keinem Teil in Windchill zugeordnet und wurde daher bei der Freigabe des Teils nicht publiziert.

• Das Dokument ist einem Teil in Windchill zugeordnet, das Übergabeziel-Attribut Zugehörige Dokumente publizieren hat jedoch den Wert Nein.

• Einführende Nullen wurden aus der Dokumentnummer gekürzt.

Dokumentlink kann nicht erstellt werden (wird in SAP nicht angezeigt)

Mögliche Fehlerursachen sind:

• Das Dokument ist keinem Teil in Windchill zugeordnet und wurde daher bei der Freigabe des Teils nicht publiziert.

• Das Dokument ist einem Teil in Windchill zugeordnet, das Übergabeziel-Attribut Zugehörige Dokumente publizieren hat jedoch den Wert Nein.

• Teil ist in SAP nicht vorhanden.

Ein Dokumentlink bleibt in SAP vorhanden, obwohl er in Windchill für die ESITarget-Betriebe gelöscht wurde

Mit einem Middleware-Konfigurationskennzeichen wird angefragt, dass Dokumentlinks in der Tabelle MARA für betriebsspezifische Dokumentlinks erstellt werden (ESIFlags/EnableDocumentLinksToMARA). Wird dieses Kennzeichen auf "wahr" eingestellt, werden für alle aus Windchill gesendeten betriebsspezifischen Dokumentlinks in SAP automatisch Dokumentlinks in der Tabelle MARA erstellt. Betriebsspezifische Links werden außerdem in der Tabelle MARC erstellt. Links in der Tabelle MARA werden nur dann gelöscht, wenn Windchill eine Anfrage zum Löschen des nicht-betriebsspezifischen Dokumentlinks sendet.

Die Operation zum Erstellen eines Dokuments schien erfolgreich zu sein, aber es wurden Warnmeldungen (40433) ausgegeben

40433: SAP hat einen funktionalen Fehler zurückgegeben, dass das Dokument beim Aufrufen von BAPI_DOCUMENT_CREATE2 bereits vorhanden ist. Die Ausführung der Funktion wird als erfolgreich angenommen, und die Verarbeitung des Dokuments wird fortgesetzt.

Die Operation zum Ändern eines Dokuments schien erfolgreich zu sein, aber es wurden Warnmeldungen (40445) ausgegeben

40445.*.* = konnte ein Dokument in SAP nicht ändern

Dokumente in SAP sind nicht-betriebsspezifisch. Daher führen an mehrere ESITarget-Betriebe im gleichen SAP-System und -Client gesendete Dokumente dazu, dass Windchill ESI redundante Meldungen an SAP sendet, die ohne Probleme ignoriert werden können. Nachdem das Dokument in einem ESITarget-Betrieb geändert wurde, setzt Windchill ESI den Status auf "Übergeben", wodurch nachfolgende Änderungen blockiert werden.

Ein Dokumentlink erscheint in allen Betrieben, der Link wurde jedoch nur in einem Betrieb erstellt.

Mit einem Middleware-Konfigurationskennzeichen wird angefragt, dass Dokumentlinks in der Tabelle MARA für betriebsspezifische Dokumentlinks erstellt werden (ESIFlags/EnableDocumentLinksToMARA). Wird dieses Kennzeichen auf true eingestellt, werden für alle aus Windchill gesendeten betriebsspezifischen Dokumentlinks in SAP automatisch Dokumentlinks in der Tabelle MARA erstellt. Betriebsspezifische Links werden außerdem in der Tabelle MARC erstellt. Wenn Links in der Tabelle MARA erstellt werden, wird der Dokumentlink in allen Betrieben angezeigt, in denen das Objekt in der Material-Benutzeroberfläche vorhanden ist. Er wird allerdings nur von dem angegebenen Betrieb für bestimmte Geschäftsabläufe verwendet.

Ein Dokumentlink wird nicht in der Material-Benutzeroberfläche angezeigt

Wenn Links nicht in der Tabelle MARA erstellt werden, wird der Dokumentlink nicht in der Material-Benutzeroberfläche angezeigt. Er wird allerdings von dem angegebenen Betrieb für bestimmte Geschäftsabläufe verwendet. Der Link wird nur über die Dokument-Benutzeroberfläche angezeigt.

Beim Anzeigen eines in SAP erstellten Dokuments bzw. einer Stückliste ist das Beschreibungs-Feld leer

In SAP verfügt jedes freie Textfeld über einen entsprechenden Sprachschlüssel.

Bei Anmeldung bei SAP wird das Feld Beschreibung (Description) auf der Registerkarte Dokumentdaten (Document Data) nur über die Dokumentbeschreibung für den dem Benutzer zugeordneten Sprachschlüssel aufgefüllt. Die Registerkarte Dokumentbeschreibungen (Document Descriptions) in der Dokument-Benutzeroberfläche enthält alle Beschreibungen. Wenn die Dokumentbeschreibung nicht auf der Registerkarte Dokumentdaten (Document Data) angezeigt wird, wird sie auf der Registerkarte Dokumentbeschreibungen (Document Descriptions) aufgeführt. Der Sprachschlüssel der Dokumentbeschreibung wird beim Erstellen des Dokuments festgelegt. Dieser Wert wird an die API gesendet. Er wird als Standardwert in der Datei ESIDefaults.properties gespeichert. Dieser Wert kann konfiguriert werden.

Bei Anmeldung bei SAP wird nur die Stücklistenbeschreibung für den dem Benutzer zugeordneten Sprachschlüssel neben der Stücklistennummer angezeigt. Der Sprachschlüssel der Stücklistenbeschreibung (Materialbeschreibung) wird bei der Materialerstellung festgelegt. Dieser Wert wird an die API gesendet. Er wird als Standardwert in der Datei ESIDefaults.properties gespeichert. Dieser Wert kann konfiguriert werden.

Wenden Sie sich bei Fragen zur ESI Konfiguration in Ihrem Unternehmen an den ESI Administrator.

Ein zukünftiges Gültigkeitsdatum für ein Teil wird nicht in SAP R/3 angezeigt; allerdings wird das Dokument-Gültigkeitsdatum angezeigt

Dieses Verhalten ist erwartet. ESI setzt das Gültigkeitsdatum von Teilen auf das heutige Datum und von Dokumenten auf das zukünftige Datum.

Änderungsstammdatensatz-Status 02 lässt den Empfang von Änderungsmeldungen nicht zu

Beim Versuch, einen hinzugefügten oder gelöschten Dokument-Link (Beziehung zwischen einem Teil und einem Dokument) von Windchill an SAP freizugeben, wird die Meldung "Change Master status 02 does not allow changes" im Windchill ESI Transaktionsprotokoll angezeigt, und die Dokument-Links werden in SAP nicht geändert.

Windchill ESI kann so konfiguriert werden, dass Aktualisierungen an Dokumentlinks ohne Änderungen der Dokumentversion zulässig oder nicht zulässig sind. Diese Konfiguration wird in TIBCO durch die globale Variable ESIFlags/EnableDocumentECNLock gesteuert.

Wenn EESIFlags/EnableDocumentCNLock auf "true" eingestellt ist, werden Änderungsstammsatzinformationen beim Erstellen bzw. beim Ändern von Dokumenten in das Dokumentobjekt in SAP geschrieben. Nach der Übergabe der Dokumentversion an SAP können Änderungen an diesem Dokument nur nach dem Ändern der Version vorgenommen werden. In diesem Fall gibt SAP die Meldung "Change Master status 02 does not allow changes (Änderungsnummerstatus 02 gestattet keine Änderungen)" zurück.

Wenn ESIFlags/EnableDocumentCNLock auf "false" eingestellt ist, werden beim Erstellen bzw. beim Ändern von Dokumenten keine Änderungsstammsatzinformationen in das Dokumentobjekt in SAP geschrieben. In diesem Fall sind Änderungen auf Dokumentlinks und Übergabeziele beschränkt und können ohne Änderung der Version an der gleichen Dokumentversion vorgenommen werden.

Änderungen an anderen Dokumentdaten als Dokumentlinks und Übergabeziele erfordern unabhängig von der Einstellung dieser globalen Variablen immer eine Versionsänderung. In einer auf Teilen aufgebauten Umgebung gilt diese globale Variable nicht, und Dokumentlinks sowie Übergabeziele können ohne Änderung der Dokumentversion geändert werden.

Dieses Verhalten wird beobachtet, wenn die globale Variable auf true eingestellt ist und ein Benutzer versucht, die Version eines bereits übergebenen Dokuments zu ändern.

Dieses Problem kann auch auftreten, wenn Windchill ESI so konfiguriert wurde, dass das Änderungsmanagement unter Verwendung von Versionen in SAP nicht aktiviert ist.

Wenden Sie sich bei Fragen zur Windchill ESI Konfiguration in Ihrem Unternehmen an den Windchill ESI Administrator.

Ein Dokument, das einem Teil zugeordnet ist, wird nicht zu allen zugeordneten Übergabezielen publiziert

Dies kann passieren, wenn das Dokument im Vergleich zum zugehörigen Teil zusätzlichen Übergabezielen zugeordnet ist. In diesem Fall, wird das Dokument nur zu den Übergabezielen publiziert, die dem Dokument zugeordnet sind.

Damit das Dokument zu den zusätzlichen Zielen publiziert wird, ordnen Sie entweder diese Ziele dem Teil zu, oder publizieren Sie das Dokument als eigenständiges Objekt oder als Ergebnisobjekt in einer Änderungsnachricht.

Teilen zugeordnete Referenzdokumente werden nicht mit der ESI-Antwort gesendet

Dies kann in einem der folgenden Fälle auftreten:

• Die Windchill ESI-Einstellung Referenzdokumente publizieren hat den Wert Nein.

• Der dem Teil zugeordnete Referenzdokument-Master kann mit dem von der Einstellung Lebenszyklusstatus der Konfigurationsspezifikation für Referenzdokument angegebenen Wert nicht in eine Iteration aufgelöst werden. Stellen Sie sicher, dass diese Einstellung richtig festgelegt ist.

Ein Dokument wird nicht publiziert, nachdem sein Lebenszyklusstatus auf "Freigegeben" festgelegt wurde

Dies kann in einem der folgenden Fälle auftreten:

• Die Einstellung ESI-Workflow automatisch starten hat den Wert Nein.

• Die Einstellung Lebenszyklusstatus, um die Publizierung eines Dokuments auszulösen (oder Lebenszyklusstatus, um die Publizierung eines CAD-Dokuments auszulösen) weist nicht Freigegeben als eines der Token in seinem Wert auf.

Stellen Sie sicher, dass diese Einstellungen richtig festgelegt sind.

Benutzerdefinierte IBAs für Dokumenten-Untertyp in der ESI-Antwort können nicht publiziert werden

Benutzerdefinierte IBAs für einen Dokument-Untertyp werden nicht in der ESI-Antwort publiziert. Dies kann in folgenden Fällen auftreten:

• Wenn in der ESI-Antwort-Metadatendatei (ESIResponseMetaInfo.xml) das Attribut und der Untertyp des Dokuments nicht im Element MapInformation definiert sind.

Lösung: Fügen Sie das wiederverwendbare Attribut und den Untertyp des Dokuments zur ESI-Antwort-Metadatendatei hinzu, um eine benutzerdefinierte IBA für einen Dokument-Untertyp zu publizieren. Siehe folgendes Beispiel zum besseren Verständnis der vorgeschlagenen Lösung.

1. Gehen Sie in der Typ- und Attributverwaltung zu Wiederverwendbare Attribute verwalten, und erstellen Sie wie folgt ein Zeichenfolgenattribut:

◦ Anzeigename: string1

◦ Interner Name: string1

2. Erstellen Sie einen Untertyp des Dokuments wie folgt:

◦ Anzeigename: Subtype_Document

◦ Interner Name: com.ptc.ptcnet.sub_Doc

3. Erstellen Sie eine IBA (mit dem in Schritt 1 erstellten wiederverwendbaren Attribut) für den Untertyp des Dokuments (in Schritt 2 erstellt) mit den folgenden Daten:

◦ Interner Name: string1

◦ Anzeigename: string1

4. Aktualisieren Sie in der ESI-Antwort-Metadatendatei (ESIResponseMetaInfo.xml) die Abschnitte wie nachfolgend beschrieben.

a. Fügen Sie im Abschnitt  das wiederverwendbare Attribut string1 zum Untertyp des Dokuments hinzu, wie gelb hervorgehoben.

b. Aktualisieren Sie <esi:typedef> im Abschnitt  durch Hinzufügen des Dokument-Untertyps (erstellt in Schritt 2) zum Dokumentbasistyp. Nutzen Sie dabei "|" als Trennzeichen, wie unten dargestellt bzw. wie folgendes Beispiel: wt.doc.WTDocument|com.ptc.ptcnet.sub_Doc

Wenn das ID-Attribut des Zuordnungselements geändert wird, sollte das mapRef-Element mit dem gleichen Wert geändert werden.

5. Nutzen Sie "Speichern als" und speichern Sie die ESI-Antwort-XML-Datei mit einem anderen Namen am Speicherort "WT_HOME\codebase\com\ptc\windchill\esi". Starten Sie den Methodenserver neu.

6. Erstellen Sie ein Dokument des Untertyps (erstellt in Schritt 2), und geben Sie einen Wert für das Attribut string1 an. Ordnen Sie dieses mit "Speichern als" gespeicherte Dokument dem jeweiligen Übergabeziel zu.

7. Publizieren Sie dieses Dokument mit der Aktion An Übergabeziel senden. Prüfen Sie, ob der Wert des Attributs string1 in der ESI-Antwortdatei publiziert wird.

Weitere Informationen zum Modifizieren der ESI-Antwort-Metadatendatei finden Sie im englischen Handbuch ERP Connector Customizer's Guide (ERP Connector Anpassungshandbuch) in den Abschnitten "Modify the ESI Response Meta Information File" und "Points to note while modifying the ESI response information file". Sie können auf der Seite Referenzdokumente nach diesem Handbuch suchen.