የእውቂያ አገልግሎት API
ማጣቀሻ
ዲሴምበር 2022

የBEMS የእውቂያ አገልግሎት ኤፒአይ ምንድን ነው?

የእውቂያ አገልግሎት ኤፒአይ የሶስተኛ ወገን ብላክቤሪ ዳይናሚክስ አፕሊኬሽኖች የዕውቂያ መረጃን ከተጠቃሚ አድራሻ አቃፊ እና ተጠቃሚው የሚፈጥራቸው ማናቸውንም ማህደሮች እና ንዑስ አቃፊዎች በመልዕክት ሳጥን ውስጥ ባለው የእውቂያዎች አቃፊ ውስጥ እንዲጠይቁ፣ እንዲያነሱ፣ እንዲፈጥሩ እና እንዲያዘምኑ ያስችላቸዋል። ለ example፣ የሚከተሉትን ለማድረግ ኤፒአይን መጠቀም ትችላለህ፡-

• አዲስ እውቂያዎችን ይፍጠሩ
• በእውቂያዎች አቃፊ ስር አቃፊዎችን እና ንዑስ አቃፊዎችን ይፍጠሩ
• ሙሉውን የእውቂያዎች ዝርዝር ከእውቂያዎች አቃፊ ውስጥ ሰርስረው ያውጡ
• ከተጠቀሰው አቃፊ ወይም ንኡስ አቃፊ እውቂያዎችን ሰርስሮ ማውጣት
• ነጠላ ዕውቂያ ሰርስረው ያውጡ
• ከተጠቀሰው ቀን ጀምሮ አዲሶቹን እና የተሻሻሉ እውቂያዎችን ያውጡ
• ያለውን የእውቂያ መረጃ ያዘምኑ

ቅርጸት ይጠይቁ ፣ ይፍጠሩ እና ያዘምኑ

በኤፒአይ ውስጥ የBEMS የመጨረሻ ነጥብ መጥቀስ አለብህ። የመጨረሻው ነጥብ የነገሩ አድራሻ የት እንደሚገኝ ይገልጻል።

የመጨረሻ ነጥብ፡- : 8443 / ኤፒአይ / እውቂያ
በBEMS ውስጥ ካለው የመልዕክት ሳጥን ውስጥ የእውቂያ መረጃን ለማምጣት የ HTTP ጥያቄ ቅርጸት የሚከተለው ነው፡-
POST : 8443 / ኤፒአይ / እውቂያ


በBEMS ውስጥ ባለው የመልእክት ሳጥን ውስጥ የኤችቲቲፒ ጥያቄ እውቂያ ለመፍጠር ያለው ቅርጸት፡-
POST : 8443/api/እውቂያ/ፍጠር


በBEMS ውስጥ ባለው የመልዕክት ሳጥን ውስጥ ያለን አድራሻ ለማዘመን የ HTTP ጥያቄ ቅርጸት፡-
POST : 8443/api/contact/update


የኤችቲቲፒ ጥያቄ ቅርጸት በእውቂያዎች አቃፊ ስር ተጨማሪ አቃፊዎችን እና ንዑስ አቃፊዎችን ለመፍጠር
በBEMS ውስጥ ያለው የመልዕክት ሳጥን፡-
POST 8443/api/አቃፊ/ፍጠር


ሁሉንም አቃፊዎች እና ንዑስ አቃፊዎች በ BEMS ውስጥ ባለው የመልእክት ሳጥን ውስጥ ባለው የእውቂያ አቃፊ ስር ለማግኘት የ HTTP ጥያቄ ቅርጸት
POST 8443/api/folder/ማግኘት


የሚከተለው እንደ ነውampራስጌ፡
የይዘት አይነት፡ መተግበሪያ/json
X-Good-GD-AuthToken፡
የእውቂያ ዝርዝር መረጃን በመጠየቅ ላይ
የሶስተኛ ወገን ብላክቤሪ ዳይናሚክስ አፕሊኬሽኖች እርስዎ በገለጹት ጊዜ ውስጥ የታከሉትን የዕውቂያ መረጃ፣ የተወሰነ ዕውቂያ ወይም የዕውቂያ ዝርዝሩን በመልዕክት ሳጥናቸው ውስጥ ካለው የተጠቃሚ አድራሻ አቃፊ ማምጣት ይችላሉ።
የእውቂያ ዝርዝር መረጃ ባህሪያትን በማውጣት ላይ
የሚከተለው ሠንጠረዥ በመልዕክት ሳጥን ውስጥ ካለው የተጠቃሚ አቃፊ ውስጥ የእውቅያ ዝርዝር መረጃን ስታወጣ በJSON ቅርጸት ጥያቄ ውስጥ ማካተት የምትችለውን የጥያቄ አካል ባህሪያትን ይገልጻል።

መለኪያ	ዓይነት	መግለጫ
መለያ	ሕብረቁምፊ	ይህ ግቤት የእውቂያ መረጃን ለመጠየቅ ጥቅም ላይ የሚውለውን የተጠቃሚውን የኢሜይል መለያ ይገልጻልampሌ፣ jamie01@ex365.example.com).
በስም	ሕብረቁምፊ	ይህ ግቤት በተወሰነ ስም ላይ በመመስረት የተጠቃሚውን አካባቢያዊ እውቂያዎች ለመፈለግ ይገልጻል። የፍለጋ ውጤቶቹ ከተወሰኑ ቁምፊዎች ስብስብ ጋር ሁሉንም እውቂያዎች ያካትታል. ለ example, "በስም": "ጄን" ሁሉንም ተጠቃሚዎች እንደ የመጀመሪያ ስማቸው, የአያት ስማቸው ወይም የስማቸው አካል የሆኑትን ሁሉ ይመልሳል. ይህንን ግቤት ሲጠቀሙ ለተመለሱት እውቂያዎች ተጨማሪ መረጃ ለማግኘት የ UserShape ንብረቶችን "መሰረታዊ" ወይም "ዝርዝር" ማካተት ይችላሉ። ለበለጠ መረጃ ከታች ያለውን የተጠቃሚ ቅርፅ መለኪያ ይመልከቱ።
በኢሜል	ሕብረቁምፊ	ይህ ግቤት የተጠቃሚውን የአካባቢ አድራሻ ዝርዝር በተወሰነ የኢሜይል አድራሻ መፈለግን ይገልጻል። ይህን ግቤት ሲጠቀሙ ለተመለሱት እውቂያዎች ተጨማሪ መረጃ ለማግኘት የ UserShape መለኪያ ባህሪያትን "መሰረታዊ" ወይም "ዝርዝር" ማካተት ይችላሉ። ለበለጠ መረጃ ከታች ያለውን የተጠቃሚ ቅርፅ መለኪያ ይመልከቱ።
FolderId	ሕብረቁምፊ	ይህ ግቤት ከተጠቀሰው FolderId እውቂያዎችን ያወጣል። ይህ አማራጭ ነው። FolderId ካልተገለጸ፣ BEMS እውቂያዎቹን ከተጠቃሚው የእውቂያ አቃፊ ሰርስሮ ያወጣል።
ከፍተኛ ቁጥር	ኢንቲጀር	ይህ ግቤት በፍለጋ መጠይቁ ውስጥ የሚመለሱትን ከፍተኛውን የእውቂያዎች ወይም የነገሮች ብዛት ይገልጻል። በነባሪ፣ BEMS በአንድ ጊዜ እስከ 512 ንጥሎችን ብቻ መመለስ ይችላል። ደንበኛው የበለጠ ሰርስሮ ለማውጣት ብዙ ጥሪዎችን ማድረግ አለበት። የ "Offset" መለኪያን በማዘጋጀት 512 እቃዎች. የ"ተጨማሪ የሚገኝ" እሴት ተጨማሪ እቃዎች ካሉ ለደንበኛው ይነግረዋል። ለበለጠ መረጃ ከዚህ በታች ያለውን የኤፒአይ ምላሽ ሰንጠረዥ ይመልከቱ።
ማካካሻ	ኢንቲጀር	ይህ ግቤት የቡድን ምላሽ መነሻ ነጥብ ይገልጻል። በነባሪ፣ ማካካሻው 0 (ዜሮ) ነው።
ከቲ.ኤስ	ኢንቲጀር (ረጅም)	ይህ ግቤት ከተወሰነ ጊዜ ጀምሮ በተጠቃሚው የግል አድራሻ ዝርዝር ውስጥ ያሉትን አዲስ ወይም የተሻሻሉ እውቂያዎችን ይገልጻል። ጀምሮ ቲዎች የሚገለጹት በጊዜ ቅርጸት ነው። አዲሶቹን እና የተሻሻሉ እውቂያዎችን ሰርስሮ ለማውጣት ከፈለጉ፣ እውቂያዎችን መፈለግ ለመጀመር የFuntT ዎችን መግለጽ አለብዎት። የFontTs ካልተገለጸ፣ BEMS ሁሉንም እውቂያዎች ከተጠቃሚው የእውቂያ አቃፊ ሰርስሮ ያወጣል። ይህን ግቤት ሲጠቀሙ ለተመለሱት እውቂያዎች ተጨማሪ መረጃ ለማግኘት የ UserShape መለኪያ ባህሪያትን "መሰረታዊ" ወይም "ዝርዝር" ማካተት ይችላሉ። ለበለጠ መረጃ ከታች ያለውን የተጠቃሚ ቅርፅ መለኪያ ይመልከቱ።
የተጠቃሚ ቅርጽ	የሕብረቁምፊ ድርድር	ይህ ግቤት በፍለጋ ውጤቶቹ ውስጥ የሚመለሱትን ባህሪያት ዝርዝር ይገልጻል (ለምሳሌample, መሰረታዊ, ሞባይል ስልክ, JobTitle, ፎቶ). UserShape የጋራ ንብረቶች ዝርዝር ቅድመ ዝግጅትን ይደግፋል፡ መሰረታዊ እና ዝርዝር። መሰረታዊ እና ዝርዝር የንብረት ስም ዝርዝሮች በBEMS ውስጥ ሊዋቀሩ ይችላሉ። • መሰረታዊ፡ በነባሪነት ይህ ንብረት የሚከተሉትን የንብረት ዝርዝር ይመልሳል፡ የመጨረሻ ስም፣ የማሳያ ስም፣ ኢሜል አድራሻ እና የስልክ ቁጥሮች። • ዝርዝር፡ በነባሪነት ይህ ንብረት ከመሰረታዊ ንብረቶች በተጨማሪ የሚከተሉትን የንብረት ዝርዝር ይመልሳል፡ ፊዚካል አድራሻዎች፣ የኩባንያ ስም፣ የስራ ስምሪት፣ መምሪያ እና ፎቶ። አስተዳዳሪዎች እንዴት እንደሚችሉ ላይ መመሪያዎችን ለማግኘት view ወይም የተጠቃሚ ቅርፅ ባህሪያቱን ያዋቅሩ፣ አባሪ ይመልከቱ፡ የተጠቃሚ ቅርፅ ባህሪያቱን ያዋቅሩ።

የኤፒአይ ምላሽ
የሚከተለው ሠንጠረዥ ከተጠቃሚው የአከባቢ አድራሻ ዝርዝር ውስጥ እውቂያዎችን ሲያነሱ በJSON ቅርጸት በተሰራው የኤፒአይ ምላሽ ውስጥ ሊታዩ የሚችሉትን የምላሽ ባህሪያት ይገልጻል።

ንብረት	ዓይነት	መግለጫ
የበለጠ ይገኛል።	ቡሊያን	ይህ ግቤት ከተመለሰው ምላሽ በላይ ብዙ እውቂያዎች እንዳሉ ያሳያል። MoreAvailable እውነት ከሆነ ደንበኛው የ"Offset" እሴትን በቀደመው ምላሽ ወደ ተቀበለው እሴት በመቀየር ኤፒአይ መጥራቱን ይቀጥላል። ተጨማሪ የሚመለሱ እውቅያዎች እንደሌሉ የሚያመለክተው የMoreAvailable እሴት ሐሰት እስኪሆን ድረስ ደንበኛው ይህንን ጥሪ ያከናውናል።
ጠቅላላ ብዛት	ኢንቲጀር	ይህ ግቤት ከጥያቄው ጋር የሚዛመዱትን ጠቅላላ የእውቂያዎች ብዛት ይገልጻል።
ቀጣይ ገጽ ኦፍሴት	ኢንቲጀር ወይም ባዶ	ይህ ግቤት የተመለሱት የሁለተኛው የእውቂያዎች ስብስብ መነሻ ነጥብ ይገልጻል።
መጠን	ኢንቲጀር	ይህ ግቤት በምላሹ ውስጥ የተመለሱትን የእውቂያዎች ብዛት ይገልጻል፣ እስከ MaxNumber መጠን ድረስ።
ማካካሻ	ኢንቲጀር	ይህ ግቤት የቡድን ምላሽ መነሻ ነጥብ ይገልጻል።
ስብስብ	የ MAP ዝርዝር	ይህ ግቤት በጥያቄው ውስጥ የተመለሱትን የእውቂያዎች ዝርዝር ይገልጻል።

እውቂያዎችን ይጠይቁ

እውቂያዎችን ከተጠቃሚው ዋና አድራሻ አቃፊ እና ተጠቃሚው ከፈጠራቸው ንዑስ አቃፊዎች ሰርስረህ ማውጣት ትችላለህ።
የተሰረዙ እውቂያዎች አልተመለሱም። በጥያቄው ውስጥ FolderId በደንበኛው ካልተሰጠ ፣እውቂያዎች ከዋናው አቃፊ ተሰርስረዋል።
በሚከተለው sample, BEMS ለተጠቃሚው, Jamie01, ማንኛውንም የተሰረዙ እውቂያዎችን ሳይጨምር ሁሉንም እውቂያዎች ከተለየ ንዑስ አቃፊ ሰርስሮ ያወጣል። የBEMS የመጀመሪያው ምላሽ እስከ 100 የሚደርሱ እውቂያዎችን ያካትታል፣ በ MaxNumber እንደተገለፀው። እያንዳንዱ የተገኘ ዕውቂያ በBEMS ውስጥ የተገለጹትን ነባሪ መሰረታዊ ባህሪያትን ያካትታል።
ከ100 በላይ እውቂያዎች ካሉ (ለምሳሌampለ፣ ይህ የመልእክት ሳጥን አጠቃላይ የ150 እውቂያዎችን ያካትታል) ምላሹ MoreAvailableን ያካትታል እውነት ነው፣ስለዚህ የደንበኛው መተግበሪያ ተጨማሪ ተደራሽነት እስካልሆነ ድረስ በቡድን ውስጥ እውቂያዎችን ለማምጣት NextOffset እሴትን በመጠቀም ተጨማሪ ጥያቄዎችን ይልካል። በዚህ የቀድሞample, የመሠረታዊ ንብረቶች የሚከተሉትን መረጃዎች ለእውቂያዎች ይመልሳል:

• የማሳያ ስም
• የኢሜል አድራሻ
• የተሰጠ ስም
• የአያት ስም

በሚከተለው example, ደንበኛው FolderId ያቀርባል እና BEMS እውቂያዎቹን ከተለየው አቃፊ ሰርስሮ ያወጣል።ጥያቄው የተሳካ ከሆነ፣ BEMS የመጠይቁን መስፈርት የሚያሟሉ የመጀመሪያዎቹን 100 እውቂያዎችን ይመልሳል። BEMS የእውቂያዎችን ጠቅላላ ብዛት እና NextPageOffset ይመልሳል።ደንበኛው የሚቀጥለውን ስብስብ ለመቀበል ከቀዳሚው መጠይቅ ወደ NextPageOffset Offset ያዘጋጃል።
BEMS የሚቀጥሉትን 50 እውቂያዎች በድምሩ ለ150 እውቂያዎች ይመልሳል። ምንም ተጨማሪ እውቂያዎች አይገኙም።የኢሜል አድራሻ እና ቅድመ-ቅምጥ ባህሪያትን በመጠቀም እውቂያዎችን ይጠይቁ
እውቂያዎችን ከተጠቃሚው የእውቂያ አቃፊ፣ ወይም ብዙ ንብረቶችን በመጠቀም ተጠቃሚው በፖስታ ሳጥን ውስጥ ከፈጠረው አቃፊዎች እና ንዑስ አቃፊዎች ሰርስረህ ማውጣት ትችላለህ (ለምሳሌample, በኢሜል አድራሻቸው መሰረት ተጠቃሚን ሰርስረው አውጥተው ቅድመ-ቅምጡን ያካትቱ ዝርዝር ባህሪያት ለእውቂያው)። በዚህ የቀድሞample፣ ምላሹ አንድ እውቂያን ያካትታል እና MoreAvailable ሐሰት ነው። ከ512 በላይ እውቂያዎች ተለይተው ከታወቁ፣ ምላሹ MoreAvailable እውነት መሆኑን ያሳያል፣ እና ተጨማሪ አቫይል ሐሰት እስካልሆነ ድረስ ደንበኛው እውቂያዎችን በቡድን ለማምጣት ተጨማሪ ጥያቄዎችን ይልካል። ደንበኛው አቃፊ መታወቂያ ከሰጠ፣ BEMS እውቂያዎቹን ከተለየ አቃፊ ሰርስሮ ያወጣል።ጥያቄው የተሳካ ከሆነ፣ BEMS የሚከተለውን ምላሽ ይመልሳል፣ እና የሶስተኛ ወገን ብላክቤሪ ዳይናሚክስ መተግበሪያዎች የኢሜይል አድራሻው jane_doe@ex ላለው አድራሻ የሚከተለውን መረጃ ያሳያሉ።ample.com ንብረት ከሌለ፣ BEMS ዋጋ ቢስ ይመልሳል እና መረጃው በምላሹ ውስጥ አይካተትም። በዚህ የቀድሞampለ፣ የሚከተለው መረጃ ለጄን ዶ ይታያል፡

• የማሳያ ስም
• የተሰጠ ስም
• የአያት ስም
• ሙሉ ስም
• ኢሜል አድራሻ

የተወሰነ ንብረት በመጠቀም የእውቂያ ዝርዝር መረጃ ይጠይቁ
የተወሰኑ ንብረቶችን ለሚመልሱ እውቂያዎች የተጠቃሚውን አድራሻ መረጃ መጠየቅ ትችላለህ (ለምሳሌ፡ample, የእውቂያዎች የመጀመሪያ ስም ብቻ). በሚከተለው sample code፣ BEMS በተጠቃሚው የእውቂያ አቃፊ ውስጥ ያሉትን ሁሉንም እውቂያዎች የመጀመሪያ ስም ይጠይቃል። ምላሹ እስከ 50 የሚደርሱ እውቂያዎችን ያካትታል። ደንበኛው አቃፊ መታወቂያ ከሰጠ፣ BEMS እውቂያዎቹን ከተለየ አቃፊ ይጠይቃል።ጥያቄው የተሳካ ከሆነ፣ BEMS የሚከተለውን ምላሽ ይመልሳል፣ እና የሶስተኛ ወገን ብላክቤሪ ዳይናሚክስ መተግበሪያዎች የእውቂያዎቹን የመጀመሪያ ስም ያሳያሉ።

የአቃፊ እና ንዑስ አቃፊ መረጃ መፍጠር እና መጠየቅ

የሶስተኛ ወገን ብላክቤሪ ዳይናሚክስ አፕሊኬሽኖች ተጠቃሚው በአድራሻቸው ውስጥ የፈጠረውን አቃፊ እና ንዑስ አቃፊ መረጃን ሰርስሮ ማውጣት ይችላል። ንዑስ አቃፊዎች እንዲሁ በአንድ የተወሰነ አቃፊ ውስጥ ሊፈጠሩ ይችላሉ።
የአቃፊ መለኪያዎችን መፍጠር እና ማዘመን
የሚከተለው ሠንጠረዥ በተጠቃሚው የመልዕክት ሳጥን የእውቂያ አቃፊ ውስጥ አቃፊ ወይም ንዑስ አቃፊ ሲፈጥሩ በJSON ቅርጸት ጥያቄ ውስጥ ሊያካትቱ የሚችሉትን የጥያቄ አካል ባህሪያትን ይገልጻል።

መለኪያ	ዓይነት	መግለጫ
የአቃፊ ስም	ሕብረቁምፊ	ይህ ግቤት ተጠቃሚው የፈጠረውን አቃፊ ወይም ንዑስ አቃፊ ስም ይገልጻል።
የወላጅ አቃፊ መታወቂያ	ሕብረቁምፊ	ይህ ግቤት እውቂያውን በተጠቀሰው የParentFolderId ውስጥ ይፈጥራል። ይህ አማራጭ ነው። የParent FolderId ካልተሰጠ፣ BEMS እውቂያውን በተጠቃሚው የእውቂያ አቃፊ ውስጥ ይፈጥራል።

አቃፊ ወይም ንዑስ አቃፊ ይፍጠሩ
በተጠቃሚው የእውቂያ አቃፊ ውስጥ አቃፊዎችን እና ንዑስ አቃፊዎችን መፍጠር ይችላሉ። የParent FolderId አማራጭ ነው። ካልቀረበ እና አቃፊ ሲፈጠር, ማህደሩ በተጠቃሚው የእውቂያ አቃፊ ውስጥ ይታያል. በሚከተለው sampለ ኮድ፣ “የድጋፍ ማህደር” የሚባለው አቃፊ በተወሰነው የParentFolderId ውስጥ እንደ ንዑስ አቃፊ ተፈጥሯል። ጥያቄው የተሳካ ከሆነ፣ BEMS የእውቂያ ማህደሩ በተሳካ ሁኔታ የተፈጠረውን የ201 HTTP ምላሽ ኮድ ይመልሳል።
ተመሳሳይ ስም ያለው አቃፊ በወላጅ አቃፊ ውስጥ ካለ፣ BEMS 200 HTTP ምላሽ ኮድ ይመልሳል እና ማህደሩ አልተቀመጠም።በእውቂያዎች አቃፊ ስር ያሉትን ሁሉንም አቃፊዎች እና ንዑስ አቃፊዎች ይጠይቁ
ተጠቃሚው በተጠቃሚ አድራሻ አቃፊ ውስጥ የፈጠረውን ሁሉንም አቃፊዎች እና ንዑስ አቃፊዎች ሰርስረህ ማውጣት ትችላለህ። በሚከተለው sampለ ኮድ፣ BEMS ተጠቃሚው የፈጠራቸውን ሁሉንም አቃፊዎች ሰርስሮ ያወጣል።ጥያቄው የተሳካ ከሆነ፣ BEMS የሚከተለውን ምላሽ ይመልሳል፣ እና የሶስተኛ ወገን ብላክቤሪ ዳይናሚክስ መተግበሪያዎች የተመለሰውን አቃፊ ያሳያሉ።

የእውቂያ መረጃ በማከል ላይ

የሶስተኛ ወገን ብላክቤሪ ዳይናሚክስ አፕሊኬሽኖች የዕውቂያ መረጃን በተጠቃሚ አድራሻ አቃፊ ውስጥ ወይም ተጠቃሚው በመልዕክት ሳጥናቸው ውስጥ የፈጠራቸውን ማህደሮች እና ንዑስ አቃፊዎች መፍጠር እና ማዘመን ይችላሉ።
ዕውቂያ ሲፈጥሩ ጥቅም ላይ የዋሉ ንብረቶች
የሚከተለው ዝርዝር በመልዕክት ሳጥን ውስጥ ባለው የተጠቃሚ አቃፊ ውስጥ አድራሻ ሲፈጥሩ በJSON ቅርጸት ጥያቄ ውስጥ ሊያካትቷቸው የሚችሏቸው የሚደገፉ የሰውነት ባህሪያትን ያሳያል። በጥያቄው አካል ውስጥ ባዶ ወይም ባዶ የሆነ ማንኛውም እሴት በእውቂያ ውስጥ አይቀመጥም።
ተጠቃሚው ያለውን እውቂያ እያዘመነ ከሆነ፣ ሁሉም የጥያቄው ዋጋዎች፣ ተለወጡም አልሆኑ፣ ለBEMS ገብተዋል። እውቂያ ሲፈጥሩ የሚከተሉት እሴቶች ሊገለጹ ይችላሉ፡

• ተገናኝ
  • የመጀመሪያ ስም
  • የአባት ስም
  • የአያት ስም
  • ሞባይል
  • የቤት ስልክ
  • የቤት ስልክ2
  • የቤት ፋክስ
  • ሌላ ፋክስ
  • ኢሜይል አድራሻ1
  • ኢሜይል አድራሻ2
  • ኢሜይል አድራሻ3
  • የንግድ ስልክ
  • የንግድ ስልክ2
  • የመኪና ስልክ
  • የኩባንያ ዋና ስልክ
  • ISDN
  • መልሶ መደወያ
  • የሬዲዮ ስልክ
  • ዋና ስልክ
  • የረዳት ስልክ
  • ቴሌክስ
  • TtyTdd ስልክ
• የቤት አድራሻ
  • ጎዳና
  • ከተማ
  • ግዛት
  • ሀገር
  • የፖስታ መላኪያ ኮድ
• ስራ
  • ኩባንያ
  • የስራ መደቡ መጠሪያ
  • መምሪያ
  • ቢሮ
  • አስተዳዳሪ
  • ረዳት
• የንግድ አድራሻ
  • ጎዳና
  • ከተማ
  • ግዛት
  • ሀገር
  • የፖስታ መላኪያ ኮድ

የተወሰነ ንብረት በመጠቀም እውቂያ ይፍጠሩ
የተወሰኑ ንብረቶችን በመጠቀም እውቂያ መፍጠር ይችላሉ። በሚከተለው sample code፣ BEMS እውቂያውን በተጠቃሚው የእውቂያ አቃፊ ውስጥ ይፈጥራል። የወላጅ ፎልደር መታወቂያ ከተካተተ፣ እውቂያው በተጠቀሰው አቃፊ ውስጥ ይፈጠራል።
በዚህ የቀድሞample, ተጠቃሚው ለእውቂያው የሚከተለውን መረጃ በመጠቀም እውቂያ ይፈጥራል:

• የመጀመሪያ ስም
• የአያት ስም
• የአያት ስም
• ሞባይል ስልክ
• የቤት ስልክ
• የንግድ ስልክ
• የኢሜል አድራሻ
• የኩባንያው ስም

እውቂያው በተሳካ ሁኔታ ከተፈጠረ፣ BEMS ልዩ መታወቂያ ይመልሳል እና የሶስተኛ ወገን ብላክቤሪ ዳይናሚክስ መተግበሪያዎች የቀረበውን የእውቂያ መረጃ ያሳያሉ። ንብረቱ ካልተገለጸ፣ BEMS ባዶ እሴት ይመልሳል እና መረጃው በእውቂያው ውስጥ አይቀመጥም።

የእውቂያ ዝርዝር መረጃን ያዘምኑ

የተወሰኑ ንብረቶችን በመጠቀም የእውቂያ መረጃን ማዘመን ይችላሉ። በሚከተለው sample code፣ BEMS በተጠቃሚው የእውቂያ አቃፊ ውስጥ ያለውን የNewContact Last የእውቂያ መረጃን ያዘምናል። ደንበኛው ለማዘመን ልዩ መታወቂያውን ይልካል። አንድ እውቂያ ሲዘምን ደንበኛው ለእውቂያው ሁሉንም እሴቶች ወደ BEMS ይልካል እሴቶቹ ተሻሽለዋልም አልሆኑ። ደንበኛው የParent Folder መታወቂያ ከሰጠ፣ BEMS በተጠቀሰው አቃፊ ውስጥ ያለውን አድራሻ ያዘምናል።
በዚህ የቀድሞample፣ እውቂያው ከስራ መረጃቸው ጋር ተዘምኗል። አዲሱ እና ነባሩ መረጃ ለማዘመን ወደ BEMS ይላካል።

• የሥራ ስምሪት
• መምሪያ
• የአያት ስም
• ሞባይል ስልክ
• የቤት ስልክ
• የንግድ ስልክ
• የኢሜል አድራሻ
• የኩባንያው ስም

ጥያቄው የተሳካ ከሆነ፣ BEMS እውቂያው በተሳካ ሁኔታ የዘመነበትን 200 HTTP ምላሽ ኮድ ይመልሳል።

አባሪ፡ የተጠቃሚ ቅርፅ ባህሪያቱን ያዋቅሩ

ጥንቃቄ፡- ለውጦቹ አስፈላጊ ካልሆኑ በስተቀር የተጠቃሚውን ቅርፀት አይቀይሩ። የBEMS ሶፍትዌርን ሲያሻሽሉ የተሻሻሉ ቅንብሮች አይቀመጡም።
የሚከተሉት እሴቶች ለተጠቃሚ ቅርጽ ባህሪያት ሊገለጹ ይችላሉ። ሌሎች እሴቶች ችላ ተብለዋል።

• ተለዋጭ ስም	• የተጠቃሚ ሰርተፍኬት
• የ ኢሜል አድራሻ	• Usersmime Certificate
• መጠሪያው ስም	• PrUserx509 ሰርተፍኬት
• የተሰጠ ስም	• የቤት ስልክ
• የመጀመሪያ ስም	• የቤት ስልክ2
• የአያት ስም	• ሞባይል
• የአያት ስም	• ፔጀር
• ሙሉ ስም	• የንግድ ስልክ
• የድርጅት ስም	• ቢዝነስፋክስ
• ኩባንያ	• ሌላ ስልክ
• መምሪያ	• የስልክ ቁጥሮች
• የስራ መደቡ መጠሪያ	• ፊዚካል አድራሻዎች
• ርዕስ	• አስተዳዳሪ
• ፎቶ	• ቀጥተኛ ዘገባዎች

1. አሳሽ ይክፈቱ እና ወደ Apache Karaf ይሂዱ Web የኮንሶል ውቅር webhttps:// ላይ የሚገኘው ጣቢያ :8443/system/console/configMgr እና እንደ አስተዳዳሪ አግባብ ባለው የማይክሮሶፍት አክቲቭ ዳይሬክቶሬት ምስክርነቶች ይግቡ።
2. በምናሌው ላይ OSGi> Configuration የሚለውን ይጫኑ።
3. ፈልግ and click Directory Lookup Common Configuration.
4. በመሠረታዊ የንብረት ስሞች መስክ ውስጥ የመሠረታዊ የንብረት ዋጋዎች ተዘርዝረዋል.
   የጋራ ንብረትን ወደ ዝርዝሩ ለማከል የ+ አዝራሩን እና የንብረት ስሙን ጠቅ ያድርጉ ወይም የጋራ ንብረትን ከዝርዝሩ ለማስወገድ - የሚለውን ይጫኑ።
5. በንብረት ስም ዝርዝር መስክ ውስጥ የጋራ ንብረት ስሞች ዝርዝር የንብረት ዋጋ ስሞች ተዘርዝረዋል ።
   የጋራ ንብረትን ወደ ዝርዝሩ ለመጨመር የ+ አዝራሩን እና ንብረቱን ጠቅ ያድርጉ ወይም የጋራ ንብረትን ከዝርዝሩ ውስጥ ለማስወገድ - የሚለውን ይጫኑ።
6. አስቀምጥን ጠቅ ያድርጉ።

ህጋዊ ማስታወቂያ
©2023 ብላክቤሪ ሊሚትድ። BLACKBERRY፣ BBM፣ BES፣ EMBLEM ዲዛይን፣ ATHOC፣ CYLANCE እና SECUSMARTን ጨምሮ ግን ያልተገደቡ የንግድ ምልክቶች የBlackberry Limited፣ ተባባሪዎቹ እና/ወይም አጋሮቹ፣ በፍቃድ ጥቅም ላይ የሚውሉ የንግድ ምልክቶች ወይም የተመዘገቡ የንግድ ምልክቶች ናቸው እና ለእንደዚህ ያሉ የንግድ ምልክቶች ብቸኛ መብቶች በግልጽ የተያዘ. ሁሉም ሌሎች የንግድ ምልክቶች የየባለቤቶቻቸው ንብረት ናቸው።
የባለቤትነት መብቶች፣ እንደአስፈላጊነቱ፣ በሚከተለው ተለይተዋል፡- www.blackberry.com/patents.
ይህ ሰነድ በማጣቀሻ የተካተቱትን እንደ በ BlackBerry የተሰጡ ወይም የሚገኙ ሰነዶችን ጨምሮ web“እንደ አይኤስ” እና “እንደሚገኝ” እና ያለ ቅድመ ሁኔታ፣ ድጋፍ፣ ዋስትና፣ ውክልና ወይም ዋስትና ያለ ማንኛውም ጣቢያ በ BlackBerry ሊሚትድ እና በተጓዳኝ ኩባንያዎች (“ብላክቤሪ”) እና ብላክቤሪ ለማንኛውም የፊደል አጻጻፍ ኃላፊነት አይወስድም። በዚህ ሰነድ ውስጥ ቴክኒካዊ፣ ወይም ሌሎች ስህተቶች፣ ስህተቶች ወይም ግድፈቶች። የ BlackBerry የባለቤትነት እና ሚስጥራዊ መረጃን እና/ወይም የንግድ ሚስጥሮችን ለመጠበቅ ይህ ሰነድ አንዳንድ የ BlackBerry ቴክኖሎጂን በአጠቃላይ አነጋገር ሊገልጽ ይችላል። ብላክቤሪ በዚህ ሰነድ ውስጥ ያለውን መረጃ በየጊዜው የመቀየር መብቱ የተጠበቀ ነው። ቢሆንም፣ ብላክቤሪ ምንም አይነት ለውጦችን፣ ማሻሻያዎችን፣ ማሻሻያዎችን ወይም ሌሎች ተጨማሪዎችን በዚህ ሰነድ ላይ በጊዜ ወይም በፍፁም ለማቅረብ ምንም አይነት ቁርጠኝነት የለውም። ይህ ሰነድ የሶስተኛ ወገን የመረጃ ምንጮች፣ ሃርድዌር ወይም ሶፍትዌሮች፣ ምርቶች ወይም አገልግሎቶች እንደ በቅጂ መብት እና/ወይም በሶስተኛ ወገን የተጠበቀ ይዘትን የመሳሰሉ አካሎችን እና ይዘቶችን ጨምሮ ማጣቀሻዎችን ሊይዝ ይችላል። webጣቢያዎች (በአጠቃላይ "የሦስተኛ ወገን ምርቶች እና አገልግሎቶች"). ብላክቤሪ ይዘቱን፣ ትክክለኛነትን፣ የቅጂ መብት ተገዢነትን፣ ተኳኋኝነትን፣ አፈጻጸምን፣ ታማኝነትን፣ ህጋዊነትን፣ ጨዋነትን፣ አገናኞችን ወይም የሶስተኛ ወገን ምርቶችን ጨምሮ ለማናቸውም የሶስተኛ ወገን ምርቶች እና አገልግሎቶች አይቆጣጠርም፣ ተጠያቂም አይደለም አገልግሎቶች. በዚህ ሰነድ ውስጥ የሶስተኛ ወገን ምርቶች እና አገልግሎቶች ማጣቀሻ ማካተት በሶስተኛ ወገን ምርቶች እና አገልግሎቶች ብላክቤሪ ወይም በሶስተኛ ወገን በምንም መልኩ መፈቀዱን አያመለክትም።
በእርስዎ ስልጣን ውስጥ በሚመለከተው ህግ ከተከለከለው ልዩ ሁኔታ በስተቀር ሁሉም ሁኔታዎች፣ ማበረታቻዎች፣ ዋስትናዎች፣ ውክልናዎች ወይም የማንኛውም አይነት ዋስትናዎች፣ መግለጫዎች ወይም የተካተቱ፣ ፅሁፎችን ጨምሮ ማበረታቻዎች፣ ዋስትናዎች፣ ውክልናዎች ወይም የጥንካሬ ዋስትናዎች፣ የአካል ብቃት ለተወሰነ ዓላማ ወይም አጠቃቀም፣ ሸቀጣ ሸቀጥ፣ የሸቀጦች ጥራት፣ ያለመብት ጥሰት፣ አጥጋቢ ብቃት፣ ወይም አርዕስት፣ የንግድ ልውውጥ ወይም የአጠቃቀም ኮርስ፣ ወይም ከሰነዱ ወይም አጠቃቀሙ ጋር የተዛመደ፣ ወይም የማንኛውም ሶፍትዌር፣ ሃርድዌር፣ አገልግሎት፣ ወይም የማንኛውም የሶስተኛ ወገን ምርቶች እና አገልግሎቶች አፈጻጸም ወይም አለመፈጸም። እንዲሁም በግዛት ወይም በክልል የሚለያዩ ሌሎች መብቶች ሊኖሩዎት ይችላሉ። አንዳንድ ስልጣኖች የተካተቱ የዋስትና እና ሁኔታዎችን ማግለል ወይም ገደብ ላይፈቅዱ ይችላሉ። በሕግ የተፈቀደ እስከሆነ ድረስ፣ ከሰነዱ ጋር የተያያዙ ማናቸውም ዋስትናዎች ወይም ሁኔታዎች ከላይ በተገለጸው መሠረት ሊገለሉ አይችሉም፣ ነገር ግን ሊገደቡ የሚችሉ፣ እርስዎ በሚቀጥሉት ጊዜ እስከ ዘጠና (90) ቀናት ውስጥ የተገደቡ ናቸው። ሰነድ ወይም የይገባኛል ጥያቄው ርዕሰ ጉዳይ የሆነው እቃ።
በስልጣንዎ ውስጥ በሚመለከተው ህግ እስከፈቀደው ከፍተኛ መጠን፣በምንም አይነት ክስተት ብላክቤሪ ከዚህ ሰነድ ወይም አጠቃቀም፣ወይም አፈጻጸም ወይም አፈጻጸም ጋር በተያያዙ ጉዳዮች ላይ ተጠያቂ አይሆንም ARTY ከሚከተሉት ጥፋቶች መካከል ምንም ገደብ የለሽም ጨምሮ እዚህ ውስጥ የተጠቀሱ ምርቶች እና አገልግሎቶች፡- ቀጥተኛ፣ ተከታይ፣ አርአያነት ያለው፣ አጋጣሚ፣ ቀጥተኛ ያልሆነ፣ ልዩ፣ ቅጣት፣ ወይም ከባድ ጉዳት የሚያደርሱ ጉዳቶች፣ ዚ ማንኛውም የሚጠበቁ ቁጠባዎች፣ የንግድ ሥራ መቆራረጥ፣ የንግድ መረጃ ማጣት፣ የንግድ ዕድል ማጣት፣ ወይም ሙስና ወይም የውሂብ መጥፋት፣ ማንኛውንም ውሂብ ማስተላለፍ ወይም መቀበል አለመቻል፣ ከማናቸውም አፕሊኬሽኖች ጋር የተቆራኙ ችግሮች፣ ከBlackery ምርት አጠቃቀም ጋር የተያያዙ ችግሮች CKBERRY ምርቶች ወይም አገልግሎቶቹ ወይም የዚያ ክፍል ወይም ከማንኛቸውም የአየር ጊዜ አገልግሎቶች፣ የመተኪያ እቃዎች ዋጋ፣ የሽፋን ወጪዎች፣ መገልገያዎች ወይም አገልግሎቶች፣ የካፒታል ዋጋ፣ ወይም ሌሎች ተመሳሳይ ልዩ ኪሳራዎች፣ ባይሆኑም ባይሆኑም እና ባይሆኑም ኤስ ቆይቷል ስለ የሚቻልበት ምክር
እንደዚህ ያሉ ጉዳቶች ፡፡
በእርስዎ ስልጣን ውስጥ በሚመለከተው ህግ እስከተፈቀደው ከፍተኛው መጠን፣ ብላክቤሪ ምንም አይነት በውል፣ ማሰቃየት ወይም በአንተ ላይ ምንም አይነት የዝቅተኝነት ግዴታን ጨምሮ ሌላ ግዴታ፣ ተግባር ወይም ተጠያቂነት አይኖረውም።
በዚህ ውስጥ ያሉት ገደቦች፣ ማግለያዎች እና የክህደቶች ተፈጻሚ ይሆናሉ፡ (ሀ) የእርምጃ፣ ጥያቄ ወይም ድርጊት ተፈጥሮ ምንም ይሁን ምን የውል ስምምነትን፣ ቸልተኝነትን፣ ህገወጥነትን፣ ቸልተኝነትን፣ ህገወጥነትን በመጣስ ያልተገደበ ነው። እና መሠረታዊ መጣስ ወይም መጣስ ወይም የዚህ ስምምነት ዋና ዓላማ ውድቀት ወይም ከዚህ ውስጥ ከተካተቱት ማናቸውም መፍትሄዎች ይድናል፤ እና (ለ) ለብላክቤሪ እና ለተያያዙ ድርጅቶቹ፣ ተተኪዎቻቸው፣ ተመድበው፣ ወኪሎች፣ አቅራቢዎች (የአየር ጊዜ አገልግሎት አቅራቢዎችን ጨምሮ)፣ የተፈቀደላቸው ብላክቤሪ አከፋፋዮች (እንዲሁም የአየር ጊዜ አገልግሎት አቅራቢን ጨምሮ) ሰራተኞች እና ገለልተኛ ተቋራጮች።
ከዚህ በላይ ከተዘረዘሩት ገደቦች እና ማግለያዎች በተጨማሪ በማንኛውም ክስተት ዳይሬክተር ፣ ሰራተኛ ፣ ወኪል ፣ አከፋፋይ ፣ አቅራቢ ፣ የጥቁርቤሪ ገለልተኛ ተቋራጭ ወይም ማንኛቸውም የጥቁር አዝሙድ ሽያጭ ተባባሪዎች አይሳተፉም። ለማንኛውም የሶስተኛ ወገን ምርቶች እና አገልግሎቶች ከመመዝገብዎ፣ ከመጫንዎ ወይም ከመጠቀምዎ በፊት፣ የእርስዎ የአየር ሰአት አገልግሎት ሰጪ ሁሉንም ባህሪያቶቻቸውን ለመደገፍ መስማማቱን ማረጋገጥ የእርስዎ ሃላፊነት ነው። አንዳንድ የአየር ሰዓት አገልግሎት አቅራቢዎች ለ BlackBerry በይነመረብ አገልግሎት በመመዝገብ የበይነመረብ አሰሳ ተግባር ላይሰጡ ይችላሉ።
ስለ ተገኝነት፣ የዝውውር ዝግጅቶች፣ የአገልግሎት ዕቅዶች እና ባህሪያት ከአገልግሎት ሰጪዎ ጋር ያረጋግጡ። የሶስተኛ ወገን ምርቶችን እና አገልግሎቶችን ከ BlackBerry ምርቶች እና አገልግሎቶች መጫን ወይም መጠቀም አንድ ወይም ከዚያ በላይ የፈጠራ ባለቤትነት፣ የንግድ ምልክት፣ የቅጂ መብት ወይም ሌላ ፍቃድ ሊፈልግ ይችላል ጥሰትን ወይም የሶስተኛ ወገን መብቶችን መጣስ። የሶስተኛ ወገን ምርቶችን እና አገልግሎቶችን ለመጠቀም እና የሶስተኛ ወገን ፈቃዶች አስፈላጊ ከሆነ የመወሰን ሃላፊነት እርስዎ ብቻ ነዎት። ከተፈለገ እነሱን ለማግኘት ሃላፊነት አለብዎት። ሁሉም አስፈላጊ ፈቃዶች እስካልገኙ ድረስ የሶስተኛ ወገን ምርቶችን እና አገልግሎቶችን መጫን ወይም መጠቀም የለብዎትም። ማንኛውም የሶስተኛ ወገን ምርቶች እና አገልግሎቶች በብላክቤሪ ምርቶች እና አገልግሎቶች የሚቀርቡት ለእርስዎ እንዲመች ሆኖ ነው እና “AS IS” ያለ ምንም ግልጽ ወይም የተዘዋዋሪ ሁኔታዎች፣ ማረጋገጫዎች፣ ዋስትናዎች፣ ውክልናዎች ወይም ዋስትናዎች በ BlackBerry እና BlackBerry ተሰጥቷቸዋል። ከዚህ ጋር በተያያዘ ምንም አይነት ተጠያቂነት አይወስድም። የርስዎ የሶስተኛ ወገን ምርቶች እና አገልግሎቶች አጠቃቀም የሚተዳደረው እና በተለየ የፍቃድ ውሎች እና ሌሎች ከሶስተኛ ወገኖች ጋር በሚተገበሩ ስምምነቶች ከተስማሙ በስተቀር በፍቃድ ወይም በሌላ ከ BlackBerry ጋር የተደረገ ስምምነት በግልፅ ካልተሸፈነ በስተቀር።
የማንኛውም ብላክቤሪ ምርት ወይም አገልግሎት የአጠቃቀም ውል በተለየ ፍቃድ ወይም ከ BlackBerry ጋር በሚተገበር ሌላ ስምምነት ተቀምጧል። በዚህ ሰነድ ውስጥ ምንም አይነት መግለጫ የተጻፉ ስምምነቶችን ወይም ዋስትናዎችን ለመተካት የታሰበ ነገር የለም ለማንኛውም የብላክቤሪ ምርት ወይም አገልግሎት በከፊል።
ብላክቤሪ ኢንተርፕራይዝ ሶፍትዌር የተወሰኑ የሶስተኛ ወገን ሶፍትዌሮችን ያካትታል። ከዚህ ሶፍትዌር ጋር የተገናኘው የፍቃድ እና የቅጂ መብት መረጃ በ ላይ ይገኛል። http://worldwide.blackberry.com/legal/thirdpartysoftware.jsp.

BlackBerry Limited
2200 ዩኒቨርሲቲ አቬኑ ምስራቅ
ዋተርሉ፣ ኦንታሪዮ
ካናዳ N2K 0A7
ብላክቤሪ UK ሊሚትድ
የመሬት ወለል ፣ የፔርስ ህንፃ ፣ ምዕራብ ጎዳና ፣
Maidenhead፣ Berkshire SL6 1RL
የተባበሩት የንጉሥ ግዛት
በካናዳ የታተመ

ሰነዶች / መርጃዎች

BEMS የእውቂያ አገልግሎት API ማጣቀሻ [pdf] የተጠቃሚ መመሪያ የዕውቂያ አገልግሎት ኤፒአይ ማጣቀሻ፣ አድራሻ፣ የአገልግሎት API ማጣቀሻ፣ የኤፒአይ ማጣቀሻ፣ ማጣቀሻ

ዋቢዎች

• የተጠቃሚ መመሪያ