এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

আপনার রূপান্তরিত কোডে ত্রুটি ঠিক করুন

ম্যাক্রো কনভার্টার অ্যাড-অন বেশিরভাগ রূপান্তর প্রক্রিয়া স্বয়ংক্রিয় করে, কিন্তু আপনার কোড চূড়ান্ত করার জন্য আপনাকে কিছু API এবং অন্যান্য আইটেমগুলিতে সামঞ্জস্য করতে হতে পারে।

আপনার প্রজেক্টে যোগ করা অ্যাপস স্ক্রিপ্ট ফাইলগুলি (GS ফাইল) বুঝতে, বিভিন্ন ধরনের ত্রুটি ব্যাখ্যা করতে এবং কীভাবে ত্রুটিগুলি ঠিক করতে হয় তা শিখতে এই নির্দেশিকাটি ব্যবহার করুন৷

আপনার প্রোজেক্টে যোগ করা অ্যাপস স্ক্রিপ্ট ফাইলগুলি বুঝুন

সাহায্য করার জন্য আপনার Apps স্ক্রিপ্ট প্রকল্পে অতিরিক্ত GS ফাইল যোগ করা হয়েছে:

VBA ধ্রুবক এবং মানগুলি সংজ্ঞায়িত করুন যা Apps স্ক্রিপ্টে বিদ্যমান নেই৷
রূপান্তরিত এপিআই প্রয়োগ করুন।
বৈকল্পিক সমাধান করুন।

নিম্নলিখিত GS ফাইলগুলি আপনার Apps Script প্রকল্পে যোগ করা হয়েছে:

Library.gs
Unimplemented_constructs.gs
Variant_resolutions.gs

`Library.gs`

সাধারণভাবে, আপনাকে library.gs ফাইলে কিছু পরিবর্তন করতে হবে না।

library.gs ফাইলটি আপনার VBA কোডে ব্যবহৃত ফাংশন এবং ধ্রুবকগুলিকে সংজ্ঞায়িত করে যা Apps স্ক্রিপ্টে বিদ্যমান নেই৷ এটি নতুন Apps স্ক্রিপ্ট কোডকে আপনার VBA কোডের সাথে আরও ভালোভাবে সাদৃশ্যপূর্ণ করতে সাহায্য করে। উপরন্তু, library.gs ফাইলের ফাংশন বা ধ্রুবক ব্যবহার করার সময় আপনাকে সংজ্ঞা পুনরাবৃত্তি করতে হবে না।

`Unimplemented_constructs.gs`

unimplemented_constructs.gs ফাইলটি কনস্ট্রাক্ট বা API এর ঠিকানা দেয় যা ম্যাক্রো কনভার্টার দ্বারা রূপান্তরিত করা যায় না। আপনার কোডটি উদ্দেশ্য অনুযায়ী কাজ করার জন্য আপনাকে সম্ভবত এই ফাইলটি সংশোধন করতে হবে।

উদাহরণ: `Window.Activate()`

নিম্নলিখিতটি Window.Activate() নামে একটি অসমর্থিত API-এর উদাহরণ। ম্যাক্রো কনভার্টার একই নামের একটি নতুন Apps স্ক্রিপ্ট ফাংশন তৈরি করে এবং এটি unimplemented_constructs.gs ফাইলে সংজ্ঞায়িত করে। যেহেতু VBA ফাংশন সমর্থিত নয়, তাই নতুন Apps Script ফাংশন একটি ব্যতিক্রম ছুঁড়েছে।

নতুন ফাংশনটি রূপান্তরিত অ্যাপস স্ক্রিপ্ট কোডে যোগ করা হয়েছে যেখানে VBA কোডে আসল API ব্যবহার করা হয়েছে।

আপনি যদি আসল API-এর আচরণ পুনরায় তৈরি করার জন্য একটি সমাধান খুঁজে পান তবে আপনাকে শুধুমাত্র unimplemented_constructs.gs ফাইলে ফাংশনের সংজ্ঞা আপডেট করতে হবে। একবার ফাংশনটি সেখানে সংজ্ঞায়িত হয়ে গেলে, আপনার Apps স্ক্রিপ্ট প্রকল্পে ফাংশনটি যেখানে প্রদর্শিত হবে সেখানে এটি প্রযোজ্য হবে৷

এখানে কোডের উদাহরণ:

মূল VBA কোড

Window.activate()

রূপান্তরিত Apps স্ক্রিপ্ট কোড, ইন লাইন যোগ করা হয়েছে

_api_window_activate();

unimplemented_constructs.gs ফাইলে ফাংশনের সংজ্ঞা যোগ করা হয়েছে

/**
 * Could not convert window.activate API. Please add relevant code in the
 * following function to implement it.
 * This API has been used at the following locations in the VBA script.
 *     module1 : line 3
 *
 * We couldn't find an equivalent API in Apps Script for this VBA API. Please
 * reconsider if this function call is critical, otherwise consider implementing
 * it in a different way.
 */
function _api_window_activate(CallingObject) {
  ThrowException("API window.activate not supported yet.");
}

`Variant_resolutions.gs`

variant_resolutions.gs ফাইলটি আপনার Apps স্ক্রিপ্ট প্রকল্পে যোগ করা হয় যদি কোনো বস্তুর ধরন নির্ধারণ করা না যায়। এটি একাধিক কারণে ঘটতে পারে, যেমন একটি API-এর একাধিক রিটার্ন টাইপ রয়েছে বা বস্তুটিকে একটি বৈকল্পিক হিসাবে ঘোষণা করা হয়েছে।

ম্যাক্রো কনভার্টার এই ফাইলটিতে __handle_resolve_<api>() নামে একটি নতুন ফাংশন যোগ করে যা প্রশ্নে থাকা APIকে প্রতিস্থাপন করে এবং বস্তুর ধরন নির্ধারণে সহায়তা করে।

কিছু ক্ষেত্রে, আপনাকে অবজেক্টের ধরন ম্যানুয়ালি ঘোষণা করতে __handle_resolve_<api>() ফাংশন আপডেট করতে হতে পারে। অসমর্থিত বস্তুর ধরন দেখুন।

উদাহরণ: `name()`

VBA তে অনেক অবজেক্ট টাইপ একটি name() API সংজ্ঞায়িত করে। সাধারণত, Apps স্ক্রিপ্টের সমতুল্য getName() হয়, কিন্তু প্রতিটি বস্তুর প্রকারের জন্য নয়। একাধিক বিকল্প ক্ষেত্রে ঘটতে পারে:

বস্তুর সমতুল্য API কে getName() চেয়ে ভিন্ন কিছু বলা হয়।
বস্তুটির নাম পাওয়ার জন্য কোনো Apps Script API নেই।
একটি সমতুল্য Apps স্ক্রিপ্ট অবজেক্ট নেই.

যখন বস্তুর ধরন নির্ধারণ করা হয় না, তখন ম্যাক্রো কনভার্টার variant_resolutions.gs ফাইলে __handle_resolve_name নামে একটি নতুন ফাংশন তৈরি করে।

এখানে কোডের উদাহরণ:

মূল VBA কোড

a = Selection.name

এই ক্ষেত্রে, বর্তমান নির্বাচনের উপর API name() বলা হয়। নির্বাচন একটি পত্রক বস্তু বা একটি আকৃতি বস্তু হতে পারে. যদি এটি একটি পত্রক অবজেক্ট হয়, তবে অনুবাদটি getName() , কিন্তু যদি এটি একটি আকৃতি অবজেক্ট হয় তবে অ্যাপস স্ক্রিপ্টে এর কোন সমতুল্য নেই।

রূপান্তরিত Apps স্ক্রিপ্ট কোড, ইন লাইন যোগ করা হয়েছে

a = __handle_resolve_name({}, getActiveSelection(), {});

নিচের __handle_resolve_name() ফাংশনটি বিভিন্ন অবজেক্টের ধরন সমাধানের জন্য variant_resolution.gs ফাইলে যোগ করা হয়েছে। ফাংশনটি বস্তুর ধরন পরীক্ষা করে, তারপর এটি সমর্থিত হলে getName() ব্যবহার করে, অথবা getName() সমর্থিত না হলে একটি ত্রুটি ছুড়ে দেয়।

variant_resolution.gs ফাইলে ফাংশনের সংজ্ঞা যোগ করা হয়েছে

function __handle_resolve_name(ExecutionContext, CallingObject, params_map) {
  var found_api_variant = false;
  var return_value;
  if (String(CallingObject) == "Sheet") {
    if (!ExecutionContext.isLhs) {
      return_value = CallingObject.getName();
      found_api_variant = true;
    }
  }
  if (CallingObject instanceof ChartInSheet) {
    if (!ExecutionContext.isLhs) {
      return_value = CallingObject.getName();
      found_api_variant = true;
    }
  }
  if (!found_api_variant) {
    ThrowException("API .name not supported yet.");
  }
  return return_value;
}

ত্রুটি খুঁজুন

আপনি যখন রূপান্তরিত Apps স্ক্রিপ্ট কোডে একটি ত্রুটির সম্মুখীন হন, তখন বার্তাটি ত্রুটির ধরন এবং এর অবস্থান নির্দিষ্ট করে৷ আপনি কোন অ্যাপস স্ক্রিপ্ট রানটাইম ব্যবহার করছেন তার উপর ত্রুটি বার্তার বিন্যাস নির্ভর করে।

আপনি যদি ডিফল্ট V8 রানটাইমে থাকেন, তাহলে আপনি একটি ত্রুটি দেখতে পাবেন যা নিচের মত দেখাচ্ছে:

_api_windows_active (unimplemented_constructs:2:3)

এর মানে ত্রুটিটি লাইন 2, অক্ষর 3-এ unimplemented_constructs.gs ফাইলে অবস্থিত।

আপনি যদি অবহেলিত Rhino রানটাইমে থাকেন, তাহলে আপনি একটি ত্রুটি দেখতে পাবেন যা নিচের মত দেখাচ্ছে:

unimplemented_constructs:2 (_api_windows_active)

এর মানে ত্রুটিটি লাইন 2 এ unimplemented_constructs.gs ফাইলে অবস্থিত।

ত্রুটির ধরন

উপরে বর্ণিত unimplemented_constructs.gs এবং variant_resolution.gs ফাইলগুলিতে আপনি যে ত্রুটিগুলি করেছেন তার বেশিরভাগই আপনি ঠিক করতে পারেন৷

আপনি যে ধরনের ত্রুটির মধ্যে পড়তে পারেন তার মধ্যে রয়েছে:

অনুপযুক্ত API
অনুপযুক্ত ভাষা নির্মাণ
আংশিকভাবে সমর্থিত API
ম্যানুয়াল কাজ প্রয়োজন
ইচ্ছাকৃত ত্রুটি

অনুপযুক্ত API

একটি অপ্রমাণিত API হল একটি API যা ম্যাক্রো কনভার্টার VBA থেকে Apps স্ক্রিপ্টে রূপান্তর করতে পারে না এবং API এর জন্য একটি পরিচিত সমাধান নেই।

unimplemented_constructs.gs ফাইলে আন-ইম্পলিমেন্টেড এপিআইগুলি সাধারণত খালি ফাংশন হিসাবে যোগ করা হয়-কখনও কখনও খালি স্বাক্ষর সহ। যদি অবজেক্টের ধরন নির্ধারণ করা না যায়, তাহলে এর পরিবর্তে, variant_resolution.gs ফাইলে অবাস্তব API যোগ করা হতে পারে।

রূপান্তরের আগে আপনার তৈরি করা সামঞ্জস্যপূর্ণ প্রতিবেদনে, এই APIটিকে আরও তদন্তের প্রয়োজন হিসাবে লেবেল করা হয়েছে।

আপনি যদি আপনার ফাইল রূপান্তর করার আগে আপনার VBA কোডে এই ধরনের API ঠিক না করেন, তাহলে অ্যাপস স্ক্রিপ্ট প্রকল্পে এটি কীভাবে প্রদর্শিত হবে তা এখানে:

/**
* Could not convert . Please add relevant code in the following
* function to implement it.
* This API has been used at the following locations in the VBA script.
*      : 
* We couldn't find an equivalent API in Apps Script for this VBA API. Please
* reconsider if this function call is critical, otherwise consider implementing
* it in a different way.
* @param param1 {}
* @param param2 {}
* ...
* @return {}
*/
function _api_<API_name>(param1, param2, ....) {
  ThrowException("API  not supported yet.");
}

অপরিবর্তিত API ত্রুটিগুলি ঠিক করুন৷

বিদ্যমান Apps Script API বা JS লাইব্রেরিগুলির সাথে অবাস্তব API সংজ্ঞায়িত করুন। এটি করার জন্য, এই পদক্ষেপগুলি অনুসরণ করুন:

ত্রুটির অবস্থানে রূপান্তরিত Apps স্ক্রিপ্ট কোড খুলুন. ত্রুটি খুঁজুন দেখুন.
ফাংশনের উপরে, যোগ করা মন্তব্যটি পড়ুন। কিছু ক্ষেত্রে, মন্তব্যটি অ্যাপস্ স্ক্রিপ্টে API কীভাবে প্রয়োগ করতে হয় তা পরামর্শ দেয়।
আপনি যদি Apps স্ক্রিপ্টে API প্রয়োগ করার উপায় খুঁজে না পান, তাহলে আপনার কোড থেকে এটি সরানোর কথা বিবেচনা করুন।
আপনি যদি কোনও সমাধান খুঁজে না পান বা আপনার কোড থেকে এই APIটি সরাতে না পারেন এবং আপনার ম্যাক্রো এই ত্রুটিটি ছুড়ে দেয়, আপনি এই ম্যাক্রোটিকে রূপান্তর করতে পারবেন না।

অবাস্তব API ত্রুটির উদাহরণ

এখানে অবাস্তব API পরিস্থিতিগুলির উদাহরণ এবং সেগুলি কীভাবে ঠিক করা যায়:

কোন সমতুল্য Apps স্ক্রিপ্ট নেই : Chart.Protect এর জন্য একটি পরোক্ষ সমাধান দেখায়, একটি API যা Apps স্ক্রিপ্টে বিদ্যমান নেই৷
একটি অজানা অবজেক্ট টাইপ : একটি পরিবর্তনশীল বস্তুর ধরনকে কীভাবে পরিচালনা করতে হয় এবং অ্যাপস্ স্ক্রিপ্টে পুনরায় তৈরি করা যেতে পারে এমন একটি অসমর্থিত অবজেক্ট টাইপ কীভাবে প্রয়োগ করতে হয় তা দেখায়।

উদাহরণ 1: কোন সমতুল্য Apps স্ক্রিপ্ট বা অজানা API নেই

এই উদাহরণে, Chart.Protect স্বয়ংক্রিয়ভাবে রূপান্তরিত হয়নি কারণ Google পত্রকগুলিতে একটি চার্ট সুরক্ষিত করার কোনো উপায় নেই৷

/**
* Could not convert chart.protect API. Please add relevant code in the following
* function to implement it.
*
* This API has been used at the following locations in the VBA script.
*     sheet1 : line 3
* You can use the following Apps Script APIs to convert it.
*
* Comments : Auto conversion of Chart.Protect is not supported yet. If the API is
* critical for the workflow the user can implement the unimplemented handler
* method in the generated code, else comment out the throw statement.
*
* @param {Object} CallingObject represents the parent object using which the API
* has been called.
* @param {string} Password
* @param {boolean} DrawingObjects
* @param {boolean} Contents
* @param {boolean} Scenarios
* @param {boolean} UserInterfaceOnly
*
*/
function _api_chart_protect(
   CallingObject, Password, DrawingObjects, Contents, Scenarios,
   UserInterfaceOnly) {
 ThrowException('API chart.protect not supported yet.');
}

যদিও আপনি একটি চার্ট রক্ষা করতে পারবেন না, আপনি চার্টের ডেটা পরিসীমা রক্ষা করতে পারেন যাতে ডেটা পরিবর্তন করা না যায়।

পরিসর রক্ষা করার একটি নমুনা বাস্তবায়ন নীচে দেখানো হয়েছে:

/**
* Could not convert chart.protect API. Please add relevant code in the following
* function to implement it.
* This API has been used at the following locations in the VBA script.
*     sheet1 : line 3
*
* You can use the following Apps Script APIs to convert it.
* Comments : Auto conversion of Chart.Protect is not supported yet. If the API
* is critical for the workflow the user can implement the unimplemented handler
* method in the generated code, else comment out the throw statement.
*
* @param {Object} CallingObject represents the parent object using which the API
* has been called.
* @param {string} Password
* @param {boolean} DrawingObjects
* @param {boolean} Contents
* @param {boolean} Scenarios
* @param {boolean} UserInterfaceOnly
*/
function _api_chart_protect(
  CallingObject, Password, DrawingObjects, Contents, Scenarios, UserInterfaceOnly) {
var ranges = CallingObject.getChart().getRanges();
for (var i = 0; i < ranges.length; i++) {
  // Note that this does not lock the range for the document owner.
  ranges[i].protect();
}
}

উদাহরণ 2: অসমর্থিত বস্তুর ধরন

যখন অবজেক্টের ধরনটি অজানা থাকে, তখন variant_resolution.gs ফাইলে অবাস্তব API ত্রুটি যোগ করা হয়। নিচের উদাহরণটি উপরের VBA name() API উদাহরণে প্রসারিত হয়েছে। variant_resolution.gs দেখুন।

এই উদাহরণে, আপনি শিখবেন:

variant_resolution.gs ফাইলে কিভাবে name() API একটি নতুন ফাংশনে রূপান্তরিত হয় ।
কনভার্ট করা কোডে কিভাবে নতুন ফাংশন বলা হয় ।
Apps Script-এ CommandBar , একটি অসমর্থিত অবজেক্ট টাইপের জন্য কীভাবে একটি সমাধান তৈরি করবেন ।

1. যেহেতু রূপান্তরিত কোডটি সঠিক অবজেক্ট টাইপ নির্ধারণ করতে পারে না যে name() কল করা হয়েছে, ম্যাক্রো কনভার্টার একটি নতুন ফাংশন তৈরি করে __handle_resolve_name নামক, নীচে দেখানো হয়েছে।

function __handle_resolve_name(ExecutionContext, CallingObject, params_map) {
 var found_api_variant = false;
 var return_value;
  if (String(CallingObject) == "Sheet") {
    if (!ExecutionContext.isLhs) {
      return_value = CallingObject.getName();
      found_api_variant = true;
    }
  }
  if (CallingObject instanceof ChartInSheet) {
    if (!ExecutionContext.isLhs) {
      return_value = CallingObject.getName();
      found_api_variant = true;
    }
  }
  if (!found_api_variant) {
    ThrowException('API .name not supported yet.');
  }
  return return_value;
}

2. ধরুন VBA কোড একটি PrintName() ফাংশন সংজ্ঞায়িত করে যা name() API কে কল করে। VBA কোড নীচে দেখানো হয়েছে:

‘Defining a function that prints the name of the object in parameter
Sub PrintName(obj as Variant)
  Debug.Print obj.Name
End Sub

যেহেতু `name()` একটি ভেরিয়েবলের উপর কল করা হয়, রূপান্তরিত কোডটি রূপান্তরের সময় অবজেক্টের ধরন জানে না। রূপান্তরিত Apps স্ক্রিপ্ট কোড `__handle_resolve_name` ফাংশন কল করবে:

function PrintName(obj) {
  Logger.log(_handle_resolve_name(obj));
}

3. ধরুন আপনার VBA কোডটি CommandBar অবজেক্ট টাইপের PrintName() ফাংশনটিকে কল করে। VBA কোড নীচে দেখানো হয়েছে:

PrintName Application.CommandBars.item("Standard")

Apps স্ক্রিপ্টে CommandBar সমর্থিত নয় এবং ফলস্বরূপ, উপরের VBA কোডে ব্যবহৃত দুটি পদ্ধতিও সমর্থিত নয়।

Application.CommandBars() : VBA-তে, এটি সমস্ত CommandBar অবজেক্টের একটি তালিকা প্রদান করে।
CommandBars.item() : VBA-তে, এটি একটি নির্দিষ্ট CommandBar অবজেক্ট প্রদান করে।

যেহেতু এই অবজেক্ট টাইপ অ্যাপস স্ক্রিপ্টে সমর্থিত নয়, রূপান্তরিত কোডটি `unimplemented_constructs.gs` ফাইলে নিম্নলিখিত ফাংশন তৈরি করে যা আপনাকে সংজ্ঞায়িত করতে হবে।

_api_application_commandbars()
_api_commandbars_item()

ফাংশনগুলিকে রূপান্তরিত কোডে কল করা হয় যা নীচে দেখানো হয়েছে:

PrintName(_api_commandbars_item(_api_application_commandbars(), "Standard")))

Here’s how the new functions are added to the unimplemented_construct.gs file:

function _api_application_commandbars(CallingObject) {
  ThrowException('API application.commandbars not supported yet.');
}
function _api_commandbars_item(CallingObject, index) {
  ThrowException('API commandbars.item not supported yet.');
}

কাজ করার জন্য নতুন ফাংশন পেতে, নিম্নলিখিত পদক্ষেপগুলি নিন:

3.1 একটি নতুন অবজেক্ট টাইপ সংজ্ঞায়িত করুন যা CommandBars এর কার্যকারিতা তৈরি করে এবং VBA-তে যা আছে তার অনুরূপ CommandBars এর একটি নতুন সংগ্রহ।

3.2 নতুন অবজেক্ট টাইপের জন্য একটি getName() পদ্ধতি যোগ করুন।

ধাপ 3.1 এবং 3.2 নীচের কোডে দেখানো হয়েছে। মেনু অবজেক্টগুলিকে একটি নতুন অবজেক্ট টাইপ হিসাবে তৈরি করা হয়েছে যা CommandBars এর আচরণকে অনুকরণ করে।

// Our Implementation of CommandBar using Menu objects.

function CommandBar(name) {
  this.name = name;
  // Create a menu object to represent the commandbar.
  this.menu = SpreadsheetApp.getUi().createMenu(name);
  // Create methods for retrieving or updating the name of the object
  this.getName = function() {
    return this.name;
  };
  this.updateName = function(name) {
    this.name = name;
  };
  // ========================================================================
  // Implement other methods of CommandBar objects that are used in the script.
  // =====================================================================
  return this;
}
// Our implementation of the collection of CommandBars that exists in VBA
function CommandBars() {
  this.commandBars = [];
  this.getCommandBar = function(name) {
    for (var i = 0; i < this.commandBars.length; i++) {
      if (!this.commandBars[i].getName() == name) {
        return this.commandBars[i];
      }
    }
    // No commandBar with the name exists, create a new one and return.
    var commandBar = new CommandBar(name);
    this.commandBars.push(commandBar);
    return commandBar;
  };
  return this;
}
// Create a global object that represents CommandBars collection.
var GlobalCommandBars = new CommandBars();

3.3 নতুন অবজেক্ট টাইপ পরিচালনা করতে variant_resolution.gs ফাইলে __handle_resolve_name ফাংশন পরিবর্তন করুন। ফাংশনে একটি বিভাগ যোগ করুন, যেমনটি নীচে দেখানো হয়েছে:

function __handle_resolve_name(ExecutionContext, CallingObject, params_map) {
 var found_api_variant = false;
 var return_value;
 if (String(CallingObject) == "Sheet") {
   if (!ExecutionContext.isLhs) {
     return_value = CallingObject.getName();
     found_api_variant = true;
   }
 }
 if (CallingObject instanceof ChartInSheet) {
   if (!ExecutionContext.isLhs) {
     return_value = CallingObject.getName();
     found_api_variant = true;
   }
 }
 // New section added below
 // ========================================================================
 if (CallingObject instanceof CommandBar) {
   objectExtend(params_map, {VALUETOSET: params_map.param0});
   if (ExecutionContext.isLhs) {
     // Call the setter method.
     CallingObject.updateName(params_map.VALUETOSET);
     found_api_variant = true;
   } else {
     // Getter is called, return the commandbar name,
     return_value = CallingObject.getName();
     found_api_variant = true;
   }
 }
 // ========================================================================
 // New section added above
 if (!found_api_variant) {
   ThrowException('API .name not supported yet.');
 }
 return return_value;
}

3.4 unimplemented_constructs.gs ফাইলে তৈরি দুটি ফাংশন সংজ্ঞায়িত করুন ( _api_application_commandbars() , _api_commandbars_item() )। এই ধাপটি নিশ্চিত করে যে ফাংশনের আসল কলগুলি কাজ করে।

//This is straightforward based on the implementation of a CommandBar and the
// CommandBars collection above:
function _api_application_commandbars(CallingObject) {
 return GlobalCommandBars;
}
function _api_commandbars_item(CallingObject, index) {
 return CallingObject.getCommandBar(index);
}

অনুপযুক্ত ভাষা নির্মাণ

একটি গঠন হল কোড ভাষার একটি উপাদান যা এক্সিকিউশন প্রবাহ বা ডেটা প্রদর্শন নিয়ন্ত্রণ করে। উদাহরণস্বরূপ, লুপ, লেবেল, ইভেন্ট এবং গোটো। এখানে সমস্ত VBA নির্মাণের একটি তালিকা রয়েছে।

যে গঠনগুলি ম্যাক্রো কনভার্টার রূপান্তর করতে পারে না সেগুলিকে অপ্রয়োজনীয় ভাষা নির্মাণ হিসাবে বিবেচনা করা হয়৷

যেখানে ম্যাক্রো কনভার্টার নির্ধারণ করে যে একটি অপ্রয়োজনীয় ভাষা গঠন বিদ্যমান, এটি একটি TODO মন্তব্য সন্নিবেশিত করে।

নিম্নলিখিত VBA নির্মাণ সমর্থিত নয়:

অপ্রয়োজনীয় ভাষা নির্মাণ ত্রুটি ঠিক করুন

আপনার কোড আপডেট করুন যাতে আপনার যুক্তি অসমর্থিত ভাষা নির্মাণের উপর নির্ভর না করে।
ত্রুটির অবস্থানে রূপান্তরিত Apps স্ক্রিপ্ট কোড খুলুন. ত্রুটি খুঁজুন দেখুন.
কোডের যুক্তির উপর ভিত্তি করে, এটিকে এমনভাবে আপডেট করুন যাতে অসমর্থিত ভাষা নির্মাণের প্রয়োজন হয় না।
যদি আপনি অসমর্থিত ভাষা নির্মাণ ছাড়া আপনার কোড পুনরায় লেখার উপায় খুঁজে না পান, আপনি এই ম্যাক্রো রূপান্তর করতে পারবেন না।

অপ্রয়োজনীয় ভাষা নির্মাণ ত্রুটির উদাহরণ

সবচেয়ে সাধারণ অপ্রয়োজনীয় ভাষা নির্মাণগুলির মধ্যে একটি হল একটি GoTo বিবৃতি। আপনি লুপ দিয়ে কিছু VBA GoTo স্টেটমেন্ট প্রতিস্থাপন করতে পারেন। GoTo স্টেটমেন্টের পরিবর্তে লুপ ব্যবহার করার দুটি উদাহরণ নিচে দেওয়া হল।

উদাহরণ 1: `GoTo` প্রতিস্থাপন করুন `While Loop`

মূল VBA কোড

Sub Test()
 a = 0
 start: Debug.Print a
 While a < 100
   a = a + 1
   If a Mod 3 == 0
     Goto start
   End If
 Wend
End Sub

সমতুল্য অ্যাপস স্ক্রিপ্ট কোড

function test() {
 var a = 0;
 start: do {
   console.log(a);
   while (a < 100) {
     a = a + 1;
     if (a % 3 == 0) {
       continue start;
     }
   }
   break start;
 } while (true);
}

উদাহরণ 2: GoTo প্রতিস্থাপন করুন লুপ দিয়ে

মূল VBA কোড

Sub Test()
 a = 0
 For i = 1 to 100
   For j = 1 to 10
     a =a a + 1
     If i + j > 50
       GoTo endLoop
     End If
   Next j
 Next i
 endLoop: MsgBox a
End Sub

সমতুল্য অ্যাপস স্ক্রিপ্ট কোড

function test() {
 var a = 0;
 endLoop: for (var i = 1; i <= 100; i++) {
    for  (var j = 0; j <=10; j++) {
      If (i + j > 50) {
        break endLoop;
      }
    }
 }
 Browser.msgBox(a);
}

   break start;
 } while (true);
}

আংশিকভাবে সমর্থিত API

আংশিকভাবে সমর্থিত API-এর জন্য, কিছু ইনপুট প্যারামিটার অ্যাপস স্ক্রিপ্টে সমর্থিত এবং কিছু নয়।

উদাহরণস্বরূপ, VBA API legend_position একটি Excel গ্রাফে কিংবদন্তি সংজ্ঞায়িত করতে ব্যবহৃত হয়। এটি একাধিক ধরনের ইনপুট মান সমর্থন করে, যার মধ্যে রয়েছে:

xlLegendPositionBottom : লেজেন্ডটিকে চার্টের নীচে রাখে।
xlLegendPositionCorner : লেজেন্ডটিকে চার্টের কোণায় রাখে।
xlLegendPositionCustom : লেজেন্ডটিকে চার্টে কাস্টম অবস্থানে রাখে।

অ্যাপস স্ক্রিপ্টের একটি সমতুল্য কোড রয়েছে যা শুধুমাত্র সেই মানগুলির কয়েকটিকে সমর্থন করে৷ নিম্নলিখিত মান সমর্থিত নয়:

xlLegendPositionCorner
xlLegendPositionCustom

আপনার রূপান্তরিত কোডে আংশিকভাবে সমর্থিত API-এর অসমর্থিত মানগুলিকে পতাকাঙ্কিত করার জন্য, library.gs ফাইলে একটি বৈধ শর্ত যোগ করা হয় যা সেই মানগুলির জন্য পরীক্ষা করে। যেমন:

if (position == xlLegendPositionCorner ||
     position == xlLegendPositionCustom) {
   position = _handle_legend_position_error(position);
}

যদি যাচাইকরণ শর্তটি অসমর্থিত মানগুলির একটি খুঁজে পায়, তাহলে একটি ত্রুটি হ্যান্ডলার ফাংশন, _handle_<API_name>_error , unimplemented_constructs.gs ফাইলে তৈরি করা হয়।

ফাংশন একটি ব্যবহারকারীর ত্রুটি নিক্ষেপ করে এবং একটি সমর্থিত মান দিয়ে মান প্রতিস্থাপন করবে না। যেমন:

/**
* Throw error message for unsupported legend position.
* The VBA API Legend.Position which can take values xlLegendPositionTop,
* xlLegendPositionLeft, xlLegendPositionBottom, xlLegendPositionRight,
* xlLegendPositionCorner, xlLegendPositionCustom. It is partially supported in
* Apps Scripts that supports only a subset of the values (does not support
* xlLegendPositionCorner and xlLegendPositionCustom).
* @param {string} position
*/
function _handle_legend_position_error(position) {
// Please comment the throw statement and return a supported position value
// instead.
// Values that are supported here are xlLegendPositionTop,
// xlLegendPositionLeft, xlLegendPositionBottom, xlLegendPositionRight.
throw new Error(
   'Google Sheets does not support legend position: ' + position);
}

আংশিকভাবে সমর্থিত API ত্রুটিগুলি ঠিক করুন৷

আপনার প্রয়োজনের জন্য একটি গ্রহণযোগ্য সমাধান দিয়ে অসমর্থিত মানগুলি প্রতিস্থাপন করতে _handle_<API_name>_error ফাংশনটি সংজ্ঞায়িত করুন।

ত্রুটির অবস্থানে রূপান্তরিত Apps স্ক্রিপ্ট কোড খুলুন. ত্রুটি খুঁজুন দেখুন.
কোন মানগুলি সমর্থিত এবং কোনটি নয় তা বুঝতে ফাংশনের উপরের মন্তব্যটি পড়ুন৷
অসমর্থিত মানগুলির জন্য, কোন সমর্থিত মানগুলি উপযুক্ত প্রতিস্থাপন হিসাবে কাজ করতে পারে তা নির্ধারণ করুন।
পরিবর্তে একটি সমর্থিত মান ফেরত দিতে _handle_<API_name>_error ফাংশন আপডেট করুন।
আপনি যদি অসমর্থিত মান প্রতিস্থাপন করার উপায় খুঁজে না পান তবে আপনি এই ম্যাক্রোটিকে রূপান্তর করতে পারবেন না।

আংশিকভাবে সমর্থিত API ত্রুটির উদাহরণ

নিম্নলিখিত উদাহরণটি উপরে উল্লিখিত VBA API legend_position এ প্রসারিত হয়েছে। আংশিকভাবে সমর্থিত API দেখুন।

নীচে মূল VBA কোডের একটি উদাহরণ যা একটি অসমর্থিত মান, xlLegendPositionCustom ব্যবহার করে।

Charts(1).Legend.Position = xlLegendPositionCustom

ম্যাক্রো কনভার্টার unimplemented_constructs.gs ফাইলে নিচের ফাংশন যোগ করে:

/**
* Throw error message for unsupported legend position.
* The VBA API Legend.Position which can take values xlLegendPositionTop,
* xlLegendPositionLeft, xlLegendPositionBottom, xlLegendPositionRight,
* xlLegendPositionCorner, xlLegendPositionCustom. It is partially supported in
* Apps Scripts that supports only a subset of the values (does not support
* xlLegendPositionCorner and xlLegendPositionCustom).
* @param {string} position
*/
function _handle_legend_position_error(position) {
// Please comment the throw statement and return a supported position value
// instead.
// Values that are supported here are xlLegendPositionTop,
// xlLegendPositionLeft, xlLegendPositionBottom, xlLegendPositionRight.
throw new Error(
   'Google Sheets does not support legend position: ' + position);
}

ম্যানুয়াল কাজ প্রয়োজন

ম্যানুয়াল কাজের প্রয়োজন মানে ভিবিএ এপিআই অ্যাপস স্ক্রিপ্টে রূপান্তরিত করা যেতে পারে, তবে এটির একটি সমাধান প্রয়োজন।

রূপান্তরের আগে আপনার তৈরি করা সামঞ্জস্যপূর্ণ প্রতিবেদনে, এই ধরনের এপিআইকে সমর্থিত কাজ হিসাবে লেবেল করা হয়েছে।

/**
* Could not convert  API. Please add relevant code in the following
* function to implement it.
* This API has been used at the following locations in the VBA script.
*      : 
*
* You can use the following Apps Script APIs to convert it.
* Apps Script APIs : 
* Apps Script documentation links : 
*
* @param param1 {}
* @param param2 {}
* ...
* @return {}
*/
function _api_<API_name>(param1, param2, ....) {
 ThrowException("API  not supported yet.");
}

ম্যানুয়াল কাজের প্রয়োজনীয় ত্রুটিগুলি ঠিক করুন

এপিআইকে উদ্দেশ্য অনুযায়ী কাজ করার জন্য এপিআই-এর জন্য একটি সমাধান প্রয়োগ করুন। 1. ত্রুটির অবস্থানে রূপান্তরিত Apps স্ক্রিপ্ট কোড খুলুন। ত্রুটি খুঁজুন দেখুন. 1. একটি সমাধানের জন্য কোন API ব্যবহার করা যেতে পারে তা বুঝতে ফাংশনের উপরের মন্তব্যটি পড়ুন। 1. যদি আপনি একটি উপযুক্ত সমাধান খুঁজে না পান, তাহলে আপনার কোড থেকে API সরানোর কথা বিবেচনা করুন৷ 1. যদি আপনি একটি সমাধান খুঁজে না পান বা আপনার কোড থেকে এই APIটি সরাতে না পারেন এবং আপনার ম্যাক্রো একটি ত্রুটি নিক্ষেপ করে, আপনি এই ম্যাক্রোটিকে রূপান্তর করতে পারবেন না৷

ম্যানুয়াল কাজের উদাহরণ ত্রুটির প্রয়োজন

এখানে এপিআইগুলির উদাহরণ রয়েছে যা ম্যানুয়াল কাজের প্রয়োজনীয় ত্রুটিগুলি ফেলে এবং কীভাবে সেগুলি ঠিক করতে হয়:

Implement a workaround for Autocorrect.Addreplacement ।
Implement a workaround for workbook.open() । এই উদাহরণটি দেখায় কিভাবে অ্যাপস স্ক্রিপ্ট দিয়ে Google ড্রাইভে ফাইল খুলতে হয়।

উদাহরণ 1: `Autocorrect.Addreplacement`

নিম্নলিখিত উদাহরণে, VBA API Autocorrect.Addreplacement রূপান্তরিত করা যেতে পারে, কিন্তু এটির একটি সমাধান প্রয়োজন৷ ম্যাক্রো কনভার্টার পরামর্শ দেয় কিভাবে কোড কমেন্টে ফাংশনটি বাস্তবায়ন করতে হয়।

/**
* Could not convert autocorrect.addreplacement API. Please add relevant code in
* the following function to implement it.
* This API has been used at the following locations in the VBA script.
*     sheet1 : line 3
* You can use the following Apps Script APIs to convert it.
* Apps Script APIs : FindReplaceRequest , onEdit
* Apps Script documentation links :
* https://developers.google.com/apps-script/reference/script/spreadsheet-trigger-builder#onedit
* https://developers.google.com/sheets/api/eap/reference/rest/v4/spreadsheets/request?hl=en#findreplacerequest

* Comments : AutoCorrect.AddReplacement was not converted, but there is an
* equivalent option you can implement manually. Use onEdit and FindReplaceRequest
* APIs instead, see https://developers.google.com/apps-script/reference/script/spreadsheet-trigger-builder#onedit
* and https://developers.google.com/sheets/api/eap/reference/rest/v4/spreadsheets/request?hl=en#findreplacerequest.
* For more information on API manual implementation, see
* https://developers.google.com/apps-script/guides/macro-converter/fix-conversion-errors.

* @param {Object} CallingObject represents the parent object using which the API
* has been called.
* @param {string} What
* @param {string} Replacement
* @return {string}
*/

function _api_autocorrect_addreplacement(CallingObject, What, Replacement) {
  ThrowException('API autocorrect.addreplacement not supported yet.');

}

Autocorrect.Addreplacement API এর বাস্তবায়ন নীচে দেখানো হয়েছে:

var AUTO_CORRECTIONS = "AUTO_CORRECTIONS";
// Need to get the autocorrections set in previous sessions and use them.
var savedAutoCorrections = PropertiesService.getDocumentProperties().getProperty(AUTO_CORRECTIONS);
var autoCorrections = savedAutoCorrections ? JSON.parse(savedAutoCorrections) : {};
function onEdit(e) {
autoCorrect(e.range);
}
function autoCorrect(range) {
for (key in autoCorrections) {
// Replace each word that needs to be auto-corrected with their replacements.
range.createTextFinder(key)
.matchCase(true)
.matchEntireCell(false)
.matchFormulaText(false)
.useRegularExpression(false)
.replaceAllWith(autoCorrections[key]);
}
}
/**
* Could not convert autocorrect.addreplacement API. Please add relevant code in
* the following function to implement it.
* This API has been used at the following locations in the VBA script.
* sheet1 : line 3
*
* You can use the following Apps Script APIs to convert it.
* Apps Script APIs : createTextFinder , onEdit
* Apps Script documentation links : https://developers.google.com/apps-script/reference/script/spreadsheet-trigger-builder#onedit ,
createTextFinder
* Comments : AutoCorrect.AddReplacement was not converted, but there is an
* equivalent option you can implement manually. Use onEdit and FindReplaceRequest
* APIs instead, see https://developers.google.com/apps-script/reference/script/spreadsheet-trigger-builder#onedit
* and createTextFinder. For more information on API manual implementation, see
* https://developers.google.com/apps-script/guides/macro-converter/fix-conversion-errors.
*
* @param {Object} CallingObject represents the parent object using which the API has been called.
* @param {string} What
* @param {string} Replacement
*
* @return {string}
*/

function _api_autocorrect_addreplacement(CallingObject, What, Replacement) {
autoCorrections[What] = Replacement;
// Store the updated autoCorrections in the properties so that future executions use the correction.
PropertiesService.getDocumentProperties().setProperty(AUTO_CORRECTIONS, JSON.stringify(autoCorrections));
}

উদাহরণ 2: `Workbook.open()`

VBA API workbook.open() একটি ফাইল পাথের উপর ভিত্তি করে একটি স্থানীয় ফাইল খোলে।

ধরুন VBA কোডে workbook.open() দ্বারা দুটি ফাইল খোলা হচ্ছে:

ফাইল 1: C:\Data\abc.xlsx
ফাইল 2: C:\Data\xyz.xlsx

নিচে দেখানো হয়েছে কিভাবে ম্যাক্রো কনভার্টার Workbook.open() Apps Script দিয়ে প্রতিস্থাপন করে সব জায়গায় Workbook.open() ফাইল 1 খুলতে ব্যবহার করা হয়:

var spreadSheetId =
   _handle_mso_excel_get_google_spreadsheet_id("C:\Data\abc.xlsx");
var spreadSheet = SpreadsheetApp.openById(spreadSheetId);

নিচের ত্রুটিটি অ্যাপস স্ক্রিপ্ট প্রকল্পের unimplemented_constructs.gs ফাইলে যোগ করা হয়েছে:

/**
* Method to return the spreadsheet id manually.
*
* @param {string} FileName ID of the spreadsheet to be opened.
* @return {string} return the spreadsheet id.
*/
function _handle_mso_excel_get_google_spreadsheet_id(FileName) {
 // Upload the Excel files being opened by the API to Google Drive and convert
 // them to Google Sheets.
 // Determine the spreadsheet ID of the Google Sheets file created.
 // Implement this method to return the corresponding spreadsheet ID when given
 //the original file path as parameter.
 throw new Error('Please return the spreadsheet ID corresponding to filename: ' + FileName);
 return '';
}

উপরের নমুনায় মন্তব্যের নির্দেশ অনুসারে, আপনাকে লক্ষ্য ফাইলগুলিকে Google ড্রাইভে Google পত্রক ফাইলগুলিতে রূপান্তর করতে হবে৷

সংশ্লিষ্ট Google স্প্রেডশীট আইডিগুলি নীচে বোল্ড করা হয়েছে:

ফাইল #1: C:\Data\abc.xlsx হয়ে যায় https://docs.google.com/spreadsheets/d/ abc123Abc123Abc123abc
ফাইল #2: C:\Data\abc.xlsx https://docs.google.com/spreadsheets/d/ xyz456Xyz456xYz456xyZ হয়ে যায়

তারপরে, আইডি দ্বারা ফাইলগুলি খুলতে অ্যাপস স্ক্রিপ্ট ফাংশনে কোডটি পরিবর্তন করুন, যেমনটি নীচে দেখানো হয়েছে:

/**
* Method to return the spreadsheet id manually.
*
* @param {string} FileName ID of the spreadsheet to be opened.
* @return {string} return the spreadsheet id.
*/
function _handle_mso_excel_get_google_spreadsheet_id(FileName) {
 // Upload the Excel files being opened by the API to Google Drive and convert
 //them to Google Sheets.
 // Determine the spreadsheet ID of the Google Sheets file created.
 // Implement this method to return the corresponding spreadsheet ID when given
 //the original file path as parameter
 if (Filename.indexOf("abc.xlsx") >= 0) {
   return "abc123Abc123Abc123abc";
 } else if (Filename.indexOf("xyz.xlsx") >= 0) {
   return "xyz456Xyz456xYz456xyZ";
 }

ইচ্ছাকৃত ত্রুটি

আপনার আসল VBA কোডের ত্রুটি আচরণ অনুকরণ করতে আপনার রূপান্তরিত কোডে ইচ্ছাকৃত ত্রুটিগুলি যোগ করা হয়েছে৷ আপনার এই ত্রুটিগুলি সংশোধন করার দরকার নেই।

ইচ্ছাকৃত ত্রুটির উদাহরণ

আপনি যদি VBA-তে অ্যারের সীমার বাইরে একটি উপাদান অ্যাক্সেস করার চেষ্টা করেন, কোডটি একটি ব্যতিক্রম নিক্ষেপ করে। অ্যাপস স্ক্রিপ্টে, কোডটি অনির্ধারিতভাবে ফিরে আসে।

অপ্রত্যাশিত ফলাফল এড়াতে, ম্যাক্রো কনভার্টার অ্যাপস স্ক্রিপ্ট কোড যোগ করে যা আপনি যদি অ্যারের সীমার বাইরে উপাদানগুলি অ্যাক্সেস করার চেষ্টা করেন তবে একটি ব্যতিক্রম থ্রো করে৷

এই উদাহরণটি নীচের কোডে দেখানো হয়েছে:

মূল VBA কোড

Dim arr
arr = Array("apple", "orange")
MsgBox arr(5)
Will throw the following error:
Subscript out of range

রূপান্তরিত অ্যাপস স্ক্রিপ্ট কোড (ব্যতিক্রম ত্রুটি যোগ করার আগে)

var arr;
arr = ["apple", "orange"];
Browser.msgBox(arr[5]);
Will return this value and not throw an error:
undefined

অ্যাপস স্ক্রিপ্ট কোড ব্যতিক্রম ত্রুটি নিক্ষেপ যোগ করা হয়েছে

/**
* Extend the regular JS array to support VB style indexing with a get method.
* @returns{*} value at the index
*/
Array.prototype.get = function() {
 var curr_res = this;
 for (var i = 0; i < arguments.length; i++) {
   if (!Array.isArray(curr_res) || curr_res.length < arguments[i]) {
     throw new Error(‘Converted VBA Error (Intentional Error): Subscript out of range’);
   }
   curr_res = curr_res[arguments[i]];
 }
 return curr_res;
};
var arr;
arr  = ["apple", "orange"];
Browser.msgBox(arr.get(5));

আপনার রূপান্তরিত কোডে ত্রুটি ঠিক করুন

আপনার প্রোজেক্টে যোগ করা অ্যাপস স্ক্রিপ্ট ফাইলগুলি বুঝুন

Library.gs

Unimplemented_constructs.gs

উদাহরণ: Window.Activate()

Variant_resolutions.gs

উদাহরণ: name()

ত্রুটি খুঁজুন

ত্রুটির ধরন

অনুপযুক্ত API

অপরিবর্তিত API ত্রুটিগুলি ঠিক করুন৷

অবাস্তব API ত্রুটির উদাহরণ

উদাহরণ 1: কোন সমতুল্য Apps স্ক্রিপ্ট বা অজানা API নেই

উদাহরণ 2: অসমর্থিত বস্তুর ধরন

অনুপযুক্ত ভাষা নির্মাণ

অপ্রয়োজনীয় ভাষা নির্মাণ ত্রুটি ঠিক করুন

অপ্রয়োজনীয় ভাষা নির্মাণ ত্রুটির উদাহরণ

উদাহরণ 1: GoTo প্রতিস্থাপন করুন While Loop

উদাহরণ 2: GoTo প্রতিস্থাপন করুন লুপ দিয়ে

আংশিকভাবে সমর্থিত API

আংশিকভাবে সমর্থিত API ত্রুটিগুলি ঠিক করুন৷

আংশিকভাবে সমর্থিত API ত্রুটির উদাহরণ

ম্যানুয়াল কাজ প্রয়োজন

ম্যানুয়াল কাজের প্রয়োজনীয় ত্রুটিগুলি ঠিক করুন

ম্যানুয়াল কাজের উদাহরণ ত্রুটির প্রয়োজন

উদাহরণ 1: Autocorrect.Addreplacement

উদাহরণ 2: Workbook.open()

ইচ্ছাকৃত ত্রুটি

ইচ্ছাকৃত ত্রুটির উদাহরণ

সম্পর্কিত নিবন্ধ

`Library.gs`

`Unimplemented_constructs.gs`

উদাহরণ: `Window.Activate()`

`Variant_resolutions.gs`

উদাহরণ: `name()`

উদাহরণ 1: `GoTo` প্রতিস্থাপন করুন `While Loop`

উদাহরণ 1: `Autocorrect.Addreplacement`

উদাহরণ 2: `Workbook.open()`