Zum Hauptinhalt springen

UrmRead

Dieser Befehl wird verwendet, um Objekte aus der Benuterverwaltung zu lesen. In Abhängigkeit des übergebenen Objekttyps werden unterschiedliche Informationen ausgelesen. Folgende Informationen können gelesen werden:

  • Benutzer

    Um Benutzer zu lesen, wird als Eltern-Objekt (obj) 0 und in (int1) _UrmTypeUser übergeben. Der Rückgabewert ist der Anmeldename des Benutzers.

  • Benutzergruppen

    Um die Benutzergruppen zu lesen, wird als Eltern-Objekt (obj) 0 und in (int1) _UrmTypeUserGroup übergeben. Der Rückgabewert entspricht dem Namen der Benutzergruppe.

  • Elementgruppe

    Um die Elementgruppen zu lesen, wird als Eltern-Objekt (obj) 0 und in (int1) _UrmTypeElmGroup übergeben. Zurückgegeben wird der Name der Elementgruppe.

  • Eigenschaften

    Um die Eigenschaften zu lesen, wird als Eltern-Objekt (obj) das auszulesende Objekt übergeben. Soll eine von CONZEPT 16 vordefinierte Eigenschaft gelesen werden muss in (int1) _UrmTypeSysProperty, soll eine benutzerdefinierte Eigenschaft gelesen werden, muss _UrmTypeProperty übergeben werden. Zurückgegeben wird der Name der Eigenschaft.

  • Mitgliedschaften

    Um die Benutzer einer Benutzergruppe zu lesen, wird als Eltern-Objekt (obj) der Deskriptor der Benutzergruppe angegeben. Sollen die Benutzergruppen ermittelt werden, denen ein Benutzer angehört, wird als (obj) der Deskriptor des Benutzers angegeben. In (int1) wird _UrmTypeMember übergeben. Zurückgegeben wird der Name des Benutzers bzw. der Benutzergruppe.

  • Rechte einer Benutzergruppe

    Um die Elementgruppen mit bestimmten Berechtigungen zu lesen, wird der Deskriptor der Benutzergruppe als (obj) und in (int1) _UrmTypePerm übergeben. Das Recht steht in (alpha3). Zurückgegeben werden alle Elementgruppen, auf die Rechte vergeben sind.

  • Eintrag in einer Elementgruppe

    Um die Einträge einer Elementgruppe zu lesen, wird als Eltern-Objekt (obj) der Desktiptor der Elementgruppe und in (int1) eine _UrmTypeElm...-Konstante übergeben. Zurückgegeben wird der Name eines Eintrags.

In (int2) wird der Lesemodus übergeben. Soll das erste (_UrmFirst) oder das letzte Element (_UrmLast) gelesen werden, muss kein Referenz-Element in (alpha3) angegeben werden. Dies ist nur notwendig, wenn die Parameter _UrmPrev oder _UrmNext oder die Existenz eines Elements (int2 = 0) überprüft werden soll.

Zurückgegeben wird der Name des entsprechenden Elements. Konnte kein Objekt gefunden werden, wird ein Leerstring zurückgegeben.

Beispiele:

// Alle Benutzergruppen ermitteln
for   tUsrGrpName # UrmRead(0, _UrmTypeUserGroup, _UrmFirst);
loop  tUsrGrpName # UrmRead(0, _UrmTypeUserGroup, _UrmNext, tUsrGrpName);
while (tUsrGrpName != '')
{
  ...
}

// Alle Benuzter einer Benutzergruppe ermitteln
tHdlUsrGrp # UrmOpen(_UrmTypeUserGroup, _UrmLock, 'Sales');
for   tUsrName # tHdlUsrGrp->UrmRead( _UrmTypeMember, _UrmFirst);
loop  tUsrName # tHdlUsrGrp->UrmRead(_UrmTypeMember, _UrmNext, tUsrName);
while (tUsrName != '')
{
  ...
}

Mögliche Laufzeitfehler: