AfScriptLstGet

AfScriptLstGet(handle1) : int
Informationen zu einem Skript ermitteln
handle1 Deskriptor einer leeren CTE-Liste Resultat int Fehlerwert Siehe Verwandte Befehle

Mit dieser Funktion können Informationen über die in ArcFlow vorhandenen Skripte ermittelt werden. Im Parameter (handle1) muss der Deskriptor einer leeren Cte-Liste übergeben werden, die vor dem Aufruf der Funktion über den Befehl AfCteOpen() angelegt wurde.

Nach dem Aufruf der Funktion ist pro Skript ein Objekt in der Cte-Liste vorhanden. Die Objekte können geladen und über die Eigenschaft "Name" der Name des Skripts ermittelt werden. In der Eigenschaft "Custom" stehen weitere Informationen mit #$# getrennt zur Verfügung. Die Informationen können zum Beispiel mit der Anweisung AfStrGet() ermittelt werden:

AfStrGet(tCteItem->spCustom,'#$#',1)	Benutzerkürzel, der zuletzt das Skript geändert hat.
AfStrGet(tCteItem->spCustom,'#$#',2)	Datum der letzten Änderung.
AfStrGet(tCteItem->spCustom,'#$#',3)	Uhrzeit der letzten Änderung.
AfStrGet(tCteItem->spCustom,'#$#',4)	Information, wo das Skript aufgerufen wird.

Beispiele

ScriptAPIArcFlowAPIArcFlow.NEXT

tCteList # AfCteOpen(_CteList);
tResult # AfScriptLstGet(tCteList);
for tCteItem # tCteList->CteRead(_CteFirst);
loop tCteItem # tCteList->CteRead(_CteNext, tCteItem);
while (sAFHdlExists(tCteItem))
{
  tScriptName # tCteItem->spName; // AfArcSearchToAbm
  tUser # AfStrGet(tCteItem->spCustom,'#$#',1); // admin out of admin#$#28.06.2024#$#15:09#$#Add-on - Kontextmenü: AfArcSearchToAbm
  ...
}
tCteList->AfCteCloseAll();

tCteList # CteOpen(_CteList);
tResult # AF.API:AfScriptLstGet(tCteList);
for tCteItem # tCteList->CteRead(_CteFirst);
loop tCteItem # tCteList->CteRead(_CteNext, tCteItem);
while (tCteItem > 0)
{
  tScriptName # tCteItem->spName; // AfArcSearchToAbm
  tUser # AF.API:AfStrGet(tCteItem->spCustom,'#$#',1); // admin out of admin#$#28.06.2024#$#15:09#$#Add-on - Kontextmenü: AfArcSearchToAbm
  ...
}
tCteList->CteClear(true);
tCteList->CteClose();

af.next.AfScriptLstGet().then( result => {
  result.returnValues.scriptList.forEach(script => {
      console.log(script.afScriptName+'/'+script.afInformations);
  });
});

Es werden keine Skripte von ArcFlow.NEXT zurückgegeben. Das Resultat nach erfolgreicher Ausführung der Anweisung befindet sich in folgenden Variablen:

Variable	Bedeutung
...returnValues.afScriptList	Array mit Skriptinformationen
...returnValues.afScriptList[0].afScriptName	Name desSkripts
...returnValues.afScriptList[0].afInformations	Informationen zum Skript mit "#$#" getrennt
...returnValues.afScriptList.length	Anzahl der Skripte

Es werden nur die allgemeinen Fehlerwerte zurückgegeben.