AfArcReadCustomFld: Unterschied zwischen den Versionen
Zur Navigation springen
Zur Suche springen
Jens (Diskussion | Beiträge) K Jens verschob die Seite AFArcReadCustomFld nach AfArcReadCustomFld, ohne dabei eine Weiterleitung anzulegen |
Jens (Diskussion | Beiträge) K Stand 4.1.09 |
||
| Zeile 6: | Zeile 6: | ||
</tr> | </tr> | ||
<tr class="ProcSyntax"> | <tr class="ProcSyntax"> | ||
<td class="title"> | <td class="title"> AfArcReadCustomFld(alpha1, alpha2, int3[, alpha4]) : int</td> | ||
<td class="platforms"> | <td class="platforms"> | ||
[[file:DE_SymbolAPI.gif|alt=Ausführbar von der API|link=Befehle der Schnittstellen]][[file:DE_SymbolNoDLL.gif|alt=Nicht ausführbar von der Programmierschnittstelle (DLL)|link=Befehle der Schnittstellen]][[file:DE_SymbolNoARC.gif|alt=Nicht ausführbar mit der Application Remote Control|link=Befehle der Schnittstellen]][[file:DE_SymbolScriptAPI.gif|alt=Ausführbar von der Script-API|link=Befehle der Schnittstellen]] | [[file:DE_SymbolAPI.gif|alt=Ausführbar von der API|link=Befehle der Schnittstellen]][[file:DE_SymbolNoDLL.gif|alt=Nicht ausführbar von der Programmierschnittstelle (DLL)|link=Befehle der Schnittstellen]][[file:DE_SymbolNoARC.gif|alt=Nicht ausführbar mit der Application Remote Control|link=Befehle der Schnittstellen]][[file:DE_SymbolScriptAPI.gif|alt=Ausführbar von der Script-API|link=Befehle der Schnittstellen]] | ||
| Zeile 165: | Zeile 165: | ||
<td width="85%" class=Right colspan="3"> | <td width="85%" class=Right colspan="3"> | ||
[[:Category:Befehle für Archive|Verwandte Befehle]], | [[:Category:Befehle für Archive|Verwandte Befehle]], | ||
[[ | [[AfArcRead#|AfArcRead()]] | ||
</td> | </td> | ||
</tr> | </tr> | ||
| Zeile 241: | Zeile 241: | ||
<pre class=source> | <pre class=source> | ||
// Read all archives of one type | // Read all archives of one type | ||
for tErr # | for tErr # AfArcReadCustomFld('ArchiveType', 'Invoice', 0); | ||
loop tErr # | loop tErr # AfArcReadCustomFld('ArchiveType', 'Invoice', _RecNext, gAFArcNr); | ||
while (tErr = _rOk) | while (tErr = _rOk) | ||
{ | { | ||
Aktuelle Version vom 30. Oktober 2024, 07:52 Uhr
 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| AfArcReadCustomFld(alpha1, alpha2, int3[, alpha4]) : int |
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Archiv über kundenspezifische Zusatzfelder lesen | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Die Funktion liest bei Angabe von 0 in (int3) das Archiv, dessen Zusatzfeld (alpha1) mit dem in (alpha2) übergebenen Wert übereinstimmt.
Die Suche nach dem Archiv kann an dem in (alpha4) angegebenen Archiv begonnen werden. Es wird dann ausgehend von dem angegebenen Archiv gesucht.
|
Bei Datums- und Zeitfeldern sind folgende Formate zwingend: YYYY-MM-DD bzw. HH:MM:SS. |
Über den Parameter (int3) können zudem folgende Leseoptionen übergeben werden:
| Konstante | Funktion |
| _RecFirst | Liest das erste Archiv, dessen Zusatzfeld (alpha1) gefüllt ist |
| _RecPrev | Liest das vorherige Archiv, dessen Zusatzfeld (alpha1) gefüllt ist, ausgehend vom übergebenen Archiv |
| _RecNext | Liest das nächste Archiv, dessen Zusatzfeld (alpha1) gefüllt ist, ausgehend vom übergebenen Archiv |
| _RecLast | Liest das letzte Archiv, dessen Zusatzfeld (alpha1) gefüllt ist |
| _RecLock | sperrt das Archiv für exklusiven Zugriff |
| _RecUnlock | entsperrt das Archiv |
Die Lese-Optionen können mit den Sperr-Optionen kombiniert werden.
Nach dem Aufruf der Funktion stehen in den Feldpuffern die Informationen des gelesenen Archivs zur Verfügung.
|
|
Bei Kombinationen mit der Leseoption _RecFirst, _RecPrev, _RecNext oder _RecLast wird nicht der Fehler _rNoRec zurückgegeben, wenn kein Archiv mit dem angegebenen Inhalt gefunden wurde. Statt dessen wird das Archiv gelesen, bei dem das Zusatzfeld gesetzt ist und der entsprechenden Position in der Sortierung entspricht.
|
Beispiele
// Read all archives of one type
for tErr # AfArcReadCustomFld('ArchiveType', 'Invoice', 0);
loop tErr # AfArcReadCustomFld('ArchiveType', 'Invoice', _RecNext, gAFArcNr);
while (tErr = _rOk)
{
...
}
tErr # AfArcReadCustomFld('ArchiveType', 'zzz', _RecFirst);
if (tErr = _rOk)
{
// Archive with value "zzz" in custom field
// or
// Archive with lowest value in custom field
// same as AfArcReadCustomFld('ArchiveType', '', _RecFirst);
}
Neben den allgemeinen Fehlerwerten können folgende Werte zurückgegeben werden:
| Konstante | Wert | Bedeutung |
| _ErrOk | 0 | ok - kein Fehler aufgetreten |
| _rLocked | 1 | Das Archiv ist von einem anderen Benutzer gesperrt |
| _rMultiKey | 2 | Es sind mehrere Archive mit den angegebenen Schlüsselwerten vorhanden |
| _rNoKey | 3 | Es existiert kein Archiv mit den angegebenen Kriterien |
| _rLastRec | 4 | Es existiert kein Archiv mit den angegebenen Kriterien |
| _rNoRec | 5 | Das angegebene Archiv existiert nicht |
| sAfErrNoRights | -20029 | Die Benutzerrechte reichen nicht aus |
Für weitere CONZEPT 16-spezifische Rückgabewerte siehe die aktuelle CONZEPT 16-Hilfe.
