AfAbmFldGrpNbpUsrGrpLstGet

AfAbmFldGrpNbpUsrGrpLstGet(alpha1, int2, handle3, var logic4[, int5]) : int
Alle Benutzergruppen mit Rechten ermitteln
alpha1 Name der Mappenfeldgruppe int2 Id der Notizbuchseite handle3 Deskriptor einer leeren CTE-Liste logic4 true, wenn alle Benutzergruppen berechtigt sind int5 Id der Mappenfeldgruppe (optional) Resultat int Fehlercode Siehe Verwandte Befehle, AfAbmFldGrpNbpUsrLstGet()

Mit dieser Anweisung werden alle Benutzergruppen ermittelt, die Berechtigungen an dem Notizbuch der Mappenfeldgruppe besitzen. Der Name der Mappenfeldgruppe und die Id der Notizbuchseite werden in den Parametern (alpha1) und (int2) übergeben. In (handle3) wird der Deskriptor einer leeren CTE-Liste (siehe AfCteOpen()) übergeben. In (logic4) muss eine logische Variable übergeben werden.

Nach erfolgreicher Ausführung der Anweisung ist in der übergebenen Liste für jede berechtigte Benutzergruppe ein Element vorhanden. Der Name der Benutzergruppe ist in der Eigenschaft "Name" gespeichert. Ist die Notizbuchseite für alle Benutzergruppen freigegeben, ist diese Liste leer. Statt dessen hat die in (logic4) übergebene Variable den Wert true.

Wird im optionalen Parameter (int5) die Id einer Mappenfeldgruppe angegeben, wird der Parameter (alpha1) nicht ausgewertet.

Beispiel

ScriptAPIArcFlowAPI

tUsrGrpList # AfCteOpen(_CteList);
tErr # AfAbmFldGrpNbpUsrGrpLstGet('Customer',1,tUsrGrpList,var tAllUsrGrp);
if (tErr != _ErrOk)
{
  // Error-Handling
  ...
}
else
{
  if (tAllUsrGrp)
  {
    // User allowed
    tPrivileged # true;
  }
  for tUsrGrpItem # tUsrGrpList->CteRead(_CteFirst);
  loop tUsrGrpItem # tUsrGrpList->CteRead(_CteNext, tUsrGrpItem);
  while (tUsrGrpItem > 0)
  {
    if (StrCnv(tUsrGrpItem->spName,_StrUpper) = 'CONTROLING')
    {
      tPrivileged # true;
      break;
    }
  }
  tUsrGrpList->AfCloseAll();
}

tUsrGrpList # CteOpen(_CteList);
tErr # AF.API:AfAbmFldGrpNbpUsrGrpLstGet('Customer',1,tUsrGrpList,var tAllUsrGrp);
if (tErr != _ErrOk)
{
  // Error-Handling
  ...
}
else
{
  if (tAllUsrGrp)
  {
    // User allowed
    tPrivileged # true;
  }
  for tUsrGrpItem # tUsrGrpList->CteRead(_CteFirst);
  loop tUsrGrpItem # tUsrGrpList->CteRead(_CteNext, tUsrGrpItem);
  while (tUsrGrpItem > 0)
  {
    if (StrCnv(tUsrGrpItem->spName,_StrUpper) = 'CONTROLING')
    {
      tPrivileged # true;
      break;
    }
  }
  tUsrGrpList->CteClear(true);
  tUsrGrpList->CteClose();
}

Neben den allgemeinen Fehlerwerten können folgende Werte zurückgegeben werden:

Konstante	Wert	Bedeutung
_ErrOk	0	ok - kein Fehler aufgetreten
_ErrHdlInvalid	-191	Der in (handle3) übergebene Deskriptor ist ungültig.
sAfErrNoRecAbmFldGrp	-20038	Die in (alpha1) oder (int5) angegebene Mappenfeldgruppe ist nicht vorhanden.

Für weitere CONZEPT 16-spezifische Rückgabewerte siehe die aktuelle CONZEPT 16-Hilfe.