---
title: "MBCS_Referenz_Extern"
topicId: "Webservice_MBCS_Referenz_Extern"
contextId: 307
editionen: [server]
description: "Beschreibung des ASMX-Webservices MBCS_Referenz_Extern für den Abruf der MultiBaseCS-Referenzlisten."
status: aktualisiert
version: "5.4"
---
URL des Webservices:

[https://service.34u.de/MBCS\_Referenz\_Extern.asmx](https://service.34u.de/MBCS_Referenz_Extern.asmx)

Mit diesem Webservice rufen Sie die MultiBaseCS-Referenzlisten ab, zum Beispiel um sie in eigenen Anwendungen aktuell zu halten. Bei jedem Aufruf übergeben Sie die Kennung Ihrer Anwendung (GUID\_Application).

Neben den unten beschriebenen Funktionen bietet der Webservice weitere, zum Beispiel für die Ortssuche (Ortssuche\_GetOrte, Ortssuche\_NearestName). Eine Übersicht aller Funktionen zeigt die Adresse des Webservices im Browser.

:::tip
Für neue Anwendungen empfehlen wir die [MultiBaseCS GraphQL-API](/entwickler). Sie bietet ebenfalls Zugriff auf die Referenzlisten.
:::

## Funktionen

### CheckApplication

| | |
| --- | --- |
| Beschreibung | Gibt den Status an, ob es sich um eine gültige Applikation handelt. |
| Argumente | GUID\_Application: Schlüssel für die aufrufende Anwendung |
| Rückgabewerte | True: Applikation ist gültig<br />False: Applikation ist nicht gültig |

### GetCount

| | |
| --- | --- |
| Beschreibung | Gibt die Anzahl der neuen Zeilen mit neueren Referenzdatenbeständen für eine Referenztabelle zurück. Es werden alle Daten gezählt, die eine höhere ID\_Version als LastIDVersion oder bei gleicher ID\_Version eine höhere ID\_Value als LastIDValue aufweisen. |
| Argumente | GUID\_Application: Schlüssel für die aufrufende Anwendung<br />TableName: Tabellenname der Referenztabelle<br />LastIDVersion: Höchste bisher vorhandene ID\_Version aller Datensätze in der Referenztabelle<br />LastIDValue: Höchste bisher vorhandene ID\_Value aller Datensätze in der Referenztabelle mit der höchsten bisher vorhandenen ID\_Version |
| Hinweise | Sind bisher keine Datensätze in der Referenztabelle vorhanden, müssen für LastIDVersion und LastIDValue die Werte 0 übergeben werden.<br />Die Werte aus ID\_Value müssen aus dem ID-Feld der Referenztabelle entnommen werden. Die entsprechenden Informationen lassen sich über den Aufruf von GetReferenzTables ermitteln. |
| Rückgabewerte | Anzahl der Zeilen mit neueren Referenzdatenbeständen. |

### GetDataFromIDList

| | |
| --- | --- |
| Beschreibung | Gibt Datenzeilen für eine Referenztabelle zurück. Es werden alle Datenzeilen zurückgegeben, die im jeweiligen ID-Feld der Referenztabelle einen der Werte aus IDValueList aufweisen. IDValueList enthält die Werte als kommaseparierte Liste. |
| Argumente | GUID\_Application: Schlüssel für die aufrufende Anwendung<br />TableName: Tabellenname der Referenztabelle<br />IDValueList: Kommaseparierte Liste mit Werten aus dem ID-Feld der Referenztabelle |
| Hinweise | Die Werte aus IDValueList müssen aus dem ID-Feld der Referenztabelle entnommen werden. Die entsprechenden Informationen lassen sich über den Aufruf von GetReferenzTables ermitteln. |
| Rückgabewerte | System.Data.Dataset mit einer System.Data.DataTable mit den angeforderten Werten. |

### GetDataFromIDList\_JSON

| | |
| --- | --- |
| Beschreibung | Gibt Datenzeilen für eine Referenztabelle als JSON-String zurück. Es werden alle Datenzeilen zurückgegeben, die im jeweiligen ID-Feld der Referenztabelle einen der Werte aus IDValueList aufweisen. IDValueList enthält die Werte als kommaseparierte Liste. |
| Argumente | GUID\_Application: Schlüssel für die aufrufende Anwendung<br />TableName: Tabellenname der Referenztabelle<br />IDValueList: Kommaseparierte Liste mit Werten aus dem ID-Feld der Referenztabelle |
| Hinweise | Die Werte aus IDValueList müssen aus dem ID-Feld der Referenztabelle entnommen werden. Die entsprechenden Informationen lassen sich über den Aufruf von GetReferenzTables ermitteln. |
| Rückgabewerte | JSON-String mit den angeforderten Werten. |

### GetDataFromIDVersion

| | |
| --- | --- |
| Beschreibung | Gibt Datenzeilen für eine Referenztabelle zurück. Es werden alle Daten zurückgegeben, die eine höhere ID\_Version als LastIDVersion oder bei gleicher ID\_Version eine höhere ID\_Value als LastIDValue aufweisen. CountItems gibt die Anzahl der maximal zurückzugebenden Elemente an. |
| Argumente | GUID\_Application: Schlüssel für die aufrufende Anwendung<br />TableName: Tabellenname der Referenztabelle<br />LastIDVersion: Höchste bisher vorhandene ID\_Version aller Datensätze in der Referenztabelle<br />LastIDValue: Höchste bisher vorhandene ID\_Value aller Datensätze in der Referenztabelle mit der höchsten bisher vorhandenen ID\_Version<br />CountItems: Anzahl der zu übermittelnden Datenzeilen |
| Hinweise | Sind bisher keine Datensätze in der Referenztabelle vorhanden, müssen für LastIDVersion und LastIDValue die Werte 0 übergeben werden.<br />Die Werte aus ID\_Value müssen aus dem ID-Feld der Referenztabelle entnommen werden. Die entsprechenden Informationen lassen sich über den Aufruf von GetReferenzTables ermitteln.<br />Die Datensätze werden sortiert nach ID\_Version und ID\_Value zurückgegeben.<br />Für den kompletten Download des Referenzdatenbestandes einer Referenztabelle sind in Abhängigkeit der Anzahl der neuen Datenzeilen und CountItems mehrere Aufrufe dieser Schnittstelle nötig. |
| Rückgabewerte | System.Data.Dataset mit einer System.Data.DataTable mit den angeforderten Werten. |

### GetIDFromValue

| | |
| --- | --- |
| Beschreibung | Gibt eine gültige MultiBaseCS-Referenz ID für einen Textwert zurück. Kann für den übergebenen Wert keine ID ermittelt werden, wird der Wert 0 zurückgegeben. |
| Argumente | GUID\_Application: Schlüssel für die aufrufende Anwendung<br />TableName: Tabellenname der Referenztabelle<br />Value: Zu prüfender Textwert<br />ID\_Kategorie: ID\_Kategorie der Beobachtung<br />ID\_Modul: ID\_Modul der Beobachtung |
| Hinweise | Der Referenzwert wird durch Übereinstimmung mit einem textlichen Feld der Referenztabelle ermittelt.<br />Bei mehreren übereinstimmenden Werten wird eine kommaseparierte Liste zurückgegeben.<br />Das Feld ID\_Kategorie dient bei der Abfrage der "tblArten" zur Einschränkung der Suche auf eine bestimmte Kategorie.<br />Bei anderen Referenztabellen wird das Feld ID\_Kategorie zur Prüfung der Gültigkeit herangezogen. Wird der Wert ID\_Kategorie für eine Tabelle mit einer Kategorieeinschränkung mit 0 übergeben, wird als Result ebenfalls 0 zurückgegeben.<br />Der Wert ID\_Modul kann übergeben werden, um Referenzwerte mit einer Modulgültigkeit abzufragen. In diesem Fall wird der Wert in ID\_Kategorie ignoriert. |
| Rückgabewerte | String mit einem oder mehreren Refrenz-IDs. |

### GetDataFromIDVersion\_JSON

| | |
| --- | --- |
| Beschreibung | Gibt Datenzeilen für eine Referenztabelle als JSON-String zurück. Es werden alle Daten zurückgegeben, die eine höhere ID\_Version als LastIDVersion oder bei gleicher ID\_Version eine höhere ID\_Value als LastIDValue aufweisen. CountItems gibt die Anzahl der maximal zurückzugebenden Elemente an. |
| Argumente | GUID\_Application: Schlüssel für die aufrufende Anwendung<br />TableName: Tabellenname der Referenztabelle<br />LastIDVersion: Höchste bisher vorhandene ID\_Version aller Datensätze in der Referenztabelle<br />LastIDValue: Höchste bisher vorhandene ID\_Value aller Datensätze in der Referenztabelle mit der höchsten bisher vorhandenen ID\_Version<br />CountItems: Anzahl der zu übermittelnden Datenzeilen |
| Hinweise | Sind bisher keine Datensätze in der Referenztabelle vorhanden, müssen für LastIDVersion und LastIDValue die Werte 0 übergeben werden.<br />Die Werte aus ID\_Value müssen aus dem ID-Feld der Referenztabelle entnommen werden. Die entsprechenden Informationen lassen sich über den Aufruf von GetReferenzTables ermitteln.<br />Die Datensätze werden sortiert nach ID\_Version und ID\_Value zurückgegeben.<br />Für den kompletten Download des Referenzdatenbestandes einer Referenztabelle sind in Abhängigkeit der Anzahl der neuen Datenzeilen und CountItems mehrere Aufrufe dieser Schnittstelle nötig. |
| Rückgabewerte | System.Data.Dataset mit einer System.Data.DataTable mit den angeforderten Werten. |

### GetReferenzTables

| | |
| --- | --- |
| Beschreibung | Gibt eine Liste von gültigen Referenztabellen zurück. |
| Argumente | GUID\_Application: Schlüssel für die aufrufende Anwendung |
| Rückgabewerte | System.Data.Dataset mit einer System.Data.DataTable mit den angeforderten Werten. |

### GetReferenzTables\_JSON

| | |
| --- | --- |
| Beschreibung | Gibt eine Liste von gültigen Referenztabellen als JSON-String zurück. |
| Argumente | GUID\_Application: Schlüssel für die aufrufende Anwendung |
| Rückgabewerte | System.Data.Dataset mit einer System.Data.DataTable mit den angeforderten Werten. |