# Funciones globales

Hemos extendido el ECMAScript base con algunas de las funciones globales que implementan otros scripts, para mayor compatibilidad con código fuente ya existente.

## Funciones

**Globales**

| Retorno | Función                                                                                                                                                   |
| ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| void    | [alert](/21/velneo-vdevelop/scripts/lenguajes/javascript/clases/funciones-globales.md#alert)( String szMensaje, \[String szTitulo] )                      |
| Boolean | [confirm](/21/velneo-vdevelop/scripts/lenguajes/javascript/clases/funciones-globales.md#confirm)( String szPregunta, \[String szTitulo] )                 |
| String  | [prompt](/21/velneo-vdevelop/scripts/lenguajes/javascript/clases/funciones-globales.md#prompt)( String szLabel, \[String szContIni], \[String szTitulo] ) |

**De API**

| Retorno | Función                                                                                                                      |
| ------- | ---------------------------------------------------------------------------------------------------------------------------- |
| void    | [importApi](/21/velneo-vdevelop/scripts/lenguajes/javascript/clases/funciones-globales.md#importapi)( String apiName )       |
| void    | [importClass](/21/velneo-vdevelop/scripts/lenguajes/javascript/clases/funciones-globales.md#importclass)( String className ) |

## Documentación de funciones

### Funciones globales

#### void alert( String szMensaje, \[String szTitulo] ) <a href="#alert" id="alert"></a>

Muestra un mensaje en un cuadro de diálogo con el botón aceptar.

Parámetros:

* szMensaje: Mensaje a mostrar.
* szTitulo: Texto opcional para mostrar en el título del cuadro de diálogo.

#### Boolean confirm( String szPregunta, \[String szTitulo] ) <a href="#confirm" id="confirm"></a>

Muestra un cuadro de diálogo de confirmación y devuelve true o false en función del botón pulsado por el usuario.

Parámetros:

* szPregunta: Texto que se mostrará al usuario.
* szTitulo: Texto opcional para mostrar en el título del cuadro de diálogo.

#### String prompt( String szLabel, \[String szContIni], \[String szTitulo] ) <a href="#prompt" id="prompt"></a>

Muestra un cuadro de diálogo solicitando la introducción de un dato. Opcionalmente se puede pasar un el contenido inicial a mostrar como valor por defecto.

Parámetros:

* szLabel: Texto descriptivo del dato a introducir.
* szContIni: Valor opcional que puede mostrar el dato a introducir.
* szTitulo: Texto opcional para mostrar en el título del cuadro de diálogo.

### Funciones de API

#### void importApi( String apiName ) <a href="#importapi" id="importapi"></a>

Fuerza la inclusión del sub-API en el script permitiendo el uso de las propiedades y funciones de sus clases.

Parámetros:

* apiName: Nombre del sub-API, ejemplo: Admin, Core, etc.

Esta función ha sido incluida en la versión Velneo 7.16.

#### void importClass( String className ) <a href="#importclass" id="importclass"></a>

Fuerza la inclusión de la clase en el script para el uso de sus funciones.

Parámetros:

* className: Nombre de la clase, ejemplo: [VQuery](/21/velneo-vdevelop/scripts/lenguajes/javascript/clases/vquery.md).

## Ejemplos

### 1. Cálculo del factorial de un número

```javascript
////////////////////////////////////////////////////////////
// Cálculo del factorial de un número

// Confirmación de que se quiere ejecutar el proceso
if ( confirm("¿Seguro que desea calcular el factorial de un número?", "Confirmación") )
{
    // Pedir el número a calcular
    var numero = parseInt( prompt("Número a calcular", 10, "Cálculo de factural") );

    // Se muestra el resultado del cálculo realizado
    alert( "El factorial del número " + formatNumber( numero ) + " es " + formatNumber( factorial( numero ) ), "Resultado")
}


// Calcula el factorial de un número
//  - num = Número del que se desea calcular el factorial

function factorial( num )
{
    var factorial = 1;

    for ( x=1; x
 1 ? ',' + splitStr[1] : '';
    var regx = /(\d+)(\d{3})/;
    while ( regx.test( splitLeft ) ) 
    {
        splitLeft = splitLeft.replace( regx, '$1' + '.' + '$2' );
    }
    return prefix + splitLeft + splitRight + postfix;
}


// Quitar el formato a un número
//  - num = Número a quitar el formateo

function unformatNumber( num )
{
    return num.replace( /([^0-9\,\-])/g,'' )*1;
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.velneo.com/21/velneo-vdevelop/scripts/lenguajes/javascript/clases/funciones-globales.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.