ContactOrganization

Contiene atributos sobre la organización de un objeto Contact.

Atributos

  • pref: true si este ContactOrganization es la preferente del usuario. (boolean)
  • type: Una string que indica que tipo de campo es (ejemplo: ‘home’). _(DOMString)
  • name: El nombre de la organización. (DOMString)
  • department: El departamento de la organización a donde el usuario pertenece. (DOMString)
  • title: El titulo del usuario en su organización. (DOMString)

Detalles

El objeto ContactOrganization almacena atributos sobre la organización. Un objeto Contact guarda uno o mas objetos ContactOrganization en un array.

Plataformas Soportadas

  • Android
  • BlackBerry WebWorks (OS 5.0 y superior)
  • iOS

Ejemplo Rápido

function onSuccess(contacts) {
	for (var i=0; i<contacts.length; i++) {
		for (var j=0; j<contacts[i].organizations.length; j++) {
			alert("Preferente: " + contacts[i].organizations[j].pref + "\n" +
					"Tipo: " + contacts[i].organizations[j].type + "\n" +
					"Nombre: " + contacts[i].organizations[j].name + "\n" + 
					"Departmento: "  + contacts[i].organizations[j].department + "\n" + 
					"Titulo: "  + contacts[i].organizations[j].title);
		}
	}
};

function onError(contactError) {
    alert('onError!');
};

var options = new ContactFindOptions();
options.filter="";
filter = ["displayName","organizations"];
navigator.contacts.find(filter, onSuccess, onError, options);

Ejemplo Completo

<!DOCTYPE html>
<html>
  <head>
    <title>Ejemplo de Contacts</title>

    <script type="text/javascript" charset="utf-8" src="phonegap.js"></script>
    <script type="text/javascript" charset="utf-8">

    // Espera a que PhoneGap se inicie
    //
    document.addEventListener("deviceready", onDeviceReady, false);

    // PhoneGap esta listo
    //
    function onDeviceReady() {
		var options = new ContactFindOptions();
		options.filter="";
		filter = ["displayName","organizations"];
		navigator.contacts.find(filter, onSuccess, onError, options);
    }

    // onSuccess: Obtiene el resultado
    //
	function onSuccess(contacts) {
		for (var i=0; i<contacts.length; i++) {
			for (var j=0; j<contacts[i].organizations.length; j++) {
				alert("Pref: " + contacts[i].organizations[j].pref + "\n" +
						"Type: " + contacts[i].organizations[j].type + "\n" +
						"Name: " + contacts[i].organizations[j].name + "\n" + 
						"Department: "  + contacts[i].organizations[j].department + "\n" + 
						"Title: "  + contacts[i].organizations[j].title);
			}
		}
	};

    // onError: Ocurrió un error
    //
    function onError(contactError) {
        alert('onError!');
    }

    </script>
  </head>
  <body>
    <h1>Ejemplo</h1>
    <p>Búsqueda de Contactos</p>
  </body>
</html>

Peculiaridades Android 2.X

  • pref: Este atributo no esta soportado en Android 2.X y siempre retornara false.

Peculiaridades Android 1.X

  • pref: Este atributo no esta soportado en Android 1.X y siempre retornara false.
  • type: Este atributo no esta soportado en Android 1.X y siempre retornara null.
  • title: Este atributo no esta soportado en Android 1.X y siempre retornara null.

Peculiaridades BlackBerry WebWorks (OS 5.0 y superior)

  • pref: Este atributo no esta soportado en Blackberry y siempre retornara false.
  • type: Este atributo no esta soportado en Blackberry y siempre retornara null.
  • name: Soportado parcialmente. El primer nombre de la organización se almacenara en el campo BlackBerry company.
  • department: Este atributo no esta soportado y siempre retornara null.
  • title: Soportado parcialmente. El primer titulo se almacenara en el campo BlackBerry jobTitle.

Peculiaridades iOS

  • pref: Este atributo no esta soportado en iOS y siempre retornara false.
  • type: Este atributo no esta soportado en iOS y siempre retornara null.
  • name: Soportado parcialmente. El primer nombre de la organización sera almacenado en el campo iOS kABPersonOrganizationProperty.
  • department: Soportado parcialmente. El primer nombre del departamento sera almacenado en el campo iOS kABPersonDepartmentProperty.
  • title: Soportado parcialmente. El primer titulo sera almacenado en el campo iOS kABPersonJobTitleProperty.