Allgemein
|
bpStarter ist eine Software zum Ausführen von Büro Plus Next Im- oder Export-Layouten (Definitionen).
Das Programm wird von unseren Kunden genutzt, um Daten aus Büro Plus Next in Shopsysteme (z.B. in einen myCMS-Shop) 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 COM-Schnittstelle nicht vorhanden oder nicht korrekt konfiguriert, wird diese Anwendung nicht funktionieren.
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.
|
|
