Durchsuchbare Dokumentation aufrufen | Zurück zur Dokumentationsübersicht
Navigation: Dokumentationen agorum core > ALBERT | AI > ALBERT | AI Agents > ALBERT| AI KI-Tools-Dokumentationen
Anzeigename: Updates an address in agorum core
Dieses Tool dient dazu, Adressdaten in agorum core gezielt zu ändern und zu aktualisieren. Es unterstützt verschiedene Adresstypen wie Adressbuch, Organisation, Abteilung, Person, E-Mail, Telefonnummer, Adressdaten (Straße, Stadt etc.), Link und Info. Für jeden Typ können spezifische Metadaten aktualisiert werden. Die Änderung erfolgt immer auf Basis der eindeutigen Objekt-ID (id/UUID) des zu ändernden Adressobjekts.
Das Tool eignet sich, um Adressdaten zentral und automatisiert zu pflegen oder zu aktualisieren – etwa im Rahmen von Integrationen oder Massenänderungen, bei denen Adressinformationen in agorum core aktuell gehalten werden müssen.
| Parameter | Beschreibung |
|---|---|
| type (Pflicht) |
Gibt an, welcher Adresstyp geändert werden soll. Mögliche Werte: book, organisation, department, person, mail, phone, data, link, info. |
| id (Pflicht) |
Die ID oder UUID des zu ändernden Objekts. Akzeptiert werden agorum core IDs, UUIDs oder Pfade. |
| book (Optional) |
Objekt mit Feldern für Adressbuch: name (Name des Adressbuchs), description (Beschreibung). |
| organisation (Optional) |
Objekt mit Feldern für Organisation: name, additionalName1, additionalName2, customerNumber, taxNumber, description, salesTaxIdentificationNumber. |
| department (Optional) |
Objekt mit Feldern für Abteilung: name, additionalName1, additionalName2, customerNumber, taxNumber, description, salesTaxIdentificationNumber. |
| person (Optional) |
Objekt mit Feldern für Person: salutation (mr, mrs, mrmrs, family), title, givenName, familyName, familyStatus (unmarried, married, unknown), dateOfBirth (ISO), description, sex (male, female, unknown), placeOfBirth, maidenName, welcomeMessage. |
| mail (Optional) |
Objekt mit Feldern für E-Mail: mailAddress, defaultMailAddress (boolean). |
| phone (Optional) |
Optional. Objekt mit Feldern für Telefonnummer: type (telephone, mobile, fax), defaultNumber (boolean), phoneNumber (Format: +Land Vorwahl Nummer[-Durchwahl]). |
| data (Optional) |
Objekt mit Feldern für Adressdaten: street1, zip, city, state, country (ISO-Code), postBox, zipPostBox, cityPostBox, houseNumber1. |
| link (Optional) |
Objekt mit Feldern für Link: link (URL), defaultLink (boolean), subject (Beschreibung). |
| info (Optional) |
Objekt mit Feldern für Info: jobTitle (Pflicht), activityRate (Prozentsatz). |
Aktualisiere die Telefonnummer für die Adresse mit der UUID 8d5b55f0-2ca3-11f0-9c15-02420a0a0005:
{
"type": "phone",
"id": "8d5b55f0-2ca3-11f0-9c15-02420a0a0005",
"phone": {
"phoneNumber": "+49 711 123456",
"defaultNumber": false,
"type": "telephone"
}
}
Tipp: Das Tool gibt nach erfolgreicher Änderung die UUID und einen Direktlink zum geänderten Objekt zurück.