Benutzer-Werkzeuge

Webseiten-Werkzeuge


camid:sql:sp_createnewaddress

Gespeicherte Prozedur: SP_CreateNewAddress

Die gespeicherte Prozedur SP_CreateNewAddress erzeugt eine neue Adresse mit deren Ansprechpartner in der xPress Datenbank. Optional kann eine bereits vorhandene Adresse mit dieser Prozedur auch upgedatet werden.

Die Datentypen beziehen sich auf jene des Microsoft SQL-Servers.


Parameter

NameBeschreibungDatentypPflichtfeld
addressNoDefiniert die Adressnummer der Adresse. Diese Nummer muss eindeutig sein. Anhand dieser Nummer werden die Adresskontakte (Ansprechpartner) der Hauptadresse zugewiesen. Auch bei einer eventuellen Aktualisierung der Adresse wird nach dieser Nummer gesucht und diese Adresse aktualisiert.nvarchar(50)x
mainAddressNoDieses Feld ist nur relevant, wenn die Adresse ein Adresskontakt (Ansprechpartner) ist. Dies ist im Prinzip eine normale Adresse, diese wird jedoch einer übergeordneter Adresse zugewiesen. In diesem Feld wird die Adressnummer der Hauptadresse angegeben.nvarchar(50)
addressTypeIdGibt die Id des Adresstypes an. Diese ist nur bei einer Adresse relevant, die als Adresskontakt definiert ist. Der Adresstyp definiert, ob der Kontakt z.B. ein Mitarbeiter oder ein Ansprechpartner ist. Eine Rechnungs- oder Lieferadresse wird auch als Adresskontakt angegeben. Wird dieses Feld angegeben, muss die Id des gewünschten Adresstyps angegeben, die der Adresstyp in xPress hat.uniqueidentifier
addressTypeNameWenn der Parameter addressTypeId nicht bekannt ist, kann stattdessen durch diesen Parameter mit der Bezeichnung nach dem gewünschten Adresstyp gesucht werden.nvarchar(50)
companyGibt die Bezeichnung der Firma an. Ist dieser Parameter definiert, wird der Adresse als Rechtsform automatisch der Typ Geschäftlich zugewiesen. Die Rechtsform kann mit dem Paramter **legalFormId** explizit gesetzt werden.nvarchar(150)Nur wenn Vor- und Nachname nicht definiert.
firstNameDefiniert den Vorname der Adresse. Zusätzlich muss auch der Nachname verpflichtend angegeben werden. Ist dieser Parameter definiert, wird der Adresse als Rechtsform automatisch der Typ Person zugewiesen. Die Rechtsform kann mit dem Paramter **legalFormId** explizit gesetzt werden.nvarchar(100)Nur wenn Firma nicht definiert
lastNameDefiniert den Nachname der Adresse. Zusätzlich muss auch der Vorname verpflichtend angegeben werden. Ist dieser Parameter definiert, wird der Adresse als Rechtsform automatisch der Typ Geschäftlich zugewiesen. Die Rechtsform kann mit dem Paramter **legalFormId** explizit gesetzt werden.nvarchar(100)Nur wenn Firma nicht definiert
streetGibt die Strasse der Adresse an.nvarchar(100)
cityIdGibt Id des Ortes der Adresse an.uniqueidentifier
zipCodeIst die Id des Ortes (cityId) nicht bekannt, kann anhand diesem Parameter nach einer Postleitzahl gesucht werden. Zusätzlich muss noch der Parameter city angegeben werden.nvarchar(10)
cityDieser Parameter definiert die Bezeichnung des Ortes, wenn dessen Id (cityId) nicht bekannt ist. In Kombination mit dem Parameter zipCode wird nach dem Ort gesucht.nvarchar(100)
phoneNumber1Definiert die erste Telefonnummer.nvarchar(50)
phoneText1Definiert die Beschreibung zur ersten Telefonnummer, z.B. geschäftlich, mobil…nvarchar(100)
phoneNumber2Definiert die zweite Telefonnummer.nvarchar(50)
phoneText2Definiert die Beschreibung zur zweiten Telefonnummer, z.B. geschäftlich, mobil…nvarchar(100)
phoneNumber3Definiert die dritte Telefonnummer.nvarchar(50)
phoneText3Definiert die Beschreibung zur dritten Telefonnummer, z.B. geschäftlich, mobil…nvarchar(100)
faxNumberDefiniert die Faxnummer der Adresse.nvarchar(50)
emailDefiniert die Emailadresse.nvarchar(100)
websiteDefiniert die Website der Adresse.nvarchar(100)
vartaxNoDefiniert die UID - Nummer der Adresse. Dieser Parameter ist nur bei geschäftlichen Adressen relevant. Aus dem Prefix und der hier definierten Nummer ergibt sich dann die vollständige UID - Nummer. Aus diesem Grund darf das zweistellige Länderkennzeichen hier nicht mit angegeben werden. Dafür ist das Prefix vorgesehen.nvarchar(50)
vartaxNoPrefixDefiniert das Prefix der UID - Nummer.nvarchar(2)
registerNoDefiniert die Steuernummer der Adresse. Diese ist nur bei Privatpersonen relevant.nvarchar(50)
customerNoDefiniert die Kundennnummer der Adresse. Diese kann frei verwendet werden. Bei einigen Schnittstellen (z.B. Buchhaltung) wird auf dieses Feld zurückgegriffen.nvarchar(50)
vendorNoDefiniert die Lieferantennummer der Adresse. Diese kann frei verwendet werden. Bei einigen Schnittstellen (z.B. Buchhaltung, digitale Bestellung) wird auf dieses Feld zurückgegriffen.nvarchar(50)
vendorClientNoDefiniert die Lieferanten Kundennummer der Adresse. Diese kann frei verwendet werden. Bei einigen Schnittstellen (z.B. Buchhaltung) wird auf dieses Feld zurückgegriffen.nvarchar(50)
addressGroupIdGibt die Id der Adressgruppe, die dieser Adresse zugewiesen werden soll. Die Adressgruppe gibt an, ob die Adresse ein Kunde, Lieferant, Mitarbeiter usw. ist.uniqueidentifierx
addressGroupNameIst die Id der Adressgruppe nicht bekannt, kann mit diesem Parameter nach der Bezeichnung nach einer Adressgruppe gesucht werden.nvarchar(100)wenn der Parameter addressGroupId nicht definiert ist. Wird keine Adressgruppe gefunden, wird nach der Adressgruppe gesucht, die in xPress als Standard definiert wurde.
conditionIdGibt die Id der Zahlungskondition an.uniqueidentifier
conditionNameIst die Id der Zahlungskondition nicht bekannt, kann mit diesem Parameter nach der Nummer oder Bezeichnung der Zahlungskondition gesucht werden. Wird keine Kondition gefunden, wird nach der Kondition gesucht, die in xPress als Standard definiert wurde.nvarchar(50)
taxIdDefiniert die Id der Steuer der Adresse.uniqueidentifier
taxNameIst die Id der Steuer nicht bekannt, kann mit diesem Parameter nach der Bezeichnung der Steuer gesucht werden. Wird keine Steuer gefunden, wird noch nach der Steuer gesucht, die in xPress als Standard hinterlegt wurde.nvarchar(100)
brancheIdGibt die Id der Branche der Adresse an.uniqueidentifier
brancheNameIst die Id der Branche nicht bekannt, kann mit diesem Parameter nach der Nummer oder Bezeichnung der Branche gesucht werden.nvarchar(100)

legalFormId

Gibt die Id der Rechtsform der Adresse an. Diese wird standardmäßig richtig zugewiesen, je nach dem, ob die Firma oder Vor- und Nachname der Adresse definiert ist. Dieser Vorschlag kann mir diesem Parameter allerdings überschrieben werden.uniqueidentifier
legalFormNameIst die Id der Rechtsform nicht bekannt, kann mit diesem Parameter nach der Nummer oder der Bezeichnung der Rechtsform gesucht werden.nvarchar(100)
descriptionDefniert eine allgemeine Beschreibung für die Adresse.nvarchar(max)
updateIfExistsGibt an, ob ein bereits bestehender Artikel mit den angegebenen Daten aktualisiert werden soll oder nicht.bit
createdByGibt den Namen an, welcher diese Methode aufruft. Dieser Wert wird in die Spalte UserCreated geschrieben, um nachvollziehen zu können, wer diesen Artikel erzeugt hat.nvarchar(30)x
camid/sql/sp_createnewaddress.txt · Zuletzt geändert: 2021/07/01 09:57 von Benjamin Marzoner