applican

マイページに戻る

Contact

端末内の連絡先情報です。

プロパティ

id : String 固定のIDです。
displayName : String 連絡先の名称です。
name : ContactName 個人名に関する情報です。
nickname : String ニックネームです。
phoneNumbers : ContactField[] 連絡先のすべての電話番号の配列です。
emails : ContactField[] 連絡先のすべてのメールアドレスの配列です。
addresses : ContactAddress 連絡先のすべての住所の配列です。
ims : ContactField[] 連絡先のすべてのIMアドレスの配列です。
organizations : ContactOrganization 連絡先のすべての組織名の配列です。
birthday : Date 連絡先の誕生日です。
note : String 連絡先のメモです。
photos : ContactField[] 連絡先の写真の配列です。
categories : ContactField[] 連絡先のユーザー定義カテゴリーの配列です。
urls : ContactField[] 連絡先に関連したURLの配列です。

メソッド

clone

メソッド説明

clone()

連絡先情報のコピーを作成します。

パラメータ

(none)

Return

void

サンプルコード

//連絡先オブジェクトをコピー
var clone = contact.clone();
clone.name.givenName = "太郎";
console.log( "コピー元の名前 = " + contact.name.givenName);
console.log( "コピー先の名前 = " + clone.name.givenName);

remove

メソッド説明

remove(Function successCallback, Function errorCallback)

連絡先を削除します。

パラメータ

successCallback : Function 連絡先を削除出来た場合にCallbackされます。
errorCallback : Function 連絡先を削除出来なかった場合にCallbackされます。

Return

void

サンプルコード

function onSuccess() {
	alert("削除に成功しました。");
};

function onError(e) {
	alert("エラー = " + e.code);
};

//連絡先を削除
contact.remove(onSuccess,onError);

save

メソッド説明

save(Function<Contact> successCallback, Function errorCallback)

新しい連絡先を保存します。idが既に登録されている場合は上書きします。

パラメータ

successCallback : Function<Contact> 連絡先を保存出来た場合にCallbackされます。
errorCallback : Function 連絡先を保存出来なかった場合にCallbackされます。

Return

void

サンプルコード

//連絡先を保存
function saveContact(){
	var myContact = applican.contacts.create();
	myContact.displayName = "Test displayName 1";
	myContact.nickname = "Test nickname 1";
	myContact.note = "この連絡先のメモ";

	var name = new ContactName();
	name.givenName = "Jane";
	name.familyName = "Doe";
	myContact.name = name;

	var address = new ContactAddress();
	address.pref = false;
	address.type = "home";
	address.formatted = "";
	address.streetAddress = "大崎 1-1-1";
	address.locality = "品川区";
	address.region = "東京都";
	address.postalCode = "1410032";
	address.country	= "日本";

	var address2 = new ContactAddress();
	address2.pref = false;
	address2.type = "work";
	address2.formatted = "";
	address2.streetAddress = "大崎 1-1-1";
	address2.locality = "品川区";
	address2.region	= "東京都";
	address2.postalCode = "1410032";
	address2.country = "日本";
	myContact.addresses	= [address, address2];
	var phone = new ContactField("home", "1234567890", false);
	var phone2 = new ContactField("work", "77777777777", false);
	var phone3 = new ContactField("カスタム", "0399998888", false);
	myContact.phoneNumbers = [phone, phone2, phone3];

	var url = new ContactField("home", "http://google.co.jp/", false);
	var url2 = new ContactField("work", "http://www.yahoo.co.jp/", false);
	myContact.urls = [url, url2];

	var email = new ContactField("home", "test＠mail.com", false);
	var email2 = new ContactField("work", "friends＠ocorp.jp", false);
	myContact.emails = [email, email2];

	var im = new ContactField("Skype", "1234", false);
	var im2 = new ContactField("Facebook", "4444", false);
	myContact.ims = [im, im2];

	var organization = new ContactOrganization();
	organization.type = "work";
	organization.name = "株式会社あいう";
	organization.department = "営業部";
	organization.title = "部長";
	myContact.organizations = [organization];

	myContact.birthday = new Date("1977/06/21");

	var photo = new ContactField("url", "http://somedomain.com/picture.jpg");

	myContact.photos = [photo];

	myContact.save(saveContact_onSuccess,saveContact_onError);
}
function saveContact_onSuccess(){
	var dump = "saveContact_onSuccess\n";
	document.getElementById("dumpAreaContacts").value =dump;
}
function saveContact_onError(){
	var dump = "saveContact_onError\n";
	document.getElementById("dumpAreaContacts").value =dump;
}