Kişiler uygulamasını başlatma

Önemli

Windows Kişiler uygulaması desteği 31 Aralık 2024'te sona erdi ve Windows 11 sürüm 24H2 ve daha yeni bir sürümden kaldırıldı. Bu sayfada belgelenen ms-people: URI düzeni artık modern Windows 11 yüklemelerinde işlevsel değildir. Uygulamalarınızda kişi yönetimi için yeni Windows için Outlook'a bakın.

Bu belgeler, eski Windows sürümleriyle çalışan geliştiriciler için başvuru amacıyla korunur.

Bu konuda ms-people: URI şeması açıklanmaktadır. WinUI'niz ve diğer Windows masaüstü uygulamalarınız bu URI düzenini kullanarak belirli eylemler için Kişiler uygulamasını başlatabilir.

ms-people: URI şeması referansı

Sonuçlar URI düzeni
Diğer uygulamaların Kişiler uygulaması Ana sayfasını başlatmasına izin verir. ms-people:
Diğer uygulamaların Kişiler uygulaması Ayarları sayfasını başlatmasına izin verir. ms-people:settings
Diğer uygulamaların, aramanın sonuç sayfasıyla Kişiler uygulamasını başlatacak bir arama dizesi sağlamasına izin verir.

Parametreler büyük/küçük harfe duyarlıdır.

Söz dizimini doğru girmezseniz veya arama dizesi değeri eksikse, varsayılan davranış herhangi bir filtreleme olmadan kişilerin tam listesini döndürmektir.

ms-people:search? SearchString=<contactsearchinfo>
Mevcut bir kişi kartı bulunursa, ona yönlendirilir. Aksi takdirde, bir kişi bulunamazsa geçici bir kişi kartına yönlendirilir. Giriş parametresi sağlanmazsa Kişiler Uygulamasını bir kişi listesiyle başlatırız.

Parametreler büyük/küçük harfe duyarlıdır.

Parametrelerin sırası önemli değildir.

Birden fazla eşleşme varsa, ilgili kişinin ilk eşleşmesini döndürüriz.

 
ms-people:viewcontact? ContactId=<contactid>&AggregatedId=<aggid>&PhoneNumber= <phonenum>&Email=<email>&ContactName=<name>&Contact=<contactobj>
Kişiler uygulamasındaki Bir Kişiyi Kaydet sayfasına, verilen kişiyi sağlanan telefon numarası veya e-posta adresiyle kaydetmek için açılır.

Parametreler büyük/küçük harfe duyarlıdır.

Parametrelerin sırası önemli değildir.

ms-people:savetocontact? PhoneNumber= <phonenum>&Email=<email>&ContactName=<name>
Verilen kişiyi kaydetmek için Kişiler uygulamasında yeni bir kişi ekleme sayfasını açar.

Yeni kişi kaydetme sayfasını açmak için LaunchUriForResultsAsync komutunu kullanın. LaunchUriAsync kullanıldığında yalnızca Kişiler uygulaması Ana sayfası başlatılır.

Parametreler büyük/küçük harfe duyarlıdır.

Parametrelerin sırası önemli değildir.

Desteklenen parametrelerin herhangi bir bileşimini kullanabilirsiniz.

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

ms-people:search: parametre referansı

Parametre Açıklama Örnek
SearchString

Opsiyonel.

İletişim arama bilgileri için arama metni.

Telefon numarası veya kişi adı.

ms-people:search?SearchString=Smith

ms-people:viewcontact: parametre referansı

Parametre Açıklama Örnek
İletişim Kimliği

Opsiyonel.

İletişim ID'si.

ms-people:viewcontact?ContactId={ContactId}

Telefon Numarası

Opsiyonel.

Kişinin telefon numarası.

ms-people:viewcontact?PhoneNumber=%2014257069326

E-posta

Opsiyonel.

Kişinin e-posta adresi.

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

Kişiadı

Opsiyonel.

Kişinin adı.

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

İletişim

Opsiyonel.

Kişi bağlantı nesnesi.

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

ms-people:savetocontact: parametre referansı

Parametre Açıklama Örnek
Telefon Numarası

Opsiyonel.

Kişinin telefon numarası.

ms-people:savetocontact?PhoneNumber=%2014257069326

E-posta

Opsiyonel.

Kişinin e-posta adresi.

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

Kişiadı

Opsiyonel.

Kişinin adı.

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

ms-people:savecontacttask: parametre referansı

Parametre Açıklama
Şirket

Opsiyonel.

İlgili kişinin şirket adı.

Ad

Opsiyonel.

İletişim kişisinin adı.

EvAdresiŞehir

Opsiyonel.

Ev adresinin şehri.

HomeAddressCountry

Opsiyonel.

Ev adresinin ülkesi.

HomeAddressState

Opsiyonel.

Ev adresinin durumu.

HomeAddressStreet

Opsiyonel.

Ev adresinin sokağı.

HomeAddressZipCode

Opsiyonel.

Ev adresinin Posta Kodu.

HomePhone

Opsiyonel.

İletişim kişisinin ev telefonu.

JobTitle

Opsiyonel.

İletişimdeki kişinin iş unvanı.

Soyadı

Opsiyonel.

İrtibat kişisinin soyadı.

İkinci Ad

Opsiyonel.

Kişinin ikinci adı.

Cep Telefonu

Opsiyonel.

Kişinin cep telefonu numarası.

Kullanıcı Adı

Opsiyonel.

Kişinin takma adı.

Notlar

Opsiyonel.

İletişim hakkındaki notlar.

Diğer E-posta

Opsiyonel.

Kişinin diğer E-posta adresi.

PersonalEmail

Opsiyonel.

Kişinin Kişisel E-posta adresi.

Soneki

Opsiyonel.

Kişinin son eki.

Başlık

Opsiyonel.

Kişi unvanı.

Web sitesi

Opsiyonel.

Kişinin web sitesi.

WorkAddressCity

Opsiyonel.

İş adresinin şehri.

WorkAddressCountry

Opsiyonel.

İş adresinin ülkesi.

WorkAddressState

Opsiyonel.

İş adresinin durumu.

WorkAddressStreet

Opsiyonel.

İş adresi.

WorkAddressZipCode

Opsiyonel.

İş adresinin Posta Kodu.

WorkEmail

Opsiyonel.

Kişinin İş E-postası.

WorkPhone

Opsiyonel.

Kişinin iş telefon numarası.

URI ile bir Windows uygulaması başlatma

URI için varsayılan uygulamayı başlatma