Seitenvergleich

api_get

Diese generische Methode ist hier dokumentiert: API & OTA-Integration#Datenlesenmitapi_get

Die Optionen innerhalb der Projekte API sind hier gelistet

Hilfreiche api_get-Aufrufe für Projekte

...

Projekte abrufen

mit AuftragsNr, Bauvorhaben, Bezeichnung, Erfassungsdatum, Lieferwoche, Status und KundenNr

http://meinserver:8080/4DAction/api_get?token=F9608E0E6CBD4177A02FB5934AAD2B4F&table=Auftrag&fields=AuftragsNr,Bauvorhaben,Bezeichnung,Erfassungsdatum,Lieferwoche,Status,KundenNr

...

Projektpositionen abrufen

Für gegebenes Projekt mit der Nummer S004 mit AuftragsNr, PositionsNr, ArtikelTypNr, Menge, Status und Verkaufspreis

http://meinserver:8080/4DAction/api_get?token=F9608E0E6CBD4177A02FB5934AAD2B4F&query=AuftragsNr%20=%20S004&table=Auftragspositio&fields=AuftragsNr,PositionsNr,Status,ArtikelTypenNr,Anzahl,VKPreis

...

Projekte API testen

Image Added

Wir haben auf GitHub und unseren FTP-Servern Templates bereitgestellt mit denen Sie die API's von profacto ausprobieren können. Mit dem Projekte API Template können Sie schnell und unkompliziert Aufrufe der API durchführen und das Ergebnis begutachten.

Projekte - API-Methoden

api_get_qr - Gibt eine Liste aller Projekte

Erforderliche Parameter: 

...

Es wird eine Übersicht von allen Projekten, einschließlich Bauvorhaben, Kommission und Status zurück gegeben.

api_put_project (Alle API) - Projekt anlegen

Erforderliche Parameter: 

Bauvorhaben, Bezeichnung

Ausgeschlossene Parameter:

PKUUID_20

Optionale Parameter:response - (true|false) bestimmt ob

...

...

...

...

...

...

...

...

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=trueJSON

In 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

Erforderliche Parameter: 

...

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

...

{"success":true,"error":"","wasUpdate":false,"AuftragsNr":"08/15","PositionsNr":5,"processingTime":28575,"errorMsg":""}

api_getposdelta - Ermittelt die für das übergebene Projekt seit dem als zweiten Parameter gegebenen Zeitstempel erfolgten Änderungen an Projektpositionen

Erforderliche Parameter: 

...

http://meinserver:8080/4DAction/api_getposdelta?token=41356A67726F4D219330ED924AE68E63&response=trueJSON&projectnr=08/15&sinceutc=0

...

{"project": true,"givenprojectnr": "M003","error": "no_posdeltas_found"}

api_get_project_doccopylist (API Projekte) - Liste aller Belege zu einem gegebenen Projekt

Erforderliche Parameter: 

...

{"items":[{"name":" Bestellung ZEG Bautzen","status":800,"date":"16.02.17","docNr":130045,"comment":"Bestellung ZEG Bautzen","user":"Krtek Maulwurf","id":1274},{"name":" Bestellung Becher - Köln","status":800,"date":"24.05.17","docNr":130051,"comment":"Bestellung Becher - Köln","user":"Krtek Maulwurf","id":1285}],"status":"ok","resultStatus":{"success":true,"wasUpdate":false,"key":"10023","processingTime":31806,"errorMsg":""}}

api_get_project_filelist - Liefert eine Liste aller Dateien, die einem Projekt zugeordnet sind

Erforderliche Parameter: 

...