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

2026-11-03T15:25:05Z

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

Neue Seite

{{Vorlage:Kostenpflichtige Module}}
{{Seitentyp|Anleitung}}
= PDF-Druck Artikellink =

Verschicken Sie Angebote als E-Mail mit PDF-Anhang oder als PDF-Export (Druckauswahl ''Export''), kann OBS zu jedem Artikel einen Link auf den Artikel in Ihrem brShop24 einfügen. Ihre Kunden kommen so mit einem Klick vom Angebot in den Shop. Diese Seite zeigt, wie Sie den Link einrichten.

{{Hinweis|1=Die Standardformulare drucken den Link nur bei '''Angeboten''' und nur, wenn Sie das Angebot per E-Mail versenden oder in eine PDF-Datei exportieren. Den Link setzt OBS fett unter die Beschreibung der Position. Beim Druck auf Papier und in anderen Belegarten erscheint er nicht. In eigenen Druckformularen können Sie ihn selbst einbauen, siehe [[#In eigenen Druckformularen|In eigenen Druckformularen]].}}

[[Datei:Br24_kurzlink_auswahl.png|alt=Druckauswahl mit E-Mail und Export]]

== Voraussetzungen ==
* Die brShop24-Schnittstelle ist aktiv.
* Der Artikel steht im Shop, und OBS hat ihn als Shop-Artikel erkannt. Das Lager des Artikels ist aktiv, und der Artikel ist im Shop weder gelöscht noch inaktiv.

OBS verlinkt mit dem '''Kurzlink'''. Das ist Ihre Shop-URL mit dem Pfad <code>artnr</code> und der Artikelnummer, z.B. <code><nowiki>https://<Ihr-Shop>.brshop24.de/artnr/BROTN2320</nowiki></code>. In OBS hinterlegen Sie die URL mit dem Platzhalter <code>$REFERENZ</code> für die Artikelnummer, z.B. <code><nowiki>https://<Ihr-Shop>.brshop24.de/artnr/$REFERENZ</nowiki></code>. Setzen Sie dabei die Adresse Ihres Shops ein. Sie ist individuell und wird zwischen Ihnen und Büroring festgelegt. Üblich ist <code><nowiki><Mitgliedname>.brshop24.de</nowiki></code>, andere Adressen sind möglich.

{{Achtung|1=Ein Kurzlink enthält nur die Artikelnummer. Eine Artikelnummer ist im Shop aber nur je Lager eindeutig. Gibt es dieselbe Nummer in mehreren Lagern, kann der Link auf den falschen Artikel führen. Nutzen Sie eigene Artikel und diese Funktion, achten Sie darauf, dass Ihre Artikelnummern im ganzen Shop eindeutig sind.}}

== Vorgehen ==
Den Link stellen Sie in der Konfiguration der Schnittstelle mit der Einstellung <code>Allgemein.Kurzlink.Artikel</code> ein. Sie erreichen sie über '''Stammdaten → Schnittstellen → Internet-Shop''', {{F10}} '''X Konfiguration'''. Sie haben zwei Möglichkeiten:
* '''URL als Text:''' Die URL erscheint so, wie sie ist, im Ausdruck.
* '''Textbaustein mit Hyperlink:''' Ein Text oder eine Grafik Ihrer Wahl erscheint im Ausdruck und führt zum Artikel.

=== Variante 1: URL als sichtbarer Text ===
{{Schritte|1=
# Öffnen Sie in der Konfiguration die Einstellung <code>Allgemein.Kurzlink.Artikel</code>.
# Tragen Sie die URL mit dem Platzhalter ein, z.B. <code><nowiki>https://<Ihr-Shop>.brshop24.de/artnr/$REFERENZ</nowiki></code>.
# Sichern Sie mit {{F2}}.
}}

[[Datei:Br24_kurzlink_config_url.png|alt=Einstellung Allgemein.Kurzlink.Artikel mit URL]]

=== Variante 2: Textbaustein mit Hyperlink ===
Im Textbaustein können Sie einen Text oder eine Grafik zum Hyperlink machen.

{{Schritte|1=
# Legen Sie einen Textbaustein an und schreiben Sie den Text, der im Ausdruck erscheinen soll. Für eine Grafik fügen Sie sie über die '''RTF Texteigenschaften''' mit dem Bild-Symbol ein oder kopieren sie mit {{Key|Strg}}+{{Key|C}} und {{Key|Strg}}+{{Key|V}} in den Text.
# Markieren Sie den Text oder die Grafik, die zum Link werden soll.
# Klicken Sie auf die Schaltfläche für Hyperlinks (Kugel mit Kette).
# Tragen Sie im Feld '''Ziel''' die URL mit dem Platzhalter ein, z.B. <code><nowiki>https://<Ihr-Shop>.brshop24.de/artnr/$REFERENZ</nowiki></code>.
# Speichern Sie den Textbaustein.
# Tragen Sie die Nummer des Textbausteins in die Einstellung <code>Allgemein.Kurzlink.Artikel</code> ein und sichern Sie mit {{F2}}.
}}

So sieht ein Textbaustein mit Text und mit Grafik als Hyperlink aus:

[[Datei:Br24_kurzlink_tb_text_v2.png|alt=Textbaustein mit Text als Hyperlink]]

[[Datei:Br24_kurzlink_tb_bild.png|alt=Textbaustein mit Bild als Hyperlink]]

Das Fenster für den Hyperlink:

[[Datei:Br24_kurzlink_tb_hyperlink.png|alt=Hyperlink einfügen mit dem Feld Ziel]]

{{Achtung|1=Verwenden Sie eine Grafik als Hyperlink, muss der Textbaustein außer der Grafik noch ein weiteres Zeichen enthalten, sonst wird der Text nicht gespeichert. Fügen Sie z.B. ein Leerzeichen hinter der Grafik ein.}}

[[Datei:Br24_kurzlink_tb_hyperlink_img.png|alt=Grafik mit Hyperlink und folgendem Leerzeichen]]

Die Einstellung mit der Nummer des Textbausteins:

[[Datei:Br24_kurzlink_config.png|alt=Einstellung Allgemein.Kurzlink.Artikel mit Textbausteinnummer]]

{{Hinweis|Gibt es einen Textbaustein mit der eingetragenen Nummer, verwendet OBS den Textbaustein. Sonst verwendet OBS den Eintrag selbst als Text.}}

=== Lager priorisieren ===
Steht ein Artikel in mehreren Lagern, legen Sie fest, welches Lager OBS für den Link bevorzugt. OBS verwendet die Artikelnummer aus dem Lager mit der höchsten Priorität.

{{Schritte|1=
# Öffnen Sie in der Konfiguration mit {{F8}} '''L Lager und Lagerlieferanten'''.
# Markieren Sie das Lager und drücken Sie {{Return}}.
# Tragen Sie im Feld '''Priorisierung Link''' eine Zahl ein. Standard ist ''0''. Je höher die Zahl, desto eher wird das Lager verwendet.
# Sichern Sie mit {{F2}}.
}}

Haben mehrere Lager dieselbe Priorität, verwendet OBS das Lager mit der kleinsten Lager-ID. Mehr zur Maske steht unter [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Zuordnungen/DepotPartner|L Lager und Lagerlieferanten]].

=== Artikel ausnehmen ===
Soll für einen Artikel kein Link im PDF erscheinen, hinterlegen Sie beim Artikel die Eigenschaft ''9207 SHOP Keinen Link setzen''.

[[Datei:Artikeleigenschaften.png|mini|rechts|Eigenschaft 9207 beim Artikel]]

{{Schritte|1=
# Öffnen Sie den Artikel im Artikelstamm.
# Fügen Sie bei den Eigenschaften die Eigenschaft ''9207 SHOP Keinen Link setzen'' hinzu.
# Sichern Sie den Artikel.
}}

=== In eigenen Druckformularen ===
Für eigene Druckformulare, z.B. für andere Belegarten, steht in den Druckscripten die Funktion <code>GetArtLinkText</code> zur Verfügung:

<syntaxhighlight lang="delphi">
cShopLink := GetArtLinkText(oDB, '', AZ_Query.A2C('az_artnr'));
</syntaxhighlight>

* Der erste Parameter ist die Datenbankverbindung des Druckscripts.
* Der zweite Parameter ist die Nummer der Shop-Schnittstelle. Bleibt er leer, nimmt OBS die erste aktive brShop24-Schnittstelle, die für den Artikel einen Link liefert.
* Der dritte Parameter ist die OBS-Artikelnummer.

Die Funktion liefert den Inhalt von <code>Allgemein.Kurzlink.Artikel</code> bzw. des Textbausteins, mit der Shop-Artikelnummer anstelle von <code>$REFERENZ</code>. Sind die [[#Voraussetzungen|Voraussetzungen]] für den Artikel nicht erfüllt oder hat er die Eigenschaft 9207, liefert sie einen leeren Text. Wo und wie der Link im Formular erscheint, legen Sie im Druckscript fest.

== Ergebnis ==
Im PDF steht bei jedem Artikel, der im Shop vorhanden ist, der Link zum Artikel. Mit Variante 1 ist es die URL, die der PDF-Export automatisch klickbar macht:

[[Datei:Br24_kurzlink_pdf_url.png|alt=PDF mit URL zum Artikel]]

Mit Variante 2 ist es Ihr Text oder Ihre Grafik:

[[Datei:Br24_kurzlink_pdf_text.png|alt=PDF mit Text als Hyperlink]]

[[Datei:Br24_kurzlink_pdf_bild.png|alt=PDF mit Bild als Hyperlink]]

== Wenn es nicht klappt ==
{| class="wikitable"
! Beobachtung !! Ursache
|-
| Bei keinem Artikel erscheint ein Link. || Die Schnittstelle ist nicht aktiv, oder <code>Allgemein.Kurzlink.Artikel</code> ist leer. Oder der Beleg ist kein Angebot bzw. wurde nicht per E-Mail oder als PDF-Datei ausgegeben.
|-
| Bei einem Artikel fehlt der Link. || Der Artikel steht nicht im Shop, ist dort gelöscht oder inaktiv, sein Lager ist nicht aktiv, oder er hat die Eigenschaft 9207.
|-
| Der Link führt zum falschen Artikel. || Dieselbe Artikelnummer gibt es in mehreren Lagern. Machen Sie die Artikelnummern eindeutig oder legen Sie die [[#Lager priorisieren|Priorität der Lager]] fest.
|-
| Statt des Textbausteins erscheint seine Nummer. || Einen Textbaustein mit dieser Nummer gibt es nicht.
|}

== Siehe auch ==
* [[OBS/Stammdaten/Schnittstellen/Internet-Shop/brShop24|brShop24]]
* [[OBS/Stammdaten/Schnittstellen/Internet-Shop/brShop24/Konfiguration|Konfiguration]]
* [[OBS/Stammdaten/Schnittstellen/Internet-Shop/brShop24/Eigene Artikel übertragen|Eigene Artikel übertragen]]
* [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Zuordnungen/DepotPartner|L Lager und Lagerlieferanten]]

OBS/Stammdaten/Schnittstellen/Internet-Shop/brShop24/PDF-Druck Artikellink - Versionsgeschichte

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