Ermittelt definierte (und i.d.R. einem Personen-Typ bereits zugeordnete) Merkmale, zu denen Personen Eigenschaften/Details besitzen können
Anmerkung zum Parameter „NotInPersonCharacsInCats“ :
Dieser Parameter wird GAR NICHT beachtet, wenn entweder
oder
Ansonsten gilt : Ist „NotInPersonCharacsInCats“…
Anmerkung zur Rückgabespalte „Modify“ :
Gibt an, ob der spezielle Benutzer „publicuser“ („UserID = 0“, s. mi_GetUserInfo_Ad) Eigenschaften/Details zum Merkmal „ID“ ÄNDERN darf bzw. eingeschränkt ändern darf. Falls der „PersonTypeSettings“-Eintrag (zur „PersonTypeID = 0“) zum Schlüssel „PCharacsBackwardCompatible“ auf „1“ gesetzt ist, hat dieser Wert die Bedeutung, ob Änderungen mit z.B. pm_InsertNewPerson_Pu oder pm_ModifyPersonData_Pu (egal welcher Benutzer sie ausführt) möglich bzw. eingeschränkt erlaubt sind. Mögliche Werte :
Anmerkung zur Rückgabespalte „Visible“ :
Wird hier eine „0“ ausgegeben, werden in Prozeduren, die vom Benutzer „publicuser“ („UserID = 0“, s. mi_GetUserInfo_Ad) ausgeführt werden, KEINE Eigenschaften/Details bzw. nur „Teile von Eigenschaften“ (s. Rückgabespalte „ReadAccessRestrictionPattern“) zum Merkmal „ID“ ausgegeben. Falls der „PersonTypeSettings“-Eintrag (zur „PersonTypeID = 0“) zum Schlüssel „PCharacsBackwardCompatible“ auf „1“ gesetzt ist, hat dieser Wert die Bedeutung, daß in „public“-Prozeduren KEINE Eigenschaften/Details bzw. nur „Teile von Eigenschaften“ zum Merkmal „ID“ ausgegeben werden.
Anmerkung zur Rückgabespalte „ReadAccessRestrictionPattern“ :
Immer „NULL“ wenn „Visible = 1“ ist. Falls hier ein Wert zurückkommt, bedeutet dies, daß der „publicuser“ („UserID = 0“, s. mi_GetUserInfo_Ad) den Teil von Eigenschaften zum Merkmal „ID“ einsehen darf, der diesem „pattern“ entspricht (für Details bedeutungslos). Derzeit mögliche Werte :
Beispielsweise bedeutet „#left(4)#“, daß nur (maximal) die ERSTEN 4 Zeichen der Eigenschaft zurückgeliefert werden.
HTTP-Method | GET |
HTTP-Auth | Optional |
Tags | |
Engine-Kategorie | person management |
Engine-Typ | Daten-Ermittlung |
Letzte Aktualisierung | 7.0.7 (2015-01-29) |
Name 1) | Standard-Wert | Beschreibung 2) | SQL-Datentyp3) | ab Version |
---|---|---|---|---|
PersonTypeID | 1 | ID eines Personen-Typs, nach dem gefiltert werden kann (siehe Beschreibung : Anmerkung zum Parameter „NotInPersonCharacsInCats“ !) | tinyint | 3.5.0 |
PersonCharacCategoryID | NULL | ID einer Kategorie von Personen-Merkmalen, nach der gefiltert werden kann (siehe Beschreibung : Anmerkung zum Parameter „NotInPersonCharacsInCats“ !) | tinyint | 3.5.0 |
NotInPersonCharacsInCats | 1 | Siehe Beschreibung : Anmerkung zum Parameter „NotInPersonCharacsInCats“ ! | tinyint | 3.5.20 |
PersonCharacteristicID | NULL | ID eines Personen-Merkmals. Wenn angegeben, wird nur der Datensatz zu diesem Merkmal ausgegeben. | smallint | 3.5.20 |
Spaltenname | Beschreibung | SQL-Datentyp4) | ab Version |
---|---|---|---|
ID | ID eines Personen-Merkmals. Besteht für ein Merkmal eine komplett lesende Zugriffsbeschränkung (s. pm_GetPChAccRestrForUsers_Ad) für den Aufrufer, FEHLT der entsprechende Datensatz im Ergebnis ! | smallint | 3.5.20 |
Description | Bezeichnung des Personen-Merkmals „ID“ | varchar(100) | 3.5.20 |
DescriptionForAdmin | Bezeichnung der „ID“ für den Administrator. Hintergrund : Merkmale, die von der Bezeichnung her identisch sind, und für einen Administrator bei Konfigurierungen nicht auseinander zu halten wären. | varchar(100) | 3.5.22 |
FieldTypeID | ID eines „Feld-Typs“, von dem alle Eigenschaften des Merkmals „ID“ sein müssen (z.B. „Text mit maximal 20 Zeichen“) | tinyint | 3.5.20 |
FieldTypeDescription | Bezeichnung des Datentyps „FieldTypeID“ | varchar(100) | 3.5.20 |
BasicFieldTypeID | ID des Basis-Feld-Typs, der „FieldTypeID“ zugrunde liegt (siehe auch mi_GetFieldTypes_Ad) | tinyint | 3.5.20 |
BasicFieldType | Bezeichnung des Basis-Feld-Typs (z.B. „Zahl“) | varchar(20) | 3.5.20 |
MaxLength | Maximale Anzahl Zeichen, die Eigenschaften/Werte zum Merkmal „ID“ haben dürfen | tinyint | 3.5.20 |
PrecisionValue | Gilt nur für Datentypen mit Basis-Daten-Typ „Zahl“ und gibt die Anzahl erlaubter Nachkommastellen an, die in Eigenschaften zum Merkmal „ID“ vorkommen dürfen. | tinyint | 3.5.20 |
Format | Von welchem „Format“ (so etwas wie ein regulären Ausdruck) müssen die Eigenschaften zum Merkmal „ID“ sein. Derzeit nicht implementiert und verwendet ! | varchar(255) | 3.5.20 |
Required | Wird hier eine „1“ ausgegeben, bedeutet das folgendes : Jede Person eines Personen-Typs, dem das Merkmal „ID“ zugewiesen ist, MUSS eine Eigenschaft zum Merkmal „ID“ angeben, ansonsten kann die Person nicht angelegt werden. | bit | 3.5.20 |
PredefinedValues | Hat das Merkmal „ID“ nur vordefinierte Werte („0“ : Nein, „1“ : Ja) ? | bit | 3.5.20 |
Required_CharacCategory | Falls „1“, so MUSS eine Person, die eine Angabe zu wenigstens einem Merkmal der Kategorie „PersonCharacCategoryID“ macht, auf JEDEN FALL auch eine Angabe zu Merkmal „ID“ machen. (Falls „Required = 1“ ist, steht hier auch IMMER eine „1“) | bit | 3.5.20 |
IsUnique | Falls „1“, darf eine bestimmte Eigenschaft zum Merkmal „ID“ nur EINER EINZIGEN Person zugewiesen werden | bit | 3.5.20 |
Modify | Dürfen „publicuser“/„Pu“-Prozed. Eigensch.-Änderung. vornehmen ? - „0“ : Nein - „1“ : Ja - „2“ : Nur Neu-Anlage - „3“ : Nur Ändern - „4“ : Nur Neu-Anlage u. Ändern - „5“ : Nur Löschen - „6“ : Nur Neu-Anlage u. Löschen - „7“ : Nur Ändern u. Löschen | tinyint | 3.5.20 |
Visible | Wenn „0“, werden durch vom „publicuser“ ausgeführte Prozeduren bzw. durch „Pu“-Prozeduren (z.B. pm_GetPersonProperties_Pu) KEINE Eigenschaften/Details bzw. nur Teile von Eigenschaften (s. „ReadAccessRestrictionPattern“) zur „ID“ ausgegeben | bit | 3.5.20 |
ReadAccessRestrictionPattern | „NULL“ wenn „Visible = 1“. Welch. Teil v. Eigensch. zu „ID“ für den „publicuser“ ausgegeben werden : - „#left(<n>)#“ : die ERSTEN n Zeichen („n = 0“ mögl.) - „#right(<n>)#“ : die LETZTEN n Zeichen („n = 0“ mögl.) - NULL : Datensätze zu „ID“ fehlen ganz | varchar(100) | 6.5.2 |
SortNo | Bestimmt die Reihenfolge des Merkmals „ID“ innerhalb aller Merkmale | smallint | 3.5.20 |
PersonCharacCategoryID | ID einer Kategorie von Personen-Merkmalen, der das Merkmal „ID“ zugeordnet ist | tinyint | 3.5.20 |
CategoryDescription | Bezeichnung der Kategorie „PersonCharacCategoryID“ | varchar(100) | 3.5.20 |
Spaltenname | Beschreibung | SQL-Datentyp5) | ab Version |
---|---|---|---|
ID | ID eines Personen-Merkmals. Besteht für ein Merkmal eine komplett lesende Zugriffsbeschränkung (s. pm_GetPChAccRestrForUsers_Ad) für den Aufrufer, FEHLT der entsprechende Datensatz im Ergebnis ! | smallint | 3.5.20 |
Description | Bezeichnung des Personen-Merkmals „ID“ | varchar(100) | 3.5.20 |
DescriptionForAdmin | Bezeichnung der „ID“ für den Administrator. Hintergrund : Merkmale, die von der Bezeichnung her identisch sind, und für einen Administrator bei Konfigurierungen nicht auseinander zu halten wären. | varchar(100) | 3.5.22 |
FieldTypeID | ID eines „Feld-Typs“, von dem alle Eigenschaften des Merkmals „ID“ sein müssen (z.B. „Text mit maximal 20 Zeichen“) | tinyint | 3.5.20 |
FieldTypeDescription | Bezeichnung des Datentyps „FieldTypeID“ | varchar(100) | 3.5.20 |
BasicFieldTypeID | ID des Basis-Feld-Typs, der „FieldTypeID“ zugrunde liegt (siehe auch mi_GetFieldTypes_Ad) | tinyint | 3.5.20 |
BasicFieldType | Bezeichnung des Basis-Feld-Typs (z.B. „Zahl“) | varchar(20) | 3.5.20 |
MaxLength | Maximale Anzahl Zeichen, die Eigenschaften/Werte zum Merkmal „ID“ haben dürfen | tinyint | 3.5.20 |
PrecisionValue | Gilt nur für Datentypen mit Basis-Daten-Typ „Zahl“ und gibt die Anzahl erlaubter Nachkommastellen an, die in Eigenschaften zum Merkmal „ID“ vorkommen dürfen. | tinyint | 3.5.20 |
Format | Von welchem „Format“ (so etwas wie ein regulären Ausdruck) müssen die Eigenschaften zum Merkmal „ID“ sein. Derzeit nicht implementiert und verwendet ! | varchar(255) | 3.5.20 |
Required | Wird hier eine „1“ ausgegeben, bedeutet das folgendes : Jede Person eines Personen-Typs, dem das Merkmal „ID“ zugewiesen ist, MUSS eine Eigenschaft zum Merkmal „ID“ angeben, ansonsten kann die Person nicht angelegt werden. | bit | 3.5.20 |
PredefinedValues | Hat das Merkmal „ID“ nur vordefinierte Werte („0“ : Nein, „1“ : Ja) ? | bit | 3.5.20 |
Required_CharacCategory | Hier steht z.Zt. immer eine „0“. Diese Rückgabespalte gibt es deswegen, weil es evtl. möglich sein soll (über einen weiteren Parameter dann), in diesem Fall das Merkmal zusammen mit ALLEN Kategorien, denen es zugeordnet ist, auszugeben. | bit | 3.5.20 |
IsUnique | Falls „1“, darf eine bestimmte Eigenschaft zum Merkmal „ID“ nur EINER EINZIGEN Person zugewiesen werden | bit | 3.5.20 |
Modify | Dürfen „publicuser“/„Pu“-Prozed. Eigensch.-Änderung. vornehmen ? - „0“ : Nein - „1“ : Ja - „2“ : Nur Neu-Anlage - „3“ : Nur Ändern - „4“ : Nur Neu-Anlage u. Ändern - „5“ : Nur Löschen - „6“ : Nur Neu-Anlage u. Löschen - „7“ : Nur Ändern u. Löschen | tinyint | 3.5.20 |
Visible | Wenn „0“, werden durch vom „publicuser“ ausgeführte Prozeduren bzw. durch „Pu“-Prozeduren (z.B. pm_GetPersonProperties_Pu) KEINE Eigenschaften/Details bzw. nur Teile von Eigenschaften (s. „ReadAccessRestrictionPattern“) zur „ID“ ausgegeben | bit | 3.5.20 |
ReadAccessRestrictionPattern | „NULL“ wenn „Visible = 1“. Welch. Teil v. Eigensch. zu „ID“ für den „publicuser“ ausgegeben werden : - „#left(<n>)#“ : die ERSTEN n Zeichen („n = 0“ mögl.) - „#right(<n>)#“ : die LETZTEN n Zeichen („n = 0“ mögl.) - NULL : Datensätze zu „ID“ fehlen ganz | varchar(100) | 6.5.2 |
SortNo | Bestimmt die Reihenfolge des Merkmals „ID“ innerhalb aller Merkmale | smallint | 3.5.20 |
Spaltenname | Beschreibung | SQL-Datentyp6) | ab Version |
---|---|---|---|
ID | ID eines Personen-Merkmals. Besteht für ein Merkmal eine komplett lesende Zugriffsbeschränkung (s. pm_GetPChAccRestrForUsers_Ad) für den Aufrufer, FEHLT der entsprechende Datensatz im Ergebnis ! | smallint | 3.5.0 |
Description | Bezeichnung des Personen-Merkmals „ID“ | varchar(100) | 3.5.0 |
DescriptionForAdmin | Bezeichnung der „ID“ für den Administrator. Hintergrund : Merkmale, die von der Bezeichnung her identisch sind, und für einen Administrator bei Konfigurierungen nicht auseinander zu halten wären. | varchar(100) | 3.5.22 |
FieldTypeID | ID eines „Feld-Typs“, von dem alle Eigenschaften des Merkmals „ID“ sein müssen (z.B. „Text mit maximal 20 Zeichen“) | tinyint | 3.5.0 |
FieldTypeDescription | Bezeichnung des Datentyps „FieldTypeID“ | varchar(100) | 3.5.0 |
BasicFieldTypeID | ID des Basis-Feld-Typs, der „FieldTypeID“ zugrunde liegt (siehe auch mi_GetFieldTypes_Ad) | tinyint | 3.5.0 |
BasicFieldType | Bezeichnung des Basis-Feld-Typs (z.B. „Zahl“) | varchar(20) | 3.5.0 |
MaxLength | Maximale Anzahl Zeichen, die Eigenschaften/Werte zum Merkmal „ID“ haben dürfen | tinyint | 3.5.0 |
PrecisionValue | Gilt nur für Datentypen mit Basis-Daten-Typ „Zahl“ und gibt die Anzahl erlaubter Nachkommastellen an, die in Eigenschaften zum Merkmal „ID“ vorkommen dürfen. | tinyint | 3.5.0 |
Format | Von welchem „Format“ (so etwas wie ein regulären Ausdruck) müssen die Eigenschaften zum Merkmal „ID“ sein. Derzeit nicht implementiert und verwendet ! | varchar(255) | 3.5.0 |
Required | Wird hier eine „1“ ausgegeben, bedeutet das folgendes : Jede Person eines Personen-Typs, dem das Merkmal „ID“ zugewiesen ist, MUSS eine Eigenschaft zum Merkmal „ID“ angeben, ansonsten kann die Person nicht angelegt werden. | bit | 3.5.0 |
PredefinedValues | Hat das Merkmal „ID“ nur vordefinierte Werte („0“ : Nein, „1“ : Ja) ? | bit | 3.5.0 |
Required_CharacCategory | Falls „1“, so MUSS eine Person, die eine Angabe zu wenigstens einem Merkmal der Kategorie „PersonCharacCategoryID“ macht, auf JEDEN FALL auch eine Angabe zu Merkmal „ID“ machen. (Falls „Required = 1“ ist, steht hier auch IMMER eine „1“) | bit | 3.5.0 |
IsUnique | Falls „1“, darf eine bestimmte Eigenschaft zum Merkmal „ID“ nur EINER EINZIGEN Person zugewiesen werden | bit | 3.5.0 |
Modify | Dürfen „publicuser“/„Pu“-Prozed. Eigensch.-Änderung. vornehmen ? - „0“ : Nein - „1“ : Ja - „2“ : Nur Neu-Anlage - „3“ : Nur Ändern - „4“ : Nur Neu-Anlage u. Ändern - „5“ : Nur Löschen - „6“ : Nur Neu-Anlage u. Löschen - „7“ : Nur Ändern u. Löschen | tinyint | 3.5.0 |
Visible | Wenn „0“, werden durch vom „publicuser“ ausgeführte Prozeduren bzw. durch „Pu“-Prozeduren (z.B. pm_GetPersonProperties_Pu) KEINE Eigenschaften/Details bzw. nur Teile von Eigenschaften (s. „ReadAccessRestrictionPattern“) zur „ID“ ausgegeben | bit | 3.5.0 |
ReadAccessRestrictionPattern | „NULL“ wenn „Visible = 1“. Welch. Teil v. Eigensch. zu „ID“ für den „publicuser“ ausgegeben werden : - „#left(<n>)#“ : die ERSTEN n Zeichen („n = 0“ mögl.) - „#right(<n>)#“ : die LETZTEN n Zeichen („n = 0“ mögl.) - NULL : Datensätze zu „ID“ fehlen ganz | varchar(100) | 6.5.2 |
SortNo | Bestimmt die Reihenfolge des Merkmals „ID“ innerhalb aller Merkmale | smallint | 3.5.0 |
PersonCharacCategoryID | ID einer Kategorie von Personen-Merkmalen, der das Merkmal „ID“ zugeordnet ist | tinyint | 3.5.0 |
CategoryDescription | Bezeichnung der Kategorie „PersonCharacCategoryID“ | varchar(100) | 3.5.0 |
(parameterunabängige Sortierung)
Spaltenname | Beschreibung | SQL-Datentyp7) | ab Version |
---|---|---|---|
ID | ID eines Personen-Merkmals. Besteht für ein Merkmal eine komplett lesende Zugriffsbeschränkung (s. pm_GetPChAccRestrForUsers_Ad) für den Aufrufer, FEHLT der entsprechende Datensatz im Ergebnis ! | smallint | 3.5.20 |
Description | Bezeichnung des Personen-Merkmals „ID“ | varchar(100) | 3.5.20 |
DescriptionForAdmin | Bezeichnung der „ID“ für den Administrator. Hintergrund : Merkmale, die von der Bezeichnung her identisch sind, und für einen Administrator bei Konfigurierungen nicht auseinander zu halten wären. | varchar(100) | 3.5.22 |
FieldTypeID | ID eines „Feld-Typs“, von dem alle Eigenschaften des Merkmals „ID“ sein müssen (z.B. „Text mit maximal 20 Zeichen“) | tinyint | 3.5.20 |
FieldTypeDescription | Bezeichnung des Datentyps „FieldTypeID“ | varchar(100) | 3.5.20 |
BasicFieldTypeID | ID des Basis-Feld-Typs, der „FieldTypeID“ zugrunde liegt (siehe auch mi_GetFieldTypes_Ad) | tinyint | 3.5.20 |
BasicFieldType | Bezeichnung des Basis-Feld-Typs (z.B. „Zahl“) | varchar(20) | 3.5.20 |
MaxLength | Maximale Anzahl Zeichen, die Eigenschaften/Werte zum Merkmal „ID“ haben dürfen | tinyint | 3.5.20 |
PrecisionValue | Gilt nur für Datentypen mit Basis-Daten-Typ „Zahl“ und gibt die Anzahl erlaubter Nachkommastellen an, die in Eigenschaften zum Merkmal „ID“ vorkommen dürfen. | tinyint | 3.5.20 |
Format | Von welchem „Format“ (so etwas wie ein regulären Ausdruck) müssen die Eigenschaften zum Merkmal „ID“ sein. Derzeit nicht implementiert und verwendet ! | varchar(255) | 3.5.20 |
Required | Wird hier eine „1“ ausgegeben, bedeutet das folgendes : Jede Person eines Personen-Typs, dem das Merkmal „ID“ zugewiesen ist, MUSS eine Eigenschaft zum Merkmal „ID“ angeben, ansonsten kann die Person nicht angelegt werden. | bit | 3.5.20 |
PredefinedValues | Hat das Merkmal „ID“ nur vordefinierte Werte („0“ : Nein, „1“ : Ja) ? | bit | 3.5.20 |
IsUnique | Falls „1“, darf eine bestimmte Eigenschaft zum Merkmal „ID“ nur EINER EINZIGEN Person zugewiesen werden | bit | 3.5.20 |
Modify | Dürfen „publicuser“/„Pu“-Prozed. Eigensch.-Änderung. vornehmen ? - „0“ : Nein - „1“ : Ja - „2“ : Nur Neu-Anlage - „3“ : Nur Ändern - „4“ : Nur Neu-Anlage u. Ändern - „5“ : Nur Löschen - „6“ : Nur Neu-Anlage u. Löschen - „7“ : Nur Ändern u. Löschen | tinyint | 3.5.20 |
Visible | Wenn „0“, werden durch vom „publicuser“ ausgeführte Prozeduren bzw. durch „Pu“-Prozeduren (z.B. pm_GetPersonProperties_Pu) KEINE Eigenschaften/Details bzw. nur Teile von Eigenschaften (s. „ReadAccessRestrictionPattern“) zur „ID“ ausgegeben | bit | 3.5.20 |
ReadAccessRestrictionPattern | „NULL“ wenn „Visible = 1“. Welch. Teil v. Eigensch. zu „ID“ für den „publicuser“ ausgegeben werden : - „#left(<n>)#“ : die ERSTEN n Zeichen („n = 0“ mögl.) - „#right(<n>)#“ : die LETZTEN n Zeichen („n = 0“ mögl.) - NULL : Datensätze zu „ID“ fehlen ganz | varchar(100) | 6.5.2 |
SortNo | Bestimmt die Reihenfolge des Merkmals „ID“ innerhalb aller Merkmale | smallint | 3.5.20 |
(parameterunabängige Sortierung)
Spaltenname | Beschreibung | SQL-Datentyp8) | ab Version |
---|---|---|---|
ID | ID eines Personen-Merkmals. Besteht für ein Merkmal eine komplett lesende Zugriffsbeschränkung (s. pm_GetPChAccRestrForUsers_Ad) für den Aufrufer, FEHLT der entsprechende Datensatz im Ergebnis ! | smallint | 3.5.0 |
Description | Bezeichnung des Personen-Merkmals „ID“ | varchar(100) | 3.5.0 |
DescriptionForAdmin | Bezeichnung der „ID“ für den Administrator. Hintergrund : Merkmale, die von der Bezeichnung her identisch sind, und für einen Administrator bei Konfigurierungen nicht auseinander zu halten wären. | varchar(100) | 3.5.22 |
FieldTypeID | ID eines „Feld-Typs“, von dem alle Eigenschaften des Merkmals „ID“ sein müssen (z.B. „Text mit maximal 20 Zeichen“) | tinyint | 3.5.0 |
FieldTypeDescription | Bezeichnung des Datentyps „FieldTypeID“ | varchar(100) | 3.5.0 |
BasicFieldTypeID | ID des Basis-Feld-Typs, der „FieldTypeID“ zugrunde liegt (siehe auch mi_GetFieldTypes_Ad) | tinyint | 3.5.0 |
BasicFieldType | Bezeichnung des Basis-Feld-Typs (z.B. „Zahl“) | varchar(20) | 3.5.0 |
MaxLength | Maximale Anzahl Zeichen, die Eigenschaften/Werte zum Merkmal „ID“ haben dürfen | tinyint | 3.5.0 |
PrecisionValue | Gilt nur für Datentypen mit Basis-Daten-Typ „Zahl“ und gibt die Anzahl erlaubter Nachkommastellen an, die in Eigenschaften zum Merkmal „ID“ vorkommen dürfen. | tinyint | 3.5.0 |
Format | Von welchem „Format“ (so etwas wie ein regulären Ausdruck) müssen die Eigenschaften zum Merkmal „ID“ sein. Derzeit nicht implementiert und verwendet ! | varchar(255) | 3.5.0 |
Required | Wird hier eine „1“ ausgegeben, bedeutet das folgendes : Jede Person eines Personen-Typs, dem das Merkmal „ID“ zugewiesen ist, MUSS eine Eigenschaft zum Merkmal „ID“ angeben, ansonsten kann die Person nicht angelegt werden. | bit | 3.5.0 |
PredefinedValues | Hat das Merkmal „ID“ nur vordefinierte Werte („0“ : Nein, „1“ : Ja) ? | bit | 3.5.0 |
Required_CharacCategory | Falls „1“, so MUSS eine Person, die eine Angabe zu wenigstens einem Merkmal der Kategorie „PersonCharacCategoryID“ macht, auf JEDEN FALL auch eine Angabe zu Merkmal „ID“ machen. (Falls „Required = 1“ ist, steht hier auch IMMER eine „1“) | bit | 3.5.0 |
IsUnique | Falls „1“, darf eine bestimmte Eigenschaft zum Merkmal „ID“ nur EINER EINZIGEN Person zugewiesen werden | bit | 3.5.0 |
Modify | Dürfen „publicuser“/„Pu“-Prozed. Eigensch.-Änderung. vornehmen ? - „0“ : Nein - „1“ : Ja - „2“ : Nur Neu-Anlage - „3“ : Nur Ändern - „4“ : Nur Neu-Anlage u. Ändern - „5“ : Nur Löschen - „6“ : Nur Neu-Anlage u. Löschen - „7“ : Nur Ändern u. Löschen | tinyint | 3.5.0 |
Visible | Wenn „0“, werden durch vom „publicuser“ ausgeführte Prozeduren bzw. durch „Pu“-Prozeduren (z.B. pm_GetPersonProperties_Pu) KEINE Eigenschaften/Details bzw. nur Teile von Eigenschaften (s. „ReadAccessRestrictionPattern“) zur „ID“ ausgegeben | bit | 3.5.0 |
ReadAccessRestrictionPattern | „NULL“ wenn „Visible = 1“. Welch. Teil v. Eigensch. zu „ID“ für den „publicuser“ ausgegeben werden : - „#left(<n>)#“ : die ERSTEN n Zeichen („n = 0“ mögl.) - „#right(<n>)#“ : die LETZTEN n Zeichen („n = 0“ mögl.) - NULL : Datensätze zu „ID“ fehlen ganz | varchar(100) | 6.5.2 |
SortNo | Bestimmt die Reihenfolge des Merkmals „ID“ innerhalb aller Merkmale | smallint | 3.5.0 |
(parameterunabängige Sortierung)
Spaltenname | Beschreibung | SQL-Datentyp9) | ab Version |
---|---|---|---|
ID | ID eines Personen-Merkmals. Besteht für ein Merkmal eine komplett lesende Zugriffsbeschränkung (s. pm_GetPChAccRestrForUsers_Ad) für den Aufrufer, FEHLT der entsprechende Datensatz im Ergebnis ! | smallint | 3.5.0 |
Description | Bezeichnung des Personen-Merkmals „ID“ | varchar(100) | 3.5.0 |
DescriptionForAdmin | Bezeichnung der „ID“ für den Administrator. Hintergrund : Merkmale, die von der Bezeichnung her identisch sind, und für einen Administrator bei Konfigurierungen nicht auseinander zu halten wären. | varchar(100) | 3.5.22 |
FieldTypeID | ID eines „Feld-Typs“, von dem alle Eigenschaften des Merkmals „ID“ sein müssen (z.B. „Text mit maximal 20 Zeichen“) | tinyint | 3.5.0 |
FieldTypeDescription | Bezeichnung des Datentyps „FieldTypeID“ | varchar(100) | 3.5.0 |
BasicFieldTypeID | ID des Basis-Feld-Typs, der „FieldTypeID“ zugrunde liegt (siehe auch mi_GetFieldTypes_Ad) | tinyint | 3.5.0 |
BasicFieldType | Bezeichnung des Basis-Feld-Typs (z.B. „Zahl“) | varchar(20) | 3.5.0 |
MaxLength | Maximale Anzahl Zeichen, die Eigenschaften/Werte zum Merkmal „ID“ haben dürfen | tinyint | 3.5.0 |
PrecisionValue | Gilt nur für Datentypen mit Basis-Daten-Typ „Zahl“ und gibt die Anzahl erlaubter Nachkommastellen an, die in Eigenschaften zum Merkmal „ID“ vorkommen dürfen. | tinyint | 3.5.0 |
Format | Von welchem „Format“ (so etwas wie ein regulären Ausdruck) müssen die Eigenschaften zum Merkmal „ID“ sein. Derzeit nicht implementiert und verwendet ! | varchar(255) | 3.5.0 |
Required | Wird hier eine „1“ ausgegeben, bedeutet das folgendes : Jede Person eines Personen-Typs, dem das Merkmal „ID“ zugewiesen ist, MUSS eine Eigenschaft zum Merkmal „ID“ angeben, ansonsten kann die Person nicht angelegt werden. | bit | 3.5.0 |
PredefinedValues | Hat das Merkmal „ID“ nur vordefinierte Werte („0“ : Nein, „1“ : Ja) ? | bit | 3.5.0 |
Required_CharacCategory | Falls „1“, so MUSS eine Person, die eine Angabe zu wenigstens einem Merkmal der Kategorie „PersonCharacCategoryID“ macht, auf JEDEN FALL auch eine Angabe zu Merkmal „ID“ machen. (Falls „Required = 1“ ist, steht hier auch IMMER eine „1“) | bit | 3.5.0 |
IsUnique | Falls „1“, darf eine bestimmte Eigenschaft zum Merkmal „ID“ nur EINER EINZIGEN Person zugewiesen werden | bit | 3.5.0 |
Modify | Dürfen „publicuser“/„Pu“-Prozed. Eigensch.-Änderung. vornehmen ? - „0“ : Nein - „1“ : Ja - „2“ : Nur Neu-Anlage - „3“ : Nur Ändern - „4“ : Nur Neu-Anlage u. Ändern - „5“ : Nur Löschen - „6“ : Nur Neu-Anlage u. Löschen - „7“ : Nur Ändern u. Löschen | tinyint | 3.5.0 |
Visible | Wenn „0“, werden durch vom „publicuser“ ausgeführte Prozeduren bzw. durch „Pu“-Prozeduren (z.B. pm_GetPersonProperties_Pu) KEINE Eigenschaften/Details bzw. nur Teile von Eigenschaften (s. „ReadAccessRestrictionPattern“) zur „ID“ ausgegeben | bit | 3.5.0 |
ReadAccessRestrictionPattern | „NULL“ wenn „Visible = 1“. Welch. Teil v. Eigensch. zu „ID“ für den „publicuser“ ausgegeben werden : - „#left(<n>)#“ : die ERSTEN n Zeichen („n = 0“ mögl.) - „#right(<n>)#“ : die LETZTEN n Zeichen („n = 0“ mögl.) - NULL : Datensätze zu „ID“ fehlen ganz | varchar(100) | 6.5.2 |
SortNo | Bestimmt die Reihenfolge des Merkmals „ID“ innerhalb aller Merkmale | smallint | 3.5.0 |
(parameterunabängige Sortierung)
Spaltenname | Beschreibung | SQL-Datentyp10) | ab Version |
---|---|---|---|
ID | ID eines Personen-Merkmals. Besteht für ein Merkmal eine komplett lesende Zugriffsbeschränkung (s. pm_GetPChAccRestrForUsers_Ad) für den Aufrufer, FEHLT der entsprechende Datensatz im Ergebnis ! | smallint | 3.5.20 |
Description | Bezeichnung des Personen-Merkmals „ID“ | varchar(100) | 3.5.20 |
DescriptionForAdmin | Bezeichnung der „ID“ für den Administrator. Hintergrund : Merkmale, die von der Bezeichnung her identisch sind, und für einen Administrator bei Konfigurierungen nicht auseinander zu halten wären. | varchar(100) | 3.5.22 |
FieldTypeID | ID eines „Feld-Typs“, von dem alle Eigenschaften des Merkmals „ID“ sein müssen (z.B. „Text mit maximal 20 Zeichen“) | tinyint | 3.5.20 |
FieldTypeDescription | Bezeichnung des Datentyps „FieldTypeID“ | varchar(100) | 3.5.20 |
BasicFieldTypeID | ID des Basis-Feld-Typs, der „FieldTypeID“ zugrunde liegt (siehe auch mi_GetFieldTypes_Ad) | tinyint | 3.5.20 |
BasicFieldType | Bezeichnung des Basis-Feld-Typs (z.B. „Zahl“) | varchar(20) | 3.5.20 |
MaxLength | Maximale Anzahl Zeichen, die Eigenschaften/Werte zum Merkmal „ID“ haben dürfen | tinyint | 3.5.20 |
PrecisionValue | Gilt nur für Datentypen mit Basis-Daten-Typ „Zahl“ und gibt die Anzahl erlaubter Nachkommastellen an, die in Eigenschaften zum Merkmal „ID“ vorkommen dürfen. | tinyint | 3.5.20 |
Format | Von welchem „Format“ (so etwas wie ein regulären Ausdruck) müssen die Eigenschaften zum Merkmal „ID“ sein. Derzeit nicht implementiert und verwendet ! | varchar(255) | 3.5.20 |
Required | Wird hier eine „1“ ausgegeben, bedeutet das folgendes : Jede Person eines Personen-Typs, dem das Merkmal „ID“ zugewiesen ist, MUSS eine Eigenschaft zum Merkmal „ID“ angeben, ansonsten kann die Person nicht angelegt werden. | bit | 3.5.20 |
PredefinedValues | Hat das Merkmal „ID“ nur vordefinierte Werte („0“ : Nein, „1“ : Ja) ? | bit | 3.5.20 |
Required_CharacCategory | Immer „0“, da in diesem Fall ja gerade die Merkmale gesucht werden, die NICHT „PersonCharacCategoryID“ zugeordnet sind ! (Dann hätte man die Spalte ja auch ganz weglassen können ?! - Genau !) | bit | 3.5.20 |
IsUnique | Falls „1“, darf eine bestimmte Eigenschaft zum Merkmal „ID“ nur EINER EINZIGEN Person zugewiesen werden | bit | 3.5.20 |
Modify | Dürfen „publicuser“/„Pu“-Prozed. Eigensch.-Änderung. vornehmen ? - „0“ : Nein - „1“ : Ja - „2“ : Nur Neu-Anlage - „3“ : Nur Ändern - „4“ : Nur Neu-Anlage u. Ändern - „5“ : Nur Löschen - „6“ : Nur Neu-Anlage u. Löschen - „7“ : Nur Ändern u. Löschen | tinyint | 3.5.20 |
Visible | Wenn „0“, werden durch vom „publicuser“ ausgeführte Prozeduren bzw. durch „Pu“-Prozeduren (z.B. pm_GetPersonProperties_Pu) KEINE Eigenschaften/Details bzw. nur Teile von Eigenschaften (s. „ReadAccessRestrictionPattern“) zur „ID“ ausgegeben | bit | 3.5.20 |
ReadAccessRestrictionPattern | „NULL“ wenn „Visible = 1“. Welch. Teil v. Eigensch. zu „ID“ für den „publicuser“ ausgegeben werden : - „#left(<n>)#“ : die ERSTEN n Zeichen („n = 0“ mögl.) - „#right(<n>)#“ : die LETZTEN n Zeichen („n = 0“ mögl.) - NULL : Datensätze zu „ID“ fehlen ganz | varchar(100) | 6.5.2 |
SortNo | Bestimmt die Reihenfolge des Merkmals „ID“ innerhalb aller Merkmale | smallint | 3.5.20 |
(parameterunabängige Sortierung)
Spaltenname | Beschreibung | SQL-Datentyp11) | ab Version |
---|---|---|---|
ID | ID eines Personen-Merkmals. Besteht für ein Merkmal eine komplett lesende Zugriffsbeschränkung (s. pm_GetPChAccRestrForUsers_Ad) für den Aufrufer, FEHLT der entsprechende Datensatz im Ergebnis ! | smallint | 3.5.0 |
Description | Bezeichnung des Personen-Merkmals „ID“ | varchar(100) | 3.5.0 |
DescriptionForAdmin | Bezeichnung der „ID“ für den Administrator. Hintergrund : Merkmale, die von der Bezeichnung her identisch sind, und für einen Administrator bei Konfigurierungen nicht auseinander zu halten wären. | varchar(100) | 3.5.22 |
FieldTypeID | ID eines „Feld-Typs“, von dem alle Eigenschaften des Merkmals „ID“ sein müssen (z.B. „Text mit maximal 20 Zeichen“) | tinyint | 3.5.0 |
FieldTypeDescription | Bezeichnung des Datentyps „FieldTypeID“ | varchar(100) | 3.5.0 |
BasicFieldTypeID | ID des Basis-Feld-Typs, der „FieldTypeID“ zugrunde liegt (siehe auch mi_GetFieldTypes_Ad) | tinyint | 3.5.0 |
BasicFieldType | Bezeichnung des Basis-Feld-Typs (z.B. „Zahl“) | varchar(20) | 3.5.0 |
MaxLength | Maximale Anzahl Zeichen, die Eigenschaften/Werte zum Merkmal „ID“ haben dürfen | tinyint | 3.5.0 |
PrecisionValue | Gilt nur für Datentypen mit Basis-Daten-Typ „Zahl“ und gibt die Anzahl erlaubter Nachkommastellen an, die in Eigenschaften zum Merkmal „ID“ vorkommen dürfen. | tinyint | 3.5.0 |
Format | Von welchem „Format“ (so etwas wie ein regulären Ausdruck) müssen die Eigenschaften zum Merkmal „ID“ sein. Derzeit nicht implementiert und verwendet ! | varchar(255) | 3.5.0 |
Required | Wird hier eine „1“ ausgegeben, bedeutet das folgendes : Jede Person eines Personen-Typs, dem das Merkmal „ID“ zugewiesen ist, MUSS eine Eigenschaft zum Merkmal „ID“ angeben, ansonsten kann die Person nicht angelegt werden. | bit | 3.5.0 |
PredefinedValues | Hat das Merkmal „ID“ nur vordefinierte Werte („0“ : Nein, „1“ : Ja) ? | bit | 3.5.0 |
IsUnique | Falls „1“, darf eine bestimmte Eigenschaft zum Merkmal „ID“ nur EINER EINZIGEN Person zugewiesen werden | bit | 3.5.0 |
Modify | Dürfen „publicuser“/„Pu“-Prozed. Eigensch.-Änderung. vornehmen ? - „0“ : Nein - „1“ : Ja - „2“ : Nur Neu-Anlage - „3“ : Nur Ändern - „4“ : Nur Neu-Anlage u. Ändern - „5“ : Nur Löschen - „6“ : Nur Neu-Anlage u. Löschen - „7“ : Nur Ändern u. Löschen | tinyint | 3.5.0 |
Visible | Wenn „0“, werden durch vom „publicuser“ ausgeführte Prozeduren bzw. durch „Pu“-Prozeduren (z.B. pm_GetPersonProperties_Pu) KEINE Eigenschaften/Details bzw. nur Teile von Eigenschaften (s. „ReadAccessRestrictionPattern“) zur „ID“ ausgegeben | bit | 3.5.0 |
ReadAccessRestrictionPattern | „NULL“ wenn „Visible = 1“. Welch. Teil v. Eigensch. zu „ID“ für den „publicuser“ ausgegeben werden : - „#left(<n>)#“ : die ERSTEN n Zeichen („n = 0“ mögl.) - „#right(<n>)#“ : die LETZTEN n Zeichen („n = 0“ mögl.) - NULL : Datensätze zu „ID“ fehlen ganz | varchar(100) | 6.5.2 |
SortNo | Bestimmt die Reihenfolge des Merkmals „ID“ innerhalb aller Merkmale | smallint | 3.5.0 |
(parameterunabängige Sortierung)
Die Prozedur hat keine Output-Parameter.
Code | Beschreibung | Quelle 12) |
---|---|---|
-569 | Der Benutzer hat kein Ausführungsrecht für die Prozedur | nur indirekt |
-567 | Die Prozedur darf z. Zt. nicht ausgeführt werden | nur indirekt |
-566 | Die Prozedur darf mit den übergebenen Parametern nicht ausgeführt werden | nur indirekt |
-535 | Das Datum liegt nicht in der Vergangenheit | nur indirekt |
-530 | Der Wert ist nicht konvertierbar | nur indirekt |
-510 | Der Benutzer ist nicht registriert | nur indirekt |
-504 | Es ist ein Problem aufgetreten, das nicht gelöst werden kann, Prozedur wird daher abgebrochen | direkt und indirekt |
-500 | Falsche Parameter | nur indirekt |
Die Rückgabe erfolgt als XML-Dokument welches gegen das Schema Response/EngineProcedure_v1_0.xsd validiert.
7.0.7 | 2015-01-29 | Interne Änderung : Datentyp-Erweiterung des „ReferenceKey“ [für „_mi_StartProcedure“-Aufruf] |
6.5.2 | 2013-02-26 | 1. Interne Anpassungen (Spalten „Visible“ und „ModificationAllowedByUser“ von „PersonCharacteristics“ sind weggefallen) 2. Neue mögliche Werte für Rückgabespalte „Modify“ 3. Neue Rückgabespalte „ReadAccessRestrictionPattern“ |
4.0.15 | 2004-07-30 | 1. Aufruf der Prozeduren „_mi_StartProcedure“ und „_mi_FinishProcedure“ 2. Ausführen von „set transaction isolation level 1“ und „set rowcount 0“ zu Beginn der Prozedur |
4.0.6 | 2003-11-14 | Explizite Konvertierung nach „bit“ für „Required_CharacCategory“ falls eine Konstante zurückgegeben wird |
4.0.3 | 2003-07-10 | Fehler in der Doku, Rückgabespalte „Modify“ ist vom Typ „tinyint“ |
4.0.0 | 2003-04-03 | 1. Fehlerhafte Doku der Rückgabemenge bzgl. der Reihenfolge einiger Rückgabespalten 2. Fehler bzgl. der Rückgabespalte „Required_CharacCategory“ falls eine „PersonCharacteristicID“ angegeben wird : sie war immer „NULL“ |
3.5.22 | 2002-08-30 | |
3.5.20 | 2002-07-22 | |
3.5.19 | 2002-06-17 | |
3.5.0 | 2000-11-23 | Erstmalig in dieser Version erstellt |
Der folgende Link öffnet in einem separaten Fenster den Engine Playground der fest mit dem dbap-demo System verbunden ist:
Unformatierte Ausgabe:
curl -X GET 'http://<partner>-<project>.dstore.de/default/engine/pm_GetPersonCharacteristics_Ad'
Mit xmllint 13) formatierte Ausgabe:
curl -X GET 'http://<partner>-<project>.dstore.de/default/engine/pm_GetPersonCharacteristics_Ad' | xmllint --format -
use dStore_php\WebService; $service = new WebService\Service( WebService\Scheme::HTTP,'<partner>-<project>.dstore.de', 80); $request = new WebService\Requests\Engine\Procedure\Request( new WebService\Requests\AccessData('default'), 'pm_GetPersonCharacteristics_Ad', array( // 'PersonTypeID' => 1, // 'PersonCharacCategoryID' => NULL, // 'NotInPersonCharacsInCats' => 1, // 'PersonCharacteristicID' => NULL ) ); $service->execute($request); $xml_result = $request->getResponse()->getBody()->toSimpleXmlDocument(); $ResultSet = $xml_result->getRowsAsArray();
XML zur Ausführung mit der Methode engine/execute, z.B. per
curl --header 'Content-Type: application/xml' -X POST 'http://<partner>-<kunde>.dstore.de/default/engine/execute' -d '<xml-daten>'
<?xml version="1.0" encoding="UTF-8"?> <ListOfBatches> <Batch No="0"> <Procedure Name="pm_GetPersonCharacteristics_Ad"> <Parameters> <!-- <Parameter Name="PersonTypeID">1</Parameter> --> <!-- <Parameter Name="PersonCharacCategoryID">NULL</Parameter> --> <!-- <Parameter Name="NotInPersonCharacsInCats">1</Parameter> --> <!-- <Parameter Name="PersonCharacteristicID">NULL</Parameter> --> </Parameters> </Procedure> </Batch> </ListOfBatches>