Compute Engine VM-এ হোস্ট করা SAP-এর জন্য টোকেন ব্যবহার করে ABAP SDK প্রমাণীকরণ কনফিগার করুন এবং ঠিকানা যাচাইকরণ API চালান

1. ভূমিকা

এই কোডল্যাবে, আপনার এসএপি সিস্টেম কম্পিউট ইঞ্জিন ভিএম ইনস্ট্যান্সে হোস্ট করা হলে টোকেন ব্যবহার করে Google ক্লাউড এপিআই অ্যাক্সেস করার জন্য প্রমাণীকরণ সেট আপ করার ধাপগুলি দিয়ে যেতে হবে।

ব্যবহৃত পরিষেবার তালিকা হল:

• কম্পিউট ইঞ্জিন
• নেটওয়ার্ক পরিষেবা
• মেঘের শেল

আপনি কি নির্মাণ করবেন

আপনি নিম্নলিখিত সঞ্চালন করবেন:

• Google API-এর সাথে সংযোগ করতে SAP সিস্টেমে ইনস্টল করা ABAP SDK কনফিগার করুন।
• ঠিকানা যাচাইকরণ API কল করার জন্য একটি উদাহরণ রিপোর্ট প্রোগ্রাম তৈরি করুন।

2. প্রয়োজনীয়তা

• একটি ব্রাউজার, যেমন ক্রোম বা ফায়ারফক্স ।
• বিলিং সক্ষম সহ একটি Google ক্লাউড প্রকল্প বা Google ক্লাউড প্ল্যাটফর্মের জন্য একটি 90-দিনের বিনামূল্যে ট্রায়াল অ্যাকাউন্ট তৈরি করুন ৷
• আপনার সিস্টেমে ইনস্টল করা SAP GUI (উইন্ডোজ বা জাভা)। যদি আপনার সিস্টেমে SAP GUI ইতিমধ্যেই ইনস্টল করা থাকে, তাহলে অ্যাপ্লিকেশন সার্ভার IP হিসাবে VM বাহ্যিক IP ঠিকানা ব্যবহার করে SAP-এর সাথে সংযোগ করুন। আপনি যদি ম্যাকে থাকেন তবে আপনি এই লিঙ্কে উপলব্ধ জাভার জন্য SAP GUI ইনস্টল করতে পারেন।

3. আপনি শুরু করার আগে

• Google ক্লাউড কনসোলে , প্রকল্প নির্বাচক পৃষ্ঠায়, একটি Google ক্লাউড প্রকল্প নির্বাচন করুন বা তৈরি করুন (উদাহরণস্বরূপ, abap-sdk-poc).
• নিশ্চিত করুন যে আপনার ক্লাউড প্রকল্পের জন্য বিলিং সক্ষম করা আছে৷ একটি প্রকল্পে বিলিং সক্ষম কিনা তা পরীক্ষা করতে শিখুন। আপনি যদি 90-দিনের ফ্রি ট্রায়াল অ্যাকাউন্ট ব্যবহার করেন তবে এই ধাপটি এড়িয়ে যান।
• আপনি Cloud Shell ব্যবহার করবেন, Google ক্লাউডে চলমান একটি কমান্ড-লাইন পরিবেশ। ক্লাউড কনসোল থেকে, উপরের ডানদিকে কোণায় ক্লাউড শেল সক্রিয় করুন ক্লিক করুন:

• নিশ্চিত করুন যে সমস্ত প্রয়োজনীয় API (IAM পরিষেবা অ্যাকাউন্ট ক্রেডেনশিয়াল API এবং ঠিকানা যাচাইকরণ API) সক্ষম আছে৷
• আপনার অ্যাকাউন্টের জন্য প্রমাণীকরণ করতে নিম্নলিখিত কমান্ডগুলি চালান এবং ডিফল্ট প্রকল্পটিকে abap-sdk-poc এ সেট করুন। Zone us-west4-b উদাহরণ হিসেবে ব্যবহার করা হয়েছে। যদি প্রয়োজন হয়, অনুগ্রহ করে আপনার পছন্দের উপর ভিত্তি করে নীচের কমান্ডগুলিতে প্রকল্প এবং অঞ্চল পরিবর্তন করুন।

gcloud auth login
gcloud config set project abap-sdk-poc
gcloud config set compute/zone us-west4-b
PROJECT_NAME=abap-sdk-poc
REGION=us-west4
ZONE=us-west4-b

• Google ক্লাউড ইনস্টল করার জন্য ABAP SDK সহ একটি SAP সিস্টেমে আপনার অ্যাক্সেস রয়েছে তা নিশ্চিত করুন৷
• আপনি একটি নতুন সিস্টেম সেট আপ করতে কোডল্যাব " Google ক্লাউড প্ল্যাটফর্মে ABAP প্ল্যাটফর্ম ট্রায়াল 2022 ইনস্টল করুন এবং ABAP SDK ইনস্টল করুন " উল্লেখ করতে পারেন।

4. একটি পরিষেবা অ্যাকাউন্ট তৈরি করুন এবং পরিষেবা অ্যাকাউন্ট টোকেন নির্মাতার ভূমিকা সেট করুন

প্রয়োজনীয় ভূমিকা সহ একটি পরিষেবা অ্যাকাউন্ট তৈরি করতে, নিম্নলিখিত পদক্ষেপগুলি সম্পাদন করুন:

1. একটি পরিষেবা অ্যাকাউন্ট তৈরি করতে নিম্নলিখিত কমান্ডটি চালান: (অনুগ্রহ করে এই পদক্ষেপটি এড়িয়ে যান যদি পরিষেবা অ্যাকাউন্ট ইতিমধ্যেই বিদ্যমান থাকে)

gcloud iam service-accounts create abap-sdk-dev \
    --description="ABAP SDK Dev Account" \
    --display-name="ABAP SDK Dev Account"

2. পরিষেবা অ্যাকাউন্ট টোকেন নির্মাতার ভূমিকা সেট করতে নিম্নলিখিত কমান্ডটি চালান:

gcloud projects add-iam-policy-binding $PROJECT_NAME \
    --member=serviceAccount:abap-sdk-dev@$PROJECT_NAME.iam.gserviceaccount.com \
    --role=roles/iam.serviceAccountTokenCreator

5. ক্লায়েন্ট কী কনফিগার করুন

ব্যবহারকারীর নাম DEVELOPER এবং পাসওয়ার্ড Htods70334 দিয়ে SAP সিস্টেমে লগ ইন করুন এবং ক্লায়েন্ট কী কনফিগার করতে এই পদক্ষেপগুলি অনুসরণ করুন:

1. SAP GUI-তে, লেনদেন কোড SPRO লিখুন।
2. SAP রেফারেন্স IMG এ ক্লিক করুন।
3. Google ক্লাউড > বেসিক সেটিংস > কনফিগার ক্লায়েন্ট কী-এর জন্য ABAP SDK-এ ক্লিক করুন।
4. নতুন এন্ট্রি ক্লিক করুন.
5. নিম্নলিখিত ক্ষেত্রের জন্য মান লিখুন:

মাঠ	বর্ণনা
গুগল ক্লাউড কী নাম	ABAP_SDK_DEMO
Google ক্লাউড পরিষেবা অ্যাকাউন্টের নাম	[e-mail]
গুগল ক্লাউড স্কোপ	https://www.googleapis.com/auth/cloud-platform
Google ক্লাউড প্রকল্প শনাক্তকারী	abap-sdk-poc
অনুমোদন শ্রেণী	/GOOG/CL_AUTH_GOOGLE৷

অন্যান্য ক্ষেত্রগুলি ফাঁকা রাখুন

6. RFC গন্তব্য তৈরি করুন

IAM শংসাপত্র এবং ঠিকানা যাচাইকরণ API এর জন্য RFC গন্তব্য তৈরি করুন।

RFC গন্তব্যের নাম	টার্গেট হোস্ট (API শেষ পয়েন্ট)	নোট
ZGOOG_IAMCREDENTIALS	হোস্ট : iamcredentials.googleapis.com পাথ : উপসর্গ: /v1/ পোর্ট : 443 SSL : সক্রিয়	এই RFC গন্তব্যটি IAM API-কে লক্ষ্য করে।
ZGOOG_ADDRESSVALIDATION_V1	হোস্ট : addressvalidation.googleapis.com পোর্ট : 443 SSL : সক্রিয়	এই RFC গন্তব্য ঠিকানার বৈধতা API লক্ষ্য করে

• প্রযুক্তিগত সেটিংস ট্যাবের অধীনে, ZGOOG_IAMCREDENTIALS গন্তব্যের জন্য নিম্নলিখিত বিবরণ লিখুন।

• প্রযুক্তিগত সেটিংস ট্যাবের অধীনে, ZGOOG_ADDRESSVALIDATION_V1 গন্তব্যের জন্য নিম্নলিখিত বিবরণ লিখুন৷

• SSL শংসাপত্র ক্ষেত্রের জন্য, নিশ্চিত করুন যে RFC উভয় গন্তব্যের জন্য ডিফল্ট SSL ক্লায়েন্ট (স্ট্যান্ডার্ড) বিকল্পটি নির্বাচিত হয়েছে।

7. পরিষেবা ম্যাপিং কনফিগার করুন

IAM API এবং ঠিকানা যাচাইকরণ API এর জন্য পরিষেবা ম্যাপিং টেবিল কনফিগার করতে, নিম্নলিখিত পদক্ষেপগুলি সম্পাদন করুন:

1. SAP GUI-তে, লেনদেন কোড SPRO লিখুন।
2. SAP রেফারেন্স IMG এ ক্লিক করুন।
3. Google ক্লাউড > বেসিক সেটিংস > কনফিগার সার্ভিস ম্যাপিং-এর জন্য ABAP SDK-এ ক্লিক করুন।
4. RFC গন্তব্যগুলির সাথে লিঙ্কযুক্ত IAM শংসাপত্র এবং ঠিকানা যাচাইকরণ API-এর জন্য নতুন এন্ট্রিগুলিতে ক্লিক করুন৷

8. কনফিগারেশন যাচাই করুন

প্রমাণীকরণ কনফিগারেশন যাচাই করতে, নিম্নলিখিত পদক্ষেপগুলি সম্পাদন করুন:

1. SAP GUI-তে, লেনদেন কোড SPRO লিখুন।
2. SAP রেফারেন্স IMG এ ক্লিক করুন।
3. Google ক্লাউড > ইউটিলিটি > যাচাইকরণ কনফিগারেশনের জন্য ABAP SDK-এ ক্লিক করুন।
4. ABAP_SDK_DEMO হিসাবে ক্লায়েন্ট কী নাম লিখুন।
5. সামগ্রিক প্রবাহ সফলভাবে কনফিগার করা হয়েছে কিনা তা পরীক্ষা করতে এক্সিকিউটে ক্লিক করুন।
6. ফলাফল কলামে একটি সবুজ চেক নির্দেশ করে যে সমস্ত কনফিগারেশন ধাপ সফলভাবে সম্পন্ন হয়েছে।

9. ঠিকানা যাচাইকরণ পরিষেবাতে কল করার জন্য একটি রিপোর্ট প্রোগ্রাম তৈরি করুন৷

1. আপনার SAP সিস্টেমে লগ ইন করুন।
2. লেনদেন কোড SE38- এ যান এবং ZDEMO_ADDRESS_VALIDATION নামের একটি রিপোর্ট প্রোগ্রাম তৈরি করুন।
3. পপ-আপে যেটি খোলে, নীচে দেখানো হিসাবে বিশদ বিবরণ প্রদান করুন এবং সংরক্ষণ করুন ক্লিক করুন।

4. পরবর্তী পপ-আপে, হয় স্থানীয় অবজেক্ট নির্বাচন করুন বা উপযুক্ত হিসাবে একটি প্যাকেজ নাম দিন।
5. ABAP সম্পাদকে, নিম্নলিখিত কোড যোগ করুন:

" data declarations
DATA lv_ret_code          TYPE i.
DATA lv_err_text          TYPE string.
DATA ls_input             TYPE /goog/cl_addrvaldn_v1=>ty_012.
DATA ls_output            TYPE /goog/cl_addrvaldn_v1=>ty_013.
DATA ls_err_resp          TYPE /goog/err_resp.
DATA lo_exception         TYPE REF TO /goog/cx_sdk.
DATA lo_address_validator TYPE REF TO /goog/cl_addrvaldn_v1.

" instantiate api client stub
TRY.
    lo_address_validator = NEW #( iv_key_name = 'ABAP_SDK_DEV' ).

    " Pass the address to be validated and corrected.
    " Mountain misspelled as  Moutain
    " Amphitheatre misspelled as Amphithetre
    ls_input-address-region_code = 'US'.
    ls_input-address-locality    = 'Moutain View'.
    APPEND '1600, Amphithetre, Parkway' TO ls_input-address-address_lines.

    " call the api method to validate address
    lo_address_validator->validate_address( EXPORTING is_input    = ls_input
                                            IMPORTING es_output   = ls_output
                                                      ev_ret_code = lv_ret_code
                                                      ev_err_text = lv_err_text
                                                      es_err_resp = ls_err_resp ).
    IF     lo_address_validator->is_success( lv_ret_code ) = abap_true
       AND ls_output-result-verdict-address_complete       = abap_true.
      cl_demo_output=>new(
        )->begin_section( `Original Address`
        )->write_data( ls_input-address-region_code
        )->write_data( ls_input-address-locality
        )->write_data( ls_input-address-address_lines
        )->next_section( `Validated & Corrected Address`
        )->begin_section( `Elementary Object`
        )->write_data( ls_output-result-address-formatted_address
        )->display( ).
    ENDIF.

  CATCH /goog/cx_sdk INTO lo_exception.
    " write code here to handle exceptions
    cl_demo_output=>display( lo_exception->get_text( ) ).
ENDTRY.

6. প্রতিবেদনটি সংরক্ষণ করুন এবং সক্রিয় করুন।
7. রিপোর্ট চালান (F8)।

সফলভাবে সঞ্চালন করার সময় আপনাকে নীচে দেখানো হিসাবে রিপোর্ট আউটপুট দেখতে হবে:

10. অভিনন্দন

অভিনন্দন! ঠিকানা যাচাইকরণ পরিষেবাতে কল করার জন্য আপনি সফলভাবে ABAP SDK কনফিগার করেছেন৷

আপনি এখন Google ক্লাউডের জন্য ABAP SDK ব্যবহার করে বিভিন্ন Google ক্লাউড পরিষেবা অ্যাক্সেস করার জন্য আপনার শেখার যাত্রা চালিয়ে যেতে অন্যান্য ABAP SDK কোডল্যাবগুলির সাথে এগিয়ে যেতে পারেন৷

11. পরিষ্কার করুন

আপনি যদি Google ক্লাউডের জন্য ABAP SDK-এর সাথে সম্পর্কিত অতিরিক্ত কোডল্যাবগুলি চালিয়ে যেতে না চান, তাহলে অনুগ্রহ করে পরিষ্কারের সাথে এগিয়ে যান৷

প্রকল্পটি মুছুন

সতর্কতা : একটি প্রকল্প মুছে ফেলার নিম্নলিখিত প্রভাব রয়েছে:

• প্রকল্পের সবকিছু মুছে ফেলা হয়েছে। আপনি যদি এই নথিতে কাজগুলির জন্য একটি বিদ্যমান প্রকল্প ব্যবহার করেন, আপনি এটি মুছে ফেললে, আপনি প্রকল্পে আপনার করা অন্য কোনো কাজও মুছে ফেলবেন।
• কাস্টম প্রকল্প আইডি হারিয়ে গেছে। আপনি যখন এই প্রকল্পটি তৈরি করেছেন, আপনি হয়ত একটি কাস্টম প্রকল্প আইডি তৈরি করেছেন যা আপনি ভবিষ্যতে ব্যবহার করতে চান৷ একটি appspot.com ইউআরএলের মতো প্রোজেক্ট আইডি ব্যবহার করে এমন ইউআরএল সংরক্ষণ করতে, পুরো প্রোজেক্ট মুছে ফেলার পরিবর্তে প্রোজেক্টের মধ্যে নির্বাচিত রিসোর্স মুছে দিন।

আপনি যদি একাধিক আর্কিটেকচার, টিউটোরিয়াল বা কুইকস্টার্টগুলি অন্বেষণ করার পরিকল্পনা করেন তবে প্রকল্পগুলি পুনঃব্যবহার করা আপনাকে প্রকল্পের কোটা সীমা অতিক্রম এড়াতে সহায়তা করতে পারে।

• Google ক্লাউড প্রকল্প মুছুন:

gcloud projects delete abap-sdk-poc

পৃথক সম্পদ মুছুন

1. IMG > Google ক্লাউড > বেসিক সেটিংস > কনফিগার ক্লায়েন্ট কী-এ গিয়ে ক্লায়েন্ট কী কনফিগারেশন এন্ট্রি মুছুন।
2. IMG > Google ক্লাউড > বেসিক সেটিংস > কনফিগার ক্লায়েন্ট কী-তে গিয়ে পরিষেবা ম্যাপিং কনফিগারেশন এন্ট্রিগুলি মুছুন৷
3. RFC গন্তব্য ZGOOG_IAMCREDENTIALS এবং ZGOOG_ADDRESSVALIDATION_V1 মুছুন।
4. পরিষেবা অ্যাকাউন্ট মুছুন:

gcloud iam service-accounts delete \
    [e-mail]