CustomFunctions.ErrorCode enum

Pacote:

custom-functions-runtime

Códigos de erro para funções personalizadas. Os códigos de erro aparecerão na célula que invocou a função.

As mensagens de erro personalizadas são apresentadas para além destes códigos de erro. As mensagens personalizadas são apresentadas no menu do indicador de erro, que é acedido ao pairar o cursor sobre o sinalizador de erro em cada célula com um erro.

Comentários

Exemplos

/**
 * Returns the #NUM! error as part of a 2-dimensional array.
 * @customfunction
 * @param {number} first First parameter.
 * @param {number} second Second parameter.
 * @param {number} third Third parameter.
 * @returns {number[][]} Three results, as a 2-dimensional array.
 */
function returnInvalidNumberError(first, second, third) {
  // Use the `CustomFunctions.Error` object to retrieve an invalid number error.
  const error = new CustomFunctions.Error(
    CustomFunctions.ErrorCode.invalidNumber, // Corresponds to the #NUM! error in the Excel UI.
  );

  // Enter logic that processes the first, second, and third input parameters.
  // Imagine that the second calculation results in an invalid number error.
  const firstResult = first;
  const secondResult = error;
  const thirdResult = third;

  // Return the results of the first and third parameter calculations
  // and a #NUM! error in place of the second result.
  return [[firstResult], [secondResult], [thirdResult]];
  };

Campos

divisionByZero = "#DIV/0!"	Este código de erro indica que a função utilizada está a dividir por zero ou células vazias. Não é possível utilizar uma mensagem de erro personalizada.
invalidName = "#NAME?"	Este código de erro indica que existe um erro de digitação no nome da função. Tenha em atenção que este código de erro é suportado como um erro de entrada de função personalizada, mas não como um erro de saída de função personalizada. Não é possível utilizar uma mensagem de erro personalizada.
invalidNumber = "#NUM!"	Este código de erro indica que existe um problema com um número na função. Não é possível utilizar uma mensagem de erro personalizada.
invalidReference = "#REF!"	Este código de erro indica que a função se refere a uma célula inválida. Tenha em atenção que este código de erro é suportado como um erro de entrada de função personalizada, mas não como um erro de saída de função personalizada. Não é possível utilizar uma mensagem de erro personalizada.
invalidValue = "#VALUE!"	Este código de erro indica que um valor na função é do tipo de dados errado. Uma mensagem de erro personalizada pode ser utilizada para além do código de erro, se assim o desejar.
notAvailable = "#N/A"	Este código de erro indica que a função ou o serviço não está disponível. Uma mensagem de erro personalizada pode ser utilizada para além do código de erro, se assim o desejar.
nullReference = "#NULL!"	Este código de erro indica que os intervalos na função não se cruzam. Não é possível utilizar uma mensagem de erro personalizada.