Benutzer-Werkzeuge

Webseiten-Werkzeuge


engine:procedures:pm_getpersoncharacteristics_ad

pm_GetPersonCharacteristics_Ad

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

  • eine „PersonCharacteristicID“ ist

oder

  • eine „PersonTypeID“ UND „PersonCharacCategoryID“ angegeben sind !

Ansonsten gilt : Ist „NotInPersonCharacsInCats“…

  • „<> 2“ UND „PersonTypeID is NULL“ UND „PersonCharacCategoryID is NULL“ : Alle Merkmale ausgeben
  • „<> 2“ UND „PersonTypeID is NULL“ UND „PersonCharacCategoryID is NOT NULL“ : Alle Merkmale der Kategorie „PersonCharacCategoryID“ ausgeben
  • „2“ UND „PersonTypeID is NULL“ UND „PersonCharacCategoryID is NULL“ : Alle Merkmale, die ÜBERHAUPT keiner Kategorie zugewiesen sind, ermitteln
  • „2“ UND „PersonTypeID is NULL“ UND „PersonCharacCategoryID is NOT NULL“ : Alle Merkmale, die NICHT der Kategorie „PersonCharacCategoryID“ zugewiesen sind, zurückgeben
  • „0“ UND „PersonTypeID is NOT NULL“ UND „PersonCharacCategoryID is NULL“ : Alle Merkmale, die dem Personentyp „PersonTypeID“ zugewiesen sind, ausgeben
  • „<> 0“ UND „PersonTypeID is NOT NULL“ UND „PersonCharacCategoryID is NULL“ : Alle Merkmale ermitteln, die dem Personentyp „PersonTypeID“ NOCH NICHT zugewiesen sind

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 :

  • „0“ : Keinerlei Änderung erlaubt (anlagen, ändern und löschen sind verboten)
  • „1“ : Alle Arten von Änderungen erlaubt (d.h. anlegen, ändern, löschen)
  • „2“ : Nur die Neu-Anlage ist erlaubt, (ändern und löschen sind verboten)
  • „3“ : Nur Ändern ist erlaubt (anlegen und löschen sind verboten)
  • „4“ : Nur Neu-Anlage und Ändern sind erlaubt (löschen ist verboten)
  • „5“ : Nur Löschen ist erlaubt (anlegen und ändern sind verboten)
  • „6“ : Nur Neu-Anlage und Löschen sind erlaubt (ändern ist verboten)
  • „7“ : Nur Ändern und Löschen sind erlaubt (anlegen ist verboten)

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 :

  • „#left(<n>)#“ : die ERSTEN n Zeichen („n = 0“ mögl.) werden ausgegeben
  • „#right(<n>)#“ : die LETZTEN n Zeichen („n = 0“ mögl.) werden ausgegeben

Beispielsweise bedeutet „#left(4)#“, daß nur (maximal) die ERSTEN 4 Zeichen der Eigenschaft zurückgeliefert werden.

HTTP-MethodGET
HTTP-AuthOptional
Tags
Engine-Kategorieperson management
Engine-TypDaten-Ermittlung
Letzte Aktualisierung7.0.7 (2015-01-29)

Parameter

Name 1) Standard-Wert Beschreibung 2) SQL-Datentyp3) ab Version
PersonTypeID1 ID eines Personen-Typs, nach dem gefiltert werden kann (siehe Beschreibung : Anmerkung zum Parameter „NotInPersonCharacsInCats“ !)
tinyint3.5.0
PersonCharacCategoryIDNULL ID einer Kategorie von Personen-Merkmalen, nach der gefiltert werden kann (siehe Beschreibung : Anmerkung zum Parameter „NotInPersonCharacsInCats“ !)
tinyint3.5.0
NotInPersonCharacsInCats1 Siehe Beschreibung : Anmerkung zum Parameter „NotInPersonCharacsInCats“ !
tinyint3.5.20
PersonCharacteristicIDNULL ID eines Personen-Merkmals. Wenn angegeben, wird nur der Datensatz zu diesem Merkmal ausgegeben.
smallint3.5.20

Rückgabe

wenn PersonTypeID is NOT NULL und PersonCharacteristicID is NOT NULL

Spaltenname Beschreibung SQL-Datentyp4) ab Version
IDID 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 !
smallint3.5.20
DescriptionBezeichnung des Personen-Merkmals „ID“
varchar(100)3.5.20
DescriptionForAdminBezeichnung 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
FieldTypeIDID eines „Feld-Typs“, von dem alle Eigenschaften des Merkmals „ID“ sein müssen (z.B. „Text mit maximal 20 Zeichen“)
tinyint3.5.20
FieldTypeDescriptionBezeichnung des Datentyps „FieldTypeID“
varchar(100)3.5.20
BasicFieldTypeIDID des Basis-Feld-Typs, der „FieldTypeID“ zugrunde liegt (siehe auch mi_GetFieldTypes_Ad)
tinyint3.5.20
BasicFieldTypeBezeichnung des Basis-Feld-Typs (z.B. „Zahl“)
varchar(20)3.5.20
MaxLengthMaximale Anzahl Zeichen, die Eigenschaften/Werte zum Merkmal „ID“ haben dürfen
tinyint3.5.20
PrecisionValueGilt 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.
tinyint3.5.20
FormatVon 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
RequiredWird 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.
bit3.5.20
PredefinedValuesHat das Merkmal „ID“ nur vordefinierte Werte („0“ : Nein, „1“ : Ja) ?
bit3.5.20
Required_CharacCategoryFalls „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“)
bit3.5.20
IsUniqueFalls „1“, darf eine bestimmte Eigenschaft zum Merkmal „ID“ nur EINER EINZIGEN Person zugewiesen werden
bit3.5.20
ModifyDü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
tinyint3.5.20
VisibleWenn „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
bit3.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
SortNoBestimmt die Reihenfolge des Merkmals „ID“ innerhalb aller Merkmale
smallint3.5.20
PersonCharacCategoryIDID einer Kategorie von Personen-Merkmalen, der das Merkmal „ID“ zugeordnet ist
tinyint3.5.20
CategoryDescriptionBezeichnung der Kategorie „PersonCharacCategoryID“
varchar(100)3.5.20

wenn PersonTypeID is NULL und PersonCharacteristicID is NOT NULL

Spaltenname Beschreibung SQL-Datentyp5) ab Version
IDID 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 !
smallint3.5.20
DescriptionBezeichnung des Personen-Merkmals „ID“
varchar(100)3.5.20
DescriptionForAdminBezeichnung 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
FieldTypeIDID eines „Feld-Typs“, von dem alle Eigenschaften des Merkmals „ID“ sein müssen (z.B. „Text mit maximal 20 Zeichen“)
tinyint3.5.20
FieldTypeDescriptionBezeichnung des Datentyps „FieldTypeID“
varchar(100)3.5.20
BasicFieldTypeIDID des Basis-Feld-Typs, der „FieldTypeID“ zugrunde liegt (siehe auch mi_GetFieldTypes_Ad)
tinyint3.5.20
BasicFieldTypeBezeichnung des Basis-Feld-Typs (z.B. „Zahl“)
varchar(20)3.5.20
MaxLengthMaximale Anzahl Zeichen, die Eigenschaften/Werte zum Merkmal „ID“ haben dürfen
tinyint3.5.20
PrecisionValueGilt 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.
tinyint3.5.20
FormatVon 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
RequiredWird 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.
bit3.5.20
PredefinedValuesHat das Merkmal „ID“ nur vordefinierte Werte („0“ : Nein, „1“ : Ja) ?
bit3.5.20
Required_CharacCategoryHier 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.
bit3.5.20
IsUniqueFalls „1“, darf eine bestimmte Eigenschaft zum Merkmal „ID“ nur EINER EINZIGEN Person zugewiesen werden
bit3.5.20
ModifyDü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
tinyint3.5.20
VisibleWenn „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
bit3.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
SortNoBestimmt die Reihenfolge des Merkmals „ID“ innerhalb aller Merkmale
smallint3.5.20

wenn PersonTypeID is NOT NULL und NotInPersonCharacsInCats = 0 und PersonCharacCategoryID is NULL und PersonCharacteristicID is NULL

Spaltenname Beschreibung SQL-Datentyp6) ab Version
IDID 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 !
smallint3.5.0
DescriptionBezeichnung des Personen-Merkmals „ID“
varchar(100)3.5.0
DescriptionForAdminBezeichnung 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
FieldTypeIDID eines „Feld-Typs“, von dem alle Eigenschaften des Merkmals „ID“ sein müssen (z.B. „Text mit maximal 20 Zeichen“)
tinyint3.5.0
FieldTypeDescriptionBezeichnung des Datentyps „FieldTypeID“
varchar(100)3.5.0
BasicFieldTypeIDID des Basis-Feld-Typs, der „FieldTypeID“ zugrunde liegt (siehe auch mi_GetFieldTypes_Ad)
tinyint3.5.0
BasicFieldTypeBezeichnung des Basis-Feld-Typs (z.B. „Zahl“)
varchar(20)3.5.0
MaxLengthMaximale Anzahl Zeichen, die Eigenschaften/Werte zum Merkmal „ID“ haben dürfen
tinyint3.5.0
PrecisionValueGilt 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.
tinyint3.5.0
FormatVon 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
RequiredWird 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.
bit3.5.0
PredefinedValuesHat das Merkmal „ID“ nur vordefinierte Werte („0“ : Nein, „1“ : Ja) ?
bit3.5.0
Required_CharacCategoryFalls „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“)
bit3.5.0
IsUniqueFalls „1“, darf eine bestimmte Eigenschaft zum Merkmal „ID“ nur EINER EINZIGEN Person zugewiesen werden
bit3.5.0
ModifyDü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
tinyint3.5.0
VisibleWenn „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
bit3.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
SortNoBestimmt die Reihenfolge des Merkmals „ID“ innerhalb aller Merkmale
smallint3.5.0
PersonCharacCategoryIDID einer Kategorie von Personen-Merkmalen, der das Merkmal „ID“ zugeordnet ist
tinyint3.5.0
CategoryDescriptionBezeichnung der Kategorie „PersonCharacCategoryID“
varchar(100)3.5.0
Sortierung der Rückgabe

(parameterunabängige Sortierung)

  • PersonCharacCategoryID (aufsteigend)
  • SortNo (absteigend)

wenn PersonTypeID is NOT NULL und NotInPersonCharacsInCats <> 0 und PersonCharacCategoryID is NULL und PersonCharacteristicID is NULL

Spaltenname Beschreibung SQL-Datentyp7) ab Version
IDID 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 !
smallint3.5.20
DescriptionBezeichnung des Personen-Merkmals „ID“
varchar(100)3.5.20
DescriptionForAdminBezeichnung 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
FieldTypeIDID eines „Feld-Typs“, von dem alle Eigenschaften des Merkmals „ID“ sein müssen (z.B. „Text mit maximal 20 Zeichen“)
tinyint3.5.20
FieldTypeDescriptionBezeichnung des Datentyps „FieldTypeID“
varchar(100)3.5.20
BasicFieldTypeIDID des Basis-Feld-Typs, der „FieldTypeID“ zugrunde liegt (siehe auch mi_GetFieldTypes_Ad)
tinyint3.5.20
BasicFieldTypeBezeichnung des Basis-Feld-Typs (z.B. „Zahl“)
varchar(20)3.5.20
MaxLengthMaximale Anzahl Zeichen, die Eigenschaften/Werte zum Merkmal „ID“ haben dürfen
tinyint3.5.20
PrecisionValueGilt 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.
tinyint3.5.20
FormatVon 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
RequiredWird 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.
bit3.5.20
PredefinedValuesHat das Merkmal „ID“ nur vordefinierte Werte („0“ : Nein, „1“ : Ja) ?
bit3.5.20
IsUniqueFalls „1“, darf eine bestimmte Eigenschaft zum Merkmal „ID“ nur EINER EINZIGEN Person zugewiesen werden
bit3.5.20
ModifyDü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
tinyint3.5.20
VisibleWenn „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
bit3.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
SortNoBestimmt die Reihenfolge des Merkmals „ID“ innerhalb aller Merkmale
smallint3.5.20
Sortierung der Rückgabe

(parameterunabängige Sortierung)

  • SortNo (absteigend)

wenn PersonTypeID is NOT NULL und PersonCharacteristicID is NULL und PersonCharacCategoryID is NOT NULL

Spaltenname Beschreibung SQL-Datentyp8) ab Version
IDID 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 !
smallint3.5.0
DescriptionBezeichnung des Personen-Merkmals „ID“
varchar(100)3.5.0
DescriptionForAdminBezeichnung 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
FieldTypeIDID eines „Feld-Typs“, von dem alle Eigenschaften des Merkmals „ID“ sein müssen (z.B. „Text mit maximal 20 Zeichen“)
tinyint3.5.0
FieldTypeDescriptionBezeichnung des Datentyps „FieldTypeID“
varchar(100)3.5.0
BasicFieldTypeIDID des Basis-Feld-Typs, der „FieldTypeID“ zugrunde liegt (siehe auch mi_GetFieldTypes_Ad)
tinyint3.5.0
BasicFieldTypeBezeichnung des Basis-Feld-Typs (z.B. „Zahl“)
varchar(20)3.5.0
MaxLengthMaximale Anzahl Zeichen, die Eigenschaften/Werte zum Merkmal „ID“ haben dürfen
tinyint3.5.0
PrecisionValueGilt 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.
tinyint3.5.0
FormatVon 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
RequiredWird 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.
bit3.5.0
PredefinedValuesHat das Merkmal „ID“ nur vordefinierte Werte („0“ : Nein, „1“ : Ja) ?
bit3.5.0
Required_CharacCategoryFalls „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“)
bit3.5.0
IsUniqueFalls „1“, darf eine bestimmte Eigenschaft zum Merkmal „ID“ nur EINER EINZIGEN Person zugewiesen werden
bit3.5.0
ModifyDü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
tinyint3.5.0
VisibleWenn „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
bit3.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
SortNoBestimmt die Reihenfolge des Merkmals „ID“ innerhalb aller Merkmale
smallint3.5.0
Sortierung der Rückgabe

(parameterunabängige Sortierung)

  • SortNo (absteigend)

wenn PersonTypeID is NULL und NotInPersonCharacsInCats <> 2 und PersonCharacteristicID is NULL und PersonCharacCategoryID is NOT NULL

Spaltenname Beschreibung SQL-Datentyp9) ab Version
IDID 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 !
smallint3.5.0
DescriptionBezeichnung des Personen-Merkmals „ID“
varchar(100)3.5.0
DescriptionForAdminBezeichnung 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
FieldTypeIDID eines „Feld-Typs“, von dem alle Eigenschaften des Merkmals „ID“ sein müssen (z.B. „Text mit maximal 20 Zeichen“)
tinyint3.5.0
FieldTypeDescriptionBezeichnung des Datentyps „FieldTypeID“
varchar(100)3.5.0
BasicFieldTypeIDID des Basis-Feld-Typs, der „FieldTypeID“ zugrunde liegt (siehe auch mi_GetFieldTypes_Ad)
tinyint3.5.0
BasicFieldTypeBezeichnung des Basis-Feld-Typs (z.B. „Zahl“)
varchar(20)3.5.0
MaxLengthMaximale Anzahl Zeichen, die Eigenschaften/Werte zum Merkmal „ID“ haben dürfen
tinyint3.5.0
PrecisionValueGilt 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.
tinyint3.5.0
FormatVon 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
RequiredWird 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.
bit3.5.0
PredefinedValuesHat das Merkmal „ID“ nur vordefinierte Werte („0“ : Nein, „1“ : Ja) ?
bit3.5.0
Required_CharacCategoryFalls „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“)
bit3.5.0
IsUniqueFalls „1“, darf eine bestimmte Eigenschaft zum Merkmal „ID“ nur EINER EINZIGEN Person zugewiesen werden
bit3.5.0
ModifyDü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
tinyint3.5.0
VisibleWenn „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
bit3.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
SortNoBestimmt die Reihenfolge des Merkmals „ID“ innerhalb aller Merkmale
smallint3.5.0
Sortierung der Rückgabe

(parameterunabängige Sortierung)

  • SortNo (absteigend)

wenn PersonTypeID is NULL und NotInPersonCharacsInCats = 2 und PersonCharacteristicID is NULL und PersonCharacCategoryID is NOT NULL

Spaltenname Beschreibung SQL-Datentyp10) ab Version
IDID 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 !
smallint3.5.20
DescriptionBezeichnung des Personen-Merkmals „ID“
varchar(100)3.5.20
DescriptionForAdminBezeichnung 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
FieldTypeIDID eines „Feld-Typs“, von dem alle Eigenschaften des Merkmals „ID“ sein müssen (z.B. „Text mit maximal 20 Zeichen“)
tinyint3.5.20
FieldTypeDescriptionBezeichnung des Datentyps „FieldTypeID“
varchar(100)3.5.20
BasicFieldTypeIDID des Basis-Feld-Typs, der „FieldTypeID“ zugrunde liegt (siehe auch mi_GetFieldTypes_Ad)
tinyint3.5.20
BasicFieldTypeBezeichnung des Basis-Feld-Typs (z.B. „Zahl“)
varchar(20)3.5.20
MaxLengthMaximale Anzahl Zeichen, die Eigenschaften/Werte zum Merkmal „ID“ haben dürfen
tinyint3.5.20
PrecisionValueGilt 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.
tinyint3.5.20
FormatVon 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
RequiredWird 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.
bit3.5.20
PredefinedValuesHat das Merkmal „ID“ nur vordefinierte Werte („0“ : Nein, „1“ : Ja) ?
bit3.5.20
Required_CharacCategoryImmer „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 !)
bit3.5.20
IsUniqueFalls „1“, darf eine bestimmte Eigenschaft zum Merkmal „ID“ nur EINER EINZIGEN Person zugewiesen werden
bit3.5.20
ModifyDü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
tinyint3.5.20
VisibleWenn „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
bit3.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
SortNoBestimmt die Reihenfolge des Merkmals „ID“ innerhalb aller Merkmale
smallint3.5.20
Sortierung der Rückgabe

(parameterunabängige Sortierung)

  • SortNo (absteigend)

wenn PersonTypeID is NULL und PersonCharacCategoryID is NULL und PersonCharacteristicID is NULL

Spaltenname Beschreibung SQL-Datentyp11) ab Version
IDID 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 !
smallint3.5.0
DescriptionBezeichnung des Personen-Merkmals „ID“
varchar(100)3.5.0
DescriptionForAdminBezeichnung 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
FieldTypeIDID eines „Feld-Typs“, von dem alle Eigenschaften des Merkmals „ID“ sein müssen (z.B. „Text mit maximal 20 Zeichen“)
tinyint3.5.0
FieldTypeDescriptionBezeichnung des Datentyps „FieldTypeID“
varchar(100)3.5.0
BasicFieldTypeIDID des Basis-Feld-Typs, der „FieldTypeID“ zugrunde liegt (siehe auch mi_GetFieldTypes_Ad)
tinyint3.5.0
BasicFieldTypeBezeichnung des Basis-Feld-Typs (z.B. „Zahl“)
varchar(20)3.5.0
MaxLengthMaximale Anzahl Zeichen, die Eigenschaften/Werte zum Merkmal „ID“ haben dürfen
tinyint3.5.0
PrecisionValueGilt 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.
tinyint3.5.0
FormatVon 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
RequiredWird 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.
bit3.5.0
PredefinedValuesHat das Merkmal „ID“ nur vordefinierte Werte („0“ : Nein, „1“ : Ja) ?
bit3.5.0
IsUniqueFalls „1“, darf eine bestimmte Eigenschaft zum Merkmal „ID“ nur EINER EINZIGEN Person zugewiesen werden
bit3.5.0
ModifyDü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
tinyint3.5.0
VisibleWenn „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
bit3.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
SortNoBestimmt die Reihenfolge des Merkmals „ID“ innerhalb aller Merkmale
smallint3.5.0
Sortierung der Rückgabe

(parameterunabängige Sortierung)

  • SortNo (absteigend)

Output-Parameter

Die Prozedur hat keine Output-Parameter.

Mögliche Return-Codes

Code Beschreibung Quelle 12)
-569Der Benutzer hat kein Ausführungsrecht für die Prozedurnur indirekt
-567Die Prozedur darf z. Zt. nicht ausgeführt werdennur indirekt
-566Die Prozedur darf mit den übergebenen Parametern nicht ausgeführt werdennur indirekt
-535Das Datum liegt nicht in der Vergangenheitnur indirekt
-530Der Wert ist nicht konvertierbarnur indirekt
-510Der Benutzer ist nicht registriertnur indirekt
-504Es ist ein Problem aufgetreten, das nicht gelöst werden kann, Prozedur wird daher abgebrochendirekt und indirekt
-500Falsche Parameternur indirekt

XML-Schema

Die Rückgabe erfolgt als XML-Dokument welches gegen das Schema Response/EngineProcedure_v1_0.xsd validiert.

Historie

7.0.7 2015-01-29Interne Änderung : Datentyp-Erweiterung des „ReferenceKey“ [für „_mi_StartProcedure“-Aufruf]
6.5.2 2013-02-261. 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-301. 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-14Explizite Konvertierung nach „bit“ für „Required_CharacCategory“ falls eine Konstante zurückgegeben wird
4.0.3 2003-07-10Fehler in der Doku, Rückgabespalte „Modify“ ist vom Typ „tinyint“
4.0.0 2003-04-031. 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-23Erstmalig in dieser Version erstellt

Code-Snippets

Engine Playground

Der folgende Link öffnet in einem separaten Fenster den Engine Playground der fest mit dem dbap-demo System verbunden ist:

cURL

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 -
dStore_php
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();
engine/execute

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>
1)
Pflichtparameter sind unterstrichen
12)
direkt meint „von der Prozedur selber“ und indirekt meint „von intern aufgerufenen Unterprozeduren“
13)
I.d.R. auf Unix-artigen Systemen bereits installiert, Bestandteil der libxml2, siehe http://www.xmlsoft.org
engine/procedures/pm_getpersoncharacteristics_ad.txt · Zuletzt geändert: 11.01.2016 (Externe Bearbeitung)