Diferencias

Muestra las diferencias entre dos versiones de la página.

--- configuracionscripts [2021/02/15 17:19] – [Configuración de scripts] scantor
+++ configuracionscripts [2025/05/29 23:45] (actual) – [Configuración de scripts] scantor
@@ Línea 3: / Línea 3: @@
 La funcionalidad de scripts se usa para realizar validaciones o llamar a servicios web simples de tipo GET que ejecutan algún tipo de tarea en un sistema externo a Be Aware 360.
-Estos scripts son utilizados como tipo de tareas en las [[configuracionlistachequeo#Configuración de listas de chequeo|listas de chequeo]].
+Estos scripts, también permiten modificar directamente los datos del caso y del contacto relacionado. Esta funcionalidad puede utilizarse para actualizar información durante la ejecución de tareas.
-**Nota:** Los scripts que se usan para las listas de chequeo corresponden a métodos de solo lectura (no ejecutan acción "save"), por lo que si en el script se ejecuta alguna función que modifique el objeto Caso (update), este no se aplicará.
+**Nota:** Los scripts son utilizados como tipo de tareas en las [[configuracionlistachequeo#Configuración de listas de chequeo|listas de chequeo]].
+Los scripts se realizan en lenguaje JavaScript.
 Dentro de los scripts se pueden consultar campos de otros objetos de negocio, como son:
@@ Línea 16: / Línea 21: @@
 **Nota:** Al realizar llamados a la URL de tipo GET es importante usar dos funciones para reemplazar los espacios y los caracteres especiales, dado que Be Aware no los soporta:
-  * La función **encodeURI(var)** cambia los espacios en blanco por ''%20''.
+  * La función **encodeURI(var)** permite utilizar espacios y otros caracteres como ''{}'' ''()'' en un mensaje sin necesidad de modificarlos por su código ASCII correspondiente. Por ejemplo, colocar %20 en lugar de espacio.
-  * La función **variable.replace** ajusta los caracteres especiales que no son soportados en una URL.
+  * La función **variable.replace** reemplaza los caracteres especiales que no son soportados en una URL por los que sí son soportados. Por ejemplo, utilizarlo para reemplazar ñ por n, á por a, etc.
 **Ejemplo de código:**
@@ Línea 53: / Línea 58: @@
 	}
 	return jsonResult;
+}
+</code>
+**Ejemplo de código Uso avanzado de API:**
+El siguiente código hace un llamado a un servicio web de forma avanzada, pudiendo incorporar diferentes métodos, body y headers, para la obtención de un token en Be Aware 360:
+<code java>
+function execute(caso,stage,contacto,usuario,cuenta,service){
+	var jsonResult = {}
+	var method = "POST"
+	var urlBase = "https://api.beaware360.com"
+	var urlEndpoint = "/ba360/apir/v10_5/login/auth"
+	var stringHeaders = "{\"Content-Type\":\"application/json\"}"
+	var stringData = "{\"pass\":\"password\", \"user\":\"username\", \"company\":\"ba360\"}"
+	var salidaStr = service.executeServiceUtil(method,stringHeaders,urlBase,urlEndpoint,stringData)
+	jsonResult.MESSAGE = salidaStr.data
+	jsonResult.CODE = salidaStr.status
+	return jsonResult
 }
 </code>
@@ Línea 93: / Línea 119: @@
   - Clic en el botón **Eliminar** ubicado al final del registro de script que desea eliminar.
   - Clic nuevamente en el botón **Eliminar** para confirmar la eliminación del registro.
+===== Variables para utilizar en un script =====
+==== Uso de las variables ====
+  * Para usar las variables según los objetos, se utiliza la nomenclatura ''{objeto}.{variable}''.
+    * Por ejemplo:
+      * **Caso:** caso.REFNUM
+      * **Contacto:** contacto.NOMBRE
+      * **Usuario:** usuario.USER
+      * **Cuenta:** cuenta.RAZONSOCIAL
+  * Para utilizar los campos personalizados, se utiliza la nomenclatura ''{objeto}.CF.{nombrecampopersonalizado}''.
+    * Por ejemplo:
+      * **Caso:** caso.CF.nombre
+      * **Contacto:** contacto.CF.fechainicio
+  * Las variables de correo corresponde a un arreglo de 3 valores. Para utilizar esta variable, se utiliza de la siguiente manera:
+    * **Primer email:** contacto.email[0]
+    * **Segundo email:** contacto.email[1]
+    * **Tercer email:** contacto.email[2]
+  * Las variables de teléfono (fono) corresponde a un arreglo de 3 valores. Para utilizar esta variable, se utiliza de la siguiente manera:
+    * **Primer teléfono:** contacto.fono[0]
+    * **Segundo teléfono:** contacto.fono[1]
+    * **Tercer teléfono:** contacto.fono[2]
+==== Variables aceptadas para objeto Caso ====
+Las variables corresponden a los valores del **Caso** desde donde se ejecuta el script.
+  * ID
+  * IDESTADO
+  * REFNUM
+  * IDESTADODESC
+  * IDCONTACTO
+  * IDCUENTA
+  * IDCUENTADESC
+  * IDCONTACTODESC
+  * IDPRIORIDAD
+  * IDPRIORIDADDESC
+  * IDPRIORIDADCOLOR
+  * IDUSUARIOASIGNADO
+  * IDUSUARIOASIGNADODESC
+  * IDTIPO
+  * IDTIPODESC
+  * IDSUBTIPO
+  * IDSUBTIPODESC
+  * IDSLA
+  * CF
+  * ORIGEN
+  * IDSLADESC
+  * IDPRODUCTO
+  * IDPRODUCTODESC
+  * IDSTAGEACTUAL
+  * IDSTAGEACTUALDESC
+  * IDWORKFLOW
+  * IDWORKFLOWDESC
+  * ASUNTO
+  * FECHACREACION
+  * IDUSUARIOCREACION
+  * IDUSUARIOCREACIONDESC
+  * FECHAMODIFICACION
+  * IDUSUARIOMODIFICACION
+  * IDUSUARIOMODIFICACIONDESC
+  * DESTACADO
+  * DUEDATE
+  * PRIMERPASO
+  * FINGRESO
+  * SLAVALUE
+  * PORCENTAJE
+  * FINALIZADO
+  * SISTEMAEXTERNO
+  * IDINTERACCION
+  * FECHAMODIFICACION
+  * FECHAREAPERTURA
+==== Variables aceptadas para objeto Contacto ====
+Las variables corresponden a los valores del **Contacto asociado al Caso** desde donde se ejecuta el script:
+  * NOMBRE
+  * APELLIDO
+  * IDENTIFICADOR
+  * CARGO
+  * TITULO
+  * DIRECCION
+  * IDCUENTA
+  * IDCUENTADESC
+  * IDTIPO
+  * IDSLA
+  * CF
+  * FECHANACIMIENTO
+  * PASS
+  * FACEBOOK
+  * TWITTER
+  * INSTAGRAM
+  * EMAILCP
+  * email
+  * fono
+  * COMPANY
+  * fonocp
+  * GRUPOSKILLS
+  * GRUPOCUENTAS
+  * GRUPOCUENTAS
+  * FECHACREACION
+  * FECHAMODIFICACION
+  * ORIGIN
+==== Variables aceptadas para objeto Usuario ====
+Las variables corresponden a los valores del **Usuario asignado al Caso** desde donde se ejecuta el script:
+  * NOMBRE
+  * APELLIDO
+  * USER
+  * ISOPAIS
+  * CF
+  * PASS
+  * EMAIL
+  * IDEMPRESA
+  * IDEMPRESADESC
+  * IDROL
+  * IDROLDESC
+  * IDPERMISO
+  * IDPERMISODESC
+  * IDUSUARIO
+  * ACCESO
+  * IDGRUPO
+  * IDGRUPODESC
+  * AVATAR
+  * PORTADA
+  * CANTIDADCASOS
+  * MULTISESSION
+  * NOTIFICACIONACTIVA
+  * TIMEZONE
+  * LANGUAGE
+  * FECHACREACION
+  * FECHAMODIFICACION
+  * GRUPOSKILLS
+  * ESTADO
+  * LATITUD
+  * LONGITUD
+  * FECHAPOSICION
+==== Variables aceptadas para objeto Cuenta ====
+Las variables corresponden a los valores de la **Cuenta asociada al Caso** desde donde se ejecuta el script:
+  * IDENTIFICADOR
+  * RAZONSOCIAL
+  * GIRO
+  * DIRECCION
+  * TELEFONO
+  * CORREO
+  * IDSLA
+  * IDSLADESC
+  * IDREPRESENTANTE
+  * IDREPRESENTANTEDESC
+  * GRUPOCONTACTOS
+  * FACEBOOK
+  * INSTAGRAM
+  * PAGINAWEB
+  * TWITTER
+  * XPOS
+  * YPOS
+  * ISOPAIS
+  * FECHACREACION
+  * FECHAMODIFICACION
+  * CF
+  * GRUPOCONTACTOS