SCRIPTCASE MACROS

La macro sc_actionbar_clicked_state() permite al desarrollador recuperar el estado actual de un botón de la barra de acción en el momento del clic.
De esta manera, es posible validar el estado actual del botón y, según las reglas de negocio del sistema, modificarlo según sea necesario.

Esta macro es exclusiva para eventos AJAX de los botones de la barra de acción.

Ejemplos

Ejemplo: Identificación del estado actual del botón en el evento ajax, para cambiar el estado al hacer clic.

if (sc_actionbar_clicked_state() == 'pending') {

    sc_actionbar_state('ajax_btn', 'sent');

} else {

    sc_actionbar_state('ajax_btn', 'pending');

}

Ejemplo: Ejemplo para ver el valor actual del botón.

echo sc_actionbar_clicked_state();

Deshabilita el botón de la barra de acción, por lo que no está disponible para hacer clic.

Esta macro se puede usar para cualquier tipo de botón (enlace o ajax) en la barra de acción.

Definición de parámetros

boton_nombre

Ejemplos

Ejemplo 1: Uso básico de las macros

sc_actionbar_disable("boton_nombre");

Ejemplo 2: Deshabilitar el botón de enlace al detalle del pedido si no hay artículos en el pedido.

// Ejemplo creado en el evento onRecord del grid usando la tabla order y orderdetail
// Si no hay artículos en el pedido, el botón estará deshabilitado

$query = "SELECT count(*) FROM OrderDetails WHERE OrderID = ". {OrderID};
sc_lookup(ds, $query);

if ({ds[0][0]} == 0) {

    //Ejemplo de uso de la macro sc_actionbar_disable
    sc_actionbar_disable("boton_nombre");

} else { 

    sc_actionbar_enable("boton_nombre");
 
}

Habilita el botón de la barra de acción, haciéndolo disponible para hacer clic.

Esta macro se puede usar para cualquier tipo de botón (enlace o ajax) en la barra de acción.

Definición de parámetros

Examples

Example 1: Uso básico de macro sc_actionbar_enable

sc_actionbar_enable("boton_nombre");

Example 2: Enabling the link button to the order detail if there is any record to be displayed.

// Ejemplo creado en el evento onRecord de la grid usando la tabla de pedidos y la tabla de detalles de pedidos
// Si no hay artículos pedidos en la medición, el botón estará deshabilitado

$query = "SELECT count(*) FROM OrderDetails WHERE OrderID =" . {OrderID};
sc_lookup(ds, $query);

if ({ds[0][0]} <> 0) {

    //Ejemplo de uso de la macro sc_actionbar_enable
    sc_actionbar_enable("boton_nombre");

} else {

    sc_actionbar_disable("boton_nombre");

}

This macro displays the action bar button, hidden using the sc_actionbar_hide macro

This macro can be used for any type of button (link or ajax) on the action bar.

Definición de parámetros

Exemplos

Example 1: Basic macro usage

sc_actionbar_hide("boton_nombre");

Example 2: Showing the order detail link button if there are any records to show.

// Ejemplo creado en el evento onRecord de la grid usando la tabla order y orderdetail
// Si no hay artículos en el pedido, el botón de enlace de detalles se ocultará.

$query = "SELECT count(*) FROM OrderDetails WHERE OrderID =" . {OrderID};
sc_lookup(ds, $query);

if ({ds[0][0]} == 0) {

     //Example of using the macro sc_actionbar_hide
     sc_actionbar_hide("boton_nombre");

} else {

     sc_actionbar_show("boton_nombre");

}

Esta macro muestra el botón de la barra de acciones, oculto mediante la macro sc_actionbar_hide

Esta macro se puede usar para cualquier tipo de botón (enlace o ajax) en la barra de acción.

Definición de parámetros

Exemplos

Ejemplo 1: Uso básico de macros

sc_actionbar_show("boton_nombre");

Ejemplo 2: Mostrar el botón de enlace de detalles del pedido si hay algún registro para mostrar.

// Ejemplo creado en el evento onRecord de la consulta usando la tabla order y orderdetail
// Si no hay artículos en el pedido, el botón no se mostrará

$query = "SELECT count(*) FROM OrderDetails WHERE OrderID =" . {OrderID};
sc_lookup(ds, $query);

if ({ds[0][0]} <> 0) {

    //Exemplo de utilização da macro
    sc_actionbar_show("boton_nombre");

} else {

    sc_actionbar_hide("boton_nombre");

}

Esta macro le permite cambiar el estado actual del botón de la barra de acción.

Para usar el evento ajax del botón, recomendamos usar esta macro junto con sc_actionbar_clicked_state(); que permite recuperar el estado actual del botón.

Definición de parámetros

Ejemplos

Ejemplo: cambiar el estado del botón ajax_btn entre pendiente y enviado en el evento onclick del botón.

if (sc_actionbar_clicked_state() == 'pending') {

        sc_actionbar_state('ajax_btn', 'sent');

} else {

        sc_actionbar_state('ajax_btn', 'pending');

}

Ejemplo: cambiar el estado del botón ajax_btn entre pendiente y enviado, y almacenar el cambio en la base en el campo email_sent.

if (sc_actionbar_clicked_state() == 'pending') {

	$update = "update orders set email_sent = 'S' WHERE orderid =". {orderid};
	sc_exec_sql($update);
        sc_actionbar_state('ajax_btn', 'sent');

} else {

	$update = "update orders set email_sent = 'N' WHERE orderid =". {orderid};
	sc_exec_sql($update);
        sc_actionbar_state('ajax_btn', 'pending');

}

Ejemplo: Visualización del estado del botón ajax_btn según el valor almacenado en el campo email_sent en el evento onRecord de la aplicación Grid.

if ({email_sent} == 'S') {

    sc_actionbar_state('ajax_btn', 'sent');

} else {

    sc_actionbar_state('ajax_btn', 'pending');

}

Ver un vídeo tutorial

Esta macro permite la ejecución de métodos JavaScript llamados desde algunos eventos en formularios, aplicaciones de control y calendario.

Para usar esta macro, necesitas crear un método javascript en Configuración de programación.

Esta macro recibe dos parámetros:

El primer parámetro (obligatorio) recibe el nombre del método javascript.
El segundo (opcional) recibe una matriz con los parámetros del método.


Ejemplos:

Ej.1:javascript de método sin parámetros:
sc_ajax_javascript ('method_name');
sc_ajax_javascript ('suma');

Ej.2: Método JavaScript con un parámetro:
sc_ajax_javascript ('method_name', array ("paramameter"));


Ej. 3: Método javascript con dos parámetros:
sc_ajax_javascript ('method_name', array("param1", "param2"));

Ejemplo que usa variables globales:
sc_ajax_javascript ('suma', array([num1], [num2]));

Ver un vídeo tutorial

Esta macro permite que la aplicación muestre mensajes personalizables, con su uso restringido a eventos de forma / control cuando se usa en eventos AJAX.

Esta macro solo es válida en aplicaciones compatibles con AJAX.

Descripción de los parámetros

Tabla2: Cadena de parámetros de mensaje

Ejemplo 01

sc_ajax_message ("Mensaje", "Título", "timeout=0");

Ejemplo 02: Usando Toast

sc_ajax_message ("Mensaje", "Título", "toast=Y&toasto_pos=center-start&type=success");

Para mostrar el mensaje utilizando Toast, esta opción debe estar habilitada en la interfaz de la aplicación.

Ver un vídeo tutorial

La macro sc_ajax_refresh() se utiliza para recargar los datos en una aplicación de consulta sin la necesidad de recargar toda la página.

Su uso es exclusivo en eventos AJAX de la consulta, ya sea en los eventos onClick de un campo o en la barra de acción.

Ejemplo de uso

$upd = "UPDATE order SET status = 'completed' WHERE id =". {orderid};
sc_exec_sql($upd);
// Ahora la macro se utilizará para actualizar los datos de la aplicación.
sc_ajax_refresh();

Ver un vídeo tutorial

Esta macro envía un mensaje en estilo de alerta en Javascript o Sweetalert2.

Obs

Para mostrar el mensaje usando la biblioteca sweetalert2, es necesario que la opción ”Usar SweetAlert” esté habilitada en la aplicación donde se usará la macro.

Esta opción se puede habilitar en el menú de configuración de la aplicación. Para acceder a él, haga clic en: Aplicación> Configuración la opción se encuentra en el bloque de Configuración de las Notificaciones.

Verifique a continuación los parámetros admitidos por la macro:

• Mensaje: Parámetro obligatorio que contiene el mensaje que se mostrará.
• $array: Este parámetro es opcional cuando se usa la macro, más obligatorio cuando queremos usar Sweetalert2.
  Cuando se usa, espera recibir una matriz con la configuración de Sweetalert2.
  

Verifique la lista de configuraciones aceptadas por Sweetalert2 en esta macro:

Verifique a continuación los ejemplos de uso de la macro:

Ejemplo 1: Mensaje usando Sweetalert
sc_alert("¡Este es un mensaje de alerta!");

Ejemplo 2: Mensaje usando Sweetalert2

$params = array(
'title' => 'Título',
'type' => 'success',
'timer' => '2000',
'showConfirmButton' => false,
'position' => 'bottom-end',
'toast' => true
);

sc_alert("Insertado con éxito!", $params);

sc_api_upload([
  'profile' => 'minha_api',
  'file' => {archivo},
  'destination' => 'destino',
]);

Usando la macro con el parámetro de configuración

La matriz con las credenciales de acceso que se deben pasar en el parámetro de configuración varía según la API utilizada. 

Vea a continuación cómo utilizar este parámetro de acuerdo con cada una de las API disponibles. 

Cuando se utiliza el parámetro de configuración en la configuración en la macro, no es necesario informar un perfil.

Uso De La Macro Con La Configuración - API De Google Drive

Primero, debemos tener las credenciales para usar la API de Google Drive en la mano, haga clic aquí para aprender cómo obtenerlas. 

Después de configurar las credenciales, vea a continuación todos los valores de la matriz que deben pasarse en el parámetro de configuración usando la API de Google Drive. 

Todos los valores a continuación son obligatorios cuando se usa el parámetro de configuración 

Ejemplos de uso de la macro con Google Drive, usando el parámetro de configuración 

sc_api_download([
  'settings' => [
    'app_name' => {appname},
    'gateway' => 'google_drive',
    'json_oauth' => {jsonoauth},
    'auth_code' => {authcode},
    'token_code' => {tokencode},
  ],
'file' => {archivo},
'destination' => {destino},
]);

Usar La Macro Con La Configuración - Dropbox

En primer lugar, debemos tener las credenciales para usar la API de Dropbox a la mano, haga clic aquí para saber cómo obtenerlas. 

Después de configurar las credenciales, vea a continuación todos los valores de la matriz que se deben pasar en el parámetro de configuración usando la API de Dropbox. 

Todos los valores a continuación son obligatorios cuando se usa el parámetro de configuración

'api_secret’  => {field_name},

Ejemplos de uso de la macro con Dropbox, usando el parámetro de configuración 

sc_api_download([
  'settings' => [
    'gateway' => 'dropbox',
    'api_key' => {apikey},
    'api_secret' => {apisecret},
    'access_token' => {accesstoken},
  ],
'file' => {archivo},
'destination' => {destino},
]);

Uso De La Macro Con Configuraciones - Amazon S3 

Debemos tener las credenciales para usar la API de almacenamiento de Amazon S3 a mano, haga clic aquí para aprender cómo obtenerlas. 

Después de configurar las credenciales, consulte a continuación todos los valores de la matriz que se deben pasar en el parámetro de configuración mediante la API de Amazon S3. 

Todos los valores a continuación son obligatorios cuando se usa el parámetro de configuración.

Ejemplos de uso de la macro con Amazon S3, usando el parámetro de configuración 

sc_api_download([
  'settings' => [
    'app_name' => 'scriptcase',
    'gateway' => 'S3',
    'api_key' => {apikey},
    'api_secret' => {apisecret},
    'region' => {api_region},
    'bucket' => {api_bucket},
  ],
'file' => {archivo},
'destination' => {destino},
]); 

La macro sc_api_gc_get_obj genera el token_code.

Tiene tres parámetros:

1. app_name: recibe el app_name, disponible en la configuración de tu api. Este parámetro acepta cadenas o variables.
2. json_oauth: recibe el contenido del archivo json, este archivo está disponible para descargar en la configuración de su API. Este parámetro acepta cadenas o variables.
3. auth_code: recibe el auth_code generado en el paso anterior u otro auth_code válido que ya ha generado.

Para obtener más información de uso y ejemplos, visite nuestro artículo de la base de conocimientos: Cómo generar el código de autenticación y el código de token

La macro sc_api_gc_get_url genera una URL para la autenticación del usuario de la cuenta de Google que se utiliza para la configuración de la API.

1. app_name - Recibe el nombre de la aplicación, disponible en su configuración de api. Este parámetro acepta cadenas o variables.
2. json_oauth - Recibe el contenido del archivo json, este archivo está disponible para descargar en la configuración de su api. Este parámetro acepta cadenas o variables.

Para obtener más información de uso y ejemplos, visite nuestro artículo de la base de conocimientos: Cómo generar el código de autenticación y el código de token

Esta macro se utiliza para cargar archivos en la nube utilizando las API de almacenamiento de Google, Amazon y DropBox.  

En primer lugar, es necesario crear las claves para usar la API, ya sea con la macro o en la interfaz de campos. 

• Haga clic aquí para aprender cómo obtener las credenciales de Google Drive
• Haga clic aquí para aprender cómo obtener las credenciales de DropBox  
• Haga clic aquí para aprender cómo obtener las credenciales de Amazon S3 

Después de obtener las credenciales, continúe con la configuración de la macro. 

Consulte la lista de parámetros a continuación.

Como se vio anteriormente, el parámetro de settings recibe una matriz con las credenciales de acceso para la API utilizada.   

Este parámetro debe usarse solo cuando no hemos definido un perfil en el menú Herramientas> API 

Cada API tiene su propia configuración para el parámetro settings, vea a continuación cómo debe configurarse cada una. 

Usando la macro con perfil

El uso de la macro con un perfil, requiere la creación previa de la misma.
Haga clic aquí para ver cómo crear un perfil en cada una de las API de almacenamiento disponibles. 

El perfil, o perfil, contiene los datos para usar la API deseada, por lo tanto, cuando se usa un perfil en la macro, no es necesario usar el parámetro settings.

El parámetro de perfil acepta solo el nombre del perfil creado, para el uso dinámico de la macro, será necesario utilizar los parámetros settings.

Ejemplo de uso de la macro con el perfil.

sc_api_upload ([ 
   'profile' => 'my_api', 
   'file' => {archivo}, 
   'parents' => 'pasta_no_drive', 
]);

Usando la macro con el parámetro de configuración

La matriz con las credenciales de acceso que se deben pasar en el parámetro de configuración varía según la API utilizada. 

Vea a continuación cómo utilizar este parámetro de acuerdo con cada una de las API disponibles. 

Cuando se utiliza el parámetro de configuración en la configuración en la macro, no es necesario informar un perfil.

Uso de la macro con la configuración - API de Google Drive

Primero, debemos tener las credenciales para usar la API de Google Drive en la mano, haga clic aquí para aprender cómo obtenerlas. 

Después de configurar las credenciales, vea a continuación todos los valores de la matriz que deben pasarse en el parámetro de configuración usando la API de Google Drive. 

Todos los valores a continuación son obligatorios cuando se usa el parámetro de configuración 

Ejemplos de uso de la macro con Google Drive, usando el parámetro de configuración 

sc_api_upload([ 
   'settings' => [ 
       'app_name' => 'scriptcase', 
       'gateway' => 'google_drive', 
       'json_oauth' => '', 
       'auth_code' => '', 
       'token_code' => '', 
   ], 
   'file' => {archivo}, 
   'parents' => '', 
]); 

Usar la macro con la configuración - Dropbox

En primer lugar, debemos tener las credenciales para usar la API de Dropbox a la mano, haga clic aquí para saber cómo obtenerlas. 

Después de configurar las credenciales, vea a continuación todos los valores de la matriz que se deben pasar en el parámetro de configuración usando la API de Dropbox. 

Todos los valores a continuación son obligatorios cuando se usa el parámetro de configuración

Ejemplos de uso de la macro con Dropbox, usando el parámetro de configuración 

sc_api_upload ([ 
   'configuración' => [ 
       'app_name' => 'scriptcase', 
       'gateway' => 'dropbox', 
       'api_key' => '', 
       'api_secret' => '', 
       'access_token' => '', 
   ], 
   'archivo' => {archivo}, 
   'padres' => '', 
]); 

Uso de la macro con configuraciones - Amazon S3 

Debemos tener las credenciales para usar la API de almacenamiento de Amazon S3 a mano, haga clic aquí para aprender cómo obtenerlas. 

Después de configurar las credenciales, consulte a continuación todos los valores de la matriz que se deben pasar en el parámetro de configuración mediante la API de Amazon S3. 

Todos los valores a continuación son obligatorios cuando se usa el parámetro de configuración.

Ejemplos de uso de la macro con Amazon S3, usando el parámetro de configuración 

sc_api_upload ([ 
   'configuración' => [ 
       'app_name' => 'scriptcase', 
       'gateway' => 'S3', 
       'api_key' => '', 
       'api_secret' => '', 
       'región' => '', 
       'cubo' => '', 
   ], 
   'archivo' => {archivo}, 
   'padres' => '', 
]);

Ver un vídeo tutorial

Esta macro permite modificar la propiedad de la aplicación. El usuario puede determinar si un Formulario se iniciará en modo de inserción, o una grid se iniciará por filtro, etc.

Esta macro debe ser usada por una aplicación para modificar las propiedades de otra aplicación.

Propiedades para aplicaciones Formularios

Propiedad para aplicaciones Grid

Propiedad para todas las aplicaciones

Ej. 1: Fuerza a la aplicación de formulario "my_form" a comenzar en el modo de inserción.
sc_apl_conf("my_form", "start", "new");

Ej. 2: No permite que la aplicación de formulario"my_form" agregue nuevos registros.
sc_apl_conf("my_form", "add", "off");

Ej. 3: Muestra un campo "my_field", de una aplicación de formulario "my_form", dinámicamente.
sc_apl_conf("my_form", "field_display_off", "my_field");

Ej. 4: Fuerza a la aplicación de formulario "my_query" a iniciar por el filtro.
sc_apl_conf("my_form", "field_display_on", "my_field");

Ej. 5: Fuerza a la aplicación de grid "my_grid" a iniciar en modo filtro.
sc_apl_conf("my_grid", "start", "filter");

Ej. 6: Fuerza la aplicacion de grid "my_grid"a mostrar N lineas en este ejemplo 20.
sc_apl_conf("my_grid", "rows", "20");

Ej. 7: Oculta un campo "my_field" en la aplicación de formulario "my_form" dinámicamente.
sc_apl_conf("my_form", "field_display_off", "my_field");

Ej. 8: Usa el boton del menu de la barra de herramientas.
if ({sc_menu_item} == "btn_1")
{
sc_apl_conf("form_customer", "start", "new");
}

Ver un vídeo tutorial

Esta macro permite que el usuario defina en su aplicación inicial lo que sucederá cuando la aplicación pierda la sesión.

La macro tiene los siguientes parámetros:

Apl: Aquí es necesario informar a qué aplicación se redirigirá la macro después de perder la sesión.

Tipo: Aquí informaremos al tipo de redireccionamiento que se producirá. Hay dos tipos:

• R: La aplicación solo redireccionará a la aplicación inicial.
• M: Se mostrará un mensaje antes del redireccionamiento.

Ejemplo: En una aplicación de inicio de sesión definida como la aplicación inicial, podemos definir que esta aplicación se redireccionará a sí mismo.
sc_apl_default("app_login","R")

Ver un video tutorial

Usado para controlar el acceso de seguridad. Estas macros activan / desactivan las aplicaciones a las que un usuario tiene acceso.

Applicación: Es el nombre o la variable que contiene el nombre de la aplicación para activar / desactivar.
Estado: Es el valor o la variable que contiene el valor que se debe atribuir a la aplicación. Los valores son: "on" para activar y "off" para desactivar.

Ej. 1:
sc_apl_status ('atu_cad', 'off');


Ej. 2:
sc_apl_status ({var_name_appl}, {var_status});

Agrega dinámicamente  un elemento a una aplicación de menú.

Solo es posible usar esta macro cuando hay una matriz creada anteriormente por la macro sc_appmenu_create.

Ej. 1: Crea un menú llamado menu_main.
sc_appmenu_create('menu_main');


Ej. 2: Agrega un en el menu_main el elemento_1 llamado Category.
sc_appmenu_add_item('menu_main','item_1','','Category','');


Ej. 3: Agrega en el menú_main (elemento_2) al elemento_1 Nombre Categoría vinculado a form_category pasando algunos parámetros.
sc_appmenu_add_item('menu_main','item_2','item_1','Category Form','form_category','param1=value;param2=value');

Esta macro inicia la matriz para el ensamblaje dinámico de una aplicación de menú. El nombre de la aplicación del menú debe ingresarse como parámetro.

Esta macro debe usarse en eventos de control o en el evento onload del menú.

Ej. 1:
sc_appmenu_create ('menu_main');

Compruebe si existe un elemento de menú y devuelva un valor verdadero o falso.

Ej. 1:

if(sc_appmenu_exist_item('menu_main', 'item_2')){

sc_appmenu_update_item('menu_main','item_2','item_1','Category Form','form_category');

}
else{

sc_appmenu_add_item('menu_main','item_2','item_1','Category Form','form_category');

}

Elimina dinamicamente un elemento del Manu.

Para usar esta macro antes es necesario ejecutar la macro sc_appmenu_create.

Ej. 1:
sc_appmenu_remove_item('menu_main','item_2');

Esta macro borra la matriz para el ensamblaje dinámico de una aplicación de menú.

El nombre de la aplicación del menú debe ingresarse como parámetro.

Ej. 1:
sc_appmenu_reset ('menu_main');

Actualiza dinámicamente un elemento a una aplicación de menú.

Solo puede usar esta macro cuando ya hay una matriz generada con la macro sc_appmenu_create antes.

Esta macro solo se puede usar en elementos que se crearon con la macro sc_appmenu_add_item anteriormente.

Ej. 1:
sc_appmenu_update_item('menu_main','item_2','item_1','Category Form','form_category');

Ver un video tutorial

Esta macro inicia un conjunto de transacciones en la base de datos.

Para el uso de esta macro necesita tener una base de datos transaccional.

En las aplicaciones de formulario, los eventos (onAfterInsert, onAfterUpdate, onAfterDelete, onBeforeInsert, onBeforeUpdate o onBeforeDelete) están protegidos automáticamente por un control de transacción, ya que la conexión es la misma que la de la aplicación.

En los otros casos, si el usuario necesita realizar un control de transacción, debe comenzar con esta macro y finalizar con la macro sc_commit_trans() para confirmar las actualizaciones o sc_rollback_trans() para cancelar las transacciones.

El parámetro "conexión" es opcional, necesario solo si el comando se ejecuta en una conexión diferente de la aplicación real.

Ej:

           sc_begin_trans();

           if({campo} == 1)

           {

                 sc_rollback_trans();

           }

          else

          {

                 sc_commit_trans();

          }

Ver un vídeo tutorial

Determina dinámicamente los campos de visualización de un bloque específico.

Por defecto, se muestran todos los bloques (condición "activada").

Ej. 1:
if ({type_customeri} == "personal")
{
sc_block_display(company, off);
}
else
{
sc_block_display(personal, off);
}

Ej. 2:  Usando una variable local como segundo parámetro

$var = "off";

sc_block_display(company, $var);

Obs: En las grid, esta macro solo funciona con orientación de "diapositiva".

Ver un video tutorial

Disponible cuando se hace clic en el botón "Copiar". Se puede probar y usar dentro de los eventos de ScriptCase, lo que permite una programación específica en tiempo de ejecución.

Ej. 1:

if (sc_btn_copy)

{

sc_message("Registro copiado exitosamente!");

}

Ver un video tutorial

Disponible cuando se hace clic en el botón "Eliminar". Se puede probar y usar dentro de los eventos de ScriptCase, lo que permite una programación específica en tiempo de ejecución.

Ej. 1:
if (sc_btn_delete)
{
sc_error_message("No fue posible eliminar este registro");
}

Ver un vídeo tutorial

Esta macro se usa para deshabilitar o habilitar botones desde una aplicación de menú.

Ej:

sc_btn_disable('btn_2', 'off');

Ver un vídeo tutorial

Esta macro está destinada a habilitar o deshabilitar dinámicamente un botón de la barra de herramientas.

Tiene dos parámetros obligatorios:

Nombre de los botones de grid

Nombre de los botones de la aplicación Calendario y Formulario

Nombre de los botones del Control

Ejemplo: Habilitando botón delete apenas para el usuario admin.

if ( [user_login] == 'admin' ) {

    sc_btn_disabled('delete', 'on');

} else {

    sc_btn_disabled('delete', 'off');

}

Ejemplo: Usando variables.

Obs: Pueden ser utilizadas variables globales o locales.

if ( [user_login] == 'admin' ) {

    sc_btn_disabled([btn_name], [status]);

} else {

    sc_btn_disabled([btn_name], [status]);

}

Ver un vídeo tutorial

Utilizado dentro de los eventos, los botones de la barra de herramientas se pueden habilitar o deshabilitar.

Button_Name: es el nombre o la variable que contiene el nombre del botón que se habilitará / deshabilitará.

Nombre de botones (Grid):

Nombre del botón: (Formulario):

Nombre del botón (Control):

OBS. Importante: los nombres de los botones deben estar en minúsculas.

Ej. 1:
sc_btn_display ('nuevo', 'off');

Ej. 2: Usando una variable local como segundo parámetro

$var = "off";
sc_btn_display ('new', $var);

Ej. 3: Al pasar variables o campos ({field} o [global_variable]) como parámetros, no es necesario utilizar comillas dobles o simples antes y después de la variable.

sc_btn_display ({variable_button}, 'off');

Ver un vídeo tutorial

Disponible cuando se hace clic en el botón "Agregar". Se puede probar y usar dentro de los eventos de ScriptCase, lo que permite una programación específica en tiempo de ejecución.

Ej. 1:
if (sc_btn_insert)
{
sc_message("Registro insertado exitosamente");

}

Ver un vídeo tutorial

Esta macro se utiliza para cambiar dinámicamente la etiqueta de los botones, ya sean creados por el desarrollador o por el propio Scriptcase.

Para ello, es necesario informar dos parámetros obligatorios,  'btn_name' e 'new_label' (nombre del botón, y nueva etiqueta).

Clique aqui y vea ejemplos de como usar la macro.

Nombre de los botones de la Grid y del grafico.

Nombre de los botones del formulario y calendario

Nombre de los botones de la grid.

Ejemplo: Parametro con string

sc_btn_label('update', 'Actualizar registro');

Ejemplo: Parametro con lang

sc_btn_label("update", {lang_btn_label});

Ejemplo: Parametro con variable Global

[btn_name] = "update";
[label] = "update";
sc_btn_label([btn_name], [label]);

Ejemplo: Parametro con variable local

$btn_name = "update";
$label= "update";
sc_btn_label($btn_name, $label);

Disponible cuando se hace clic en el botón "Agregar nuevo". Se puede probar y usar dentro de los eventos de ScriptCase, lo que permite una programación específica en tiempo de ejecución.

Ej. 1:
if (sc_btn_new)
{
{My_Date} = date('Y/m/d');
}

Disponible cuando se hace clic en el botón "Agregar nuevo". Se puede probar y usar dentro de los eventos de ScriptCase, lo que permite una programación específica en tiempo de ejecución.

Ej. 1:
   if (sc_btn_new)
{
   My_Date} = date ('Y / m / d');
}

Ver un video tutorial

Disponible cuando se hace clic en el botón "Guardar". Se puede probar y usar dentro de los eventos de ScriptCase, lo que permite una programación específica en tiempo de ejecución.

Ej. 1:
  if (sc_btn_update)
{
  sc_error_message("Record updated successfully");
}

Ver un video tutorial

Esta macro tiene como objetivo calcular los dígitos de verificación.

Ej. 1:
sc_calc_dv({my_dv}, {my_rest}, 1234567, 11, 98765432, 1);
Cálculo de parcelas: 7x2 = 14; 6x3 = 18; 5x4 = 20; 4x5 = 20; 3x6 = 18; 2x7 = 14; 1x8 = 8
Suma de paquetes: 14 + 18 + 20 + 20 + 18 + 14 + 8 = 112
Resto de la división de 112/11 = 2
Dígito: 11 - 2 = 9

Ej. 2:
sc_calc_dv ({my_dv}, {my_rest}, 1234567, 10, 12, 2);
Cálculo de parcelas: 7x2 = 14; 6x1 = 6; 5x2 = 10; 4x1 = 4; 3x2 = 6; 2x1 = 2; 1x2 = 2
Suma de paquetes: 1 + 4 + 6 + 1 + 0 + 4 + 6 + 2 + 2 = 26
Resto de la división de 26/10 = 6
Dígito: 10 - 6 = 4

Permite utilizar las API integradas con Scriptcase. Actualmente ofrecemos la integración con Mandrill y Amazon SES API.

Esta macro tiene dos parámetros:

Ej.1 - Configuración de parámetros, array con información de la API.

$settings = array( 'settings' => ['gateway' => 'mandrill', 'api_key'=> {api_key}] );

$mandrill = sc_call_api('', $settings);

Ej. 2: Envío de correo electrónico usando Mandril.

$txt_no_tags = strip_tags({body});

$arr_merge = array(
                'name'  => '',
                'type'  => 'to',
                'email' => 'example@exemple.com'
            );

$var_config = array( 'settings' => ['gateway' => 'mandrill', 'api_key'=> {api_key}] );

$mandrill = sc_call_api('', $var_config);
$var_msg = array(
              'from_email'                     => {from_email},
              'from_name'                      => {from_name},
               'html'                          => {body},
               'text'                          => $txt_no_tags,
               'to'                            => array($arr_merge),              
               'subject'                       => {subject},
               'important'                     => true,            
               'auto_text'                     => null,
               'auto_html'                     => null,
               'inline_css'                    => null,
               'metadata'                      => array('website' => 'www.scriptcase.net')
   );

$async = false;
$return = $mandrill->messages->send($var_msg, $async);

Ej. 3 - Envío de SMS usando clickatell.

$var_config     = array( 
  'message'     => [
    'to'      => {sms_to},
    'message'     => {sms_txt},
    ],
    'settings'    => [
    'gateway'   => {gateway},
    'auth_token'  => {auth_token},
    ] 
);

sc_send_sms($var_config);

Ej. 4 - Uso de la macro con PayPal

  $arr_settings = [
            'gateway' => 'paypal',
            'environment' => 'sandbox',
            'auth_email' => 'vitorjamil@gmail.com',
            'auth_token' => '72AE21503DDA4840BE1DC7945F6D1CE1'
                 ];
sc_call_api('',$arr_settings);

Controla dinámicamente si se muestra el captcha/recaptcha configurado en la aplicación.

Para utilizar la macro, la aplicación debe estar previamente configurada con el recurso.

Ejemplo

if ( $_SERVER['REMOTE_ADDR'] == '127.0.0.1' ) {

    sc_captcha_display("on");

} else {

    sc_captcha_display("off");

Ver un video tutorial

Macro para comprobar si se ha cambiado el nombre del campo.

Ej. 1:
if (sc_changed({my_field}))
{
Echo "Filed has been changed";
}

Ver un video tutorial

Esta macro cambia dinámicamente las conexiones de la aplicación

Ej. 1: Para cambiar las conexiones:

sc_change_connection("Old_Concection01", "New_Connection01" ; "Old_Concection02", "New_Connection02");

Permite cambiar más de una aplicación / conexión en un comando. Se pueden pasar múltiples conexiones como parámetros que deben estar separados por un ";".

Ej. 2: Usando variables:

sc_change_connection([Global_Connetion], [Test_Connection]);

Los cambios tienen efecto en las próximas aplicaciones.

Ej. 3: Cambiar la conexión principal de la aplicación

sc_change_connection({Password}, [Test] ; "Mi_Conexion", [Global_Connection]);

Los cambios tienen efecto en las próximas aplicaciones.

Ej. 4: Para eliminar los cambios:

Para recuperar su configuración anterior puede usar la macro sc_reset_change_connection();

Esta macro permite manipular las propiedades CSS de los campos y filas de la consulta

De esta forma puedes cambiar el aspecto de la aplicación de forma dinámica y con muchas más opciones de modificación

Lista de parámetros

Ejemplo

Ejemplo de cambio del color de la fuente y utilización del sc_badge

switch({taskstatus}) {
	case 'COMPLETED':
		sc_change_css('color', '#dcfce7', 'taskstatus');
		sc_change_css('sc_badge', 'green', 'taskstatus');
		break;
		
	case 'IN-PROGRESS':
		sc_change_css('color', '#1e40af', 'taskstatus');
		sc_change_css('sc_badge', 'blue', 'taskstatus');
		break;
		
	case 'NOT-STARTED':
		sc_change_css('color', '#991b1b', 'taskstatus');
		sc_change_css('sc_badge', 'red', 'taskstatus');
		break;
}

Ejemplo de utilización de la macro con atributos css

switch({taskstatus}) {
	case 'COMPLETED':
		sc_change_css('color', '#166534', 'taskstatus');
		sc_change_css('background-color', '#dcfce7', 'taskstatus');
		sc_change_css('padding-right', '0.6em', 'taskstatus');
		sc_change_css('padding-left', '0.6em', 'taskstatus');
		sc_change_css('border-radius', '14px', 'taskstatus');
		sc_change_css('font-weight', 'bold', 'taskstatus');
		sc_change_css('width', 'fit-content', 'taskstatus');
		sc_change_css('display', 'block', 'taskstatus');
		sc_change_css('padding-top', '0.2em', 'taskstatus');
		sc_change_css('padding-bottom', '0.2em', 'taskstatus');
		sc_change_css('font-size', '60%', 'taskstatus');
		sc_change_css('margin', '10%', 'taskstatus');
		break;
		
	case 'IN-PROGRESS':
		sc_change_css('color', '#1e40af', 'taskstatus');
		sc_change_css('background-color', '#dbeafe', 'taskstatus');
		sc_change_css('padding-right', '0.6em', 'taskstatus');
		sc_change_css('padding-left', '0.6em', 'taskstatus');
		sc_change_css('border-radius', '14px', 'taskstatus');
		sc_change_css('font-weight', 'bold', 'taskstatus');
		sc_change_css('width', 'fit-content', 'taskstatus');
		sc_change_css('display', 'block', 'taskstatus');
		sc_change_css('padding-top', '0.2em', 'taskstatus');
		sc_change_css('padding-bottom', '0.2em', 'taskstatus');
		sc_change_css('font-size', '60%', 'taskstatus');
		sc_change_css('margin', '10%', 'taskstatus');
		break;
		
	case 'NOT-STARTED':
		sc_change_css('color', '#991b1b', 'taskstatus');
		sc_change_css('background-color', '#fee2e2', 'taskstatus');
		sc_change_css('padding-right', '0.6em', 'taskstatus');
		sc_change_css('padding-left', '0.6em', 'taskstatus');
		sc_change_css('border-radius', '14px', 'taskstatus');
		sc_change_css('font-weight', 'bold', 'taskstatus');
		sc_change_css('width', 'fit-content', 'taskstatus');
		sc_change_css('display', 'block', 'taskstatus');
		sc_change_css('padding-top', '0.2em', 'taskstatus');
		sc_change_css('padding-bottom', '0.2em', 'taskstatus');
		sc_change_css('font-size', '60%', 'taskstatus');
		sc_change_css('margin', '10%', 'taskstatus');
		break;
}

Ver un video tutorial

Esta macro tiene el objetivo de confirmar un conjunto de transacciones en la base de datos

En las aplicaciones de formularios, hay eventos que realizan transacciones con la base de datos (Ex: onAfterInsert, onAfterUpdate, onAfterDelete, onBeforeInsert, onBeforeUpdate, onBeforeDelete, etc...).
El control de transacciones de estos eventos se realiza mediante Scriptcase, si la conexión proporcionada es la misma de la aplicación.
Sin embargo, si el usuario tiene que realizar cualquier tipo de redirección en estos eventos, es necesario utilizar la macro sc_commit_trans antes de la redirección para asegurar las transacciones realizadas anteriormente.

Ej: onAfterUpdate - Utilizando la redirección después de actualizar un registro:

sc_commit_trans();


sc_redir('grid_main');

El parámetro "conexión" es opcional, siendo necesario solo si el comando se ejecuta en una base de datos diferente a la aplicación.

Ver un vídeo tutorial

Esta macro devuelve una cadena resultante de la definición de dos o más valores Puede usarse en la búsqueda de campos o eventos junto con las macros sc_lookup() y sc_select()

Hace formato concat de acuerdo a su base de datos.

Ej. 1: Edición de lookup (Edición de búsqueda):

SELECT campo1, sc_concat(campo2,' - ',campo3) FROM tabla

Ej. 2: Usando la macro con sc_lookup:

sc_lookup(Dataset,"SELECT campo1,sc_concat(campo2, ' - ' ,campo3) FROM tabla");

Ver un video tutorial

Válido solo en el código de programación PHP que se ejecuta cuando se lo llama a través de un botón de la barra de herramientas.

Esta macro se usa para confirmar que la acción debe ejecutarse realmente, evitando errores.

Parámetro

Esta macro tiene un solo parámetro, que es el mensaje de confirmación que se mostrará.

Ej. 1:
sc_confirm ("¿Realmente deseas ejecutar esta acción?");

Ver un video tutorial

1º Parámetro: nombre de la conexión que se editará.

2º Parámetro: matriz de elementos que contienen la información de conexión que se editará. Mira los índices de la matriz:

Nota: No es necesario usar todos los índices en la matriz, solo podemos pasar los requeridos.

Ejemplo:

$arr_conn = array();

$arr_conn['user'] = "admin2";
$arr_conn['password'] = "admin2pass";
$arr_conn['database'] = "sc_samples2";

sc_connection_edit("sc_connection", $arr_conn);

Ver un video tutorial

Cuando se usa, la macro crea una nueva conexión con la información insertada en sus parámetros. Esta conexión está disponible en toda la sesión actual de Scriptcase y deja de existir cuando se cierra la sesión.

La nueva conexión solo estará disponible en la próxima aplicación.

1º Parámetro: nombre de la conexión.

Nota: si hay una conexión creada dentro del Scriptcase con el mismo nombre, esta macro no tiene ningún efecto. Las conexiones creadas dentro de Scriptcase prevalecen. Si desea editar una conexión existente, consulte la documentación de la macro sc_connection_edit .

2º Parámetro: Matriz de elementos que contienen la información de conexión. Mira los índices de la matriz:

Nota: Se requiere que todos los artículos estén llenos, con la excepción de los artículos. ['persistent'] y ['encoding'].

Vea abajo la lista de drivers:

Ejemplo:

$arr_conn = array();

$arr_conn['drive'] = "mysqlt";
$arr_conn['server'] = "127.0.0.1";
$arr_conn['user'] = "root";
$arr_conn['password'] = "pass123";
$arr_conn['database'] = "sc_samples";
$arr_conn['persistent'] = "Y";
$arr_conn['encoding'] = "utf8";

sc_connection_new("new_conn_mysql", $arr_conn);

Ver un vídeo tutorial

Esta macro tiene el objetivo de calcular el incremento o disminución de fechas. Para su uso son necesarios algunos parámetros de la siguiente manera:

Ej. 1:
{birthdate} = sc_date({birthdate}, "dd/mm/yyyy", "+", 30, 0, 0);

Ej. 2:
$new_date = sc_date({birthdate}, "yyyy-mm-dd", "-", 15, 3, 2);

Ej. 3:
{inclusion_dt} = sc_date(date('Ymd'), "yyyymmdd", "-", 0, 1, 1);

OBS: Para obtener la certificación del formato de fecha, antes de usar la función, pruébelo en cualquier caso:
echo "form_date =". {nombre del campo fecha};

Ver un vídeo tutorial

Esta macro convierte el campo de fecha pasado como parámetro con un formato de entrada a otro campo con un formato de salida.

Consulte a continuación la lista de parámetros para esta macro y los valores aceptados.

Para obtener más información sobre las cadenas de datos, consulte el Manual de PHP

Ej. 1: Convierte la fecha del formato "dd/mm/ yyyy" al formato "yyyymmdd".

{field_date} = sc_date_conv({field_date}, "dd/mm/yyyy", "yyyymmdd");

Ej. 2: Convierte la fecha del formato nativo de la base de datos a "dd/mm/yyyy".

{field_date} = sc_date_conv({field_date}, "db_format", "dd/mm/yyyy");

Ej. 3: Convierte la fecha del formato nativo de la base de datos a  "dd/mm/yyyy".

{field_date} = sc_date_conv({field_date}, "dd/mm/yyyy", "db_format");

Ex. 4: Convertir la fecha del formato nativo de la base de datos(db_format) al formato de configuración regional(sc_format_region)

{field_date} = sc_date_conv({field_date},"db_format","sc_format_region");

Ex. 5: Convertir la fecha de "aaaa-mm-dd" al formato de configuración regional(sc_format_region)

{field_date} = sc_date_conv({field_date},"aaaa-mm-dd","sc_format_region");

Ver un vídeo tutorial

Calcula la diferencia entre dos fechas (pasadas como parámetros) en días.

Ej. 1:
{amount_days} = sc_date_dif({date1}, "aaaa-mm-dd", {date2}, "mm/dd/aaaa");

Ej. 2:
{amount_days} = sc_date_dif("2000-05-01", "aaaa-mm-dd", "04/21/2004", "mm/dd/aaaa");
{amount_days} sería igual a -1451 (days)

Nota: Los formatos pueden ser diferentes pero deben ser en días, meses y años.

Ver un video tutorial

Calcula la diferencia entre dos fechas (pasadas como parámetros) que devuelve la cantidad de días, meses y años.

El resultado se devuelve en una estructura de matriz, donde el índice 0 tiene la cantidad de días, el índice 1 tiene la cantidad de meses y el índice 2 tiene la cantidad de años.

Ej. 1:
$diferencia = sc_date_dif_2 ({date1}, "yyyy-mm-dd", {date2}, "mm/dd/yyyy", 1);
{dif_days} = $diferencia[0];
{dif_months} = $diferencia[1];
{dif_years} = $diferencia[2];

Ej. 2:
$diferencia = sc_date_dif_2 ("2000-05-01", "yyyy-mm-dd", "04/21/2004", "mm/dd/yyyy", 1);
$diferencia[0] = 20 (days)
$diferencia[1] = 11 (months)
$diferencia[2] = 3 (years)

Ej. 3: Usando la opción 2
$diferencia = sc_date_dif_2 ("2000-05-01", "yyyy-mm-dd", "04/21/2004", "mm/dd/yyyy", 2);
$diferencia[0] = 21 (days)
$diferencia[1] = 11 (months)
$diferencia[2] = 3 (years).

Nota: Los formatos entre las dos fechas pueden ser diferentes, pero deben tener días, meses y años. También debe conocer el formato interno que se devuelve para que la macro funcione correctamente.

Ver un video tutorial

Esta macro comprueba si un campo de fecha está vacío.

Ej. 1:
if (sc_date_empty({my_date}) )
{
  sc_error_message("Invalid Date");
}

Ver un video tutorial

Devuelve, el campo o la variable encriptados, a su valor original.

Ej. 1: Usando una variable local:
{mi_campo} = sc_decode($field_cript);

Ej. 2: Usando una variable de usuario:
$mi_var = sc_decode($field_cript);

Nota: Netmake no es responsable por la integridad del algoritmo de criptografía (es un algoritmo de código abierto)

Ver un video tutorial

Devuelve el campo o variable con el contenido encriptado.

Ej. 1: Cifrar una variable local:
$field_cript = sc_encode({my_field});

Ej. 2:Cifrar una variable de usuario:
$field_cript = sc_encode($my_var);

Note: Netmake no es responsable de la integridad del algoritmo de cifrado (el algoritmo proporcionado es de código abierto).

Ver un video tutorial

Esta variable devuelve una cadena con un mensaje de error de base de datos, que ocurre al tratar de excluir un registro.

Se usa cuando hay una necesidad de tratar estos mensajes. < br />
Como por ejemplo, en caso de validaciones de bases de datos a través de desencadenantes o procedimientos que devuelvan mensajes.

Ej. 1: contenido de la variable {sc_error_delete} , que devuelve un mensaje de error generado por el activador de la base de datos usando

MsSQL. "[Microsoft] [Controlador ODBC SQL Server] [SQL Server] No puede borrar este registro."

Nota: Para acceder al error de devolución de la base de datos, ve la macro " sc_error_continue ".

Ver un video tutorial

El sc_error_exit La macro interrumpe la ejecución del código.

Cuando se usa sin parámetro, la macro usa un retorno, por lo que al usarla en un método PHP solo se interrumpirá la ejecución del código en el método, regresando al evento de origen y ejecutando el resto del código. En este caso, para interrumpir la ejecución del evento de la aplicación, también se debe utilizar la macro al devolver el método.

Esta macro debe usarse después de la macro. sc_error_message();

Parámetros

Tiene dos parámetros que no son obligatorios y el uso o no de los parámetros interfiere con el funcionamiento de la macro.

Ejemplos

Ex. 1: Muestra solo el mensaje de error.

sc_error_message('Mensaje de error');
sc_error_exit();

Ex. 2: Muestra mensajes de error y el botón "Aceptar" para redirigir a la URL especificada.

sc_error_message('Mensaje de error');
sc_error_exit(http://www.meusite.com);

Ex. 3: Muestra mensajes de error y el botón "Aceptar" para redirigir a la Aplicación informada.

sc_error_message('Mensaje de error');
sc_error_exit(mi_aplicación, "_blank");

Ver un vídeo tutorial

Esta variable devuelve una cadena con el error de base de datos, que ocurre al agregar un registro. Se usa cuando es necesario tratar estos mensajes. Por ejemplo, en el caso de validaciones de bases de datos a través de desencadenantes o procedimientos que devuelven mensajes.

Ej. 1: Variable {sc_erro_insert} , al devolver un mensaje de error generado por la base de datos, se activa el uso de mssql

"[Microsoft] [Controlador ODBC SQL Server] [SQL Server ] No puede agregar este registro. "

Nota: Para acceder al error de la base de datos, consulte la macro " sc_error_continue ".

Ver un video tutorial

Esta macro genera un mensaje de error.

En las aplicaciones "Formularios y Control ", los mensajes se presentan junto con otros mensajes de error. encontrados en la aplicación, excepto cuando se utiliza la macro "sc_error_exit ".

En las aplicaciones "Grid y menú ", los mensajes solo se presentarán a través de la macro " sc_error_exit ".

Ej. 1:
if ({discount}> 0.10 && [glo_usr] == 'operator')
{
sc_error_message ("El descuento ". {Discount}. " es mayor a 0.10");
}

En este ejemplo, si el valor en el campo de descuento es más de 0.10 y el usuario intenta agregar o guardar este registro, la operación finaliza y el aparece un mensaje de error. El comando debe terminar con ");" (cerrar paréntesis y punto y coma) utilizado como delimitador para el intérprete de macros.

Ver un video tutorial

Esta macro devuelve una cadena con un mensaje de error de base de datos que se produce al actualizar un registro. Se usa cuando existe la necesidad de tratar estos mensajes. Por ejemplo, en el caso de validaciones de bases de datos a través de disparadores o procedimientos que devuelven mensajes.

Ej. 1: Variable {sc_erro_update}, devolviendo un mensaje de error generado por un activador de base de datos usando mssql.

"[Microsoft] [Controlador ODBC SQL Server] [SQL Servidor] No puede actualizar este registro ".

Nota: Para acceder al error de devolución de la base de datos, consulte la macro " sc_error_continue". 

Ver un video tutorial

Esta macro permite condicionar las circunstancias en que se ejecutan los comandos SQL.

El parámetro "Conexión" es opcional. Es obligatorio si el comando que se ejecuta está en una base de datos diferente de la aplicación.

Ej. 1:
if (sc_after_delete) {
sc_exec_sql("delete from mytable where key = {key_ant}");
}

Ver un video tutorial

Esta macro se puede usar en los eventos de ScriptCase y en el botón creado y puede devolver valores / proceso después de la ejecución.