Allgemein
|
bpStarter ist eine Software zum Ausführen von Büro Plus
Next Im- oder Export-Layouten.
Das Programm wird von unseren Kunden genutzt, um Daten aus Büro Plus
Next in das inbase Shopsystem
(bzw. in die myCMS-Shopmodule) zu exportieren und eingehende Bestellungen in Büro Plus
NexT zu importieren.
bpStarter kann im hierzu auch Batchmodus ausgeführt werden.
Genutzt wird hierbei die Büro Plus NexT COM-Schnittstelle.
Ist diese COM-Schnittstelle nicht vorhanden oder nicht korrekt
konfiguriert, wird diese Anwendung nicht funktionieren. |
|
| Überblick |
Zur Verbindung mit Büro Plus NexT wird
- ein Benutzername (z.B. administrator),
- die Mandantenbezeichnung (z.B. TestMandant)
- eine VerbindungsZeichenfolge -ConnectName-, eg. der registrierte Firmenname
wie in Büro Plus angegeben (z.B. Maier & Co. KG)
- und optional ein ConnectKey ( in der Büro Plus Next Dokumentation nicht näher
definiert ).
benötigt
Genutzt wird hierbei die Büro Plus
Next COM-Schnittstelle.
Ist diese Büro Plus Schnittstelle nicht
vorhanden oder nicht korrekt konfiguriert, wird diese Anwendung nicht
funktionieren.
Nur mit einwandfrei konfigurierten Büro Plus Next Schnittstellen
sind nachfolgend beschriebenen Büro Plus Importe oder Next Exporte möglich.
Büro Plus NexT arbeitet für die Im- und
Exporte mit sog. Layouts.
In diesen Layouts wird die Struktur der zu im-
oder exportierenden Daten, die erforderlichen Dateinamen und sonstige Parameter
wie Filter, Meldungen etc. festgelegt.
Diese Layouts sind nach
Datenbereiche gruppiert. Diese Gruppierungen sind sog. Layoutgruppen.
Durch
die Auswahl einer NexT Layoutgruppe (z.B. AdrExpListe) wird der Zugriff auf die
Im- oder Export-Layouts geregelt.
Aus Sicherheitsgründen greift bpStarter nur auf externe Layouts
zu.
Das bedeutet:
- Sie erstellen in NexT Büro Plus ein Layout
- und ziehen nach Fertigstellung
(und evtl. Ausschalten aller
Meldungen und Abfragen innerhalb des Layouts)
dieses Layout in den bpStarter-Ordner ...
|
|
| Erste Schritte |
Um bpStarter zu testen, folgen Sie folgendem Ablauf:
- Erstellen eines Büro Plus NexT Layouts
- Testen des Büro Plus NexT Layouts
- Abschalten aller Meldungen
- Kopieren des Layoutes in den bpStarter Ordner
- bpStarter öffnen
- Notwendige Parameter eingeben
- einen gültiger Benutzername zur Anmeldung an Büro Plus NexT
- eine gültige Mandantenbezeichnung
- eine VerbindungsZeichenfolge, der registrierte Firmenname wie in Büro Plus NexT
angegeben
- optional ein ConnectKey ( in der Büro Plus NexT Dokumentation nicht näher
definiert ).
- Verbindung testen
- Büro Plus NexT Layoutgruppe auswählen
- Büro Plus NexT Layout-Datei auswählen
- Büro Plus NexT Export (oder Import) starten
- Ergebnis überprüfen
|
|
| 1. Büro Plus NexT: Layout
erstellen |
| Wählen Sie in Büro Plus NexT über das Menü
Datei den Punkt Export aus. |
 |
Wählen Sie die Büro Plus NexT Layoutgruppe Adressen und klicken
Sie doppelt auf "Neuer Export"
|
 |
 |
Bestätigen Sie "Neuer Export" und
vergeben anschließend einen neuen Namen, hier z.B. "TestAdrExport"
|
 |
Klicken Sie auf "Gestalten", um die Felder
für den Büro Plus NexT Export auszuwählen.
|
 |
Wählen Sie durch Doppelklick auf die
Feldbezeichner die entsprechenden Felder aus,
|
 |
z.B. "«Adr.AdrNr»;«Adr.Re.Na1»;«Adr.Re.Na2»;«Adr.Re.Na3»;«Adr.Re.PLZ»;«Adr.Re.Ort»;«Adr.Re.Str»;"
Um
in der Büro Plus NexT Exportdatei einen Zeilenumbruch nach jedem Datensatz zu erzeugen drücken
Sie am Ende der Zeile "STRG+Eingabe" oder geben Sie \n ein.
Bestätigen
die Auswahl mit "OK".
Legen Sie nun die Eigenschaften des Büro Plus NexT Export Layouts fest: Ausgabe/ Ausgabeformat und Ausgabedatei:
|
 |
und bestätigen die Auswahl mit "OK".
|
| 2. Büro Plus NexT: Layout
testen |
Aktivieren Sie das Büro Plus NexT Layout "TestAdrExport" und klicken
auf "DatenExport"
|
 |
Vor dem Büro Plus NexT Export werden noch einmal bestimmte Parameter
wie Filter, Dateiname etc. abgefragt, bestätigen Sie mit "OK".
|
 |
Nach dem Büro Plus NexT Export werden Meldungen über den Ablauf
des Exportes angezeigt, diese Meldungen und die Parameterabfragen (s.o.) werden
unter 3. ausgeschaltet.
|
 |
Überprüfen Sie das Ergebnis der Büro Plus NexT Exporte , indem Sie die
Zieldatei des Exportes -C:\Programme\bpStarter\adrtest.txt- öffnen.
|
|
| 3. Büro Plus NexT:
Layout, Meldungen abschalten |
Aktivieren Sie das Layout "TestAdrExport" und klicken auf "Eigenschaften".
Deaktivieren Sie alle nicht benötigten Abfrage- bzw. Meldungsparameter: |
|
 |
und bestätigen die Änderungen mit "OK".
|
| 4. Büro Plus NexT: Layout
kopieren |
Akivieren Sie in Büro Plus NexT das Exportlayout "TestAdrExport"
und drücken "STRG+C" für das Kopieren in den
Zwischenspeicher.
Öffnen Sie den Ordner "C:\Programme\bpStarter"
und drücken Sie hier "STRG+V" zum Einfügen aus dem
Zwischenspeicher.
|
|
| 5. bpStarter öffnen |
Doppelklicken Sie auf das Symbol "bpStarter".
|
|
| 6. Notwendige Parameter zur Verbindung mit Büro Plus NexT eingeben |
Tragen die erforderlichen Verbindungsdaten ein
(Username,Kennwort,Mandant,ConnectName).
Username, Kennwort und Mandant entnehmen Sie einer gültigen Büro Plus
NexT Anmeldung.
Falls Sie unsicher sein sollten, wie die richtige
Verbindungszeichenfolge (ConnectName) lautet, klicken Sie in Büro Plus auf
das Menü Hilfe/Hotline.
Hier wird Ihnen
der Büro Plus NexT registrierte Firmenname angezeigt:
|
|
|
| 7. Verbindung zu Büro Plus NexT testen |
Testen Sie die Verbindung zu Büro Plus NexT über das
Einstellungen/Büro Plus Verbindung testen
|
 |
Nach einem erfolgreichem Test der Verbindung zu Büro Plus NexT können
Sie den 1. Teil der Eingaben speichern:
|
|
| 8. Büro Plus NexT Layoutgruppe auswählen |
Die Layoutgruppe kann manuell eingegeben oder über den
Zugriff auf die Büro Plus NexT Daten ausgewählt werden.
|
|
|
|
| 9. Layout-Datei (.BPL) auswählen |
Ebenso kann die Layoutdatei (BPL) ausgewählt werden ...
|
 |
Nach der Eingabe aller Parameter speichern Sie die
Konfiguration:
|
|
| 10. Export (oder Import)
starten |
Nach dem Speichern können Sie den Export starten ...
|
 |
|
| 11. Ergebnis überprüfen |
Überprüfen Sie wiederum das Ergebnis der Datei C:\Programme\bpStarter\adrtest.txt
|
|
|
| Batchmodus |
|
|
bpStarter kann durch den Befehlszeilenparameter -once im
Batchmodus ausgeführt werden.
Parameter: |
| |
-once |
Batchmodus, d.h. bpStarter wird ausgeführt und danach automatisch
beendet |
| |
-debug |
erweiterte Fehlermeldungen |
| |
-mandant |
Angabe Büro Plus NexT Mandant, z.b. Mand0 |
| |
-layoutgroup |
Für Batchmodus zusätzliche NexT Layoutgruppe, z.B. ArtExpListe |
| |
-layoutfile |
Für Batchmous zusätzliche Layoutdatei, z.B.
C:\Daten\bpStarter\TESTARTIKEL.BPL |
|
| Batchmodus Beispiel |
Erstellen Sie im bpStarter Ordner folgende Batchdatei:
|
echo off
START /WAIT bpStarter.exe -debug -mandant Man1 -layoutfile
C:\Programme\bpStarter\TESTADR.BPL -layoutgroup AdrExpListe -once
rem
Jetzt wird der Errorlevel ausgewertet:
IF ERRORLEVEL 1 goto fehler1
ECHO .
ECHO Die Anwendung hat keinen Rueckgabewert / Errrolevel ausgeloest
ECHO ################################
goto ende
ECHO !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
ECHO Die Anwendung wurde mit
dem Rueckgabewert / Errrolevel 1 beendet
ECHO !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
goto ende
:ende
PAUSE
| | |
|
| Hinweise /
Haftungsausschluß |
bpStarter wird seit 2002 auf verschiedenen Plattformen (Windows
XP, Windows 2000 Server, Windows 2003 Server) eingesetzt.
Hierbei
konnten wir keine Fehler feststellen und freuen uns über die Zuverlässigkeit
und Stabilität der Anwendung.
Die Software befindet sich aber
immer noch im Entwicklungsstadium.
Deswegen übernehmen wir keine Haftung für evtl. vorhandene
Programmfehler und deren Folgen.
Für entsprechende Hinweise sind wir jedoch dankbar, um das Programm
weiterentwickeln zu können.
Wir empfehlen, diese Software, wie jede Andere, vor dem tatsächlichen
Einsatz umfassend
mit nicht kritischen Daten im Echtbetrieb zu testen.
|
|
myCMS ist ein Warenzeichen der Fa. inbase - Wolfgang Timm-
e.K.
Büro Plus NexT ist ein Warenzeichen der microtech GmbH
Windows
ist ein Warenzeichen der Microsoft Inc.
Alle verwendeten Warenzeichen werden
anerkannt.
|
|
