第3項. 電話帳機能

Rhodesでは、端末にインストールされている電話帳機能と連携をすることができます。
電話帳機能を使用するためには、build.ymlに以下を追記する必要があります。


capabilities:
  - pim

 

 1. 電話帳に登録されている情報を取得する。

電話帳の情報を取得するにはRho::RhoContact.findメソッドを使用する。
引数には以下の指定ができる。

引数 取得できる情報
“ID” 指定したIDに一致する電話帳情報
all 電話帳に登録されているすべての情報
first 電話帳に登録されている最初のデータ
count 電話帳に登録されている件数
select

指定した項目のみ抽出

※指定できる項目は下記の「選択可能な項目について」を参照。

conditions 検索条件を指定

 

検索条件の指定方法

検索条件をHash形式で渡すことで絞り込むことができる(Androidのみ)。
指定できる値は”not_nil”, ”is_nil”のいずれかを指定できる。
例: 姓が未入力のユーザを取得したい場合、
Rho::RhoContact.find(:all, :conditions => {“last_name” => “is_nil”})

  • ● :per_page - 取得件数を指定する。
  • ● :offset - データの取得開始位置

選択可能な項目について

共通項目
“last_name”
“first_name”
“mobile_number” 携帯電話番号
“business_number” (仕事)電話番号
“email_address” E-メールアドレス
“company_name” 会社名
“id” ID

 

iPhoneのみ選択可能
“prefix” 敬称(前)
“middle_name” ミドルネーム
“suffix” 敬称(後)
“nickname” ニックネーム
“birthday” 誕生日(YYYY-MM-DD)
“anniversary” 記念日(YYYY-MM-DD)
“created” 登録日(YYYY-MM-DD)
“updated” 更新日(YYYY-MM-DD)
“company_name” 会社名
“job_title” 役職
“assistant_name” 秘書名
“assistant_number” 秘書電話番号
“spouse_name” 配偶者名
“person_note” メモ、ノート

 

Androidのみ選択可能
“display_name” 表示名
“home_number” 家の電話番号

 

仕事用住所追加項目
“street_address_1” 住所
“city_1” 市町村区
“state_1” 都道府県
“zip_1” 郵便番号
“country_1” 国名

 

自宅用住所追加項目
“street_address_2” 住所
“city_2” 市町村区
“state_2” 都道府県
“zip_2” 郵便番号
“country_2” 国名

 

その他用住所追加項目
“street_address_3” 住所
“city_3” 市町村区
“state_3” 都道府県
“zip_3” 郵便番号
“country_3” 国名
“email_address” Eメールアドレス
“home_email_address” ホームメールアドレス
“other_email_address” その他のメールアドレス
“business_number” 会社の電話番号
“home_number” 家の電話番号
“mobile_number” 携帯電話番号
“main_number” メインの電話番号
“pager_number” 会社電話番号
“home_fax” 家のFAX番号
“work_fax” 会社のFAX番号
“home_page” ホームページ

 

 2. 電話帳情報を作成する

電話帳情報の作成を行うにはRho::RhoContact.create!メソッドを使用する。
引数に渡したHash情報をもとに、電話帳情報を作成する。

 

attr = {
  “display_name” => “山田 太郎”,
  “mobile_number => “0123-45-6789”,
  “email_address => “yamada_tarou@example.com”}
Rho::RhoContact.create!(attr)

 3. 電話帳情報を編集する

電話帳情報編集を行うにはRho::RhoContact.update_attributesメソッドを使用する。


attr = {
  “id” => id
  “display_name” => “山田 太郎”,
  “mobile_number => “0123-45-6789”,
  “email_address => “yamada_tarou@example.com”}
Rho::RhoContact.update_attributes(attr)

 4. 電話帳情報を削除する

電話帳情報の削除を行うにはRho::RhoContact.destroyメソッドを使用する。


Rho::RhoContact.destroy({ID})

システム工房エムのサイトへのリンク

住所〒690-0017 島根県松江市西津田3-2-3 TEL.0852-23-8590 FAX.0852-23-8591
Copyright 2008-2010 System Maker M,All right reserved