api_get
Diese generische Methode ist hier dokumentiert: API & OTA-Integration#Datenlesenmitapi_get
...
| Verfügbare Tabellen | gesperrte Felder |
|---|---|
| Auftrag | PKUUID_20 |
| Auftragspositio | PKUUID_16 |
AuftragsKosten | PKUUID_63 |
| PosKonstanten | PKUUID_55 |
| PosKalkulationszeiten | PKUUID_148 |
| PosKalkulationsMaterial | PKUUID_149 |
| KalkBereiche | PKUUID_44 |
| KalkGruppen | PKUUID_45 |
| DokumentMengen | PKUUID_145 |
| Betriebsauftrag | PKUUID_100 |
| BetriebsPos | PKUUID_101 |
Hilfreiche api_get-Aufrufe für Projekte
...
Erforderliche Parameter:
Bauvorhaben, Bezeichnung
Ausgeschlossene Parameter:
PKUUID_20
Optionale Parameter:response - (true|false) bestimmt ob
| Schlüssel | Werte | Definition |
|---|---|---|
| response | JSON, HTML | bestimmt die Art der API- |
...
| Response |
...
| textupdatemode |
...
default: Standardtexte aus Voreinstellungen |
...
customer: Texte wie im Kunden hinterlegt |
...
none: Texte lassen |
...
| bestimmt wie Textbausteine für den gegebenen Kunden aktualisiert werden können | |
| paymentupdatemode | default: Zahlungsbedingungen mit den aus dem Kunden hinterlegten Werten überschreiben |
...
none: Werte aus dem Projekt stehen lassen | bestimmt ob die Zahlungskonditionen des Projekts oder des Kunden maßgeblich sind |
| update |
...
| true, false | bestimmt ob ein bestehender Datensatz aktualisiert wird, hierbei ist der zusätzliche Parameter AuftragsNr (ProjektNr e.g. PK-0003) zwingend erforderlich | |
| Bezeichnung | beliebige Zeichenkette (e.g. Holz-Elemente) | definiert die Bezeichnung des Projekts |
Konkretes Beispiel:
http://meinServer:8080/4DAction/api_put_project?token=41356A67726F4D219330ED924AE68E63&AuftragsNr=S019&update=true&Bauvorhaben=Altbau&Bezeichnung=kleines%20Nebenprojekt&textupdatemode=0&paymentupdatemode=1&response=trueJSONIn der JSON-Rückmeldung wird auch die neue vergebene AuftragsNr zurückgeliefert:
{"success":true,"error":"","wasUpdate":false,"AuftragsNr":"S014","processingTime":7819,"errorMsg":""}Die AuftragsNr wird automatisch hochgezählt und ist nicht erforderlich bei Neuanlage. Bei Aktualisierungen von bestehenden Projekten ist der Parameter allerdings zwingend erforderlich.
Wird ein neues Projekt erzeugt, so wird automatisch auch ein Projektordner nach dem in den Voreinstellungen definierten Regelwerk für Projektordner erzeugt.
api_put_projectpos - Projektposition anlegen
...
Optionale Parameter:
response, update, append
PositionsNr automatisch bestimmen lassen:
Mit dem optionalen Parameter append=True können Sie die PositionsNr auf 0 setzen. In diesem Fall wird die höchste PositionsNr ermittelt und um 1 hochgezählt
Konkretes Beispiel:
http://meinserver:8080/4DAction/api_put_projectpos?token=41356A67726F4D219330ED924AE68E63&response=trueJSON&AuftragsNr=08/15&PositionsNr=5&Anzahl=5...
http://meinserver:8080/4DAction/api_getposdelta?token=41356A67726F4D219330ED924AE68E63&response=trueJSON&projectnr=08/15&sinceutc=0
...