इस पेज का अनुवाद Cloud Translation API से किया गया है.

अपने बदले गए कोड की गड़बड़ियां ठीक करना

मैक्रो कन्वर्टर ऐड-ऑन, कन्वर्ज़न की ज़्यादातर प्रोसेस को अपने-आप पूरा कर देता है. हालांकि, अपने कोड को पूरा करने के लिए, आपको कुछ एपीआई और अन्य आइटम में बदलाव करने पड़ सकते हैं.

अपने प्रोजेक्ट में जोड़ी गई Apps Script फ़ाइलों (GS फ़ाइलों) को समझने, गड़बड़ी के अलग-अलग टाइप को समझने, और गड़बड़ियों को ठीक करने का तरीका जानने के लिए, इस गाइड का इस्तेमाल करें.

अपने प्रोजेक्ट में जोड़ी गई Apps Script फ़ाइलों के बारे में जानकारी

इन चीज़ों में मदद करने के लिए, आपके Apps Script प्रोजेक्ट में अन्य GS फ़ाइलें जोड़ी जाती हैं:

VBA की ऐसी स्थिर वैल्यू और वैल्यू तय करें जो Apps Script में मौजूद नहीं हैं.
ऐसे एपीआई लागू करें जिन्हें बदला नहीं गया है.
वैरिएंट से जुड़ी समस्याओं को हल करें.

आपके Apps Script प्रोजेक्ट में ये GS फ़ाइलें जोड़ी जाती हैं:

Library.gs
Unimplemented_constructs.gs
Variant_resolutions.gs

`Library.gs`

आम तौर पर, आपको library.gs फ़ाइल में कोई बदलाव करने की ज़रूरत नहीं होती.

library.gs फ़ाइल में उन फ़ंक्शन और कॉन्स्टेंट के बारे में बताया गया है जिनका इस्तेमाल आपके VBA कोड में किया गया था और जो Apps Script में मौजूद नहीं हैं. इससे, नए Apps Script कोड को आपके VBA कोड से मिलता-जुलता बनाने में मदद मिलती है. इसके अलावा, library.gs फ़ाइल के फ़ंक्शन या कॉन्स्टेंट का इस्तेमाल करने पर, आपको हर बार परिभाषाएं दोहराने की ज़रूरत नहीं होती.

`Unimplemented_constructs.gs`

unimplemented_constructs.gs फ़ाइल, उन कॉन्स्ट्रक्ट या एपीआई के पते दिखाती है जिन्हें मैक्रो कन्वर्टर से बदला नहीं जा सका. अपने कोड को सही तरीके से काम कराने के लिए, आपको इस फ़ाइल में बदलाव करना पड़ सकता है.

उदाहरण: `Window.Activate()`

यहां Window.Activate() नाम के ऐसे एपीआई का उदाहरण दिया गया है जो काम नहीं करता. मैक्रो कन्वर्टर, मिलते-जुलते नाम वाला एक नया Apps Script फ़ंक्शन बनाता है और उसे unimplemented_constructs.gs फ़ाइल में बताता है. VBA फ़ंक्शन काम नहीं करता है इसलिए, Apps Script का नया फ़ंक्शन एक अपवाद देता है.

नया फ़ंक्शन, बदले गए Apps Script कोड में उन सभी जगहों पर जोड़ा जाता है जहां VBA कोड में ओरिजनल एपीआई का इस्तेमाल किया गया था.

अगर आपको ओरिजनल एपीआई के व्यवहार को फिर से बनाने का कोई समाधान मिलता है, तो आपको सिर्फ़ unimplemented_constructs.gs फ़ाइल में फ़ंक्शन की परिभाषा को अपडेट करना होगा. फ़ंक्शन को वहां तय करने के बाद, यह आपके Apps Script प्रोजेक्ट में जहां भी दिखता है वहां लागू होता है.

यहां कोड में उदाहरण दिया गया है:

ओरिजनल VBA कोड

Window.activate()

बदले गए Apps Script कोड को इन-लाइन जोड़ा गया

_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 Script प्रोजेक्ट में जोड़ दिया जाता है. ऐसा कई वजहों से हो सकता है, जैसे कि ऐसा एपीआई जिसमें कई रिटर्न टाइप हों या ऑब्जेक्ट का एलान अपने-आप एक वैरिएंट के तौर पर किया गया हो.

मैक्रो कन्वर्टर, इस फ़ाइल में __handle_resolve_<api>() नाम का एक नया फ़ंक्शन जोड़ता है. यह फ़ंक्शन, एपीआई की जगह लेता है और ऑब्जेक्ट टाइप तय करने में मदद करता है.

कुछ मामलों में, ऑब्जेक्ट टाइप को मैन्युअल तौर पर बताने के लिए, आपको __handle_resolve_<api>() फ़ंक्शन को अपडेट करना पड़ सकता है. ऑब्जेक्ट का वह टाइप जो काम नहीं करता देखें.

उदाहरण: `name()`

VBA में कई तरह के ऑब्जेक्ट, name() एपीआई तय करते हैं. आम तौर पर, Apps Script के लिए getName() का इस्तेमाल किया जाता है. हालांकि, यह हर तरह के ऑब्जेक्ट के लिए नहीं होता. इसके कई वैकल्पिक उदाहरण हो सकते हैं:

ऑब्जेक्ट के मिलते-जुलते एपीआई को getName() से अलग नाम दिया जाता है.
ऑब्जेक्ट का नाम पाने के लिए, उसमें Apps Script API नहीं है.
इसके लिए कोई मिलता-जुलता Apps Script ऑब्जेक्ट नहीं है.

जब ऑब्जेक्ट टाइप तय नहीं होता है, तो मैक्रो कन्वर्टर variant_resolutions.gs फ़ाइल में __handle_resolve_name नाम का एक नया फ़ंक्शन बनाता है.

कोड में उदाहरण यहां दिया गया है:

ओरिजनल VBA कोड

a = Selection.name

इस मामले में, मौजूदा विकल्प पर एपीआई name() को कॉल किया जाता है. चुना गया डेटा, शीट ऑब्जेक्ट या आकार ऑब्जेक्ट हो सकता है. अगर यह शीट ऑब्जेक्ट है, तो इसका अनुवाद getName() है. हालांकि, अगर यह शेप ऑब्जेक्ट है, तो Apps Script में इसका कोई मिलता-जुलता ऑब्जेक्ट नहीं है.

बदले गए Apps Script कोड को इन-लाइन जोड़ा गया

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 Script कोड में कोई गड़बड़ी होती है, तो मैसेज में गड़बड़ी का टाइप और उसकी जगह के बारे में बताया जाता है. गड़बड़ी के मैसेज का फ़ॉर्मैट, इस बात पर निर्भर करता है कि Apps Script के किस रनटाइम का इस्तेमाल किया जा रहा है.

अगर आपके पास डिफ़ॉल्ट V8 रनटाइम है, तो आपको गड़बड़ी का ऐसा मैसेज दिखेगा:

_api_windows_active (unimplemented_constructs:2:3)

इसका मतलब है कि गड़बड़ी unimplemented_constructs.gs फ़ाइल की लाइन 2, वर्ण 3 पर है.

अगर आपके पास अब काम न करने वाला Rhino रनटाइम है, तो आपको गड़बड़ी का यह मैसेज दिखेगा:

unimplemented_constructs:2 (_api_windows_active)

इसका मतलब है कि गड़बड़ी unimplemented_constructs.gs फ़ाइल में लाइन 2 में मौजूद है.

गड़बड़ी के टाइप

ऊपर बताई गई unimplemented_constructs.gs और variant_resolution.gs फ़ाइलों में हुई ज़्यादातर गड़बड़ियां ठीक की जा सकती हैं.

आपको इस तरह की गड़बड़ियां दिख सकती हैं:

एपीआई लागू नहीं किया गया
भाषा के लिए लागू नहीं किया गया कॉन्स्ट्रक्ट
कुछ हद तक काम करने वाला एपीआई
मैन्युअल तरीके से काम करना ज़रूरी है
जान-बूझकर की गई गड़बड़ी

लागू नहीं किया गया एपीआई

लागू नहीं किया गया एपीआई वह एपीआई होता है जिसे Macro Converter, VBA से Apps Script में बदल नहीं सकता. साथ ही, एपीआई के लिए कोई समाधान भी नहीं है.

लागू नहीं किए गए एपीआई को आम तौर पर unimplemented_constructs.gs फ़ाइल में खाली फ़ंक्शन के तौर पर जोड़ा जाता है. कभी-कभी, इन फ़ंक्शन के हस्ताक्षर भी खाली होते हैं. अगर ऑब्जेक्ट टाइप का पता नहीं चल पाता है, तो ऐसा हो सकता है कि लागू नहीं किया गया एपीआई, variant_resolution.gs फ़ाइल में जोड़ दिया जाए.

कन्वर्ज़न से पहले जनरेट की गई, काम करने की रिपोर्ट में इस एपीआई को ज़्यादा जांच की ज़रूरत है के तौर पर लेबल किया गया है.

अगर फ़ाइल को बदलने से पहले, अपने VBA कोड में इस तरह के एपीआई को ठीक नहीं किया जाता है, तो Apps Script प्रोजेक्ट में यह इस तरह दिखता है:

/**
* 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.");
}

एपीआई की ऐसी गड़बड़ियां ठीक करना जिन्हें लागू नहीं किया गया

मौजूदा Apps Script एपीआई या JS लाइब्रेरी के साथ, लागू नहीं किए गए एपीआई के बारे में बताएं. ऐसा करने के लिए, यह तरीका अपनाएं:

गड़बड़ी वाली जगह पर, बदला गया Apps Script कोड खोलें. गड़बड़ियां ढूंढना लेख पढ़ें.
फ़ंक्शन के ऊपर, जोड़ी गई टिप्पणी पढ़ें. कुछ मामलों में, टिप्पणी में Apps Script में एपीआई को लागू करने का तरीका बताया जाता है.
अगर आपको Apps Script में एपीआई लागू करने का कोई तरीका नहीं मिल रहा है, तो इसे अपने कोड से हटाएं.
अगर आपको कोई समाधान नहीं मिलता है या अपने कोड से इस एपीआई को हटाने के बाद भी आपका मैक्रो यह गड़बड़ी दिखाता है, तो इस मैक्रो को बदला नहीं जा सकता.

लागू नहीं की गई एपीआई की गड़बड़ियों के उदाहरण

यहां एपीआई के लागू नहीं किए गए उदाहरण और उन्हें ठीक करने के तरीके दिए गए हैं:

इसके बराबर कोई Apps Script नहीं है: यह Chart.Protect के लिए, सीधे तौर पर काम न करने वाला कोई विकल्प दिखाता है. यह एक ऐसा एपीआई है जो Apps Script में मौजूद नहीं है.
ऑब्जेक्ट का कोई ऐसा टाइप जिसकी जानकारी नहीं है: इसमें, वैरिएबल के तौर पर काम करने वाले ऑब्जेक्ट टाइप को मैनेज करने का तरीका बताया गया है. साथ ही, ऐसे ऑब्जेक्ट टाइप को लागू करने का तरीका भी बताया गया है जो काम नहीं करता और जिसे Apps Script में फिर से बनाया जा सकता है.

उदाहरण 1: मिलती-जुलती कोई Apps Script या अज्ञात एपीआई

इस उदाहरण में, Chart.Protect अपने-आप बदला नहीं गया, क्योंकि Google Sheets में चार्ट को सुरक्षित करने का कोई तरीका नहीं है.

/**
* 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();
}
}

दूसरा उदाहरण: ऑब्जेक्ट का ऐसा टाइप जो काम नहीं करता

जब ऑब्जेक्ट टाइप की जानकारी नहीं होती है, तो लागू नहीं किए गए एपीआई की गड़बड़ी को variant_resolution.gs फ़ाइल में जोड़ा जाता है. नीचे दिए गए उदाहरण में, ऊपर दिए गए VBA name() एपीआई के उदाहरण के बारे में ज़्यादा जानकारी दी गई है. variant_resolution.gs देखें.

इस उदाहरण में, आपको यह जानकारी मिलेगी:

name() एपीआई को variant_resolution.gs फ़ाइल में नए फ़ंक्शन में कैसे बदला जाता है.
बदले गए कोड में नए फ़ंक्शन को कॉल करने का तरीका.
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() एपीआई को कॉल करता है. 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 Script कोड, `__handle_resolve_name` फ़ंक्शन को कॉल करेगा:

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

3. मान लें कि आपका VBA कोड, ऑब्जेक्ट टाइप CommandBar पर PrintName() फ़ंक्शन को कॉल करता है. VBA कोड यहां दिखाया गया है:

PrintName Application.CommandBars.item("Standard")

CommandBar, Apps Script में काम नहीं करता. इसलिए, ऊपर दिए गए VBA कोड में इस्तेमाल किए गए दो तरीकों का इस्तेमाल भी नहीं किया जा सकता.

Application.CommandBars(): VBA में, यह सभी CommandBar ऑब्जेक्ट की सूची दिखाता है.
CommandBars.item(): VBA में, यह एक खास CommandBar ऑब्जेक्ट दिखाता है.

यह ऑब्जेक्ट टाइप, Apps Script में इस्तेमाल नहीं किया जा सकता. इसलिए, बदला गया कोड `unलागूed_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() तरीका जोड़ें.

तीसरा चरण और चौथा चरण, नीचे दिए गए कोड में दिखाया गया है. मेन्यू ऑब्जेक्ट, एक नए ऑब्जेक्ट टाइप के तौर पर बनाए जाते हैं. ये 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 Script कोड खोलें. गड़बड़ियां ढूंढना देखें.
कोड के लॉजिक के आधार पर, उसे इस तरह अपडेट करें कि उसमें ऐसी भाषा का इस्तेमाल न करना पड़े जो काम नहीं करती.
अगर आपको काम न करने वाली भाषा के कॉन्स्ट्रक्ट के बिना, अपना कोड फिर से लिखने का कोई तरीका नहीं मिलता है, तो इस मैक्रो को बदला नहीं जा सकता.

लागू नहीं की गई भाषा के कॉन्स्ट्रक्ट से जुड़ी गड़बड़ियों के उदाहरण

GoTo स्टेटमेंट, लागू नहीं किए गए सबसे आम भाषा कॉन्स्ट्रक्ट में से एक है. कुछ VBA GoTo स्टेटमेंट को लूप से बदला जा सकता है. यहां GoTo स्टेटमेंट के बजाय लूप का इस्तेमाल करने के दो उदाहरण दिए गए हैं.

पहला उदाहरण: `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

इसके बराबर का Apps Script कोड

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

इसके बराबर का Apps Script कोड

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);
}

कुछ हद तक काम करने वाला एपीआई

कुछ एपीआई के साथ काम करने वाले इनपुट पैरामीटर, Apps Script में काम करते हैं और कुछ नहीं.

उदाहरण के लिए, VBA API legend_position का इस्तेमाल, Excel ग्राफ़ में लेजेंड तय करने के लिए किया जाता है. यह कई तरह की इनपुट वैल्यू के साथ काम करता है. जैसे:

xlLegendPositionBottom: लेजेंड को चार्ट में सबसे नीचे रखता है.
xlLegendPositionCorner: इससे लेजेंड, चार्ट के कोने में दिखता है.
xlLegendPositionCustom: चार्ट पर लेजेंड को पसंद के मुताबिक जगहों पर डालता है.

Apps Script में एक ऐसा कोड है जो सिर्फ़ कुछ वैल्यू के साथ काम करता है. ये वैल्यू इस्तेमाल नहीं की जा सकतीं:

xlLegendPositionCorner
xlLegendPositionCustom

बदले गए कोड में, कुछ एपीआई के साथ काम न करने वाली वैल्यू को फ़्लैग करने के लिए, library.gs फ़ाइल में पुष्टि करने की एक शर्त जोड़ी जाती है. यह शर्त उन वैल्यू की जांच करती है. उदाहरण के लिए:

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

अगर पुष्टि करने की शर्त में, काम न करने वाली कोई वैल्यू मिलती है, तो unimplemented_constructs.gs फ़ाइल में गड़बड़ी की जानकारी देने वाला एक फ़ंक्शन _handle_<API_name>_error बन जाता है.

फ़ंक्शन, उपयोगकर्ता को गड़बड़ी का मैसेज दिखाता है और वैल्यू को काम करने वाली वैल्यू से बदल नहीं पाएगा. उदाहरण के लिए:

/**
* 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);
}

एपीआई के कुछ हिस्से काम न करने से जुड़ी गड़बड़ियां ठीक करना

काम न करने वाली वैल्यू को अपनी ज़रूरतों के हिसाब से काम करने वाली वैल्यू से बदलने के लिए, _handle_<API_name>_error फ़ंक्शन तय करें.

गड़बड़ी वाली जगह पर, बदला गया Apps Script कोड खोलें. गड़बड़ियां ढूंढना लेख पढ़ें.
फ़ंक्शन के ऊपर दी गई टिप्पणी पढ़ें और जानें कि कौनसी वैल्यू इस्तेमाल की जा सकती हैं और कौनसी नहीं.
इस्तेमाल न की जा सकने वाली वैल्यू के लिए, यह तय करें कि इस्तेमाल की जा सकने वाली कौनसी वैल्यू, सही विकल्प के तौर पर काम कर सकती हैं.
इसके बजाय, इस्तेमाल की जा सकने वाली वैल्यू दिखाने के लिए, फ़ंक्शन _handle_<API_name>_error को अपडेट करें.
अगर आपको काम न करने वाली वैल्यू को बदलने का कोई तरीका नहीं मिलता है, तो इस मैक्रो को बदला नहीं जा सकता.

एपीआई से जुड़ी ऐसी गड़बड़ी का उदाहरण जो कुछ हद तक काम करती है

नीचे दिए गए उदाहरण में, ऊपर बताए गए VBA API legend_position के बारे में ज़्यादा जानकारी दी गई है. कुछ हद तक काम करने वाला एपीआई देखें.

यहां ओरिजनल VBA कोड का एक उदाहरण दिया गया है. इसमें ऐसी वैल्यू का इस्तेमाल किया गया है जो काम नहीं करती, xlLegendPositionCustom.

Charts(1).Legend.Position = xlLegendPositionCustom

Macro Converter, 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);
}

मैन्युअल तरीके से काम करना होगा

मैन्युअल तरीके से काम करना ज़रूरी है का मतलब है कि VBA एपीआई को Apps Script में बदला जा सकता है, लेकिन इसके लिए कुछ करना होगा.

कन्वर्ज़न से पहले जनरेट की गई, काम करने की जानकारी वाली रिपोर्ट में, इस तरह के एपीआई को काम करने वाले तरीके के साथ काम करता है के तौर पर लेबल किया गया है.

/**
* 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 Script कोड खोलें. गड़बड़ियां ढूंढना देखें. 1. फ़ंक्शन के ऊपर दी गई टिप्पणी पढ़ें, ताकि यह समझा जा सके कि समस्या को हल करने के लिए, किन एपीआई का इस्तेमाल किया जा सकता है. 1. अगर आपको कोई सही तरीका नहीं मिलता है, तो अपने कोड से एपीआई को हटाने पर विचार करें. 1. अगर आपको कोई समाधान नहीं मिलता है या अपने कोड से इस एपीआई को हटाने के बाद भी आपके मैक्रो में गड़बड़ी दिखती है, तो इस मैक्रो को बदला नहीं जा सकता.

मैन्युअल तरीके से किए गए काम की गड़बड़ियों के उदाहरण

यहां ऐसे एपीआई के उदाहरण दिए गए हैं जिनसे मैन्युअल काम करने की ज़रूरत पड़ने वाली गड़बड़ियां होती हैं. साथ ही, उन्हें ठीक करने का तरीका भी बताया गया है:

Implement a workaround for Autocorrect.Addreplacement.
Implement a workaround for workbook.open(). इस उदाहरण में, Apps Script का इस्तेमाल करके Google Drive में फ़ाइलें खोलने का तरीका बताया गया है.

पहला उदाहरण: `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 एपीआई को लागू करने का तरीका यहां बताया गया है:

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));
}

दूसरा उदाहरण: `Workbook.open()`

VBA API workbook.open(), फ़ाइल पाथ के आधार पर कोई लोकल फ़ाइल खोलता है.

मान लें कि VBA कोड में workbook.open() से दो फ़ाइलें खोली जा रही हैं:

फ़ाइल 1: C:\Data\abc.xlsx
फ़ाइल 2: C:\Data\xyz.xlsx

नीचे बताया गया है कि फ़ाइल 1 को खोलने के लिए Workbook.open() का इस्तेमाल करने पर, Macro Converter Workbook.open() को Apps Script से कैसे बदलता है:

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

Apps Script प्रोजेक्ट में 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 Drive पर Google Sheets फ़ाइलों में बदलना होगा.

इनसे जुड़े 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 हो जाएगा

इसके बाद, आईडी से फ़ाइलों को खोलने के लिए, Apps Script फ़ंक्शन में कोड में बदलाव करें, जैसा कि यहां दिखाया गया है:

/**
* 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 में किसी ऐरे की सीमाओं से बाहर के एलिमेंट को ऐक्सेस करने की कोशिश की जाती है, तो कोड एक अपवाद दिखाता है. Apps Script में, कोड कोई वैल्यू नहीं दिखाता.

अनचाहे नतीजों से बचने के लिए, Macro Converter, Apps Script कोड जोड़ता है. यह कोड, ऐरे की सीमाओं से बाहर के एलिमेंट को ऐक्सेस करने पर अपवाद दिखाता है.

यह उदाहरण नीचे दिए गए कोड में दिखाया गया है:

ओरिजनल VBA कोड

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

एक्सेप्शन गड़बड़ी जोड़े जाने से पहले, बदला गया Apps Script कोड

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

अपवाद वाली गड़बड़ी दिखाने के लिए जोड़ा गया Apps Script कोड

/**
* 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));

अपने बदले गए कोड की गड़बड़ियां ठीक करना

अपने प्रोजेक्ट में जोड़ी गई Apps Script फ़ाइलों के बारे में जानकारी

Library.gs

Unimplemented_constructs.gs

उदाहरण: Window.Activate()

Variant_resolutions.gs

उदाहरण: name()

गड़बड़ियां ढूंढना

गड़बड़ी के टाइप

लागू नहीं किया गया एपीआई

एपीआई की ऐसी गड़बड़ियां ठीक करना जिन्हें लागू नहीं किया गया

लागू नहीं की गई एपीआई की गड़बड़ियों के उदाहरण

उदाहरण 1: मिलती-जुलती कोई Apps Script या अज्ञात एपीआई

दूसरा उदाहरण: ऑब्जेक्ट का ऐसा टाइप जो काम नहीं करता

लागू नहीं किए गए भाषा कॉन्स्ट्रक्ट

लागू नहीं की गई भाषा के कॉन्स्ट्रक्ट से जुड़ी गड़बड़ियां ठीक करना

लागू नहीं की गई भाषा के कॉन्स्ट्रक्ट से जुड़ी गड़बड़ियों के उदाहरण

पहला उदाहरण: GoTo को While Loop से बदलना

उदाहरण 2: GoTo को लूप के लिए बदलें

कुछ हद तक काम करने वाला एपीआई

एपीआई के कुछ हिस्से काम न करने से जुड़ी गड़बड़ियां ठीक करना

एपीआई से जुड़ी ऐसी गड़बड़ी का उदाहरण जो कुछ हद तक काम करती है

मैन्युअल तरीके से काम करना होगा

मैन्युअल तरीके से ठीक की जा सकने वाली गड़बड़ियां ठीक करना

मैन्युअल तरीके से किए गए काम की गड़बड़ियों के उदाहरण

पहला उदाहरण: Autocorrect.Addreplacement

दूसरा उदाहरण: Workbook.open()

जान-बूझकर की गई गड़बड़ी

जान-बूझकर की गई गड़बड़ी का उदाहरण

मिलते-जुलते लेख

`Library.gs`

`Unimplemented_constructs.gs`

उदाहरण: `Window.Activate()`

`Variant_resolutions.gs`

उदाहरण: `name()`

पहला उदाहरण: `GoTo` को `While Loop` से बदलना

पहला उदाहरण: `Autocorrect.Addreplacement`

दूसरा उदाहरण: `Workbook.open()`