啟動連絡人應用程式Launch the People app

本主題說明 ms 人員: URI 配置。This topic describes the ms-people: URI scheme. 您的應用程式可以使用此 URI 配置來啟動連絡人應用程式,以執行特定動作。Your app can use this URI scheme to launch the People app for specific actions.

ms-people: URI 配置參考ms-people: URI scheme reference

結果Results URI 配置URI scheme
可讓其他 app 啟動連絡人 app 主頁面。Allows other apps to launch the People app Main page. ms-people:ms-people:
可讓其他 app 啟動連絡人 app 設定頁面。Allows other apps to launch the People app Settings page. ms-people:settingsms-people:settings
可讓其他應用程式提供將會啟動含有搜尋結果頁面之連絡人應用程式的搜尋字串。Allows other apps to provide a search string that will launch the People app with the result page of the search.

這些參數區分大小寫。The parameters are case sensitive.

如果您未正確輸入語法或遺失搜尋字串值,預設行為將是傳回未經篩選的完整連絡人清單。If you do not enter the syntax correctly, or are missing the search string value, the default behavior is to return a full list of contacts without any filtering.

ms-people:search?SearchString=<contactsearchinfo>ms-people:search?SearchString=<contactsearchinfo>
如果找到連絡人,就會啟動到現有的連絡人卡片。Launches to an existing contact card, if the contact is found. 如果找不到連絡人,就會啟動到暫時連絡人卡片。Or, launches to a temporary contact card, if no contact is found. 如果未提供輸入參數,我們將會啟動含有連絡人清單的連絡人應用程式。If no input parameter is supplied, we will launch the People App with a contact list.

這些參數區分大小寫。The parameters are case sensitive.

參數的順序並不重要。The order of the parameters doesn’t matter.

如果有多個相符項目,我們會傳回第一個相符的連絡人。If there is more than one match, we will return the first match of the contact.

 
ms 人員: viewcontact?ContactId = < ContactId > & AggregatedId = < aggid > & PhoneNumber = < phonenum > & email = < 電子郵件連絡人 > & = < name > & Contact = < contactobj>ms-people:viewcontact?ContactId=<contactid>&AggregatedId=<aggid>&PhoneNumber= <phonenum>&Email=<email>&ContactName=<name>&Contact=<contactobj>
啟動到連絡人應用程式內的儲存連絡人頁面,以提供的電話號碼或電子郵件地址與儲存指定的連絡人。Launches to a Save-contact page within the People app to save the given contact with the supplied phone number or email address.

這些參數區分大小寫。The parameters are case sensitive.

參數的順序並不重要。The order of the parameters doesn’t matter.

ms-people:savetocontact?PhoneNumber= <phonenum>&Email=<email>&ContactName=<name>ms-people:savetocontact?PhoneNumber= <phonenum>&Email=<email>&ContactName=<name>
啟動至 \[連絡人\] 應用程式 中的 \[新增連絡人\] 頁面,以儲存指定的連絡人。Launches to the add a new contact page within the People app to save the given contact.

請使用 LaunchUriForResultsAsync 來開啟 \[儲存新的連絡人\] 頁面。Use LaunchUriForResultsAsync to open the save new contact page. 使用 LaunchUriAsync 只會啟動 [連絡人] App 主頁面。Using LaunchUriAsync will only launch the People app Main page.

這些參數區分大小寫。The parameters are case sensitive.

參數的順序並不重要。The order of the parameters doesn’t matter.

您可以使用任何支援的參數組合。You can use any combination of supported parameters.

ms-people:savecontacttask?PhoneNumber= <phonenum>&Email=<email>&ContactName=<name>ms-people:savecontacttask?PhoneNumber= <phonenum>&Email=<email>&ContactName=<name>

ms-people:search: 參數參考ms-people:search: parameter reference

參數Parameter 說明Description 範例Example
SearchStringSearchString

選擇性。Optional.

連絡人搜尋資訊的搜尋字串。The search string for the contact search information.

電話號碼或連絡人名稱。The phone number or the contact name.

ms-people:search?SearchString=Smithms-people:search?SearchString=Smith

ms-people:viewcontact: 參數參考ms-people:viewcontact: parameter reference

參數Parameter 說明Description 範例Example
ContactIdContactId

選擇性。Optional.

連絡人的連絡人識別碼。Contact Id of the contact.

ms-people:viewcontact?ContactId={ContactId}ms-people:viewcontact?ContactId={ContactId}

PhoneNumberPhoneNumber

選擇性。Optional.

連絡人的電話號碼。Phone number of the contact.

ms-people:viewcontact?PhoneNumber=%2014257069326ms-people:viewcontact?PhoneNumber=%2014257069326

電子郵件Email

選擇性。Optional.

連絡人的電子郵件。Email of the contact.

ms-people:viewcontact?Email=johnsmith@contsco.comms-people:viewcontact?Email=johnsmith@contsco.com

連絡人ContactName

選擇性。Optional.

連絡人的名稱。Name of the contact.

ms-people:viewcontact?ContactName=John%20%Smithms-people:viewcontact?ContactName=John%20%Smith

ContactContact

選擇性。Optional.

Contact 物件。Contact object.

ms-people:viewcontact?Contact={Serialized Contact}ms-people:viewcontact?Contact={Serialized Contact}

ms-people:savetocontact: 參數參考ms-people:savetocontact: parameter reference

參數Parameter 說明Description 範例Example
PhoneNumberPhoneNumber

選擇性。Optional.

連絡人的電話號碼。Phone number of the contact.

ms-people:savetocontact?PhoneNumber=%2014257069326ms-people:savetocontact?PhoneNumber=%2014257069326

電子郵件Email

選擇性。Optional.

連絡人的電子郵件。Email of the contact.

ms-people:savetocontact?Email=johnsmith@contsco.comms-people:savetocontact?Email=johnsmith@contsco.com

連絡人ContactName

選擇性。Optional.

連絡人的名稱。Name of the contact.

ms-people:savetocontact?Email=johnsmith@contsco.com&ContactName= John%20%Smithms-people:savetocontact?Email=johnsmith@contsco.com&ContactName= John%20%Smith

ms-people:savecontacttask: 參數參考ms-people:savecontacttask: parameter reference

參數Parameter 說明Description
公司Company

選擇性。Optional.

連絡人的公司名稱。Company name of the contact.

名字FirstName

選擇性。Optional.

連絡人的名字。First name of the contact.

HomeAddressCityHomeAddressCity

選擇性。Optional.

住家地址的縣市。City of the home address.

HomeAddressCountryHomeAddressCountry

選擇性。Optional.

住家地址的國家/地區。Country of the home address.

HomeAddressStateHomeAddressState

選擇性。Optional.

住家地址的州/省。State of the home address.

HomeAddressStreetHomeAddressStreet

選擇性。Optional.

住家地址的街道。Street of the home address.

HomeAddressZipCodeHomeAddressZipCode

選擇性。Optional.

住家地址的郵遞區號。Zip Code of the home address.

HomePhoneHomePhone

選擇性。Optional.

連絡人的住家電話號碼。Home phone of the contact.

JobTitleJobTitle

選擇性。Optional.

連絡人的職稱。Job title of the contact.

姓氏LastName

選擇性。Optional.

連絡人的姓氏。Last name of the contact.

MiddleNameMiddleName

選擇性。Optional.

連絡人的中間名。Middle name of the contact.

手機MobilePhone

選擇性。Optional.

連絡人的行動電話號碼。Mobile phone number of the contact.

暱稱Nickname

選擇性。Optional.

連絡人的暱稱。Nickname of the contact.

備註Notes

選擇性。Optional.

連絡人的附註Notes about the contact.

OtherEmailOtherEmail

選擇性。Optional.

連絡人的其他電子郵件。Other Email of the contact.

PersonalEmailPersonalEmail

選擇性。Optional.

連絡人的個人電子郵件。Personal Email of the contact.

尾碼Suffix

選擇性。Optional.

連絡人的尾碼。Suffix of the contact.

標題Title

選擇性。Optional.

連絡人的頭銜。Title of the contact.

網站Website

選擇性。Optional.

連絡人的網站。Website of the contact.

WorkAddressCityWorkAddressCity

選擇性。Optional.

工作地址的縣市。City of the work address.

WorkAddressCountryWorkAddressCountry

選擇性。Optional.

工作地址的國家/地區。Country of the work address.

WorkAddressStateWorkAddressState

選擇性。Optional.

工作位址的州/省。State of the work address.

WorkAddressStreetWorkAddressStreet

選擇性。Optional.

工作地址的街道。Street of work address.

WorkAddressZipCodeWorkAddressZipCode

選擇性。Optional.

工作地址的郵遞區號。Zip Code of the work address.

WorkEmailWorkEmail

選擇性。Optional.

連絡人的工作電子郵件。Work Email of the contact.

WorkPhoneWorkPhone

選擇性。Optional.

連絡人的工作電話號碼。Work phone number of the contact.