chkpnt/1und1-servicedienste

Machine-readable and auto-updating versions of the 1&1 Servicedienste PDFs

1und1-servicedienste's Issues

[KB] UniqueId for contacts in FritzBox Phonebook XML

Background about the unique-id of contacts in the Phonebook

Question to AVM:

Guten Tag,

ich bin gerade dabei programmatisch ein Telefonbuch zu erzeugen und lese
hierzu das Beispiel auf Seite 17/18 von
https://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/x_contactSCPD.pdf

Hierzu eine Frage zur uniqueid: Muss diese über alle auf einer Fritzbox
genutzten Telefonbücher eindeutig sein oder nur innerhalb eines
Telefonbuchs? Oder ist das Element gar optional und ich kann es weglassen?

Viele Grüße

Answer:

vielen Dank für Ihre Anfrage.

In Kurzform; ja, die uniqueid ist über alle Telefonbücher übergreifend eineindeutig.

Ein Kollege hat noch etwas Hinergrund spendiert:
Dabei zu beachten ist, dass wenn ein Eintrag überschrieben werden soll, die PhonebookID auch die ID sein muss, in der der Eintrag mit entsprechender UniqueID enthalten ist.

Beispiel:

• der Kontakt "Klaudia Kleber" wird über TR064 mit SetPhonebookEntryUID in PhonebookID 0 neu angelegt. Liefert die Response zB. "NewPhonebookEntryUniqueID" mit dem Wert 20.
• Klaudia heiratet nun und soll in "Klaudia Klabautermann" umbenannt werden.
• nun muss dies entsprechend im XML mit der uniqueid 20 und an das PhonebookID 0 mit SetPhonebookEntryUID geschickt werden.
• würde man hier bspw. an PhonebookID 1 schicken (sofern es denn existier) so würde die Action in der Response wahrscheinlich die uniqueid 21 zurückliefern.
• damit wäre der alten Eintrag nicht überschrieben, sondern ein weiterer Eintrag in einem anderen Telefonbuch angelegt.