Wiki-Quellcode von timerecording/set_costcenter.php
Zuletzt geändert von YellowFox_RD am 2025/01/20 15:37
Verstecke letzte Bearbeiter
| author | version | line-number | content |
|---|---|---|---|
 |
1.1 | 1 | (% class="box" %) |
| |
2.1 | 2 | ((( |
| 3 | Inhaltsverzeichnis | ||
| 4 | ))) | ||
| 5 | |||
| |
1.1 | 6 | {{toc/}} |
| 7 | |||
| 8 | (% class="box" %) | ||
| 9 | ((( | ||
| |
2.1 | 10 | **Kompatibilität** |
| 11 | Diese Funktion ist nur für Kunden mit aktivierter Zeiterfassung V3 verfügbar. | ||
| |
1.1 | 12 | ))) |
| 13 | |||
| 14 | Erlaubt das anlegen, bearbeiten und löschen von Kostenstellen. | ||
| |
2.1 | 15 | |
| |
1.1 | 16 | = Beschreibung = |
| |
2.1 | 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 | |||
| |
1.1 | 20 | = //Parameter// = |
| 21 | |||
| |
2.1 | 22 | |
| |
1.1 | 23 | |=Parameter|=Beschreibung|=Typ|=Hinweis|=Pflicht |
| |
2.1 | 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:((( | ||
| |
1.1 | 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 | ||
| |
2.1 | 33 | |name|Name der Kostenstelle|string| |ja(1) |
| |
1.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"}}[ | ||
| |
2.1 | 41 | { |
| 42 | "ident": "A100", | ||
| 43 | "duration": 2000 | ||
| 44 | }, | ||
| 45 | { | ||
| 46 | "ident": "A200", | ||
| 47 | "duration": null | ||
| 48 | }, | ||
| 49 | { | ||
| 50 | "ident": "A300" | ||
| 51 | } | ||
| |
1.1 | 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 = | ||
| |
2.1 | 67 | |
| |
1.1 | 68 | Beim Anlegen und Bearbeiten wird im Erfolgsfall "**COSTCENTER_DATA_SAVED**" zurückgegeben. |
| |
2.1 | 69 | Beim Löschen einer Kostenstellen wird im Erfolgsfall "**COSTCENTER_DELETED**" zurückgegeben. |
| |
1.1 | 70 | Bei fehlenden oder fehlerhaften Eingaben wird ein "(% class="error" %)**ERROR:Beschreibung**(%%)" zurückgegeben. |
| |
2.1 | 71 | |
| |
1.1 | 72 | = Beispiele = |
| |
2.1 | 73 | |
| |
1.1 | 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 |