API የመጫኛ መመሪያ
የማጣቀሻ መመሪያ
የለውጥ ነጥብ 2021

© 2021 Changepoint Canada ULC ሁሉም መብቶች የተጠበቁ ናቸው። የአሜሪካ መንግስት መብቶች-በአሜሪካ መንግስት የመጠቀም፣ የማባዛ ወይም ይፋ ማድረጉ በ Changepoint Canada ULC የፍቃድ ስምምነት እና በDFAR 227.7202-1(a) እና 227.7202-3(a) (1995) ላይ በተደነገገው መሰረት ገደቦች ተገዢ ነው። DFARS 252.227-7013(c)(1)(ii) (OCT 1988)፣ FAR 12.212(a) (1995)፣ FAR 52.227-19፣ ወይም FAR 52.227-14 (ALT III)፣ እንደአስፈላጊነቱ። ይህ ምርት የ Changepoint Canada ULC ሚስጥራዊ መረጃ እና የንግድ ሚስጥሮችን ይዟል። ያለቅድመ ግልጽ የጽሁፍ ፍቃድ ከChangepoint Canada ULC ውጭ ይፋ ማድረግ የተከለከለ ነው። የዚህ ምርት አጠቃቀም ከ Changepoint Canada ULC ጋር የተጠቃሚው የፍቃድ ስምምነት ውሎች እና ሁኔታዎች ተገዢ ነው። ሰነዶች ሊባዙ የሚችሉት በፈቃድ ሰጪው ለውስጣዊ አገልግሎት ብቻ ነው። የChangepoint Canada ULC ግልጽ የጽሁፍ ፍቃድ ከሌለ የዚህ ሰነድ ይዘት ሊቀየር፣ ሊሻሻል ወይም ሊቀየር አይችልም። Changepoint Canada ULC በዚህ ውስጥ የተገለጸውን ይዘት በማንኛውም ጊዜ በማስታወቂያም ሆነ ያለ ማስታወቂያ ሊለውጠው ይችላል።

የ Changepoint API በመጫን ላይ

Changepoint API ስለ መጫን
የለውጥ ነጥብ ኤፒአይ እንደ COM ኤፒአይ፣ የዊንዶውስ ኮሙኒኬሽን ፋውንዴሽን (WCF) አገልግሎት እና ለኋላ ተኳኋኝነት፣ እንደ Web የአገልግሎቶች ማሻሻያ (WSE) አገልግሎት። ስለ Changepoint API መረጃ ለማግኘት የChangepoint API ማጣቀሻን ይመልከቱ። ለማሻሻያ ማስታወሻዎች፣ ማሳሰቢያዎች እና የታወቁ ጉዳዮች፣ በChangepoint ውስጥ የቡድን አቃፊዎች ውስጥ ያሉትን የመልቀቂያ ማስታወሻዎችን ይመልከቱ።
የለውጥ ነጥብ ኤፒአይ በማሻሻል ላይ
ከቀደመው የChangepoint ልቀት እያሻሻሉ ከሆነ፣ ይህን ስሪት ከመጫንዎ በፊት የቀደመውን የChangepoint API እና ክፍሎቹን ለማራገፍ የዊንዶውስ መቆጣጠሪያ ፓናልን ይጠቀሙ።
Changepoint API መስፈርቶች
የ Changepoint API ከመጫንዎ በፊት Changepointን መጫን አለብዎት። ለሶፍትዌር መስፈርቶች፣ በChangepoint ውስጥ ባለው የ2021 የመልቀቂያ ማስታወሻዎች እና ፓቼስ ቡድን አቃፊ ውስጥ የሚገኘውን የChangepoint ሶፍትዌር ተኳሃኝነት ማትሪክስ ይመልከቱ።
File የመንገድ ስምምነቶች
በዚህ ሰነድ ውስጥ፣ የሚከተሉት የውል ስምምነቶች ለጋራ መንገዶች ጥቅም ላይ ይውላሉ፡

• የ Changepoint መጫኛ የስር መንገድ.
  ነባሪው መንገድ፡-
  ሐ፡ ፕሮግራም Files (x86)ChangepointChangepoint
• እንደ የመግቢያ ቅንጅቶች መገልገያ ላሉ የጋራ የለውጥ ነጥብ መገልገያዎች መነሻ ቦታ።
  ነባሪው መንገድ፡-
  ሐ፡ ፕሮግራም Files (x86) የተለመደ FilesChangepointChangepoint

የ Changepoint API በመጫን ላይ

1. ከ Changepoint API media root directory, setup.exe ን ያሂዱ።
2. የባህሪ ምረጥ ማያ ገጽ እስኪታይ ድረስ ጥያቄዎቹን ይከተሉ።
3. ለመጫን የሚፈልጓቸውን ባህሪያት ይምረጡ እና ቀጣይ የሚለውን ጠቅ ያድርጉ.
4. የኤፒአይ መድረሻ አቃፊውን በነባሪ ይምረጡ API, እና ቀጣይ የሚለውን ጠቅ ያድርጉ.
   ማስታወሻ፡- የChangepoint Login Settings መገልገያ በ ውስጥ ተጭኗል የመግቢያ ቅንብሮች፣ እርስዎ የገለጹት የመድረሻ አቃፊ ምንም ይሁን ምን።
5. እርስዎ ከመረጡ Web አገልግሎቶች API፡ a. ምርጫ ሲደረግ
   a Web የጣቢያው ማያ ገጽ ይታያል, ሀ ይምረጡ webምናባዊ ማውጫውን ለመጨመር ጣቢያ እና በመቀጠል ቀጣይን ጠቅ ያድርጉ።
   ለ. ለመቀጠል ቀጣይ የሚለውን ጠቅ ያድርጉ። 6. የኤፒአይ መጫኑ ሲጠናቀቅ ጨርስን ጠቅ ያድርጉ።

የChangepoint API መሸጎጫ እንዲያውቅ በማዋቀር ላይ
የChangepoint API መሸጎጫ የሚያውቅ እንዲሆን ለማዋቀር የ"cache" እሴቶቹን ይተኩ። የይለፍ ቃል" እና "መሸጎጫ. የአገልጋዮች” ቁልፎች በሲፒ Web አገልግሎቶችWeb.ውቅር file በድርጅቱ ውስጥ ጥቅም ላይ ከዋሉት እሴቶች ጋርWeb.ውቅር file.
በማንቃት ላይ Web የአገልግሎት ማሻሻያዎች (WSE)

1. ያርትዑ Web.ውቅር file ለ web አገልግሎቶች. ነባሪው ቦታ፡-
   APICP Web አገልግሎቶችWeb.ውቅር
2. የሚከተለውን የአስተያየት መስመር ሶስት አጋጣሚዎችን ያግኙ፡
   <!- ​​እየተጠቀሙ ከሆነ የሚከተለውን አካል አስተያየት ይስጡ Web የአገልግሎት ማሻሻያዎች (WSE) ኤፒአይ። የWCF አገልግሎቶችን እየተጠቀሙ እና ካልጫኑ አስተያየቶችን ይተዉ Web የአገልግሎት ማሻሻያዎች (WSE) ->
3. እያንዳንዱን የአስተያየት መስመር ምሳሌ የሚከተለውን አካል አስተያየት አትስጥ፡
   <section name=”microsoft.web.አገልግሎት2″ … >webአገልግሎቶች >web.አገልግሎት2>
   ማስታወሻ፡- የwebአገልግሎቶች> ምንም አስተያየት የማይሰጥበት አካል ልጅ ነው።web>.

ምዝግብ ማስታወሻን በማዋቀር ላይ Web አገልግሎቶች API
ምዝግብ ማስታወሻውን ማዘጋጀት አለብዎት file የመንገድ እና የምዝግብ ማስታወሻ ደረጃዎች. የምዝግብ ማስታወሻዎቹ ደረጃዎች ድምር ናቸው። ለ example, ደረጃ 3ን ከገለጹ, ደረጃዎች 1, 2 እና 3 ገብተዋል. ነባሪው የምዝግብ ማስታወሻ ደረጃ 8 ነው።

1. ያርትዑ web አገልግሎቶች Web.ውቅር. ነባሪው ቦታ፡-
   APICP Web አገልግሎቶችWeb.ውቅር
2. ምዝግብ ማስታወሻውን ያዘጋጁFileመንገድ። ነባሪ እሴቱ ነው። APIAPILgs 3. LogLevel ያዘጋጁ. ትክክለኛዎቹ እሴቶች፡-
   0 = ምንም ምዝግብ ማስታወሻ የለም
   1 = የምንጭ ነገር እና ዘዴ
   2 = የስህተት መልእክት
   3 = የግቤት መለኪያዎች
   4 = ይመለሳል
   5 = ማስጠንቀቂያ
   8 = የፍተሻ ነጥብ

ምናባዊ ማውጫ ማረጋገጫን በማዋቀር ላይ Web አገልግሎቶች API
ስም-አልባ መዳረሻን ማንቃት እና የተቀናጀ የዊንዶውስ ማረጋገጫን ለሲፒ ማሰናከል አለቦትWebበበይነመረብ መረጃ አገልግሎቶች (IIS) ውስጥ የአገልግሎት ምናባዊ ማውጫ። ለበለጠ መረጃ የማይክሮሶፍት አይአይኤስን ሰነድ ይመልከቱ።
የውሂብ ጎታ ግንኙነት ቅንብሮችን በማዋቀር ላይ ለ Web አገልግሎቶች API
በ ውስጥ ያለውን የውሂብ ጎታ ግንኙነት ቅንብሮችን ለማመስጠር የመግቢያ ቅንብሮችን ይጠቀሙ Web አገልግሎቶች API Web.ውቅር file. ለበለጠ መረጃ በ Changepoint የመጫኛ መመሪያ ውስጥ "የውሂብ ጎታ ግንኙነት ቅንብሮችን ማዋቀር" የሚለውን ይፈልጉ።
ለ Changepoint WCF ማረጋገጫን በማዋቀር ላይ Web አገልግሎቶች
ለ Changepoint WCF የመተግበሪያ ማረጋገጫ እና ነጠላ መግቢያ (SSO) ማዋቀር ይችላሉ። Web አገልግሎቶች.
Secure Token Service (STS) በመጠቀም የሚከተሉት የማስፈጸሚያ አማራጮች ይገኛሉ፡-

• ኤስኤስኦ ISAPI SSL አማራጭን በመጠቀም
• ኤስኤስኦ WS-ፌዴሬሽን (ADFS 2.0) SSLን በመጠቀም ያስፈልጋል

SSL የሚያስፈልግ ከሆነ የውቅረት ስክሪፕቱ ጥቅም ላይ መዋሉን ያረጋግጣል።
የISAPI ውቅረት ስክሪፕቶች እና የመተግበሪያ ማረጋገጫ እንደ አማራጭ SSLን ማንቃት ይችላሉ።
ለWCF የመተግበሪያ ማረጋገጫን በማዋቀር ላይ Web አገልግሎቶች
ለ Changepoint WCF ነባሪው የማረጋገጫ አይነት Web አገልግሎቶች የመተግበሪያ ማረጋገጫ ናቸው።
በዚህ ክፍል ውስጥ ያሉትን ሂደቶች ተጠቀም፡-

• Changepoint WCF አዋቅር Web የመተግበሪያ ማረጋገጫን በSSL ለመጠቀም አገልግሎቶች
• የለውጥ ነጥብ WCF አድህር Web ከኤስኤስኦ አተገባበር ውስጥ አንዱን ከተተገበረ በኋላ ለትግበራ ማረጋገጫ አገልግሎቶች

PowerShellን ያዋቅሩ

1. የዊንዶውስ ፓወር ሼል ጥያቄን ይክፈቱ።
2. የማስፈጸሚያ ፖሊሲውን ያሻሽሉ፡
   አዋቅር-አስፈፃሚ ፖሊሲ ያልተገደበ

Stagሠ 1 የውቅረት መለኪያዎችን ይሰብስቡ
የውቅረት መለኪያዎችን ዋጋዎች ይወስኑ.

መለኪያ	መግለጫ
Webየአገልግሎት_ዱካ	የለውጥ ነጥብ WCF ቦታ Web አገልግሎቶች web ማመልከቻ files. ነባሪ፡ \API\CP Web አገልግሎቶች
የአገልግሎት ሰርተፍኬት_ ስም	የመልእክት ደህንነት ሁነታን በመጠቀም አገልግሎቱን ለደንበኞች ለማረጋገጥ የሚያገለግል የምስክር ወረቀት ስም። ነባሪ፡ የ"CN=ChangepointAPICertificate"የምስክር ወረቀት ስም።
HTTPS ያስፈልገዋል	HTTPS ጠይቅ (እውነት/ሐሰት) ነባሪ፡ ሐሰት።

Stagሠ 2 የውቅር ስክሪፕቶችን ያስፈጽሙ
የን ውቅር ለማሻሻል የውቅረት መለኪያዎችን እሴቶቹን ይጠቀሙ webጣቢያዎች.

1.  የPowerShell ጥያቄን ይክፈቱ።
   ማስታወሻ፡- አገልጋይህ የተጠቃሚ መለያ ቁጥጥር የነቃ ከሆነ ከፍ ያለ የአስተዳዳሪ ፈቃዶችን በመጠቀም የPowerShell ጥያቄን መክፈት አለብህ።
2. ወደ ሲፒ ይሂዱ web የአገልግሎት ውቅር ማውጫ፣ ነባሪ፡-
   ውቅረት ሲፒWebአገልግሎት
3.  አስፈጽም ./Configuration_AppAuth.ps1
4. መጠየቂያዎቹን ይከተሉ።

ነጠላ መግቢያ (SSO) ለWCF በማዋቀር ላይ Web አገልግሎቶች
PowerShellን ያዋቅሩ

1. የዊንዶውስ ፓወር ሼል ጥያቄን ይክፈቱ።
2. የማስፈጸሚያ ፖሊሲውን ያሻሽሉ፡
   አዋቅር-አስፈፃሚ ፖሊሲ ያልተገደበ

ISAPIን ለWCF በመጠቀም ኤስኤስኦን በማዋቀር ላይ Web አገልግሎቶች
Stagሠ 1 የውቅረት መለኪያዎችን ይሰብስቡ
ለሚከተሉት የውቅር መለኪያዎች እሴቶቹን ይወስኑ.

መለኪያ	መግለጫ
Webየአገልግሎት_ዱካ	የ Changepoint WCF ቦታ Web አገልግሎቶች web ማመልከቻ files. ነባሪ፡ \API\CP Web አገልግሎቶች
HTTPS ያስፈልገዋል	HTTPS ጠይቅ (እውነት/ሐሰት)። ነባሪ፡ ሐሰት።
የመቀየሪያ ነጥብ_RSA_ ኩኪ_ቀይር	ለኩኪ ምስጠራ የሚጠቀሙበት የምስክር ወረቀት ስም። ነባሪ፡ የ"CN=ChangepointAPICertificate"የምስክር ወረቀት ስም።
የአገልግሎት ሰርቲፊኬት_ስም	የመልእክት ደህንነት ሁነታን በመጠቀም አገልግሎቱን ለደንበኞች ለማረጋገጥ ጥቅም ላይ የሚውለውን የምስክር ወረቀት ስም ያስገቡ። ነባሪ፡ የ"CN=ChangepointAPICertificate"የምስክር ወረቀት ስም።
የሰርቲፊኬት_ስም መፈረም	የመፈረሚያ የምስክር ወረቀት ስም ያስገቡ። ይህ መልዕክቶችን ለመፈረም የሚጠቀሙበት የምስክር ወረቀት ስም ነው። ነባሪ፡ የ"CN=ChangepointAPICertificate"የምስክር ወረቀት ስም።
ISAPI_ሁነታ	የ ISAPI ሁኔታ። ነባሪ፡ ኤንቲ
ISAPI_ራስጌ	ISAPI_Mode "HEADER" ሲሆን ጥቅም ላይ የዋለው ራስጌ ለምሳሌampሌ፣ ባዶ።
የይገባኛል ጥያቄ ዓይነት	የኤስኤስኦ የይገባኛል ጥያቄ አይነት ያስገቡ። ነባሪ፡ http://schemas.xmlsoap.org/ws/2005/05/identity/claims/upn

Stagሠ 2 የውቅር ስክሪፕቶችን ያስፈጽሙ

1. የPowerShell ጥያቄን ይክፈቱ።
   ማስታወሻ፡- አገልጋይህ የተጠቃሚ መለያ ቁጥጥር የነቃ ከሆነ ከፍ ያለ የአስተዳዳሪ ፈቃዶችን በመጠቀም የPowerShell ጥያቄን መክፈት አለብህ።
2. ወደ ሲፒ ይሂዱ web የአገልግሎት ውቅር ማውጫ፣ ነባሪ፡-
   ውቅረት ሲፒWebአገልግሎት
3. አስፈጽም: ./Configuration_SSO_ISAPI.ps1
4. መጠየቂያዎቹን ይከተሉ።

WS-ፌደሬሽን (ADFS 2.0) ለWCF በመጠቀም ኤስኤስኦን በማዋቀር ላይ Web አገልግሎቶች
Stagሠ 1 የውቅረት መለኪያዎችን ይሰብስቡ
በሠንጠረዡ ውስጥ ያሉትን የውቅረት መለኪያዎች ዋጋዎችን ይወስኑ, ከታች. ADFS_Server_URI በዋና ተጠቃሚው አሳሽ የኢንተርኔት ክልል ውስጥ መሆኑን ያረጋግጡ።
ማስታወሻ፡- በነባሪ፣ Changepoint የታተመውን የፌደሬሽን ሜታዳታ ሰነድ በመጠቀም የደህንነት ማስመሰያዎችን ለመፈረም የሚያገለግሉትን የህዝብ ቁልፎች በራስ ሰር ለማዘመን ተዋቅሯል። በ ADFS ውስጥ ይህ ነው-
https://ADFS_Federation.ServiceName/FederationMetadata/2007-06/FederationMetadata.xml
በአንዳንድ ሁኔታዎች የ ADFS አገልጋይን ከመቀየሪያ ነጥብ መድረስ ላይቻል ይችላል። web አገልጋይ ስለዚህ የማዋቀሪያውን ስክሪፕት ካስኬዱ በኋላ ውቅሩን እራስዎ ማዘመን ይኖርብዎታል። ለዝርዝር መረጃ በገጽ 12 ላይ ያለውን “የወል ቁልፎችን በእጅ ማዘመን” የሚለውን ይመልከቱ።

መለኪያ	መግለጫ
Webየአገልግሎት_ዱካ	የለውጥ ነጥብ WCF ቦታ Web አገልግሎቶች web ማመልከቻ fileኤስ. ነባሪ፡ \API\CP Web አገልግሎቶች
Webአገልግሎት_URI	ለ Changepoint WCF የሚጠቀሙበት የጎራ መለያ Web አገልግሎቶች. ለ exampሌ.፣ https://changepointapi.abc.corp/CPWebService
ለውጥ ነጥብ_RSA_ ኩኪ_ቀይር	ለኩኪ ምስጠራ የሚጠቀሙበት የምስክር ወረቀት ስም። ነባሪ፡ የ"CN=ChangepointApiCertificate"የምስክር ወረቀት ስም።
የአገልግሎት ሰርቲፊኬት_ስም	የመልእክት ደህንነት ሁነታን በመጠቀም አገልግሎቱን ለደንበኞች ለማረጋገጥ የሚያገለግል የምስክር ወረቀት ስም። ነባሪ፡ የ"CN=ChangepointApiCertificate"የምስክር ወረቀት ስም።
የሰርቲፊኬት_ስም መፈረም	መልዕክቶችን ለመፈረም የሚጠቀሙበት የምስክር ወረቀት ስም። ነባሪ፡ የ"CN=ChangepointApiCertificate"የሰርቲፊኬት ስም ስራ ላይ ይውላል።
ADFS_ የፌደሬሽን አገልግሎት ስም	የፌዴሬሽኑ አገልግሎት ስም. ስሙን ለማግኘት፡ ከ ADFS አገልጋይ ADFS 2.0 አስተዳደር ኮንሶል አስጀምር። • ከግራ ምናሌው ADFS 2.0 ን ይምረጡ። • ከድርጊት መቃን ውስጥ የፌደሬሽን አገልግሎት ንብረቶችን አርትዕ የሚለውን ይምረጡ። የፌዴሬሽኑ አገልግሎት ስም በአጠቃላይ ትር ላይ ነው.
የይገባኛል ጥያቄ ዓይነት	የኤስኤስኦ የይገባኛል ጥያቄ አይነት። ነባሪው፡- http://schemas.xmlsoap.org/ws/2005/05/identity/claims/upn

Stagሠ 2 የውቅር ስክሪፕቶችን ያስፈጽሙ
አዋቅር webለማዋቀሪያ መለኪያዎች እሴቶቹን በመጠቀም ጣቢያዎች.

1. የPowerShell ጥያቄን ይክፈቱ።
   ማስታወሻ፡- አገልጋይህ የተጠቃሚ መለያ ቁጥጥር የነቃ ከሆነ ከፍ ያለ የአስተዳዳሪ ፈቃዶችን በመጠቀም የPowerShell ጥያቄን መክፈት አለብህ።
2. ወደ የለውጥ ነጥብ ይሂዱ web የአገልግሎት ውቅር ማውጫ፣ ነባሪ፡- ውቅረት ሲፒWebአገልግሎት
3.  ማስፈጸም፡./Configuration_SSO_ADFS.ps1
4. መጠየቂያዎቹን ይከተሉ።

Stagሠ 3 የሚታመን ፓርቲ እምነት መፍጠር
በ ADFS 2.0 Console ላይ የሚተማመን ፓርቲ እምነትን ይፍጠሩ።

1. በእርስዎ ADFS አገልጋይ ላይ ADFS 2.0 ኮንሶሉን ያስጀምሩ።
2. እርምጃ > ታማኝ ፓርቲን አክል የሚለውን ይምረጡ።
3. ጀምርን ጠቅ ያድርጉ።
4. በመስመር ላይ ወይም በአካባቢያዊ አውታረመረብ ላይ የታተመውን የታማኝ አካል ውሂብ አስመጣ የሚለውን ይምረጡ።
5. የፌዴሬሽኑን ሜታዳታ አድራሻ ያስገቡ እና በመቀጠል ቀጣይ የሚለውን ጠቅ ያድርጉ፣ ለምሳሌampላይ:
   https://changepointapi.abc.corp/cpwebservice/federationmetadata/2007-06/federationmetadata.xml
6. የማሳያ ስም አስገባ ለምሳሌ Changepoint WCF API, እና ቀጣይ, ቀጣይ, ቀጣይ, ከዚያም ዝጋን ጠቅ ያድርጉ.
7. ከላይ ላለው የለውጥ ነጥብ የሚተማመን ፓርቲ የይገባኛል ጥያቄ ህግ ያክሉ። ለ Changepoint፣ ነባሪው የይገባኛል ጥያቄ ህግ ስም "UPN" ነው።
8. የወጪ የይገባኛል ጥያቄ አይነት “* UPN” ወይም “UPN” የሚለውን የኤልዲኤፒ አይነታ “የተጠቃሚ-ዋና-ስም” ካርታ ይስሩ።

የህዝብ ቁልፎችን በእጅ በማዘመን ላይ
የ ADFS አገልጋይ ማስመሰያ ፊርማ ጣት አሻራ ለማግኘት

1. ከ ADFS አገልጋይ፣ ADFS 2.0 አስተዳደር ኮንሶሉን አስጀምር።
2. አገልግሎት > ሰርተፍኬቶችን ይምረጡ እና የቶከን መፈረም ሰርተፍኬትን ሁለቴ ጠቅ ያድርጉ።
3. የዝርዝሮች ትርን ይምረጡ።
4. የTumbprint መስኩን ይምረጡ።
5. የአውራ ጣት እሴቱን ለማግኘት የመጀመሪያውን ቦታ ጨምሮ ሁሉንም ክፍተቶች ያስወግዱ።

ለማዘመን Web.ውቅር file

1. ADFS ን ያርትዑ web.ውቅር. ነባሪው ቦታ፡-
   EnterpriseRP-STS_ADFS
2. ከስር ኤለመንት፣ ida:FederationMetadataLocation ቁልፍን አግኝ እና እሴቱን አጽዳ፡-
   
3. ስር , ያግኙ ንጥረ ነገር እና በሚከተለው ይተኩ: https://ADFS_Federation.ServiceName/adfs/services/trust” >https://ADFS_Federation.ServiceName/adfs/services/trust” />

የCOM API ግንኙነትን በመሞከር ላይ

1. የኤፒአይ የሙከራ መሣሪያን ያሂዱ። ነባሪው ቦታ፡-
   APIAPI ComponentsApiTestKit.exe።
2. የግንኙነት ሕብረቁምፊ > ኢንክሪፕተር የሚለውን ጠቅ ያድርጉ።
3. በቀላል የጽሑፍ ግንኙነቶች ሕብረቁምፊ መስክ ውስጥ፡-
   ሀ. SERVERNAMEን እና DATABASENAMEን በውሂብ ጎታህ መረጃ ይተኩ።
   ለ. USERID እና PASSWORDን በዳታቤዝ አስተዳዳሪ የተጠቃሚ መለያ መረጃ ይተኩ።
   ሐ. እንደ አስፈላጊነቱ የጊዜ ማብቂያውን ዋጋ ያስገቡ።
4. ኢንክሪፕት የሚለውን ጠቅ ያድርጉ።
5. በተመሰጠረ የግንኙነት ሕብረቁምፊ መስክ ውስጥ ጽሑፉን ይቅዱ።
6. የንግግር ሳጥኑን ዝጋ።
7. በኤፒአይ ሙከራ ኪት ሜኑ ላይ Connection> COM API Connection Tester የሚለውን ጠቅ ያድርጉ።
8. በ Current Version ትር ውስጥ የተመሰጠረውን የግንኙነት ሕብረቁምፊ ወደ የግንኙነት ሕብረቁምፊ መስክ ይለጥፉ።
9. በLoginId እና Password መስኮች ውስጥ የChangepoint መለያዎን የመግቢያ መታወቂያ እና ይለፍ ቃል ያስገቡ።
10. በ Loglevel (0-8) መስክ ውስጥ በ COM API ምዝግብ ማስታወሻ ውስጥ የሚመለሰውን የስህተት መረጃ ደረጃ ይግለጹ file የምርመራው ውጤት በግንኙነት ላይ ችግር ካሳየ.
    0 = ምንም ምዝግብ ማስታወሻ የለም
    1 = የምንጭ ነገር እና ዘዴ
    2 = የስህተት መልእክት
    3 = የግቤት መለኪያዎች
    4 = ይመለሳል
    5 = ማስጠንቀቂያ
    8 = የፍተሻ ነጥብ
    ነባሪው 8 ነው ፡፡
11. አገናኝን ጠቅ ያድርጉ።
    ግንኙነቱ የተሳካ ከሆነ፣ በውጤት መስኩ ላይ የስኬት መልእክት ይታያል። ግንኙነቱ ካልተሳካ የCOM API ምዝግብ ማስታወሻን ያረጋግጡ file ለስህተቶች. የምዝግብ ማስታወሻው ነባሪ ቦታ file ነው። APIAPILgs

የተጫኑትን የኤፒአይ ክፍሎች ስሪት በመፈተሽ ላይ
የመልቀቂያውን ስሪት እና ዱካ ጨምሮ ስለተጫኑት ክፍሎች ዝርዝሮችን ለማግኘት የስሪት አራሚ መገልገያውን መጠቀም ይችላሉ።

1. CPVersionChecker.exe ን ያሂዱ። ነባሪው መንገድ፡- የኤፒአይፒአይ አካላት
2. አንብብ የሚለውን ጠቅ ያድርጉ።

የ ን ስሪት በመፈተሽ ላይ Web አገልግሎቶች API

1. የኢንተርኔት ኤክስፕሎረርን ከአገልጋዩ ያስጀምሩ Web አገልግሎቶች ኤፒአይ ተጭኗል እና አድራሻውን ያስገቡ፡-
   http://localhost.port/CPWeb.Service/WSLogin.asmx  ወደብ የት ነው የወደብ ቁጥር የ webሲፒውን የጫኑበት ጣቢያWebየአገልግሎት ምናባዊ ማውጫ።
2. በ WSLogin ገጽ ላይ GetVersion አገናኝን ጠቅ ያድርጉ።
3. ጥሪን ጠቅ ያድርጉ።

በመሞከር ላይ Web አገልግሎቶች API ግንኙነት

1. የኢንተርኔት ኤክስፕሎረርን ከአገልጋዩ ያስጀምሩ Web አገልግሎቶች ኤፒአይ ተጭኗል እና አድራሻውን ያስገቡ፡- http://localhost.port/CPWeb.Service/WSLogin.asmx  ወደብ የት ነው የወደብ ቁጥር የ webሲፒውን የጫኑበት ጣቢያWebየአገልግሎት ምናባዊ ማውጫ።
2. በ WSLogin ገጽ ላይ የTestConnection አገናኝን ጠቅ ያድርጉ።
3. ጥሪን ጠቅ ያድርጉ። 4. በፈተና ውጤቶች ውስጥ፡-

• ከሆነ ኤለመንት ውሸት ነው፣ የሙከራ ግንኙነቱ ተሳክቷል።
• ከሆነ ኤለመንት እውነት ነው፣ የሙከራ ግንኙነቱ አልተሳካም። ለተጨማሪ
  ስለ ውድቀት ምክንያቶች መረጃ, ይመልከቱ እና በፈተና ውጤቶች ውስጥ ያሉ ንጥረ ነገሮች እና የኤፒአይ ምዝግብ ማስታወሻዎችን ያረጋግጡ። ወደ ኤፒአይ ምዝግብ ማስታወሻዎች ያለው ነባሪ መንገድ፡- APIAPILgs

በማዋቀር ላይ Web አገልግሎቶች ኤፒአይ በቋንቋ አገልጋይ ላይ

1. የለውጥ ነጥብን ለማሰማራት Web አገልግሎቶች በቋንቋ አገልጋይ ላይ፣ ማከል ወይም ማዘመን አለብህ tag በውስጡ Web አገልግሎቶች API web.ውቅር. ነባሪ ቦታ የ Web.ውቅር file ነው፡- APICP Web አገልግሎቶችWeb.ውቅር
2. ከሆነ tag ቀድሞውንም አለ፣ ሁለቱም የባህል እና የዩኒ ባህል ባህሪያት “en-US” መሆናቸውን ያረጋግጡ።
3. ከሆነ tag ቀድሞውኑ የለም ፣ የሚከተለውን ያክሉ , አስተያየት እና ንጥረ ነገሮች ወደweb> መስቀለኛ መንገድ:web>
   Visual Basic አማራጮች፡ ሁሉንም የውሂብ አይነት ልወጣዎችን ላለመፍቀድ ጥብቅ=" እውነትን አዘጋጅ። የሁሉንም ተለዋዋጮች ማስታወቂያ ለማስገደድ ግልጽ="እውነት" አዘጋጅ። ->
4. IIS ን እንደገና ያስጀምሩ።

ሰነዶች / መርጃዎች

Changepoint API ሶፍትዌር [pdf] የመጫኛ መመሪያ ኤፒአይ፣ ሶፍትዌር፣ ኤፒአይ ሶፍትዌር

ዋቢዎች

• የተጠቃሚ መመሪያ