Trabajar con el modo de vista previa del valor de fórmula en las funciones personalizadas

El modo de vista previa del valor de fórmula ayuda a los usuarios a evaluar una fórmula mientras la editan. Cuando un usuario selecciona parte de una fórmula, Excel calcula y muestra el valor seleccionado. Por ejemplo, en la siguiente imagen se muestra un valor de vista previa de 7 para la expresión A1+A2seleccionada .

De forma predeterminada, Excel ejecuta una función personalizada durante la versión preliminar del valor de fórmula. Este comportamiento puede causar problemas en función de lo que haga la función personalizada. Use la propiedad de solo invocation.isInValuePreview lectura para detectar un cálculo en versión preliminar y devolver un valor ficticio cuando el cálculo completo:

• Llame a una API de uso medido.
• Acceda a un recurso limitado, como una base de datos.
• Tómese demasiado tiempo para proporcionar una versión preliminar útil.

La siguiente getHousePrice función personalizada devuelve un precio ficticio durante la versión preliminar. Para un cálculo estándar, llama al servicio medido y devuelve el precio real.

/**
 * Get the listing price for a house on the market for the given address.
 * @customfunction
 * @param address The address of the house.
 * @param invocation Custom function handler.
 * @returns The price of the house at the address.
 */
export function getHousePrice(address: string, invocation: CustomFunctions.Invocation): number {
  // Check if this call is for formula value preview mode.
  if (invocation.isInValuePreview) {
    // Avoid long-running expensive service calls.
    // Return a usable but fake number.
    return 450000;
  } else {
    // Make the actual service calls in this block.
    const price = callHouseServiceAPI(address);
    return price;
  }
}

Vea también

• Crear funciones personalizadas en Excel
• Opciones de parámetros de funciones personalizadas