CAM: Artikeldaten importieren
Grundlegende Informationen zum Paket Produktionsplanung und -steuerung finden Sie unter Erste Schritte PPS.Übersicht
Dieses Dokument beschreibt, welche Möglichkeiten bei der Übertragung von Artikel-Stammdaten in die BMD Software bestehen.
Einstellungen
BMDPpsService konfigurieren
Für die Konfiguration des BMDPpsServices wenden Sie sich bitte an den BMD PPS Support.
Datenumfang konfigurieren
Jene Felder, die in der Schnittstelle übergeben werden können, werden im Fenster CAM-Interface definiert. Dabei werden im Menü "Einstellungen" je Bereich die unterschiedlichen Feldauswahlen konfiguriert.
Menüaufruf: 
Produktionsplanung und -steuerung → Stammdaten → Interfaces → CAM-Interface
Produktionsplanung und -steuerung → Stammdaten → Interfaces → CAM-InterfaceElement ARTICLE
Beispiel
 | Die Einstellungen, welche Felder übergeben werden, ist im Element "ARTICLE" zu finden:  |
Artikelbeschreibungstext
Der Artikelbeschreibungstext kann als Fließtext und mit Zeilenabständen importiert werden.
Beispiel für den Import des Artikelbeschreibungstextes
|   |
Artikelübersetzungen
Artikelübersetzungen können direkt in die Übersetzungstabelle importiert werden.
Beispiel für den Import der Artikelübersetzung
| In diesem Fall wird mit dem Sprachencode "LANGUAGE=4" der Text in englischer Sprache importiert:   |
Element ARTICLE_DOCUMENT
Beispiel
| Die Einstellungen, welche Felder übergeben werden, sind im Element "ARTICLE_DOCUMENT" zu finden. Für die Felder "Zeichnungsnummer" (= DRAWING_NUMBER) und "Betreff" (= TITLE) gibt es jeweils zwei Felder zur Auswahl. Jeweils eines der Felder kann zur Eindeutigkeit, als sogenannter Key Value, beim Import definiert werden und ist im BMDConst-Name im Namen mit "KV" ersichtlich. So kann mittels Angabe eines Key Values auch eine Versionierung von Dokumenten über CAM in der PPS angestoßen werden. Damit hier auch später in den Dokumentenversionen auf den ersten Blick unterschieden werden kann, gibt es die Möglichkeit, auf die Freifelder der Dokumentenversion die gesendete Version mitzusenden.  Freifelder auf Dokumentenversion:  |
Artikelfoto- und Artikeldokumentenimport
Wenn Sie Artikelfotos oder Artikeldokumente mitimportieren wollen, gibt es zwei Möglichkeiten, dies umzusetzen:
- Ablage des Artikelfotos/Artikeldokuments in bestimmten Pfad, Angabe des Pfades im XML-File
- Artikelfoto/Artikeldokument wird über das BASE64-Format im XML-File mitgegeben
Eine Möglichkeit des Artikelfoto- oder Artikeldokumentenexports gibt es über die CAM-Schnittstelle in der PPS nicht. Über den Preiskatalog-Export gibt es aber diese Funktionalität. Bei Fragen zum Export bitte an den WWS Support wenden!
Voraussetzungen für den Artikeldokumenten-Import
Für die Übergabe von Artikeldokumenten müssen folgende Einstellungen getroffen werden:
- Das BMD DMS (inkl. Angabe eines gültigen Pfades) muss eingerichtet sein.
- Der XML-Schnittstellenverzeichnis-Parameter muss mit einem gültigen Pfad befüllt sein.
Achtung: Auch wenn es keinen dateibasierten Austausch gibt, wird dieses Verzeichnis als Zwischenverzeichnis für den Import verwendet! - Am Archiv muss eine Standardperson hinterlegt sein. Dies ist jene Person, zu der das Artikeldokument zugeordnet wird.
Der Aufruf der Archive erfolgt über CRM und DMS → DMS → Archive.
Beispiel
| Die zum Artikel abgelegten Dokumente werden der Person "Eigenproduktion BMD" zugeordnet.  |
Voraussetzungen für den Artikelfotoimport
Für die Übergabe von Artikelfotos müssen folgende Einstellungen getroffen werden:
- Der Pfad für Artikelfotos muss eingerichtet und gültig sein (TOOLS → Administration → Pfade).
- Der XML-Schnittstellenverzeichnis-Parameter muss mit einem gültigen Pfad befüllt sein.
Achtung: Auch wenn es keinen dateibasierten Austausch gibt, wird dieses Verzeichnis als Zwischenverzeichnis für den Import verwendet!
Artikelfotoimport mit Pfad
Artikelfotos können in einem im XML-File angegebenen Pfad hinterlegt werden, von dem sie dann abgeholt und importiert werden sollen.
Dieser Pfad wird im Element <ARTICLE_PICTURE> im Artikelimport mitgegeben. Das Foto wird dann von dort abgeholt, dem gewünschten Artikel zugeordnet und erneut unter dem angegebenen Artikelfoto-Pfad gespeichert.
Beispiel
| Auszug aus einem XML-File für den Import von Artikel und Artikelfoto: <?xml version="1.0" encoding="ISO-8859-1"?> <MAIN> <ARTICLE ACTION="CREATE" COPY_ARTICLE="100" COPY_PIECELIST="TRUE" COPY_SUPPLIER_REGISTRY="TRUE" GENERATE_ARTICLENO="TRUE"> <FREE_FIELD_A5>Freifeld</FREE_FIELD_A5> <ARTICLE_DESC>Benennung Deutsch</ARTICLE_DESC> <UNIT>Stk</UNIT> <ARTICLE_PICTURE>\\PPS-SRV\Transfer\Artikelfotos\foto1.jpg</ARTICLE_PICTURE> </ARTICLE> </MAIN> Im angegebenen Pfad warten die Fotos zum Import:  |
Artikelfotoimport im BASE64-Format
Die Artikelfotos können auch im BASE64-Format codiert importiert werden. Dazu sind folgende zwei Elemente notwendig:
- <ARTICLE_PICTURE> Angabe des Speichernamens des Fotos
- <BASE64PICTURE> im BASE64-Format gespeichertes Foto
Beispiel
| Auszug aus einem XML-File für den Import von Artikel und Artikelfoto mittels BASE64-Format: <?xml version="1.0" encoding="ISO-8859-1"?> <MAIN> <ARTICLE ACTION="CREATE" COPY_ARTICLE="100" COPY_PIECELIST="TRUE" COPY_SUPPLIER_REGISTRY="TRUE" GENERATE_ARTICLENO="TRUE"> <FREE_FIELD_A5>Freifeld</FREE_FIELD_A5> <ARTICLE_DESC>Benennung Deutsch</ARTICLE_DESC> <UNIT>Stk</UNIT> <ARTICLE_PICTURE>artikelfoto.png</ARTICLE_PICTURE> <BASE64PICTURE>iVBORw0KGgoAAAANSUhEUgAAAYMAA...</BASE64PICTURE> </ARTICLE> </MAIN> |
Einstellungen für Artikelkopie
Mit dem folgenden Parameter kann eingestellt werden, welche Felder im Zuge der Artikelkopie vom Quellartikel auf den neu anzulegenden Artikel kopiert werden sollen.
Produktionsplanung und -steuerung → Stammdaten → Einstellungen → Parameter → PPS → CAM-Interface
Hier kann der Feldauswahl-Speichername hinterlegt werden, welcher für die Artikelkopierfunktion verwendet wird. |
Hinweis
 | Das Feld "Grundeinheit" muss definitiv in dieser Feldauswahl vorhanden sein. Ansonsten bricht die Artikelneuanlage via CAM ab, wenn die Quelldaten kopiert werden sollen. |
Ablauf
Ob der BMD Dienst läuft und mit der Datenbank verbunden ist, kann über die Logdatei des BMDPpsServices herausgefunden werden. Sie heißt "BMDPPSSVC.LOG".
Die Logdatei des BMDPpsServices finden Sie hier: TOOLS → Administration → Protokolle → Logdateien
Für den Dokumentenexport gibt es ebenfalls eine Logdatei namens "BMDCREATEDOCSEXTERN.LOG", die die Befehle für den Import von Dokumenten mitprotokolliert.
Beispiel
| Folgender Eintrag zeigt, dass die Datenbankverbindung erfolgreich war:  Die Logdatei für den Dokumentenimport kann z. B. wie folgt aussehen:  |
Befehl zur Vergabe einer neuen Artikelnummer
Mit den Befehlen ARTICLE ACTION="CREATE" sowie GENERATE_ARTICLENO="TRUE" in der Artikelneuanlage wird eine neue Artikelnummer aus dem BMD Artikelnummernkreis vergeben. Dabei wird die aktuell höchste numerische Artikelnummer in der aktuellen Firma ermittelt und um eins hochgezählt.
Es ist in dieser Konstellation nicht zulässig, eine Artikelnummer im XML-Stream mitzuschicken.
Zusätzlich mitgegebene Felder werden beim neu anzulegenden Artikel ggf. überschrieben bzw. zusätzlich importiert.
Achtung!
 | Damit die Artikelnummernvergabe funktioniert, ist der WWS Parameter Artikelnummernvorschlag auf die Ausprägungen "0 - Nächste num. Artikelnummer", "1 - Vorschlag EAN-Nummer" oder "2 - Nächste num. Artikelnummer in WG" zu stellen. Sofern die nächste numerische Artikelnummer innerhalb einer Warengruppe vergeben werden soll, ist über das CAM-Interface auch die Information zur Warenhauptgruppe und Warenuntergruppe anzugeben. |
Hinweis
| Für diesen Anwendungsfall (Vergabe einer BMD Artikelnummer durch BMD) ist es sinnvoll, einen eindeutigen Schlüssel (externe Artikelnummer) in einem separaten Feld an BMD zu übergeben. Somit kann das Fremdsystem gegebenenfalls diese Informationen verknüpfen. |
Beispiel
| XML-Stream, der importiert werden soll: <?xml version="1.0" encoding="UTF-8"?> <MAIN> <ARTICLE ACTION="CREATE" GENERATE_ARTICLENO="TRUE"> <ARTICLE_DESC>Test Neuanlage Artikel</ARTICLE_DESC> <UNIT>Stk</UNIT> <WEIGHT>3.5</WEIGHT> <LENGTH>550</LENGTH> <WIDTH>110</WIDTH> <HEIGHT>75</HEIGHT> </ARTICLE> </MAIN> Einlesen über das CAM-Interface:  Ergebnis im BMD Artikelstamm:  |
Befehl zum Kopieren von Artikelinformationen
Nur im Zuge der Neuanlage von Artikeln ist es auch möglich, Felder des Artikelstamms sowie Zusatzdaten von einem bereits in BMD bestehenden Artikel auf den neu anzulegenden Artikel zu kopieren. Derzeit können die Zusatzdaten "Lieferantenartikel" sowie "Stückliste" von einem Quellartikel kopiert werden.
Bei der Kopie verhält sich das Programm analog zur Artikelkopier-Funktion, die auch im Artikelstamm aufgerufen werden kann.
Beispiel
| XML-Stream, der importiert werden soll: <?xml version="1.0" encoding="UTF-8"?> <MAIN> <ARTICLE ACTION="CREATE" GENERATE_ARTICLENO="TRUE" COPY_SUPPLIER_REGISTRY="TRUE" COPY_PIECELIST="TRUE" COPY_ARTICLE="net001"> <ARTICLE_DESC>Test Neuanlage Artikel mit Kopie</ARTICLE_DESC> <UNIT>Stk</UNIT> <WEIGHT>3.5</WEIGHT> <LENGTH>550</LENGTH> <WIDTH>110</WIDTH> <HEIGHT>75</HEIGHT> </ARTICLE> </MAIN>  Ergebnis der Kopie vom Quellartikel im BMD Artikelstamm:
 |
