Aktueller Release

Previous
Verwenden nativer mobiler Funktionen
Next
Interne Kameraanwendung

Kontakte-API

5 views 0 Updated on July 24, 2024

Verwalten von Kontakten

Mit der JavaScipt API des Simplifier Mobile Client können Sie Ihre Kontakte in Ihren Geschäftsanwendungen verwalten.
Es gibt Methoden zum Erstellen, Lesen, Löschen und Bearbeiten von Kontakten.

Auslesen von Kontakten

Es gibt zwei Möglichkeiten, Kontakte zu lesen.
Die erste Möglichkeit besteht darin, alle vorhandenen Kontakte anzufordern.
Die zweite Möglichkeit besteht darin, einen einzelnen Kontakt aus einer Liste von Kontakten auszuwählen.

Anfordern einer Liste von Kontakten

Um eine Liste von Kontakten anzufordern, können Sie das Funktionsfenster verwenden. Contacts.find, das einen Erfolgs-Callback, einen Fehler-Callback und ein Optionsobjekt erfordert, das beschreibt, welche Kontaktfelder gefüllt werden sollen.
Der success-Parameter ist ein Array von Kontakten ohne die gefilterten Felder, die durch das Optionsobjekt definiert sind. 

window.ContactsX.find(fnSuccess, fnError, oContactOptions)

Beispiel:

window.ContactsX.find(
   function (aContacts) {
      console.log(aContacts);
   },
   function (oError) {
      console.error(oError);
   },
   {
      fields: {
         displayName:true, //default: true
         firstName:true, //default: true
         middleName:true, //default: true
         familyName:true, //default: true
         phoneNumbers:true,
         emails:false,
         addresses:false
      }
   }
);

Auswählen eines einzelnen Ansprechpartners

Die Verwendung des Funktionsfensters. ContactsX.pick startet eine Kontaktauswahl, um einen einzelnen Kontakt auszuwählen.
Die Funktion erfordert einen Erfolgsrückruf und einen Fehlerrückruf.
Der success-Parameter hat den Datentyp Contact und enthält alle Felder. 

window.ContactsX.pick(fnSuccess, fnError)

Beispiel:

window.ContactsX.pick(
   function (oSuccess) {
     console.log(oSuccess);
   },
   function (oError) {
      console.error(oError);
   }
);

Erstellen und Bearbeiten eines Kontakts

Das Methodenfenster. ContactsX.save ermöglicht das Erstellen und Bearbeiten von Kontakten.
Für diese Methode sind ein Contact-Objekt , ein Erfolgsrückruf und ein Fehlerrückruf als Parameter erforderlich.
Der Erfolgsrückruf empfängt das gespeicherte Contact-Objekt . 

window.ContactsX.save(oContact, fnError, oContactOptions)

Erstellen eines neuen Kontakts

Um einen neuen Kontakt zu erstellen, darf das Kontaktobjekt die Feld-ID nicht enthalten.

Beispiel:

window.ContactsX.save(
   {
      firstName: "John",
      familyName: "Doe",
      phoneNumbers: [{
         type: "mobile",
         value: "112"
      }]
   },
   function (oContact) {
      console.log(oContact);
   }, 
   function (oError) {
      console.error(oError);
   }
);

Bearbeiten eines vorhandenen Kontakts

Das Aktualisieren eines Kontakts funktioniert genauso wie das Erstellen eines Kontakts.
Wichtig ist hierbei, das Feld id und alle anderen Felder des Kontakts mit einzubeziehen.

Beispiel:

window.ContactsX.save(
   {
      id: "877-568-ABC",
      firstName: "John",
      familyName: "Doe",
      phoneNumbers: [{
         type: "mobile",
         value: "110112"
      }]
   },
   function (oContact) {
      console.log(oContact);
   }, 
   function (oError) {
      console.error(oError);
   }
);

Löschen eines Kontakts

Das Methodenfenster. ContactsX.delete ermöglicht das Löschen eines Kontakts.
Für diese Methode sind die ID eines vorhandenen Kontakts, ein Erfolgsrückruf und ein Fehlerrückruf als Parameter erforderlich. 

window.ContactsX.delete(sContactId, fnSuccess, fnError)

Beispiel:

window.ContactsX.delete(
   "877-568-ABC",
   function (oContact) {
      console.log(oContact);
   }, 
   function (oError) {
      console.error(oError);
   }
);

Objekte

Kontakt

id (String) – eine eindeutige Kennung displayName (String) – wird nur auf Android unterstützt: firstName (String), middleName (String), familyName (String), phoneNumbers (ContactPhoneNumber[]), E-Mail-Adressen (ContactEmail[]), Adressen (ContactAddress[])

KontaktTelefonnummer

id (String) – ein eindeutiger Identifikatortyp (String) – Typ des Werts der Telefonnummer (z. B. “mobile”, “home”) (String)

KontaktE-Mail

id (String) – ein eindeutiger Identifikator type (String) – Typ des Werts der EMail-Adresse (z. B. “work”, “home”) (String)

KontaktAdresse

id (String) – ein eindeutiger Identifikator type (String) – Typ der Adresse (z. B. “work”, “home”) Straße (String) Ort (String) Region (String) postalCode (String) Land (String)

Fehler

code (Integer) Nachricht (Zeichenfolge)

Fehlercodes

Die Feldfunktion des Fehlerobjekts kann den folgenden Wert haben, den Sie im Fenster finden. ContactX.ErrorCodes 1 – UnsupportedAction 2 – WrongJsonObject 3 – PermissionDenied 4 – CanceledAction 5 – NotFound 10 – UnknownError

Related Articles