AfUserLogin: Unterschied zwischen den Versionen

Aus ArcFlow Wiki
Zur Navigation springen Zur Suche springen
← Zum vorherigen Versionsunterschied
K Stand 4.1.09
K Stand 4.1.14
 
Zeile 63: Zeile 63:
</table>
</table>
<div class="BigLang">
<div class="BigLang">
<p><p>Mit diesem Befehl wird eine Verbindung zur ArcFlow-Datenbank aufgebaut
Mit diesem Befehl wird eine Verbindung zur ArcFlow-Datenbank aufgebaut
und ein Benutzer angemeldet.</p>
und ein Benutzer angemeldet.


<p>In (alpha1) wird das Protokoll und der Name bzw. die IP-Adresse des  
In (alpha1) wird das Protokoll und der Name bzw. die IP-Adresse des  
CONZEPT 16-Servers übergeben, bei dem die ArcFlow-Datenbank eingetragen  
CONZEPT 16-Servers übergeben, bei dem die ArcFlow-Datenbank eingetragen  
ist. Die Informationen werden dabei in der Form <font class=source>&lt;Protokoll&gt;:&lt;Servername / IP-Adresse&gt;</font> angegeben.</p>
ist. Die Informationen werden dabei in der Form <font class=source>&lt;Protokoll&gt;:&lt;Servername / IP-Adresse&gt;</font> angegeben.


<p>Der Name der ArcFlow-Datenbank wird im zweiten Parameter eingetragen. In der Regel sollte das <font class=source>ArcFlow</font> sein.</p>
Der Name der ArcFlow-Datenbank wird im zweiten Parameter eingetragen. In der Regel sollte das <font class=source>ArcFlow</font> sein.


<p>In (alpha3) und (alpha4) wird der Benutzername und das Passwort des Benutzers angegeben. Bei der Anmeldung an ArcFlow kann der Benutzer "administrator" als alias für den Benutzer "admin" angegeben werden. Dieses Alias ist bei der API-Anweisung nicht zulässig.</p></p>
In (alpha3) und (alpha4) wird der Benutzername und das Passwort des Benutzers angegeben. Bei der Anmeldung an ArcFlow kann der Benutzer "administrator" als alias für den Benutzer "admin" angegeben werden. Dieses Alias ist bei der API-Anweisung nicht zulässig.


<p><b>Beispiel</b>{{Marker}}
== Beispiel ==
</p><p>


<tabber>
|-|ArcFlowAPI=
<pre class=source>
<pre class=source>
tErg # AfUserLogin('TCP:192.168.0.1','ArcFlow','Api','');
tResult # Af.API:AfOpen('\\dmsserver\Client\Lib');
if (tResult != _ErrOk)
{
  // Fehlerbehandlung
  ...
  return(tResult);
}
tResult # AF.API:AfUserLogin('dmsserver', 'ArcFlow', 'Api');
if (tResult != _ErrOk)
{
  // Fehlerbehandlung
  ...
  return(tResult);
}
...
</pre>
</pre>
</tabber>


<p>In diesem Beispiel wird der Benutzer "Api" angemeldet. Der Benutzer benötigt zur Anmeldung kein Passwort. Der Rückgabewert muss in jedem Fall überprüft werden.</p></p>
In diesem Beispiel wird der Benutzer "Api" angemeldet. Der Benutzer benötigt zur Anmeldung kein Passwort, wenn in ArcFlow definiert ist, dass das Kennwort des Systembenutzers bei der Anmeldung verwendet werden soll. Der Rückgabewert muss in jedem Fall überprüft werden.


<p>
Als Rückgabewert wird ein [[Allgemeine Fehlercodes#|allgemeiner Fehlerwert]]  
Als Rückgabewert wird ein [[Allgemeine Fehlercodes#|allgemeiner Fehlerwert]]  
zurückgegeben.  
zurückgegeben.  
</p><p>
  <table class=lang>
    <tr>
      <td><b>Konstante</b></td>
      <td align=center width=80><b>Wert</b></td>
      <td><b>Bedeutung</b></td>
    </tr>
    <tr class="ProcErrorItem">
      <td class=source valign=top>_ErrOk</td>
      <td align=center valign=top>0</td>
      <td>kein Fehler aufgetreten</td>
    </tr>


<table class=lang>
  <tr>
    <td><b>Konstante</b></td>
    <td align=center width=80><b>Wert</b></td>
    <td><b>Bedeutung</b></td>
  </tr>
  <tr class="ProcErrorItem">
    <td class=source valign=top>_ErrOk</td>
    <td align=center valign=top>0</td>
    <td>kein Fehler aufgetreten</td>
  </tr>
  <tr class="ProcErrorItem">
    <td class=source valign=top>sAfErrInvalidPassword</td>
    <td align=center valign=top>-1100</td>
    <td>Benutzer oder Kennwort ist falsch.</td>
  </tr>
  <tr class="ProcErrorItem">
    <td class=source valign=top>sAfErrUserLocked</td>
    <td align=center valign=top>-1110</td>
    <td>Der Benutzer wurde nach mehreren fehlerhaften Anmeldeversuchen gesperrt.</td>
  </tr>
</table>


    <tr class="ProcErrorItem">
      <td class=source valign=top>sAfErrInvalidPassword</td>
      <td align=center valign=top>-1100</td>
      <td>Benutzer oder Kennwort ist falsch.</td>
    </tr>
    <tr class="ProcErrorItem">
      <td class=source valign=top>sAfErrUserLocked</td>
      <td align=center valign=top>-1110</td>
      <td>Der Benutzer wurde nach mehreren fehlerhaften Anmeldeversuchen gesperrt.</td>
    </tr>
  </table>
</p><p>
</p>
</div>
</div>
</translate>
</translate>
[[Category:Allgemeine Befehle der API]]
[[Category:Allgemeine Befehle der API]]

Aktuelle Version vom 30. Oktober 2025, 14:15 Uhr

 AfUserLogin(alpha1, alpha2, alpha3, alpha4) : int

Ausführbar von der APINicht ausführbar von der Programmierschnittstelle (DLL)Nicht ausführbar mit der Application Remote ControlNicht ausführbar von der Script-API

Benutzer an ArcFlow anmelden
alpha1 Protokoll und Name des Servers
alpha2 Name der ArcFlow-Datenbank
alpha3 Benutzername
alpha4 Passwort
Resultat int Fehlerwert
Siehe

Verwandte Befehle, AfUserLogout(), AfOpen()

Mit diesem Befehl wird eine Verbindung zur ArcFlow-Datenbank aufgebaut und ein Benutzer angemeldet.

In (alpha1) wird das Protokoll und der Name bzw. die IP-Adresse des CONZEPT 16-Servers übergeben, bei dem die ArcFlow-Datenbank eingetragen ist. Die Informationen werden dabei in der Form <Protokoll>:<Servername / IP-Adresse> angegeben.

Der Name der ArcFlow-Datenbank wird im zweiten Parameter eingetragen. In der Regel sollte das ArcFlow sein.

In (alpha3) und (alpha4) wird der Benutzername und das Passwort des Benutzers angegeben. Bei der Anmeldung an ArcFlow kann der Benutzer "administrator" als alias für den Benutzer "admin" angegeben werden. Dieses Alias ist bei der API-Anweisung nicht zulässig.

Beispiel

tResult # Af.API:AfOpen('\\dmsserver\Client\Lib');
if (tResult != _ErrOk)
{
  // Fehlerbehandlung
  ...
  return(tResult);
}
tResult # AF.API:AfUserLogin('dmsserver', 'ArcFlow', 'Api');
if (tResult != _ErrOk)
{
  // Fehlerbehandlung
  ...
  return(tResult);
}
...

In diesem Beispiel wird der Benutzer "Api" angemeldet. Der Benutzer benötigt zur Anmeldung kein Passwort, wenn in ArcFlow definiert ist, dass das Kennwort des Systembenutzers bei der Anmeldung verwendet werden soll. Der Rückgabewert muss in jedem Fall überprüft werden.

Als Rückgabewert wird ein allgemeiner Fehlerwert zurückgegeben.

Konstante Wert Bedeutung
_ErrOk 0 kein Fehler aufgetreten
sAfErrInvalidPassword -1100 Benutzer oder Kennwort ist falsch.
sAfErrUserLocked -1110 Der Benutzer wurde nach mehreren fehlerhaften Anmeldeversuchen gesperrt.
Abgerufen von „https://wiki.arcflow.net/index.php?title=AfUserLogin&oldid=7593“