CRM Interface

Grundlegende Informationen zum Paket finden Sie unter Erste Schritte CRM.

CRM und DMS → Stammdaten → Einstellungen → CRM Interface

Beim CRM Interface handelt es sich um eine Funktionalität zum Stammdatenaustausch zwischen einem Fremdsystem und NTCS. Dieses Fenster dient zur Darstellung der Inhalte aus der Tabelle BUERO.AEN_AENDERUNGCRM. Diese Tabelle wird als "Drehscheibe" für den Datenaustausch verwendet.

Hinweis

Dieses Fenster sowie dessen Funktionen sind ausschließlich für Administratoren gedacht!

Systematik / Ablauf

Das CRM Interface bietet folgende Funktionen:

Eine "Stored-Procedure" (SQL-Server-Programm), mit der ein Fremdprogramm Einträge in die Tabelle BUERO.AEN_AENDERUNGCRM erstellen kann. Die Inhalte können in diesem Fenster angezeigt werden.
Eine "Stored-Procedure", mit der ein Programm (BMD-Makro) diese Daten auslesen kann.
Eine "Stored-Procedure", mit der man einem Datensatz ein Statusfeld ("erledigt") setzen kann.

Stored-Procedures in NTCS

Bei einer "Stored-Procedure" handelt es sich um eine Funktion in Datenbankmanagementsystemen, mit der ganze Abläufe von Anweisungen vom Datenbank-Client aufgerufen werden können. Sie ist somit ein eigenständiger Befehl, der wiederum eine Abfolge von gespeicherten Befehlen ausführt.

In jeder BMD-Datenbank sind schon bestimmte Stored-Procedures enthalten. Sie können von einem Fremdsystem mit einem SQL-Benutzer mit entsprechenden Rechten über den SQL-Befehl EXEC ausgeführt werden. Für den Datenaustausch von Stammdaten mit einem Fremdsystem sind folgende Stored-Procedures relevant:

Einfügen eines AEN-Datensatzes in die Tabelle BUERO.AEN_AENDERUNGCRM:

CREATE PROCEDURE [BUERO].[SPBMD_AEN_INSERT]
       (
       @DMLTYPE INT,
       @DESTINATION INT,
       @ENTITY_TYPE INT,
       @GUID NVARCHAR(36),
       @TEXTDATA BMD_BIGSTRING,
       @ERRORCODE INT = NULL,
       @FIRMENNR BIGINT = NULL,
       @PERSONENID NVARCHAR(16) = NULL,
       @KONTAKT_FIRMENNR BIGINT = NULL,
       @KONTAKT_PERSONENID NVARCHAR(16) = NULL,
       @KONTAKTLFDNR INT = NULL,
       @PROJEKT_FIRMENNR BIGINT = NULL,
       @PROJEKTNR BIGINT = NULL,
       @PROJEKTTYP INT = NULL,
       @ADRESSLFDNR BIGINT = NULL)

Folgende Ausprägungen können in die Datenbankfelder übergeben werden:

DMLTYPE	0 = nicht definiert (ist für bestehende Datensätze notwendig) 1 = Insert 2 = Update
DESTINATION	0 = BMD --> Fremdsystem 1 = Fremdsystem --> BMD
ENTITY_TYPE	0 = nicht definiert 1 = Kunde 2 = Zusatzadresse 3 = Kontaktperson 4 = Kontaktzuordnung 5 = Gesellschafter 6 = Projekt
GUID	ID aus dem Fremdsystem
ERRORCODE	Nummer von zwischen Schnittstellenprogrammierern festgelegten Fehlermeldungen (nicht vorgegeben)
@TEXTDATA	Datencontainer mit beliebigen Daten (zum jeweiligen ENTITY_TYPE passend); kann auch eine XML-Struktur enthalten

Beispiel

EXEC BUERO.SPBMD_AEN_INSERT 1, 1, 1, '1234567890-1234567890', '<BUERO.PER_PERSON PER_FIRMENNR="1" PER_PERSONENNR="201001" PER_NAME="TEST" PER_UIDNR="ATU12345678"/>'

Dieses Beispiel schickt einen Datensatz für den Insert eines Kunden aus einem Fremdsystem nach BMD. Die GUID des Kunden im Fremdsystem ist '1234567890-1234567890'. Die Daten des Kunden sind in einer XML verpackt, die von einem BMD-Importmakro verwertet werden kann <BUERO.PER_PERSON PER_FIRMENNR="1" PER_PERSONENNR="201001" PER_NAME="TEST" PER_UIDNR="ATU12345678"/>

Erledigen eines AEN-Datensatzes in der Tabelle BUERO.AEN_AENDERUNGCRM:

CREATE PROC BUERO.SPBMD_AEN_COMPLETE (@AENID BIGINT)

Beispiel

EXEC BUERO.SPBMD_AEN_COMPLETE 27497441

Dieses Beispiel markiert den (durch ein Makro erfolgreich importierten) Datensatz mit der laufenden Nummer (AEN_AENDERUNGCRMID) 27497441 als erledigt. Das AEN_VERARBEITETKZ wird durch die Stored-Procedure von 0 auf 1 gesetzt.