MINERVA-Nimz: Neue Seite zum Menüpunkt „M Migration“ der Schnittstelle brShop24 (Neuaufbau Internet-Shop) [Styleguide-Abweichung: Linkziele folgen in derselben Welle]

2026-11-03T15:25:03Z

Neue Seite zum Menüpunkt „M Migration“ der Schnittstelle brShop24 (Neuaufbau Internet-Shop) [Styleguide-Abweichung: Linkziele folgen in derselben Welle]

Neue Seite

{{Vorlage:Kostenpflichtige Module}}
{{Seitentyp|Maske}}
= M Migration =

Mit der Migration verbinden Sie die Daten, die der Büroring aus Ihrem VShop 4 in den brShop24 übernommen hat, mit Ihren Stammdaten in OBS. Danach pflegt OBS Benutzerkonten und Preislisten im Shop über die Schnittstelle weiter. Sie erreichen die Migration über '''Stammdaten → Schnittstellen → Internet-Shop''', {{F10}} '''M Migration'''. Das Menü '''Shop Migration''' bietet:
* '''A Liste Benutzer''' öffnet die Liste der importierten Benutzer. Dort verknüpfen Sie Benutzer, die OBS nicht selbst zuordnen konnte, mit Ansprechpartnern, siehe [[#Manuelle Zuordnung Benutzer|Manuelle Zuordnung Benutzer]].
* '''Z Migration starten''' startet die Migration, siehe [[#Migration starten|Migration starten]].

'''Warum eine Migration?''' Der Shop ändert seine Daten über eine Programmierschnittstelle (API). Sie erlaubt Änderungen nur an Datensätzen, die für die Pflege von außen freigegeben sind. Die Migration teilt dem Shop mit, welche Datensätze OBS künftig bearbeiten darf, und richtet in OBS alles ein, was für die Pflege nötig ist.

'''Was macht die Migration?''' Sie liest je nach Auswahl Kundengruppen, Benutzer, Kostenstellen und Preislisten aus dem Shop und verknüpft sie mit den Stammdaten in OBS. Für einen Benutzer sucht OBS z.B. den passenden Ansprechpartner, legt die Webshop-Einstellungen der Person an und gibt Ansprechpartner und Preislisten für die Schnittstelle frei. Im Shop markiert OBS die Datensätze als API-Datensätze. Ab dann kann OBS sie über die Schnittstelle ändern.

{{Achtung|1=Passwörter kann OBS aus dem Shop nicht lesen, das lässt die API aus Sicherheitsgründen nicht zu. Hat ein Ansprechpartner in OBS kein Passwort, erzeugt die Migration eines. Anmeldedaten im Shop überschreibt OBS bei einer Aktualisierung nicht.}}

== Liste ==
'''A Liste Benutzer''' öffnet die Liste '''Shop - Migration Benutzer'''. Sie zeigt die Benutzer, die die Migration zuletzt aus dem Shop gelesen hat. Unter der Liste sehen Sie die Angaben zur Person des markierten Benutzers.

{| class="wikitable"
! Spalte !! Inhalt
|-
| '''Kunde''' || Die Kundennummer des Benutzers aus dem Shop.
|-
| '''Nachname''', '''Vorname''', '''E-Mail''' || Die Angaben zur Person aus dem Shop.
|-
| '''Benutzer''' || Der Benutzername (Login) im Shop.
|-
| '''Rel''' || Wie viele Ansprechpartner OBS zu diesem Benutzer findet, siehe [[#Manuelle Zuordnung Benutzer|Manuelle Zuordnung Benutzer]]. Bei einem zugeordneten Benutzer steht hier ''1''.
|}

Mit {{F4}} wählen Sie, welche Benutzer die Liste zeigt:
* '''A - Nicht Verknüpfte Alle''': alle Benutzer ohne Ansprechpartner. Das ist die Standardansicht.
* '''B - Nicht Verknüpfte mit Kundennummer''': Benutzer ohne Ansprechpartner, die eine Kundennummer haben.
* '''C - Alle Benutzer''': auch die bereits zugeordneten Benutzer.

== Tasten und Schaltflächen ==
{| class="wikitable"
! Taste !! Funktion
|-
| {{F4}} || Wählt die Ansicht der Liste, siehe [[#Liste|Liste]].
|-
| {{F6}} || Startet die Migration aus der Liste heraus, wie '''Z Migration starten'''.
|-
| {{Return}} || Ordnet dem markierten Benutzer einen Ansprechpartner aus OBS zu.
|-
| {{Einfg}} || Legt für den markierten Benutzer einen neuen Ansprechpartner an und verknüpft ihn.
|}

== Migration starten ==
{{Schritte|1=
# Markieren Sie in der Liste '''Internet-Shops''' Ihre brShop24-Schnittstelle und drücken Sie {{F10}}.[[Datei:Br24_mig_start1.jpg|alt=Shop-Menü der brShop24-Schnittstelle]]
# Wählen Sie '''M Migration'''.[[Datei:Br24_mig_start2.jpg|alt=Shop-Menü mit dem Eintrag M Migration]]
# Wählen Sie '''Z Migration starten'''.[[Datei:Br24_mig_start3.jpg|alt=Menü Shop Migration mit Z Migration starten]]
# Markieren Sie in der Auswahl '''Migration starten für''' die Teile, die laufen sollen: ''Kundendaten'' und, wenn Sie Preislisten verwenden, ''Preislisten''. Drücken Sie {{F2}}.[[Datei:Br24_mig_start4.jpg|alt=Auswahl Migration starten für mit Kundendaten und Preislisten]]
}}

{{Hinweis|1=Beim ersten Mal führen Sie am besten alle Teile aus. Bricht die Migration ab, starten Sie sie neu. Sie können die Migration beliebig oft ausführen.}}

{{Achtung|1=Die Migration der Preislisten läuft erst, wenn die Migration der Kundendaten mindestens einmal vollständig durchgelaufen ist. Sonst überspringt OBS sie und vermerkt das im Protokoll der Schnittstelle.}}

=== Kundendaten ===
OBS liest zuerst Kundentypen, Kundenqualifikationen, Kundengruppen und Benutzer aus dem Shop und speichert sie zwischen. Danach liest es die Kostenstellen.

Anschließend verknüpft OBS die Benutzer mit Ansprechpartnern aus dem Personenstamm. Das geschieht in sieben Stufen, von genau zu locker. In jeder Stufe sucht OBS zuerst nur beim Kunden mit der Kundennummer des Benutzers, danach bei allen Kunden.

{| class="wikitable"
! Stufe !! Gleich sein müssen
|-
| API-ID || Die API-ID des Benutzers. Sie gibt es nur, wenn der Benutzer schon über die Schnittstelle gepflegt wurde.
|-
| Vollständig || Benutzername, E-Mail, Vorname und Nachname. Die E-Mail muss gefüllt sein.
|-
| Name || E-Mail, Vorname und Nachname. Die E-Mail muss gefüllt sein.
|-
| Benutzername erweitert || Benutzername und Nachname.
|-
| Benutzername einfach || Benutzername.
|-
| E-Mail und Nachname || E-Mail und Nachname. Die E-Mail muss gefüllt sein.
|-
| E-Mail || E-Mail. Die E-Mail muss gefüllt sein.
|}

OBS ordnet nur eindeutig zu: Die Angaben dürfen im Shop nur bei einem Benutzer vorkommen und müssen genau einen sichtbaren Ansprechpartner treffen, der noch keinem Benutzer zugeordnet ist. Benutzer ohne Nachnamen ordnet OBS nicht zu. Die übrigen Benutzer verknüpfen Sie danach selbst, siehe [[#Manuelle Zuordnung Benutzer|Manuelle Zuordnung Benutzer]].

Danach richtet OBS für die Kunden und zugeordneten Benutzer ein:
* die [[OBS/Stammdaten/Schnittstellen/Internet-Shop/brShop24/C Personen übertragen|Webshop-Einstellungen]] der Person je Kundennummer,
* die Freigabe des Ansprechpartners für die Schnittstelle,
* die Eigenschaft 9013 beim Ansprechpartner,
* den Benutzernamen aus dem Shop, wenn der Ansprechpartner noch keinen hat,
* ein neues Passwort, wenn der Ansprechpartner noch keines hat.

{{Hinweis|1=Damit OBS einen Benutzer später aktualisieren kann, z.B. nach einer Namensänderung, braucht der Ansprechpartner E-Mail, Benutzername und Passwort.}}

Dann markiert OBS Kundengruppen und Benutzer im Shop als API-Datensätze.

Zum Schluss gleicht OBS die Kostenstellen ab. Eine Kostenstelle wird zugeordnet, wenn ihre Bezeichnung in OBS und im Shop übereinstimmt. OBS gibt sie dann für die Schnittstelle frei und trägt den eindeutigen Bezeichner aus dem Shop ein. Lässt sich eine Kostenstelle nicht zuordnen, hindert das die Migration der Preislisten nicht.

=== Preislisten ===
Die Auswahl ''Preislisten'' gibt es nur, wenn Sie in OBS Preislisten verwenden.

OBS liest die Preislisten aus dem Shop. Jede Preisliste hat im brShop24 einen ''eindeutigen Bezeichner''. Bei der Übernahme aus dem VShop 4 hat der Büroring dort den Wert eingetragen, an dem OBS die Preisliste schon bisher erkannt hat. Anhand dieses Bezeichners sucht OBS die Preisliste in OBS. Erkennt es sie, dann
# gibt OBS die Preisliste für die Schnittstelle frei,
# markiert sie im Shop als API-Datensatz,
# leert die Preise der Liste im Shop und
# überträgt die aktuellen Preise aus OBS.

Schritt 3 und 4 sparen Zeit. Zwischen der Übernahme durch den Büroring und Ihrer Migration können Wochen liegen. Sonst müsste OBS jeden Preis aus dem Shop laden, prüfen und dann übergehen, ändern oder löschen. OBS merkt sich, welche Preise es übertragen hat, und überträgt später nur Änderungen. Dafür muss jede Preisliste einmal vollständig übertragen werden. Ohne das vorherige Laden aller Preise sparen Sie Datenvolumen und, gerade bei großen Standard-Preislisten, unter Umständen Stunden.

Zum Schluss aktualisiert OBS die Zuordnungen der Preislisten zu Kundengruppen und Benutzern.

== Nachbearbeitung ==
OBS ordnet nur eindeutige Datensätze automatisch zu und überspringt alle anderen. So entsteht kein Durcheinander in Ihren Stammdaten. Damit Sie auch mit den übersprungenen Benutzern über die Schnittstelle arbeiten können, verknüpfen Sie sie selbst.

=== Manuelle Zuordnung Benutzer ===
Öffnen Sie '''M Migration''', '''A Liste Benutzer'''. Die Liste zeigt zunächst nur Benutzer ohne Ansprechpartner.

[[Datei:Br24_migben_liste.jpg|rahmenlos|720px|alt=Liste Shop - Migration Benutzer]]

Die Spalte '''Rel''' zählt die möglichen Ansprechpartner: sichtbare Ansprechpartner, die noch keinem Benutzer zugeordnet sind und bei denen Benutzername, E-Mail, Vorname oder Nachname mit dem Benutzer übereinstimmen. Gibt es die Kundennummer in OBS, zählen nur Ansprechpartner dieses Kunden.

'''Vorhandenen Ansprechpartner zuordnen'''
{{Schritte|1=
# Markieren Sie den Benutzer und drücken Sie {{Return}}.
# Wählen Sie in der Auswahl '''Migration Auswahl Ansprechpartner''' den passenden Ansprechpartner. Die Auswahl zeigt die Ansprechpartner, die in '''Rel''' gezählt sind.
}}

'''Neuen Ansprechpartner anlegen'''
{{Schritte|1=
# Markieren Sie den Benutzer und drücken Sie {{Einfg}}.
# Gibt es die Kundennummer des Benutzers in OBS nicht, legt OBS eine neue Person an. Es fragt nach dem Namen: ''Name eingeben'' oder ''Benutzerdaten'' (Vor- und Nachname aus dem Shop). ''Abbruch'' bricht ab.
# OBS legt einen Ansprechpartner mit Anrede, Name, E-Mail und Benutzername aus dem Shop und einem neuen Passwort an, gibt ihn für die Schnittstelle frei und setzt die Eigenschaft 9013.
}}

In beiden Fällen führt OBS danach die Migration für diesen einen Benutzer aus: Webshop-Einstellungen anlegen, Ansprechpartner freigeben, Benutzer im Shop als API-Datensatz markieren und das Ergebnis im Shop prüfen. Der Benutzer verschwindet dann aus der Standardansicht.

{{Hinweis|1=Hat der Benutzer im Shop keinen Nachnamen, meldet OBS „Nachname erforderlich, um diese Funktion zu verwenden.“ Ist ihm schon ein Ansprechpartner zugeordnet, meldet OBS „Ansprechpartner ist bereits zugewiesen.“}}

== Siehe auch ==
* [[OBS/Stammdaten/Schnittstellen/Internet-Shop/brShop24|brShop24]]
* [[OBS/Stammdaten/Schnittstellen/Internet-Shop/brShop24/C Personen übertragen|C Personen übertragen]]
* [[OBS/Stammdaten/Schnittstellen/Internet-Shop/brShop24/B Preislisten verwalten|B Preislisten verwalten]]
* [[OBS/Stammdaten/Schnittstellen/Internet-Shop/brShop24/F Kundengruppen|F Kundengruppen]]
* [[OBS/Stammdaten/Schnittstellen/Internet-Shop/brShop24/Eigene Artikel übertragen|Eigene Artikel übertragen]]

OBS/Stammdaten/Schnittstellen/Internet-Shop/brShop24/M Migration - Versionsgeschichte

MINERVA-Nimz: Neue Seite zum Menüpunkt „M Migration“ der Schnittstelle brShop24 (Neuaufbau Internet-Shop) [Styleguide-Abweichung: Linkziele folgen in derselben Welle]