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

2.2.1. Element ARTICLE

Beispiel

Die Einstellungen, welche Felder übergeben werden, sind im Element "ARTICLE" zu finden:

Hinweis

Nicht alle Felder der jeweiligen Tabellen sind für den Export und Import über das CAM-Interface verfügbar!

Unter der jeweiligen Feldauswahl (aufrufbar unter "Einstellungen" im Fenster "CAM-Interface") gibt es für jede Tabelle ein eigenes Element, wo überprüft werden kann, ob das Feld auch für den Export/Import verfügbar ist.

2.2.1.1. Artikelbeschreibungstext

Der Artikelbeschreibungstext kann als Fließtext und mit Zeilenabständen importiert werden.

Beispiel für den Import des Artikelbeschreibungstextes

<?xml version="1.0" encoding="ISO-8859-1"?><MAIN>
<ARTICLE>
<ARTICLE_NO>2</ARTICLE_NO>
<ARTICLE_DESC>Grundplatte</ARTICLE_DESC>
<ARTICLE_DECRIPTION_TEXT>Freitext Artikelbeschreibung
Beschreibung Zeile 2
Beschreibung Zeile 3
<UNIT>Stk</UNIT>
</ARTICLE>
</MAIN>

2.2.1.2. 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:

<?xml version="1.0" encoding="ISO-8859-1"?><MAIN>
<ARTICLE>
    <ARTICLE_NO>2</ARTICLE_NO>
    <ARTICLE_DESC LANGUAGE="4">Base plate</ARTICLE_DESC>
    <UNIT>Stk</UNIT>
</ARTICLE>
</MAIN>

Nach Auswahl der Sprache Englisch sehen Sie den importierten Text:

2.2.2. 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.

Im vorliegenden Fall ist der Pfad (= PATH) gleich dem Pfad des PPS Parameters "XML-Verzeichnis abgearbeiteter Dateien" (PPS → Stammdaten → Einstellungen → PPS Parameter → PPS → CAM-Interface) und wird als Zwischenziel für einen erfolgreichen Import benötigt.

<?xml version="1.0" encoding="ISO-8859-1"?>
<MAIN>
<ARTICLE ACTION="MODIFY">
    <ARTICLE_NO>2</ARTICLE_NO>
        <ARTICLE_DOCUMENT>
        <ARCHIVE>1</ARCHIVE>
        <PATH>D:\dokumenteimport\f4_zeichnung.pdf</PATH>
        <TITLE>Betreff Test</TITLE>
        <DRAWING_NUMBER>Zeichnungsnummer</DRAWING_NUMBER>
        <CATEGORY>2</CATEGORY>
        <VERSION_FREE_FIELD_NK1>1234</VERSION_FREE_FIELD_NK1>
        <VERSION_FREE_FIELD_A5>Revision 1</VERSION_FREE_FIELD_A5>
        <BASE64DOCUMENT>JVBERi0xLjQKJcfsj6IKNSAwIG9iago8PC9MZW5ndGggNiAwIFIvRmlsdGVyIC9GbGF0ZURlY29kZT4...</BASE64DOCUMENT>

</ARTICLE_DOCUMENT>
</ARTICLE>
</MAIN>

Dokumentenbereich im Artikelstamm:

Dokumentenversionen:

3. 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!

3.1. 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 → Stammdaten → CRM und Kanzlei → DMS → Archive.

Beispiel

Die zum Artikel abgelegten Dokumente werden der Person "DMS Standardperson" zugeordnet.

3.2. 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 → 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!

3.2.1. 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:

3.2.2. 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>

3.2.3. 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.

PPS → Stammdaten → Einstellungen → PPS Parameter → PPS → CAM-Interface

Speichername Feldauswahl für Artikelkopie

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.

Seitenanfang

4. 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 → Tools → 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:

4.1. 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:

4.2. Befehl zum Duplizieren 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 duplizieren. Derzeit können die Zusatzdaten "Lieferantenartikel" sowie "Stückliste" von einem Quellartikel kopiert werden.

Bei der Kopie verhält sich das Programm analog zur Duplizieren-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:

Es wurden die Artikelstamm-Informationen (erkennbar z. B. am Feld "Teileart") kopiert.
Es wurde die Stückliste kopiert.
Es wurden die Lieferanten-Zusatzdaten (erkennbar am Feld "Lieferant") kopiert.

Siehe auch:

Themen PPS

CAM-Interface

CAM: Stücklistenstammdaten importieren

CAM: Stücklisten importieren mit eindeutigen Bezeichnungen

CAM: Artikeldaten importieren