Wiki-Quellcode von timerecording/set_costcenter.php
Zuletzt geändert von YellowFox_RD am 2025/01/20 15:37
Zeige letzte Bearbeiter
author | version | line-number | content |
---|---|---|---|
1 | (% class="box" %) | ||
2 | ((( | ||
3 | Inhaltsverzeichnis | ||
4 | ))) | ||
5 | |||
6 | {{toc/}} | ||
7 | |||
8 | (% class="box" %) | ||
9 | ((( | ||
10 | **Kompatibilität** | ||
11 | Diese Funktion ist nur für Kunden mit aktivierter Zeiterfassung V3 verfügbar. | ||
12 | ))) | ||
13 | |||
14 | Erlaubt das anlegen, bearbeiten und löschen von Kostenstellen. | ||
15 | |||
16 | = Beschreibung = | ||
17 | |||
18 | (% class="blue mark" %)**POST**(%%)** //timerecording/set_costcenter.php?company//**//=//COMPANY_RTIKEY//**&import**=//COMPANY_IMPORTKEY**&action**=ACTION_TYPE**&name**=COSTCENTER_IDENT**&name**=COSTCENTER_NAME**&valid_from**=COSTCENTER_VALIDFROM_DATETIME**&valid_to**=COSTCENTER_VALIDTO_DATETIME**&planned_duration**=COSTCENTER_DURATION**&defined_activities**=COSTCENTER_ACTIVITIES**&allow_other_activities**=COSTCENTER_OTHER_ACTIVITIES_OPTION**&defined_persons**=COSTCENTER_PERSONS | ||
19 | |||
20 | = //Parameter// = | ||
21 | |||
22 | |||
23 | |=Parameter|=Beschreibung|=Typ|=Hinweis|=Pflicht | ||
24 | |company|RTI Firmenschlüssel|string| |ja | ||
25 | |import|RTI Importschlüssel|string| |ja | ||
26 | |action|Unterscheidung der verschiedenen Aktionen|string|zulässige Modi sind:((( | ||
27 | * new: eine neue Kostenstelle anlegen | ||
28 | * update: Daten einer angelegten Kostenstelle ändern | ||
29 | * delete: eine angelegte Kostenstelle löschen | ||
30 | )))|ja | ||
31 | |ident|Kennung der Kostenstellen|string|Eindeutige Kennung der Kostenstelle. | ||
32 | Nur mit dieser Kennung ist später möglich eine Kostenstelle wieder zu bearbeiten oder zu löschen.|ja | ||
33 | |name|Name der Kostenstelle|string| |ja(1) | ||
34 | |valid_from|Beginn der Gültigkeit der Kostenstelle|string|YYYYmmddHHiiss|ja(1) | ||
35 | |valid_to|Ende der Gültigkeit der Kostenstelle|string|YYYYmmddHHiiss|nein | ||
36 | |planned_duration|Geplante Dauer der Kostenstelle|integer|in Minuten|nein | ||
37 | |defined_activities|Festgelegte Tätigkeiten der Kostenstellen|array|Ein Array von Objekten die die Kennung (string) und eine optionale Planungsdauer in Minuten (integer oder string) pro Tätigkeit enthalten. | ||
38 | Die Kennung der Tätigkeiten muss eindeutig sein und bereits im System hinterlegt sein. | ||
39 | Beispiel: | ||
40 | {{code language="js"}}[ | ||
41 | { | ||
42 | "ident": "A100", | ||
43 | "duration": 2000 | ||
44 | }, | ||
45 | { | ||
46 | "ident": "A200", | ||
47 | "duration": null | ||
48 | }, | ||
49 | { | ||
50 | "ident": "A300" | ||
51 | } | ||
52 | ]{{/code}}|nein | ||
53 | |allow_other_activities|Diese Option legt fest ob neben den übergebenen Tätigkeiten "defined_activities" auch andere Tätigkeiten für die Buchung erlaubt sind.|integer|Mögliche Werte: 0 oder 1 | ||
54 | Standard: 0|nein | ||
55 | |defined_persons|Festgelegte Personen der Kostenstelle|array|Ein Array von Mitarbeiternummern(string). | ||
56 | Werden Personen für eine Kostenstelle festgelegt, so ist es nur noch diesen Personen möglich auf diese Kostenstelle zu buchen. | ||
57 | Die Mitarbeiternummer wird über die Personalverwaltung für jede Person separat festgelegt. | ||
58 | Beispiel: | ||
59 | {{code language="js"}}[ "M1000", "M1001", "M1002" ]{{/code}}|nein | ||
60 | |||
61 | Hinweise: | ||
62 | (1) Pflichtfeld beim Anlegen einer Kostenstelle | ||
63 | |||
64 | Werden Felder beim Bearbeiten von Kostenstellen nicht übermittelt, so werden diese nicht verändert. | ||
65 | |||
66 | = Rückgabe = | ||
67 | |||
68 | Beim Anlegen und Bearbeiten wird im Erfolgsfall "**COSTCENTER_DATA_SAVED**" zurückgegeben. | ||
69 | Beim Löschen einer Kostenstellen wird im Erfolgsfall "**COSTCENTER_DELETED**" zurückgegeben. | ||
70 | Bei fehlenden oder fehlerhaften Eingaben wird ein "(% class="error" %)**ERROR:Beschreibung**(%%)" zurückgegeben. | ||
71 | |||
72 | = Beispiele = | ||
73 | |||
74 | **Anlegen einer Kostenstellen mit allen Feldern** | ||
75 | {{code language="java"}}https://map.yellowfox.de/rti/timerecording/set_costcenter.php?company=COMPANY_RTIKEY&import=COMPANY_IMPORTKEY&action=new&ident=B1234&name=Baustelle&valid_from=20210101000000&valid_to=20211231235959&planned_duration=10000&defined_activities=[{"ident":"A100","duration":5000},{"ident":"A200",duration:5000}]&allow_other_activities=0&defined_persons=["M1000","M1001"]{{/code}} | ||
76 | |||
77 | **Bearbeiten des Namens einer Kostenstellen** | ||
78 | {{code language="java"}}https://map.yellowfox.de/rti/timerecording/set_costcenter.php?company=COMPANY_RTIKEY&import=COMPANY_IMPORTKEY&ident=B1234&action=update&name=Büro{{/code}} | ||
79 | |||
80 | **Löschen einer Kostenstellen** | ||
81 | {{code language="java"}}https://map.yellowfox.de/rti/timerecording/set_costcenter.php?company=COMPANY_RTIKEY&import=COMPANY_IMPORTKEY&ident=B1234&action=delete{{/code}} | ||
82 |