سروس API سے رابطہ کریں۔
حوالہ
دسمبر 2022

BEMS رابطہ سروس API کیا ہے؟

رابطہ سروس API تیسرے فریق کے بلیک بیری ڈائنامکس ایپس کو صارف کے رابطہ فولڈر اور کسی بھی فولڈرز اور ذیلی فولڈرز سے رابطہ کی معلومات کو استفسار کرنے، بازیافت کرنے، تخلیق کرنے اور اپ ڈیٹ کرنے کی اجازت دیتا ہے جو صارف اپنے میل باکس میں رابطوں کے فولڈر میں بناتا ہے۔ سابق کے لیےample، آپ مندرجہ ذیل کام کرنے کے لیے API کا استعمال کر سکتے ہیں:

• نئے رابطے بنائیں
• رابطوں کے فولڈر کے تحت فولڈرز اور سب فولڈرز بنائیں
• رابطوں کے فولڈر سے رابطوں کی مکمل فہرست بازیافت کریں۔
• کسی مخصوص فولڈر یا ذیلی فولڈر سے رابطے بازیافت کریں۔
• ایک رابطہ بازیافت کریں۔
• ایک مخصوص تاریخ کے بعد سے نئے اور تبدیل شدہ رابطوں کو بازیافت کریں۔
• موجودہ رابطے کی معلومات کو اپ ڈیٹ کریں۔

فارمیٹ کی درخواست کریں، تخلیق کریں اور اپ ڈیٹ کریں۔

آپ کو API میں BEMS اینڈ پوائنٹ کی وضاحت کرنی ہوگی۔ اختتامی نقطہ بتاتا ہے کہ آبجیکٹ ایڈریس کہاں واقع ہے۔

اختتامی نقطہ: :8443/api/contact
BEMS میں میل باکس سے رابطے کی معلومات حاصل کرنے کے لیے HTTP درخواست کا فارمیٹ یہ ہے:
پوسٹ :8443/api/contact


BEMS میں میل باکس میں رابطہ بنانے کے لیے HTTP درخواست کا فارمیٹ یہ ہے:
پوسٹ :8443/api/contact/create


BEMS میں میل باکس میں کسی رابطے کو اپ ڈیٹ کرنے کے لیے HTTP درخواست کا فارمیٹ یہ ہے:
پوسٹ :8443/api/contact/update


ایک میں رابطے کے فولڈر کے تحت اضافی فولڈرز اور ذیلی فولڈرز بنانے کے لیے HTTP درخواست کا فارمیٹ
BEMS میں میل باکس ہے:
پوسٹ :8443/api/folder/create


BEMS میں میل باکس میں رابطوں کے فولڈر کے تحت تمام فولڈرز اور ذیلی فولڈرز حاصل کرنے کے لیے HTTP درخواست کا فارمیٹ یہ ہے:
پوسٹ :8443/api/folder/get


مندرجہ ذیل کے طور پر ہےampلی ہیڈر:
مواد کی قسم: درخواست/json
X-Good-GD-AuthToken:
رابطہ فہرست کی معلومات کی درخواست کرنا
فریق ثالث کی BlackBerry Dynamics ایپس رابطے کی معلومات کو بازیافت کر سکتی ہیں جو آپ کے بتائے ہوئے عرصے کے اندر شامل کی گئی تھی، ایک مخصوص رابطہ، یا صارف کے میل باکس میں موجود رابطہ فولڈر سے رابطہ کی فہرست۔
رابطے کی فہرست کی معلومات کی خصوصیات کو بازیافت کرنا
مندرجہ ذیل جدول درخواست کے جسم کی خصوصیات کو بیان کرتا ہے جو آپ JSON فارمیٹ شدہ درخواست میں شامل کر سکتے ہیں جب آپ میل باکس میں صارف کے فولڈر سے رابطہ کی فہرست کی معلومات حاصل کرتے ہیں۔

پیرامیٹر	قسم	تفصیل
اکاؤنٹ	تار	یہ پیرامیٹر صارف کے ای میل اکاؤنٹ کی وضاحت کرتا ہے جو رابطہ کی معلومات کی درخواست کرنے کے لیے استعمال ہوتا ہے (مثال کے طور پرampلی، jamie01@ex365.example.com).
نام کے ساتھ	تار	یہ پیرامیٹر مخصوص نام کی بنیاد پر صارف کے مقامی رابطوں کو تلاش کرنے کی وضاحت کرتا ہے۔ تلاش کے نتائج میں مخصوص حروف کے سیٹ کے ساتھ تمام رابطے شامل ہیں۔ سابق کے لیےample، "ByName": "Jane" ان تمام صارفین کو واپس کرے گا جن کے پہلے نام، آخری نام، یا نام کے کسی حصے کے طور پر جین ہے۔ جب آپ اس پیرامیٹر کو استعمال کرتے ہیں، تو آپ واپس کیے گئے رابطوں کے لیے اضافی معلومات حاصل کرنے کے لیے UserShape کی خصوصیات "بنیادی" یا "تفصیل" بھی شامل کر سکتے ہیں۔ مزید معلومات کے لیے نیچے یوزر شیپ پیرامیٹر دیکھیں۔
ای میل کے زریعے	تار	یہ پیرامیٹر مخصوص ای میل ایڈریس کے ساتھ صارف کے مقامی رابطہ کی فہرست کو تلاش کرنے کی وضاحت کرتا ہے۔ جب آپ یہ پیرامیٹر استعمال کرتے ہیں، تو آپ واپس کیے گئے رابطوں کے لیے اضافی معلومات حاصل کرنے کے لیے UserShape پیرامیٹر کی خصوصیات "بنیادی" یا "تفصیل" بھی شامل کر سکتے ہیں۔ مزید معلومات کے لیے نیچے یوزر شیپ پیرامیٹر دیکھیں۔
فولڈر آئی ڈی	تار	یہ پیرامیٹر مخصوص فولڈر آئی ڈی سے رابطوں کو بازیافت کرتا ہے۔ یہ اختیاری ہے۔ اگر FolderId کی وضاحت نہیں کی گئی ہے تو، BEMS صارف کے رابطہ فولڈر سے رابطوں کو بازیافت کرتا ہے۔
زیادہ سے زیادہ نمبر	عدد	یہ پیرامیٹر تلاش کے استفسار میں واپس آنے والے رابطوں یا اشیاء کی زیادہ سے زیادہ تعداد کی وضاحت کرتا ہے۔ پہلے سے طے شدہ طور پر، BEMS ایک وقت میں صرف 512 آئٹمز تک واپس کر سکتا ہے۔ کلائنٹ کو اس سے زیادہ کی وصولی کے لیے متعدد کالیں کرنی ہوں گی۔ "آفسیٹ" پیرامیٹر ترتیب دے کر 512 آئٹمز۔ "مزید دستیاب" قدر کلائنٹ کو بتاتی ہے کہ آیا مزید اشیاء دستیاب ہیں۔ مزید معلومات کے لیے ذیل میں API رسپانس ٹیبل دیکھیں۔
آفسیٹ	عدد	یہ پیرامیٹر بیچ کے ردعمل کے نقطہ آغاز کی وضاحت کرتا ہے۔ بطور ڈیفالٹ، آفسیٹ 0 (صفر) ہے۔
چونکہ ٹی ایس	عدد (لمبا)	یہ پیرامیٹر ایک مخصوص وقت سے صارف کی ذاتی رابطہ فہرست میں نئے یا تبدیل شدہ رابطوں کی وضاحت کرتا ہے۔ چونکہ ٹی ایس کو عہد وقت کی شکل میں بیان کیا گیا ہے۔ اگر آپ نئے اور تبدیل شدہ رابطوں کو بازیافت کرنا چاہتے ہیں، تو آپ کو رابطوں کی تلاش شروع کرنے کے لیے SinceTs کی وضاحت کرنی ہوگی۔ اگر SinceTs کی وضاحت نہیں کی گئی ہے، تو BEMS صارف کے رابطہ فولڈر سے تمام رابطوں کو بازیافت کرتا ہے۔ جب آپ یہ پیرامیٹر استعمال کرتے ہیں، تو آپ واپس کیے گئے رابطوں کے لیے اضافی معلومات حاصل کرنے کے لیے UserShape پیرامیٹر کی خصوصیات "بنیادی" یا "تفصیل" بھی شامل کر سکتے ہیں۔ مزید معلومات کے لیے نیچے یوزر شیپ پیرامیٹر دیکھیں۔
یوزر شیپ	سٹرنگ صف	یہ پیرامیٹر تلاش کے نتائج میں واپس آنے والی صفات کی فہرست بتاتا ہے (مثال کے طور پرample، بنیادی، موبائل فون، جاب ٹائٹل، تصویر)۔ UserShape مشترکہ خصوصیات کی فہرست کی ایک پیش سیٹ فہرست کی حمایت کرتا ہے: بنیادی اور تفصیل۔ بنیادی اور تفصیلی جائیداد کے نام کی فہرستیں BEMS میں ترتیب دی جا سکتی ہیں۔ بنیادی: بطور ڈیفالٹ، یہ پراپرٹی درج ذیل خصوصیات کی فہرست واپس کرتی ہے: LastName، DisplayName، Email Address، اور PhoneNumbers۔ • تفصیل: ڈیفالٹ کے طور پر، یہ پراپرٹی بنیادی خصوصیات کے علاوہ پراپرٹیز کی درج ذیل فہرست واپس کرتی ہے: Phyical Addresses، CompanyName، Job Title، Department، اور Photo. اس بارے میں ہدایات کے لیے کہ منتظمین کیسے کر سکتے ہیں۔ view یا یوزر شیپ پراپرٹیز کو کنفیگر کریں، ضمیمہ دیکھیں: یوزر شیپ پراپرٹیز کو کنفیگر کریں۔

API کا جواب
مندرجہ ذیل جدول جوابی خصوصیات کی وضاحت کرتا ہے جو JSON فارمیٹ شدہ API کے جواب میں ظاہر ہوسکتی ہیں جب آپ صارف کی مقامی رابطہ فہرست سے رابطے بازیافت کرتے ہیں۔

جائیداد	قسم	تفصیل
مزید دستیاب	بولین	یہ پیرامیٹر اس بات کی نشاندہی کرتا ہے کہ واپس کیے گئے جواب سے زیادہ رابطے دستیاب ہیں۔ اگر MoreAvailable درست ہے، تو کلائنٹ API کو کال کرنا جاری رکھے گا اور "آفسیٹ" ویلیو کو پچھلے جواب میں موصول ہونے والی قدر میں تبدیل کرتا ہے۔ کلائنٹ اس کال کو اس وقت تک انجام دیتا ہے جب تک کہ MoreAvailable قدر غلط نہ ہو، جو اس بات کی نشاندہی کرتا ہے کہ واپس کرنے کے لیے مزید رابطے نہیں ہیں۔
ٹوٹل کاؤنٹ	عدد	یہ پیرامیٹر ان رابطوں کی کل تعداد بتاتا ہے جو بازیافت کے استفسار سے مماثل ہیں۔
NextPageOffset	انٹیجر یا null	یہ پیرامیٹر ان رابطوں کے دوسرے بیچ کے نقطہ آغاز کی وضاحت کرتا ہے جو واپس آئے ہیں۔
سائز	عدد	یہ پیرامیٹر جواب میں واپس کیے گئے رابطوں کی تعداد بتاتا ہے، جو کہ بتائے گئے MaxNumber سائز تک ہے۔
آفسیٹ	عدد	یہ پیرامیٹر بیچ کے ردعمل کے نقطہ آغاز کی وضاحت کرتا ہے۔
مجموعہ	MAP کی فہرست	یہ پیرامیٹر درخواست میں واپس کیے گئے رابطوں کی فہرست بتاتا ہے۔

رابطوں کی درخواست کریں۔

آپ صارف کے مرکزی رابطہ فولڈر اور صارف کے بنائے ہوئے ذیلی فولڈرز سے رابطے بازیافت کرسکتے ہیں۔
حذف شدہ رابطے واپس نہیں کیے جاتے ہیں۔ اگر درخواست میں کلائنٹ کے ذریعہ FolderId فراہم نہیں کیا جاتا ہے تو، رابطے مرکزی فولڈر سے بازیافت کیے جاتے ہیں۔
درج ذیل ایس میںample، BEMS صارف، Jamie01 کے لیے تمام رابطوں کو بازیافت کرتا ہے، کسی بھی حذف شدہ رابطوں کو چھوڑ کر، مخصوص ذیلی فولڈر سے۔ BEMS کے پہلے جواب میں 100 تک رابطے شامل ہیں، جیسا کہ MaxNumber کے ذریعے بیان کیا گیا ہے۔ ہر رابطہ جو بازیافت کیا جاتا ہے اس میں پہلے سے طے شدہ بنیادی خصوصیات شامل ہوتی ہیں جو BEMS میں بیان کی گئی ہیں۔
اگر 100 سے زیادہ رابطے دستیاب ہیں (مثال کے طور پرample، اس میل باکس میں 150 رابطوں کی کل تعداد شامل ہے) جواب میں ایک MoreAvailable صحیح ہے، اس لیے کلائنٹ ایپلیکیشن NextOffset ویلیو کا استعمال کرتے ہوئے اضافی درخواستیں بھیجتی ہے تاکہ مزید دستیاب ہونے تک روابط کو بیچ میں بازیافت کیا جا سکے۔ اس میں سابقample، بنیادی خصوصیات رابطوں کے لیے درج ذیل معلومات واپس کرتی ہیں:

• ڈسپلے کا نام
• ای میل ایڈریس
• نام دیا ہے۔
• کنیت

مندرجہ ذیل سابق میںample، کلائنٹ ایک FolderId فراہم کرتا ہے اور BEMS مخصوص فولڈر سے رابطوں کو بازیافت کرتا ہے۔اگر درخواست کامیاب ہو جاتی ہے تو، BEMS پہلے 100 رابطے واپس کرتا ہے جو استفسار کے معیار پر پورا اترتے ہیں۔ BEMS رابطوں کی کل تعداد اور NextPageOffset کو رابطوں کی اگلی کھیپ کو بازیافت کرنے کے لیے بھی واپس کرتا ہے۔کلائنٹ اگلا بیچ حاصل کرنے کے لیے پچھلی استفسار سے Offset کو NextPageOffset پر سیٹ کرتا ہے۔
BEMS کل 50 رابطوں کے لیے اگلے 150 رابطے واپس کرتا ہے۔ کوئی اضافی رابطے دستیاب نہیں ہیں۔ای میل ایڈریس اور پیش سیٹ خصوصیات کا استعمال کرتے ہوئے رابطوں کی درخواست کریں۔
آپ صارف کے رابطہ فولڈر، یا فولڈرز اور ذیلی فولڈرز سے رابطے بازیافت کر سکتے ہیں جو صارف نے میل باکس میں متعدد خصوصیات کا استعمال کرتے ہوئے بنائے ہیں (سابقہ ​​کے لیےampلی، صارف کے ای میل ایڈریس کی بنیاد پر بازیافت کریں اور رابطہ کے لیے پہلے سے سیٹ ڈیٹیل پراپرٹیز شامل کریں)۔ اس میں سابقample، جواب میں ایک رابطہ شامل ہے اور MoreAvailable غلط ہے۔ اگر 512 سے زیادہ رابطوں کی نشاندہی کی جاتی ہے، تو جواب اشارہ کرتا ہے کہ MoreAvailable درست ہے، اور کلائنٹ بیچ میں رابطوں کو بازیافت کرنے کے لیے اضافی درخواستیں بھیجتا ہے جب تک کہ MoreAvailable غلط نہ ہو۔ اگر کلائنٹ فولڈر آئی ڈی فراہم کرتا ہے، تو BEMS مخصوص فولڈر سے رابطوں کو بازیافت کرتا ہے۔اگر درخواست کامیاب ہو جاتی ہے تو، BEMS درج ذیل جواب دیتا ہے، اور فریق ثالث کی بلیک بیری ڈائنامکس ایپس ای میل ایڈریس jane_doe@ex کے ساتھ رابطوں کے لیے درج ذیل معلومات ظاہر کرتی ہیں۔ample.com اگر کوئی پراپرٹی دستیاب نہیں ہے تو، BEMS ایک کالعدم قیمت واپس کرتا ہے اور معلومات جواب میں شامل نہیں ہوتی ہے۔ اس میں سابقampلی، جین ڈو کے لیے درج ذیل معلومات ظاہر کی گئی ہیں:

• ڈسپلے نام
• دیا گیا نام
• کنیت
• پورا نام
• ای میل ایڈریس

ایک مخصوص پراپرٹی کا استعمال کرتے ہوئے رابطے کی فہرست کی معلومات کی درخواست کریں۔
آپ ان رابطوں کے لیے صارف کے رابطے کی معلومات کی درخواست کر سکتے ہیں جو مخصوص خصوصیات واپس کرتے ہیں (مثال کے طور پرample، رابطوں کا صرف پہلا نام)۔ درج ذیل ایس میںample کوڈ، BEMS صارف کے رابطہ فولڈر میں تمام رابطوں کے پہلے نام کی درخواست کرتا ہے۔ جواب میں 50 تک رابطے شامل ہیں۔ اگر کلائنٹ فولڈر آئی ڈی فراہم کرتا ہے، تو BEMS مخصوص فولڈر سے رابطوں کی درخواست کرتا ہے۔اگر درخواست کامیاب ہو جاتی ہے تو، BEMS درج ذیل جواب واپس کرتا ہے، اور فریق ثالث کی بلیک بیری ڈائنامکس ایپس رابطوں کا پہلا نام ظاہر کرتی ہیں۔

فولڈر اور سب فولڈر کی معلومات بنانا اور درخواست کرنا

تھرڈ پارٹی بلیک بیری ڈائنامکس ایپس فولڈر اور سب فولڈر کی معلومات کو بازیافت کر سکتی ہیں جو صارف نے اپنے رابطہ فولڈر میں بنایا ہے۔ ذیلی فولڈرز بھی ایک مخصوص فولڈر میں بنائے جا سکتے ہیں۔
فولڈر کے پیرامیٹرز بنانا اور اپ ڈیٹ کرنا
مندرجہ ذیل جدول درخواست کے جسم کی خصوصیات کو بیان کرتا ہے جو آپ JSON فارمیٹ شدہ درخواست میں شامل کر سکتے ہیں جب آپ صارف کے میل باکس کے رابطہ فولڈر میں فولڈر یا ذیلی فولڈر بناتے ہیں۔

پیرامیٹر	قسم	تفصیل
فولڈر کا نام	تار	یہ پیرامیٹر اس فولڈر یا ذیلی فولڈر کا نام بتاتا ہے جسے صارف نے بنایا تھا۔
پیرنٹ فولڈر آئی ڈی	تار	یہ پیرامیٹر مخصوص ParentFolderId میں رابطہ بناتا ہے۔ یہ اختیاری ہے۔ اگر ParentFolderId فراہم نہیں کیا جاتا ہے، تو BEMS صارف کے رابطہ فولڈر میں رابطہ بناتا ہے۔

ایک فولڈر یا ذیلی فولڈر بنائیں
آپ صارف کے رابطہ فولڈر میں فولڈر اور ذیلی فولڈر بنا سکتے ہیں۔ ParentFolderId اختیاری ہے۔ جب یہ فراہم نہیں کیا جاتا ہے اور ایک فولڈر بن جاتا ہے، فولڈر صارف کے رابطہ فولڈر میں ظاہر ہوتا ہے۔ درج ذیل ایس میںample کوڈ، "سپورٹ فولڈر" نامی فولڈر مخصوص ParentFolderId میں ذیلی فولڈر کے طور پر بنایا گیا ہے۔ اگر درخواست کامیاب ہو جاتی ہے، تو BEMS ایک 201 HTTP رسپانس کوڈ واپس کرتا ہے جس سے رابطہ فولڈر کامیابی کے ساتھ بن گیا ہے۔
اگر پیرنٹ فولڈر میں اسی نام کا فولڈر موجود ہے تو، BEMS 200 HTTP رسپانس کوڈ واپس کرتا ہے اور فولڈر محفوظ نہیں ہوتا ہے۔رابطہ فولڈر کے تحت تمام فولڈرز اور ذیلی فولڈرز کی درخواست کریں۔
آپ تمام فولڈرز اور ذیلی فولڈرز کو بازیافت کرسکتے ہیں جو صارف نے صارف کے رابطہ فولڈر میں بنائے ہیں۔ درج ذیل ایس میںample کوڈ، BEMS صارف کے بنائے ہوئے تمام فولڈرز کو بازیافت کرتا ہے۔اگر درخواست کامیاب ہو جاتی ہے تو، BEMS درج ذیل جواب واپس کرتا ہے، اور فریق ثالث کی بلیک بیری ڈائنامکس ایپس بازیافت شدہ فولڈر کو ظاہر کرتی ہیں۔

رابطے کی معلومات شامل کرنا

فریق ثالث کی بلیک بیری ڈائنامکس ایپس صارف کے رابطہ فولڈر میں رابطے کی معلومات، یا فولڈرز اور ذیلی فولڈرز جو صارف نے اپنے میل باکس میں بنائے ہیں تخلیق اور اپ ڈیٹ کر سکتی ہیں۔
رابطہ بناتے وقت استعمال ہونے والی خصوصیات
درج ذیل فہرست معاون باڈی خصوصیات کو دکھاتی ہے جو آپ JSON فارمیٹ شدہ درخواست میں شامل کر سکتے ہیں جب آپ میل باکس میں صارف کے فولڈر میں رابطہ بناتے ہیں۔ کوئی بھی قدر جو درخواست کے باڈی میں کالعدم یا خالی ہے رابطہ میں محفوظ نہیں کی جاتی ہے۔
اگر صارف کسی موجودہ رابطے کو اپ ڈیٹ کر رہا ہے، تو درخواست کی تمام اقدار، چاہے وہ تبدیل ہوں یا نہ ہوں، BEMS کو جمع کر دی جاتی ہیں۔ رابطہ بناتے وقت درج ذیل اقدار کی وضاحت کی جا سکتی ہے۔

• رابطہ کریں۔
  • پہلا نام
  • درمیانی نام
  • آخری نام
  • موبائل فون
  • گھر کا فون
  ہوم فون 2
  • ہوم فیکس
  • دیگر فیکس
  • ای میل ایڈریس1
  • ای میل ایڈریس2
  • ای میل ایڈریس3
  • کاروباری فون
  • بزنس فون2
  • کار فون
  • کمپنی مین فون
  • ISDN
  • کال بیک
  • ریڈیو فون
  • بنیادی فون
  اسسٹنٹ فون
  • Telex
  • TtyTddPhone
• گھر کا پتہ
  • گلی
  • شہر
  • حالت
  • ملک
  • ڈاک کامخصوص نمبر
• کام
  • کمپنی
  • ملازمت کا عنوان
  • شعبہ
  • دفتر
  • مینیجر
  • اسسٹنٹ
• کاروباری پتہ
  • گلی
  • شہر
  • حالت
  • ملک
  • ڈاک کامخصوص نمبر

ایک مخصوص پراپرٹی کا استعمال کرتے ہوئے رابطہ بنائیں
آپ مخصوص خصوصیات کا استعمال کرتے ہوئے ایک رابطہ بنا سکتے ہیں۔ درج ذیل ایس میںample کوڈ، BEMS صارف کے رابطہ فولڈر میں رابطہ بناتا ہے۔ اگر ایک ParentFolderId شامل ہے، تو رابطہ مخصوص فولڈر میں بنتا ہے۔
اس میں سابقampلی، صارف رابطہ کے لیے درج ذیل معلومات کا استعمال کرتے ہوئے ایک رابطہ بناتا ہے:

• پہلا نام
• آخری نام
• درمیانی نام
• موبائل فون
• ہوم فون
• کاروباری فون
• ای میل ایڈریس
• کمپنی کا نام

اگر رابطہ کامیابی کے ساتھ بن جاتا ہے تو، BEMS ایک منفرد ID واپس کرتا ہے اور فریق ثالث کی بلیک بیری ڈائنامکس ایپس فراہم کردہ رابطہ کی معلومات ظاہر کرتی ہیں۔ اگر کسی پراپرٹی کی وضاحت نہیں کی گئی ہے تو، BEMS ایک کالعدم قیمت واپس کرتا ہے اور معلومات کو رابطے میں محفوظ نہیں کیا جاتا ہے۔

رابطے کی فہرست کی معلومات کو اپ ڈیٹ کریں۔

آپ مخصوص خصوصیات کا استعمال کرتے ہوئے کسی رابطے کے لیے معلومات کو اپ ڈیٹ کر سکتے ہیں۔ درج ذیل ایس میںample کوڈ، BEMS صارف کے رابطہ فولڈر میں NewContact Last کے لیے رابطے کی معلومات کو اپ ڈیٹ کرتا ہے۔ کلائنٹ اپ ڈیٹ کرنے کے لیے رابطہ کے لیے UniqueID بھیجتا ہے۔ جب کسی رابطہ کو اپ ڈیٹ کیا جاتا ہے، کلائنٹ رابطہ کی تمام اقدار BEMS کو بھیجتا ہے، چاہے اقدار میں ترمیم کی گئی ہو یا نہیں۔ اگر کلائنٹ ایک ParentFolderID فراہم کرتا ہے، تو BEMS مخصوص فولڈر میں رابطے کو اپ ڈیٹ کرتا ہے۔
اس میں سابقample, رابطے کو ان کے کام کی معلومات کے ساتھ اپ ڈیٹ کیا جاتا ہے۔ نئی اور موجودہ معلومات کو اپ ڈیٹ کرنے کے لیے BEMS کو بھیجا جاتا ہے۔

• ملازمت کا عنوان
• محکمہ
• درمیانی نام
• موبائل فون
• ہوم فون
• کاروباری فون
• ای میل ایڈریس
• کمپنی کا نام

اگر درخواست کامیاب ہو جاتی ہے، تو BEMS ایک 200 HTTP رسپانس کوڈ واپس کرتا ہے جس سے رابطہ کامیابی کے ساتھ اپ ڈیٹ ہو جاتا ہے۔

ضمیمہ: UserShape کی خصوصیات کو ترتیب دیں۔

احتیاط: UserShape کی خصوصیات میں ترمیم نہ کریں جب تک کہ تبدیلیوں کی ضرورت نہ ہو۔ جب آپ BEMS سافٹ ویئر کو اپ گریڈ کرتے ہیں تو ترمیم شدہ ترتیبات برقرار نہیں رہتی ہیں۔
UserShape کی خصوصیات کے لیے درج ذیل اقدار کو بیان کیا جا سکتا ہے۔ دیگر اقدار کو نظر انداز کیا جاتا ہے۔

• عرف	صارف کا سرٹیفکیٹ
• ای میل اڈریس	• Usersmime سرٹیفکیٹ
ڈسپلے نام	• PrUserx509 سرٹیفکیٹ
• دیا گیا نام	• گھر کا فون
• پہلا نام	ہوم فون2
• کنیت	• موبائل فون
• آخری نام	• پیجر
مکمل نام	• کاروباری فون
• کمپنی کا نام	• بزنس فیکس
• کمپنی	• دیگر ٹیلی فون
• شعبہ	• فون نمبر
• ملازمت کا عنوان	جسمانی پتے
• عنوان	• مینیجر
• تصویر	• ڈائریکٹ رپورٹس

1. ایک براؤزر کھولیں اور اپاچی کراف پر جائیں۔ Web کنسول کنفیگریشن webسائٹ https:// پر واقع ہے :8443/system/console/configMgr اور مناسب مائیکروسافٹ ایکٹو ڈائرکٹری اسناد کے ساتھ بطور ایڈمنسٹریٹر لاگ ان کریں۔
2. مینو پر، OSGi > کنفیگریشن پر کلک کریں۔
3. تلاش کریں۔ and click Directory Lookup Common Configuration.
4. BasicPropertyNames فیلڈ میں، بنیادی جائیداد کی قدریں درج ہیں۔
   فہرست میں مشترکہ پراپرٹی شامل کرنے کے لیے + بٹن اور پراپرٹی کے نام پر کلک کریں یا فہرست سے مشترکہ پراپرٹی کو ہٹانے کے لیے – بٹن پر کلک کریں۔
5. DetailedPropertyNames فیلڈ میں، مشترکہ پراپرٹی کے ناموں کے تفصیلی پراپرٹی ویلیو کے نام درج ہیں۔
   فہرست میں مشترکہ پراپرٹی شامل کرنے کے لیے + بٹن اور پراپرٹی پر کلک کریں یا فہرست سے مشترکہ پراپرٹی کو ہٹانے کے لیے – بٹن پر کلک کریں۔
6. محفوظ کریں پر کلک کریں۔

قانونی نوٹس
©2023 بلیک بیری لمیٹڈ۔ ٹریڈ مارک، بشمول بلیک بیری، بی بی ایم، بی ای ایس، ایمبلیم ڈیزائن، اے ٹی او سی، سائلنس اور سیکسمارٹ بلیک بیری لمیٹڈ کے ٹریڈ مارک یا رجسٹرڈ ٹریڈ مارکس، اس کی ذیلی کمپنیاں اور/یا ملحقہ، لائسنس کے تحت استعمال ہوتے ہیں، اور ایسے ٹریڈ مارکس کے خصوصی حقوق ہیں۔ واضح طور پر محفوظ. دیگر تمام ٹریڈ مارک ان کے متعلقہ مالکان کی ملکیت ہیں۔
پیٹنٹس، جیسا کہ قابل اطلاق، شناخت کیا گیا ہے: www.blackberry.com/patents.
یہ دستاویزات بشمول حوالہ کے ذریعہ شامل تمام دستاویزات جیسے کہ بلیک بیری پر فراہم کردہ یا دستیاب دستاویزات webبلیک بیری لمیٹڈ اور اس سے منسلک کمپنیوں ("BlackBerry") اور بلیک بیری کی طرف سے کسی بھی قسم کی شرط، توثیق، گارنٹی، نمائندگی، یا وارنٹی کے بغیر "جیسے ہے" اور "جیسا دستیاب ہے" فراہم کردہ یا قابل رسائی بنائی گئی سائٹ اور بلیک بیری کسی بھی ٹائپوگرافیکل کی کوئی ذمہ داری قبول نہیں کرتا، اس دستاویز میں تکنیکی، یا دیگر غلطیاں، غلطیاں، یا کوتاہیاں۔ بلیک بیری کی ملکیتی اور خفیہ معلومات اور/یا تجارتی رازوں کی حفاظت کے لیے، یہ دستاویز بلیک بیری ٹیکنالوجی کے کچھ پہلوؤں کو عمومی اصطلاحات میں بیان کر سکتی ہے۔ بلیک بیری اس دستاویز میں موجود معلومات کو وقتاً فوقتاً تبدیل کرنے کا حق محفوظ رکھتا ہے۔ تاہم، بلیک بیری آپ کو بروقت یا بالکل بھی اس دستاویز میں ایسی تبدیلیاں، اپ ڈیٹس، اضافہ، یا دیگر اضافے فراہم کرنے کا کوئی عہد نہیں کرتا ہے۔ اس دستاویز میں معلومات کے فریق ثالث کے ذرائع، ہارڈ ویئر یا سافٹ ویئر، پروڈکٹس یا خدمات بشمول اجزاء اور مواد جیسے کاپی رائٹ اور/یا فریق ثالث کے ذریعے محفوظ کردہ مواد کے حوالے شامل ہو سکتے ہیں۔ webسائٹس (مجموعی طور پر "تیسرے فریق کی مصنوعات اور خدمات")۔ بلیک بیری کسی بھی فریق ثالث کی مصنوعات اور خدمات کو کنٹرول نہیں کرتا اور نہ ہی اس کے لیے ذمہ دار نہیں ہے، بشمول مواد، درستگی، کاپی رائٹ کی تعمیل، مطابقت، کارکردگی، اعتبار، قانونی حیثیت، شائستگی، لنکس، یا فریق ثالث کی مصنوعات کے کسی دوسرے پہلو اور خدمات اس دستاویز میں فریق ثالث کی مصنوعات اور خدمات کا حوالہ شامل کرنے کا مطلب کسی بھی طرح سے فریق ثالث کی مصنوعات اور خدمات کی بلیک بیری یا فریق ثالث کی توثیق نہیں ہے۔
آپ کے دائرہ اختیار میں قابل اطلاق قانون کی طرف سے خاص طور پر ممنوعہ حد تک کے علاوہ، تمام شرائط، توثیق، ضمانتیں، نمائندگی، یا کسی بھی قسم کی وارنٹی، بغیر اجازت کے محدودیت، کوئی بھی شرائط، توثیق، ضمانتیں، نمائندگی یا پائیداری کی ضمانتیں، کسی خاص مقصد یا استعمال کے لیے موزوں، تجارتی قابلیت، قابل تجارت معیار، غیر خلاف ورزی، عدم تحفظ کا عنوان کسی قانون یا کسٹم یا تجارت کے لین دین یا استعمال کے کورس سے پیدا ہونے والا، یا دستاویزی یا اس کے استعمال، یا کسی بھی سافٹ ویئر، ہارڈ ویئر، پارٹنر اور خدمت کار کی کارکردگی یا غیر کارکردگی سے متعلق خدمات کا حوالہ دیا گیا ہے، یہاں سے خارج کر دیا گیا ہے۔ آپ کو دوسرے حقوق بھی حاصل ہو سکتے ہیں جو ریاست یا صوبے کے لحاظ سے مختلف ہوتے ہیں۔ کچھ دائرہ اختیار مضمر وارنٹیوں اور شرائط کے اخراج یا حد بندی کی اجازت نہیں دے سکتے ہیں۔ قانون کی طرف سے اجازت دی گئی حد تک، دستاویز سے متعلق کسی بھی مضمر وارنٹی یا شرائط کو اس حد تک خارج نہیں کیا جا سکتا جیسا کہ اوپر بیان کیا گیا ہے، لیکن ان کو محدود رکھا جا سکتا ہے، (90) اس تاریخ سے دن جب آپ نے پہلی بار دستاویز یا وہ آئٹم حاصل کیا جو دعویٰ کا تابع ہے۔
آپ کے دائرہ اختیار میں قابل اطلاق قانون کے ذریعہ اجازت دی گئی زیادہ سے زیادہ حد تک، کسی بھی صورت میں بلیک بیری اس دستاویز یا اس کے استعمال کے لیے، اس سے متعلق کسی بھی قسم کے نقصانات کے لیے ذمہ دار نہیں ہوگا۔ ہارڈ ویئر، سروس، یا کوئی تیسری پارٹی پروڈکٹس اور سروسز کا حوالہ دیا گیا ہے جن میں بغیر کسی حد کے مندرجہ ذیل نقصانات شامل ہیں: براہ راست، نتیجہ خیز، مثالی، اتفاقی، بالواسطہ، خصوصی، تعزیری، یا نقصان دہ کارروائیاں UES، کسی بھی متوقع بچت کا ادراک کرنے میں ناکامی، کاروباری رکاوٹ، کاروباری معلومات کا نقصان، کاروبار کے مواقع کا نقصان، یا بدعنوانی یا ڈیٹا کا نقصان، کسی بھی ڈیٹا کو منتقل کرنے یا وصول کرنے میں ناکامی، کسی بھی درخواست کی لاگت سے منسلک پروڈکٹ کے ساتھ منسلک مسائل CES، ڈاؤن ٹائم لاگت، بلیک بیری مصنوعات کے استعمال کا نقصان یا خدمات یا اس کا کوئی حصہ یا کسی بھی ایئر ٹائم خدمات کا، متبادل سامان کی قیمت، کور کی لاگت، سہولیات یا خدمات، سرمائے کی لاگت، یا اسی طرح کے دیگر مالیاتی نقصانات، مالیاتی نقصانات EEN، اور یہاں تک کہ اگر بلیک بیری ہو چکا ہے۔ کے امکان کے بارے میں مشورہ دیا
بہت نقصانات
آپ کے دائرہ اختیار میں قابل اطلاق قانون کے ذریعہ اجازت دی گئی زیادہ سے زیادہ حد تک، بلیک بیری کی کوئی دوسری ذمہ داری، ڈیوٹی، یا ذمہ داری نہیں ہوگی جو کچھ بھی معاہدہ، ٹارٹ، یا غیر رضامندی سے ہو لاپرواہی یا سخت ذمہ داری۔
یہاں کی حدود، اخراج، اور دستبرداریوں کا اطلاق ہوگا: (A) آپ کی طرف سے کارروائی، مطالبہ، یا کارروائی کی وجہ کی نوعیت سے قطع نظر، لیکن اس میں شامل ہیں، لیکن معاہدہ، نان و نفقہ تک محدود نہیں، سخت ذمہ داری یا کوئی دوسرا قانونی نظریہ اور بنیادی خلاف ورزی یا خلاف ورزی یا اس معاہدے کے بنیادی مقصد یا اس میں شامل کسی بھی تدارک کی ناکامی سے بچ جائے گا؛ اور (B) بلیک بیری اور اس سے وابستہ کمپنیوں کو، ان کے جانشینوں، تفویض کرنے والے، ایجنٹس، سپلائرز (بشمول ایئر ٹائم سروس فراہم کرنے والے)، بلیک بیری کے بااختیار ڈسٹریبیوٹرز (بشمول متعلقہ متعلقہ) متعلقہ ڈائریکٹرز، ملازمین، اور آزاد ٹھیکیدار۔
اوپر بیان کی گئی حدود اور اخراج کے علاوہ، کسی بھی صورت میں کوئی بھی ڈائریکٹر، ملازم، ایجنٹ، تقسیم کار، سپلائی کرنے والا، بلیک بیری کا آزاد ٹھیکیدار یا کسی بھی قسم کی غیر منقولہ مالی امداد نہیں کرے گا یا دستاویزات سے متعلق۔ کسی بھی فریق ثالث کی مصنوعات اور خدمات کو سبسکرائب کرنے، انسٹال کرنے یا استعمال کرنے سے پہلے، یہ یقینی بنانا آپ کی ذمہ داری ہے کہ آپ کا ایئر ٹائم سروس فراہم کنندہ ان کی تمام خصوصیات کی حمایت کرنے پر راضی ہو گیا ہے۔ ہو سکتا ہے کہ کچھ ایئر ٹائم سروس فراہم کرنے والے بلیک بیری انٹرنیٹ سروس کی رکنیت کے ساتھ انٹرنیٹ براؤزنگ کی فعالیت پیش نہ کریں۔
دستیابی، رومنگ کے انتظامات، سروس پلانز اور خصوصیات کے لیے اپنے سروس فراہم کنندہ سے چیک کریں۔ بلیک بیری کی مصنوعات اور خدمات کے ساتھ تھرڈ پارٹی پروڈکٹس اور سروسز کی تنصیب یا استعمال کے لیے ایک یا زیادہ پیٹنٹ، ٹریڈ مارک، کاپی رائٹ، یا دوسرے لائسنس کی ضرورت ہو سکتی ہے تاکہ فریق ثالث کے حقوق کی خلاف ورزی یا خلاف ورزی سے بچا جا سکے۔ آپ اس بات کا تعین کرنے کے لیے مکمل طور پر ذمہ دار ہیں کہ آیا فریق ثالث کی مصنوعات اور خدمات کا استعمال کرنا ہے اور اگر ایسا کرنے کے لیے کسی تیسرے فریق کے لائسنس کی ضرورت ہے۔ اگر ضرورت ہو تو آپ ان کو حاصل کرنے کے ذمہ دار ہیں۔ آپ کو تھرڈ پارٹی پروڈکٹس اور سروسز کو انسٹال یا استعمال نہیں کرنا چاہیے جب تک کہ تمام ضروری لائسنس حاصل نہ کر لیے جائیں۔ بلیک بیری کی مصنوعات اور خدمات کے ساتھ فراہم کی جانے والی کوئی بھی تھرڈ پارٹی مصنوعات اور خدمات آپ کو سہولت کے طور پر فراہم کی جاتی ہیں اور بلیک بیری اور بلیک بیری کی طرف سے کسی بھی قسم کی واضح یا مضمر شرائط، توثیق، ضمانتیں، نمائندگی، یا وارنٹی کے بغیر "جیسے ہے" فراہم کی جاتی ہیں۔ اس کے سلسلے میں، کوئی ذمہ داری قبول نہیں کرتا ہے۔ فریق ثالث پروڈکٹس اور سروسز کا آپ کا استعمال اس کے زیر انتظام ہوگا اور اس سے مشروط ہوگا کہ آپ فریق ثالث کے ساتھ الگ الگ لائسنس اور اس پر لاگو ہونے والے دوسرے معاہدوں کی شرائط سے متفق ہوں، سوائے اس حد کے جس کا بلیک بیری کے ساتھ لائسنس یا دوسرے معاہدے میں واضح طور پر احاطہ کیا گیا ہو۔
کسی بھی بلیک بیری پروڈکٹ یا سروس کے استعمال کی شرائط ایک علیحدہ لائسنس یا بلیک بیری کے ساتھ اس پر لاگو ہونے والے دوسرے معاہدے میں بیان کی گئی ہیں۔ اس دستاویز میں کسی بھی چیز کا مقصد بلیک بیری کی طرف سے فراہم کردہ کسی بھی واضح تحریری معاہدوں یا وارنٹیوں کو ختم کرنا نہیں ہے جو بلیک بیری کی مصنوعات یا اس کے علاوہ کسی اور خدمت کے حصے کے لیے فراہم کیے گئے ہیں۔
بلیک بیری انٹرپرائز سافٹ ویئر میں کچھ تھرڈ پارٹی سافٹ ویئر شامل ہوتا ہے۔ اس سافٹ ویئر سے وابستہ لائسنس اور کاپی رائٹ کی معلومات پر دستیاب ہے۔ http://worldwide.blackberry.com/legal/thirdpartysoftware.jsp.

بلیک بیری لمیٹڈ
2200 یونیورسٹی ایونیو ایسٹ
واٹر لو، اونٹاریو
کینیڈا N2K 0A7
بلیک بیری یو کے لمیٹڈ
گراؤنڈ فلور، پیئرس بلڈنگ، ویسٹ سٹریٹ،
میڈن ہیڈ، برکشائر SL6 1RL
برطانیہ
کینیڈا میں شائع ہوا۔

دستاویزات / وسائل

BEMS رابطہ سروس API حوالہ [پی ڈی ایف] یوزر گائیڈ رابطہ سروس API حوالہ، رابطہ، خدمت API حوالہ، API حوالہ، حوالہ

حوالہ جات

• صارف دستی