Wiki-Quellcode von get_persons.php
Zuletzt geändert von YellowFox_RD am 2025/01/20 15:36
Zeige letzte Bearbeiter
author | version | line-number | content |
---|---|---|---|
1 | (% class="box" %) | ||
2 | ((( | ||
3 | Inhaltsverzeichnis | ||
4 | ))) | ||
5 | |||
6 | {{toc/}} | ||
7 | |||
8 | Gibt die Personenliste zurück. Diese besteht aus dem Personenname und dem aktuellsten Personen Schlüssel. | ||
9 | |||
10 | = Beschreibung = | ||
11 | |||
12 | (% class="green mark" %)**GET**(%%)** get_persons.php?company**=//COMPANY_RTIKEY//**&import**=//IMPORT_RTIKEY// | ||
13 | |||
14 | = Parameter = | ||
15 | |||
16 | |=Parameter|=Beschreibung|=Typ|=Hinweis|=Pflicht | ||
17 | |company|RTI Firmenschlüssel|string| |ja | ||
18 | |import|RTI Importschlüssel für alle Fahrzeuge/Personen|string| |ja | ||
19 | |||
20 | = Rückgabe = | ||
21 | |||
22 | Es wird eine Zeichenkette zurück gegebenBei einem Fehler wird der "(% class="error" %)**403 - Verboten: Zugriff verweigert.**(%%)" HTTP-Header gesendet.. | ||
23 | |||
24 | == CSV Format == | ||
25 | |||
26 | Bei einer korrekten Anfrage werden die Personaldaten im CSV (Comma Separated Value) Format ausgeliefert wobei die erste | ||
27 | Anwortzeile immer die Kopfzeile ist, die die Feld-/Spalten Namen festlegt. Dannach folgen dann die Daten | ||
28 | |||
29 | === Metainformationen === | ||
30 | |||
31 | |=Trennzeichen|Semikolon ( ; ) | ||
32 | |=Textbegrenzer|Doppeltes Hochkomma ( " ) | ||
33 | |=Zeilenende|0x0D 0x0A (CarriageReturn LineFeed) | ||
34 | |=Header|Zeile 1 | ||
35 | |=Kodierung|UTF-8 | ||
36 | |||
37 | === Spalten === | ||
38 | |||
39 | |=Spalte|=Beschreibung | ||
40 | |NAME|Name der Person | ||
41 | |KEY|aktuellster Personalschlüssel | ||
42 | |EMPL_NR|Mitarbeiternummer | ||
43 | |||
44 | === Beispielaufruf === | ||
45 | |||
46 | **Personenliste** | ||
47 | {{code language="java"}}https://map.yellowfox.de/rti/get_persons.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY{{/code}} | ||
48 | |||
49 | === Beispielantwort === | ||
50 | |||
51 | **Personenliste** | ||
52 | {{code language="java"}}"NAME";"KEY";"EMPL_NR" | ||
53 | "Mr. Miller";"SP12345";"" | ||
54 | "Mrs. Meier";"SP48234";"1234"{{/code}} | ||
55 | |||
56 | |||
57 |