Este elemento, userInterface, forma parte del objeto appData, disponiendo de cARTaracterísticas propias que hacen que sea descrito a continuación.

Dentro de este ámbito, podemos encontrar funciones que nos permiten interactuar con el usuario o con el dispositivo físico, permitiendo activación/desactivación de periféricos, impresión, notificaciones sonoras, o funcionalidades más básicas como un msgbox.

Es posible llamar a los métodos con ui.nombremetodo, en vez de usar el antiguo appdata.userInterface.

Objeto genérico para hacer todo tipo de cosas.

Objeto XoneGlobalUI

Añade un evento al calendario integrado en Android.

Ejemplo:

var fechainicio = Date.parse(formatDateTime(self.FECHA,2) + " " + self.HORAINI + ":00");
var fechafin = Date.parse(formatDateTime(self.FECHA,2) + " " + self.HORAFIN + ":00");
ui.addCalendarItem("Titulo Tarea byXOne:" + self.TIPO.toString(),"Descripción: " + self.DESCRIPCION.toString(),"Lugar del Evento",fechainicio,fechafin);

Solicita que se active el servicio de GPS

Ejemplo:

	let sDeviceOs = appData.getGlobalMacro("##DEVICE_OS##");
	if (sDeviceOs == "android") {
		let nStatus = ui.checkGpsStatus();
		if (nStatus === 0) {
			ui.showToast("No hay GPS, no se puede activar.");
		}
		if (nStatus == 1) {
			ui.showToast("Está activada la localización por GPS.");
		}
		if (nStatus == 2) {
			ui.showToast("Está activada la localización por redes wifi y de telefonía.");
		}
		if (nStatus == 3) {
			ui.showToast("No está activado el GPS ni la ubicación por redes wifi y telefonía, a ver si nos lo activan.");
			ui.askUserForGpsPermission();
		}
		if (nStatus == 4) {
			ui.showToast("Está activada la localización por GPS y redes wifi y de telefonía.");
		}
		if (nStatus == -1) {
			ui.showToast("Error inesperado, compruebe la consola de mensajes.");
		}
	}
}

Verifica que se puede usar red móvil en el dispositivo, o sea que el dispositivo está registrado en la red, que tiene tarjeta SIM y que esté el servicio disponible.

Ejemplo:

<after-edit show-wait-dialog="false">
        <action name="runscript">
          <script language="javascript">
				if(ui.canMakePhoneCall())
				{
				    ui.makePhoneCall("123456789");
				}
				else
				{
				    ui.showToast("No es posible hacer llamadas");
				}
		  </script>
        </action>
      </after-edit>
 

Permite Capturar Imagen. Según sintaxis en imagen1 guarda la posicion de la imagen capturada y en grupoimagen al frame que pertenece

Ejemplo:

<accion show-wait-dialog="false" refresh="false">
        <action name="runscript">
          <param name="param" />
          <include file="funciones_perifericos.js" language="javascript" />
          <script language="javascript">
      		switch (param) {
      			case "mail":
      				EnviarMail("NO");
      				break;
      			case "mailsi":
      				EnviarMail("SI");
      				break;
      			case "mailsicancel":
      				self.MAP_VISIBLE=0;
      				break;
      			case "pdf":
      				if (len(self.MAP_PDFSERIE)===0 || self.MAP_PDFNUMERO===0 || len(self.MAP_PDFFECHA)===0 || len(self.MAP_PDFTEXT)===0)
      					appData.failWithMessage (-8100,"Todos los campos son obligatorios");
      				else
      					GeneratePDFDocument();
      				break;
      			case "cbarras":
      				CodigoBarras();
      				break;
      			case "compartir":
					ui.captureImage ("captureimg","group4Frame");
					ui.shareData ("Compartir byXOne:" + cstr(self.MAP_COMPARTIR),"",self.captureimg);
					break;
				default:
					ui.msgBox ("No pulso ninguna opción valida","AVISO",0);
					break;
      		}
		</script>
        </action>
    </accion>

Indica el estado actual del GPS en el dispositivo, los posibles valores que devuelve son:

Ejemplo:

function comprobarEstadoGps() {
	let sDeviceOs = appData.getGlobalMacro("##DEVICE_OS##");
	if (sDeviceOs == "android") {
		let nStatus = ui.checkGpsStatus();
		if (nStatus === 0) {
			ui.showToast("No hay GPS, no se puede activar.");
		}
		if (nStatus == 1) {
			ui.showToast("Está activada la localización por GPS.");
		}
		if (nStatus == 2) {
			ui.showToast("Está activada la localización por redes wifi y de telefonía.");
		}
		if (nStatus == 3) {
			ui.showToast("No está activado el GPS ni la ubicación por redes wifi y telefonía, a ver si nos lo activan.");
			ui.askUserForGpsPermission();
		}
		if (nStatus == 4) {
			ui.showToast("Está activada la localización por GPS y redes wifi y de telefonía.");
		}
		if (nStatus == -1) {
			ui.showToast("Error inesperado, compruebe la consola de mensajes.");
		}
	}
}

Borra cajón

Ejemplo:

<borrar show-wait-dialog="false" refresh-prop="DIBUJO">
        <action name="runscript">
          <script language="javascript">
				ui.clearDrawing("DIBUJO");
			</script>
        </action>
      </borrar>

Cuando se llama a este método, crea un acceso directo a la aplicación que se le pase en el primer parámetro, que puede ser otra distinta a la que se esté ejecutando. El segundo parámetro indica si queremos evitar que se creen duplicados al llamar de nuevo a esta función.

En cualquier caso, esta función es totalmente dependiente de la aplicación de escritorio que tenga instalado el usuario, en algunos casos muestra una notificación “toast” siempre, en otros no, y en otros ni crea el acceso directo. Con la aplicación de escritorio por defecto que viene en Android debería funcionar bien.
Se usará icon.png como icono del acceso directo.

Ejemplo:

	  <btnaddShortcut show-wait-dialog="false" refresh="false">
        <action name="runscript">
          <script language="javascript">
          		ui.createShortcut("DemoPruebas",0,"Title1","");
          </script>
        </action>
      </btnaddShortcut>

Elimina la Notificación de la barra superior de notificaciones realizado con el “ShowNotification”, hemos de especificar el ID (1) de la notificación para especificar el mensaje que queremos quitar.

Ejemplo:

 <notificar show-wait-dialog="false">
        <action name="runscript">
          <script language="javascript">
				ui.showNotification(1, "Título", "Esto es una notificación", "Aviso de recepción de datos");
			</script>
        </action>
      </notificar>
      <eliminar show-wait-dialog="false">
        <action name="runscript">
          <script language="javascript">
				ui.dismissNotification("1");
			</script>
        </action>

Este método permite dibujar una ruta entre 2 puntos en un mapa incrustado en la aplicación.

Ejemplo:

ui.drawMapRoute("MAP_MAPA", self.LATITUD, self.LONGITUD, 43.0069, -7.5699, "driving", "#FF0000");

if(objGPS.STATUS != 1) {
	//ui.showToast("El campo STATUS vale " + objGPS.STATUS);
        	} else {
                		if ( appData.getGlobalMacro("##DEVICE_OS##") == "IOS"){
                  			self.getOwnerCollection().getOwnerObject().MAP_VERDATOS2 = 1;
                  			self.getOwnerCollection().getOwnerObject().MAP_TL = "Pinche para ver ruta en el navegador";
                  			if( appData.getCurrentEnterprise().getVariables("MIUBICACION") == 1){
        						ui.drawMapRoute("@mapa",self.LATITUD,self.LONGITUD,"","","","");
                  			}
        				}else{
        					//ui.drawMapRoute("@mapa",self.LATITUD,self.LONGITUD,"","");
        					ui.drawMapRoute("@mapa", self.LATITUD, self.LONGITUD, objGPS.LATITUD, objGPS.LONGITUD, "driving", "#FF0000");
        				}    		
				}
          	}
          	

Obsoleto. Se recomienda usar el objeto XonePrinter para las acciones de impresión.

Finaliza la conexión a la impresora.

Ejemplo:

Function ImprimirPrinterServer
	ui.StartPrint "datecs"
	ui.PrintLine "test"
	ui.Print "Sin hacer salto de linea"
	ui.PrintLine "Pues es verdad"
	ui.PrintLine "Prueba de texto lo suficientemente largo más o menos, supongo, no sé, sólo para ver qué pasa si lo hago."
	ui.PrintLine "-------------------------------------------------------------------------------------------------------------------"
	ui.PrintImage "test.png", 300, 300, "center", 0
	ui.EndPrint
End Function

Este método sirve para ejecutar un nodo tras esperar un cierto tiempo. El tiempo se especifíca en segundos y el nodo debe estar en la colección donde se encuentre el script con la llamada a este método. Se pueden poner decimales, por ejemplo 0.3 que vienen a ser 300 milisegundos. No poner 0.

<before-edit> <!-- O en cualquier otra parte -->
	<action name="runscript">
		<script language="javascript">
			ui.executeActionAfterDelay("Nodo_A_Ejecutar", 20);
			<!-- Ponemos que se ejecute cuando pasen 20 segundos -->
		</script>
	</action>
</before-edit>

<Nodo_A_Ejecutar>
	<action name="runscript">
		<script language="javascript">
 
			...... Hacemos lo que sea .......
			<!-- ui.executeActionAfterDelay("Nodo_A_Ejecutar", 20 );--> Si queremos que sea repetitivo
		</script>
	</action>
</Nodo_A_Ejecutar>

Ejemplo:

<btn_replica show-wait-dialog="false" refresh="false">
		<action name="runscript">
			<script language="javascript">
				ui.showToast("Iniciando ciclo de réplica");
				replica.start();
				ui.executeActionAfterDelay("btn_RefreshPend",5);
			</script>
		</action>
	</btn_replica>

Ejemplo:

<after-edit show-wait-dialog="false">
        <action name="runscript">
          <script language="javascript">
				self.MAP_VOLUMEN=ui.getSoundVolumen();
				self.MAP_MAXVOLUMEN=ui.getMaxSoundVolume();
		  </script>
        </action>
      </after-edit>

Ejemplo:

<after-edit show-wait-dialog="false">
        <action name="runscript">
          <script language="javascript">
				self.MAP_VOLUMEN=ui.getSoundVolumen();
				self.MAP_MAXVOLUMEN=ui.getMaxSoundVolume();
		  </script>
        </action>
      </after-edit>

Devuelve el objeto ventana asociada al objeto que se le pasa como parámetro. Si el objeto no tiene ventana aún, devuelve NULL.
Las posibles acciones sobre dicha ventana son: Refresh, Bind, SetFocus, PickFile .

Ejemplos:

function startUpdateGpsLoop() {
    let myPromise = new Promise(function(bien, mal) {
        bBreakUpdateGpsLoop = false;
		let ventana = ui.getView(self);
        while(!bBreakUpdateGpsLoop) {
            if (!ventana) {
                break;
            }
            try {
                actualizarGps();
            } catch(error) {
                ui.showToast("Hubo un error");
            }
            ventana.refreshValue("MAP_LONGITUD", "MAP_LATITUD", "MAP_FGPS");

function frameScroll(e) {
	if (e.dy<=10 && self.MAP_SHOWOVERSCROLL===1) {
		self.MAP_SHOWOVERSCROLL=0;
		ui.getView(self).refresh("froverscroll");
	} else {
		if (e.dy>10 && self.MAP_SHOWOVERSCROLL===0) {
			self.MAP_SHOWOVERSCROLL=1;
			ui.getView(self).refresh ("froverscroll");
		}
	}
}

Es un Método Drawer que permite ocultar el grupo que se le pasa como parámetro.

Ejemplo:

function changeOpction(index,bHideGroup){
	clearRefresh("mREFRESH");
	var stHeight = 0;
 
	stHeight = calculateHeight(index);	
 
	if(self.MAP_OPTION != index){
  		self.MAP_OPTION = index;
 
		if ( index == 1){
			self.MAP_DATA_HEIGHT = stHeight.toString() + "p";
			self.MAP_BTN_OPT1 = "opt1-sel.png";
			self.MAP_BTN_OPT1_COLOR = "#51a80a";
		}else{
			self.MAP_BTN_OPT1 = "opt1.png";
			self.MAP_BTN_OPT1_COLOR = "#666666";
		}
 
		if ( index == 2){
			self.MAP_DATA_HEIGHT = stHeight.toString() + "p";
			self.MAP_BTN_OPT2 = "opt2-sel.png";
			self.MAP_BTN_OPT2_COLOR = "#51a80a";
		}else{            
			self.MAP_BTN_OPT2 = "opt2.png";
			self.MAP_BTN_OPT2_COLOR = "#666666";
		}
 
		if( index == 3){
			self.MAP_DATA_HEIGHT = stHeight.toString() + "p";
			self.MAP_BTN_OPT3 = "opt3-sel.png";
			self.MAP_BTN_OPT3_COLOR = "#51a80a";
		}else{            
			self.MAP_BTN_OPT3 = "opt3.png";
			self.MAP_BTN_OPT3_COLOR = "#666666";
		}
 
		if( index == 4){
			self.MAP_DATA_HEIGHT = stHeight.toString() + "p";
			self.MAP_BTN_OPT4 = "opt4-sel.png";
			self.MAP_BTN_OPT4_COLOR = "#51a80a";
		}else{           
			self.MAP_BTN_OPT4 = "opt4.png";
			self.MAP_BTN_OPT4_COLOR = "#666666";
		}
 
		if ( index == 5){
			self.MAP_DATA_HEIGHT = stHeight.toString() + "p";
			self.MAP_BTN_OPT5 = "opt5-sel.png";
			self.MAP_BTN_OPT5_COLOR = "#51a80a";
		}else{             
			self.MAP_BTN_OPT5 = "opt5.png";
			self.MAP_BTN_OPT5_COLOR = "#666666";
		}
 
		if ( index == 6){
			self.MAP_DATA_HEIGHT = stHeight.toString() + "p";
			self.MAP_BTN_OPT6 = "opt3-sel.png";
			self.MAP_BTN_OPT6_COLOR = "#51a80a";
		}else{             
			self.MAP_BTN_OPT6 = "opt3.png";
			self.MAP_BTN_OPT6_COLOR = "#666666";
		}
 
		if( index == 7){
			self.MAP_DATA_HEIGHT = stHeight.toString() + "p";
			self.MAP_BTN_OPT7 = "opt6-sel.png";
			self.MAP_BTN_OPT7_COLOR = "#51a80a";
		}else{             
			self.MAP_BTN_OPT7 = "opt6.png";
			self.MAP_BTN_OPT7_COLOR = "#666666";
		}
 
		if ( self.MAP_OPTION == 6){
			if ( self.MAP_ISFISTOPEN_OPT5_SUB1 == 1){
				//realizamos el filtro.
				doFilter(isIpad(),1);
			}
		}
 
		if ( self.MAP_OPTION == 3){
			self.getContents("@Historico").unlock();
			if ( self.getContents("@Historico").count() == 0){
				if ( self.MAP_FILTER == 0){
					activeOrDesactiveFilter();
				}
			}else{
				if ( self.MAP_FILTER == 1){		
					activeOrDesactiveFilter();
				}		
			}
			self.getContents("@Historico").lock();
		}else{
			if ( self.MAP_FILTER == 1){		
				activeOrDesactiveFilter();
			}
		}			
 
		ui.executeActionAfterDelay("reevaluateLoad",0.2);
 
		if ( bHideGroup == 1){		
			ui.hideGroup("99");	
		}
	}else{
		if ( bHideGroup == 1){		
			ui.hideGroup("99");
		}
	}
 
	if(canApplyFilter() == 1){
		self.MAP_FILTER_BACKGROUND = "FilterOrange.png";
	}else{
		self.MAP_FILTER_BACKGROUND = "FilterGreen.png";
	}
 
	setRefresh("mREFRESH","frameOpcion5");
	setRefresh("mREFRESH","frameOpcion4");
	setRefresh("mREFRESH","frameOpcion3");
	setRefresh("mREFRESH","frameOpcion2");
	setRefresh("mREFRESH","frameOpcion1");
	setRefresh("mREFRESH","framePrincipal");
	setRefresh("mREFRESH","SubMenus");
	setRefresh("mREFRESH","SubMenu_OPT2");
	setRefresh("mREFRESH","SubMenu_OPT4");
	setRefresh("mREFRESH","SubMenu_OPT5");
	setRefresh("mREFRESH","MAP_BT_FILTRO");
	setRefresh("mREFRESH","frm_filtro");
	setRefresh("mREFRESH","frmCheckListType");
	setRefresh("mREFRESH","frmNextGrafotp1");
	setRefresh("mREFRESH","frmbackGrafotp1");
	setRefresh("mREFRESH","frameBtnFlotante");
	setRefresh("mREFRESH","frameBtnFlotante_option4_next");
	setRefresh("mREFRESH","frameBtnFlotante_option4_back");
	setRefresh("mREFRESH","frameBtnFlotante_option4_next2");
	setRefresh("mREFRESH","frameBtnFlotante_option4_back2");	
	setRefresh("mREFRESH","MAP_BTN_OPT_1");
	setRefresh("mREFRESH","MAP_BTN_OPT_2");
	setRefresh("mREFRESH","MAP_BTN_OPT_7");
	setRefresh("mREFRESH","MAP_BTN_OPT_3");
	setRefresh("mREFRESH","MAP_BTN_OPT_4");
	setRefresh("mREFRESH","MAP_BTN_OPT_5");
	setRefresh("mREFRESH","MAP_BTN_OPT_6");
 
	if(getRefresh("mREFRESH").length > 0){
    	ui.refresh(getRefresh("mREFRESH"));
	}
	ui.refresh();
}
 
 

Si está visible, permite ocultar el Drawer.

Ejemplo:

ui.hideNavigationDrawer();

Si está visible, oculta el teclado en pantalla de android.

Ejemplo:

 <action name="runscript">
          <script language="javascript">
 
                ui.hideSoftwareKeyboard();
                var filtoBuscar="1=1";
 
                if (self.MAP_FINALIZADOS==1)
                    filtoBuscar="i.FINALIZADA=1 ";
 
                if (self.MAP_FAVORABLES==1)
                    filtoBuscar=filtoBuscar + " AND i.FAVORABLE=1 ";
 
                 if (self.MAP_BUSCAR.length!=0 || self.MAP_INSPECCIONADOS==1)
          		     filtoBuscar=filtoBuscar + " AND (a.SERIAL LIKE '%" + self.MAP_BUSCAR + "%' OR t.DESCRIPCION LIKE '%" + self.MAP_BUSCAR + "%' OR m.DESCRIPCION LIKE '%" + self.MAP_BUSCAR + "%' OR s.DESCRIPCION LIKE '%" + self.MAP_BUSCAR + "%')";
          		self.getContents("M_Inspecciones").setFilter(filtoBuscar);
                self.getContents("M_Inspecciones").loadAll();
                ui.refresh("M_Inspecciones"); 
                xself.executeNode("countInspecciones");
          </script>

Ejemplo:

 <pdf1>
		<action name="runscript">
		    <script language="javascript">
    		    try{
		        var variable1 = "Generando PDF";
		        ui.showWaitDialog(variable1);
		        if(self.MAP_DOPDF == 0){
		            self.MAP_DOPDF = 1;
    				var pdf01 = createObject("XOnePDF");
    				GenerarPDF1("basico.pdf",pdf01,0);
    				pdf01 = null;
		            self.MAP_DOPDF = 0;
		        }
    		    }finally{
    		        ui.hideWaitDialog();
    		    }
			</script>

Verifica que esté una aplicación instalada,

Ejemplo:

//  ¿Está instalada la aplicación del Facebook?
 
if (ui.isApplicationInstalled("com.facebook.katana") == 0) {
        /* 
         * Sí lo está. Usamos los intents de Android para lanzar una página
         * con la aplicación nativa.
         */

Método que se utiliza para saber si el dispositivo está conectado a alguna red wifi. Devuelve true o false.

Ejemplo:

if(ui.isWifiConnected())
	{
		replica.start();
	}

Mostrar un mensaje en pantalla.

Ejemplo:

    <borrar>
        <action name="runscript">
          <script language="javascript">
          <![CDATA[
	          	var a = ui.msgBox("¿Esta seguro que desea borrar todos las lineas de las cuales no existen los ficheros en su dispositivo?","¡¡¡ATENCION!!!",1);
	          	if( a === 1){
	            	var coll = self.getContents("ReplicaFiles");
	            	var fso = createObject("filemanager");
	            	var borrados = 0;
	            	var cantidad = coll.getCount();
	            	if( cantidad <= 0){
	            		coll.loadAll();
	            		cantidad = coll.count - 1;
	            	}
                    for (var i = 0; i < cantidad; i++) {
                        var fichero = coll[i].FILENAME.toString();
	            		var fic = fso.fileExists(fichero);		
						if( fic == -1){
							coll[i].deleteObject();
							cantidad--;
							borrados++;
						}
	            	}
					fso=null;
					fic=null;
					ui.msgBox("Se han borrado " + cstr(borrados) + " lineas por no existir los ficheros asociados.","Información",0);
	          	}
	          ]]>
            </script>
        </action>
      </borrar>
      <borrar2>
        <action name="runscript">
          <script language="javascript">
          <![CDATA[
		          	var a=ui.msgBox ("¿Esta seguro que desea borrar todos las fotos del terminal que ya han sido enviadas a la central?","¡¡¡ATENCION!!!",1);
		          	if (a===1) {
		            	var coll=self.getContents("ReplicaFilesenviados");
		            	var fso = createObject("filemanager");
		            	var fic;
		            	var borrados=0;
		            	var borrados2=0;
		            	var cantidad=coll.getCount();
		            	if (cantidad<=0) {
		            		coll.loadAll();
		            		cantidad=coll.getCount();
		            	}
		            	for (var i=0;i<cantidad;i++) {
		            		fichero=cstr(coll.get(i).FILENAME);
		            		fic = fso.fileExists(fichero);		
							if (fic===0) {
								fso.delete(fichero);
								coll.get(i).deleteObject();
								cantidad--;
								borrados++;
							} else {
								coll.get(i).deleteObject();
								cantidad--;
								borrados2++;
							}
		            	}
						fso=null;
						fic=null;
						ui.msgBox ("Se han borrado " + cstr(borrados) + " fotos del terminal y sus registros.  Se han borrado " + cstr(borrados2) + " registros de fotos que no existen en el terminal.","Información",0);
		          	}
					]]>
            </script>
        </action>
      </borrar2>
      <replicar>
        <action name="runscript">
          <script language="javascript">
            		replica.start();
            		ui.msgBox ("Proceso de réplica iniciado. Se necesita buena cobertura o wifi para garantizar el envío de las fotos.","Información",0);
            	</script>
        </action>
      </replicar>
      <salir>
        <action name="runscript">
          <script language="javascript">
            		appData.failWithMessage (-11888,"##EXIT##");
            	</script>
        </action>
      </salir>

Mostrar mensaje con sonido.

Ejemplo:

  <before-edit refresh="true">
        <action name="runscript">
          <script language="javascript">	
          		appData.getCurrentEnterprise().setVariables("MIUBICACION",0);
				var ok = ui.msgBox("¿Desea acceder al Geoposicionamiento de su dispositivo?","Aviso",4);
        		if ( ok == 6 ){
					appData.getCurrentEnterprise().setVariables("MIUBICACION",1);
        		}
				self.MAP_VERDATOS = 0;
				if ( appData.getCurrentEnterprise().getVariables("MIUBICACION") == 1){
					ui.startGps();
					PosicionamientoGPS();
					if ( appData.getCurrentEnterprise().getVariables("MIUBICACION") == 10 ){
						ui.msgBox("No se ha podido posicionar el dispositivo.","",0);
					}
				}
		</script>
        </action>
      </before-edit>

Permite abrir una colección en modo edición.

Ejemplo:

 set obj1=coll.createobject
                coll.additem obj1
                obj1("MAP_ID_ENT")=obj("ID_ENT")
		        obj1("MAP_ID_PS")=obj("ID_PS")
		        obj1("MAP_PUNTODESERVICIO")=obj("MAP_PS")
		        obj1("MAP_PUNTODESERVICIONOMBRE")=obj("MAP_NOMBRE")
		        if appData.globalmacro("##DEVICE_OS##")="android" then
                    ui.openEditView obj1
                else
                    PushValue obj1
                end if
			else
			    '##XONE_TRANSLATE_NEXT_LINE##
                msg="El punto de servicio  "
                '##XONE_TRANSLATE_NEXT_LINE##
                msg1=" no tiene servicios pendientes en esta ruta"
                '##XONE_TRANSLATE_NEXT_LINE##

<pulsar show-wait-dialog="false">
        <action name="runscript">
          <param name="coll" />
          <param name="tipo" />
          <param name="subtipo" />
          <script language="javascript">
              if (tipo) {
              		if (tipo===0)
              			self.executeNode("cambiarMenu('BASICO','1SELECT.png',##FLD_MAP_COLOR1##)");
 
    				if (tipo===1)
              			self.executeNode ("cambiarMenu('CONTENTS','2SELECT.png',##FLD_MAP_COLOR2##)");
 
              		if (tipo===2)
              			self.executeNode ("cambiarMenu('PERIFERICOS','3SELECT.png',##FLD_MAP_COLOR3##)");
 
    				if (tipo===3)
              			self.executeNode ("cambiarMenu('REGLAS DE NEGOCIO','4SELECT.png',##FLD_MAP_COLOR4##)");
 
              }
 
              var param = {TIPO:"",MAP_COLORACTIVO:""};
              if ( coll === "EspecialPerifericos" || coll === "EspecialDatosOnline"){
                  param.TIPO = subtipo||"";
              }
              if (coll==="ContentConsolaReplica" || tipo == 5){
	          		param.MAP_COLORACTIVO = self.MAP_COLOR5;
			  }else{
	          		param.MAP_COLORACTIVO = self.MAP_COLORACTIVO;
			  }
 
              var obj = appData.getCollection(coll).createObject(param,true);
 
              ui.openEditView(obj);
 
           </script>
        </action>
      </pulsar>

Muestra una colección en pantalla.

En función de la forma en que esté definido el UI de la colección en el mappings, se puede usar un control especial o en caso de no tener nada definido, se muestra en modo grid.

Esta función solamente está definida en determinados frameworks, independientemente de la plataforma, pero la idea es que se vaya generalizando.

De todas maneras el uso de las nuevas reglas de UI harán que este tipo de funcionalidad se vaya sustituyendo.

Ejemplo:

ui.openMenu("ColeccionQueSea",31,1);  

 <action name="runscript">
          <param name="coll" />
          <script language="javascript">
          		ui.openMenu(coll,26,1);
		</script>
        </action>

Abre el fichero que se pasa por parámetro.

Ejemplo 1:

ui.openFile("##APP##\Files"+self.FICHATECNICA);
ui.openFile("http://www.xone.es/XOneAndroidFramework.apk");

Ejemplo 2:

    switch (parametro) {
        case 'ver':
            // abrirmos el chat ...
            openChat(self.getObjectIndex(),self.getOwnerCollection().getOwnerObject());
            break;
        // case 'veradjunto': 
        //     ui.openFile(self.ADJUNTO);
        //     break;
        case 'verfoto': 
            ui.openFile(self.MAP_FOTO);
            break;
        case 'vervoz': 
            ui.openFile(self.MAP_VOZ);
            break;
        // case 'compartir': 
        //     break;
    }

Abre una URL pasada como parámetro.

Ejemplo:

ui.openUrl(strURLAdrress);

 <prop name="MAP_TL5" class="tlRegistro " height="8%" type="B" visible="1" title="PULSE PARA VER LAS CONDICIONES DE LA CUENTA" locked="false" onclick="javascript:ui.openUrl('https://ladireccionURL');"/>
            <prop name="MAP_TL52" class="tlRegistro" type="B" visible="1" title="POLITICA DE PRIVACIDAD" locked="false" onclick="javascript:ui.openUrl('https://ladireccionURL');"/>

Seleccionar archivo.

Ejemplo:

ui.pickFile("MAP_ADJUNTORESPUESTA","*.jpg;*.png",false,"##FILESPATH##",1); 
ui.pickFile("MAP_ADJUNTORESPUESTA","*.jpg;*.png",false,"/sdcard/DCIM/Camera",1);
ui.pickFile('MAP_IMG','', true);    

Sólo los dos primeros parámetros son obligatorios.

1º Prop donde almacena, 2º Extensiones permitidas, 3º Solo fotos, 4º Ruta inicial, 5º No permite rutas superiores a la inicial

<camera show-wait-dialog="false">
        <action name="runscript">
          <param name="TIPO" />
          <script language="javascript">
			   self.MAP_ADDIMG=0;       
			   switch (TIPO) {
                   case 'adjuntar':
                        self.MAP_TYPEFILE="ADJUNTO"; 
                        var jsParams = {
        				    targetProperty : "MAP_FOTO",
        				    fileTypes      : "jpg,png"
        				};
        				ui.pickFile(jsParams);
                        break;
                    case 'foto':
						.....
                    case 'video':
                        .....
                } 
		  </script>
        </action>
      </camera>
 

Función que permite redibujar la pantalla.

Ejemplo:

if iaccion = 0 then
      				this("MAP_CIERRE") = 0
      				this("MAP_HEIGHT") = "1174px"
      				'ui.relayout 
	    			ui.Refresh "frmOpcion2","frmOpcion1","frmOpcion3","frm_btControl","frmMenu","frmGeneral","MAP_HEIGHT","MAP_NUMEROOT_R","MAP_BT_CERRAR"
      			end if
      

Se utiliza para que un script que se ejecute en el fondo pueda poner visible la última ventana. para notificaciones traer la App a foreground.

Ejemplo:

<after-edit show-wait-dialog="false">
        <action name="runscript">
          <script language="javascript">
				......
				ui.showNotification(1, "Título", "Notificación 1", "Mensaje nuevo", self, "btnToForeground");
		  </script>
        </action>
      </after-edit>	  
	  <btnToForeground show-wait-dialog="false" refresh="false">
        <action name="runscript">
          <param name="index" />
          <script language="javascript">
          		ui.returnToForeground();
          </script>
        </action>
      </btnToForeground>

Se utiliza para retornar al Menú Principal.

Ejemplo:

	if (filtro!="")
		{
	              ui.toggleGroup("99");
		      ui.returnToMainMenu();
		      var coll=appData.getCollection(COLL);
		      coll.clear();
		      var objabrir=coll.findObject(filtro);

<script language="javascript">
          	if (self.MAP_LEVEL==0)
          	{
				ui.returnToMainMenu();
			}
			else
			{	
				var vResult=showMsgBox("¿Está seguro de que quiere salir de la denuncia sin guardar?", "CONFIRMACIÓN!!",1,0);
				if (vResult==6 )
				{
					appData.failWithMessage (-11888,"##EXIT##");
				}
			}
	  	</script>
        </action>
      </onback>	  

Permite salvar una pantalla con dibujo, muy utilizado por ejemplo, cuando el cliente dibuja la firma con el dedo.

Ejemplo:

ui.saveDrawing("FIRMACLIENTE") 'Con este método guardamos el fichero con la firma del cliente.

 <guardar show-wait-dialog="false" refresh-prop="DIBUJO">
        <action name="runscript">
          <script language="javascript">
				//Opcional: Acepta un segundo parámetro, nombre de fichero
				ui.saveDrawing("DIBUJO");
				//Comprobación extra, ver si se ha guardado correctamente
				var FileManager = createObject("FileManager");
				var path = appData.filesPath + self.DIBUJO.toString();
				var result = FileManager.fileExists(path);
				if ( result == 0){
					ui.showToast("Fichero " + path + " guardado correctamente");
				}else{
					ui.showToast("Error al guardar fichero " + path);
				}
				FileManager = null;
			</script>
        </action>
      </guardar>

Este método permite ejecutar un sonido con o sin vibración, y puede repetirse n veces. El sonido a ejecutarse será un fichero del proyecto.Se podrá configurar el tono de las notificaciones en el dispositivo,así como habilitar o no la vibración con la ##DEFAULT## macro.

Ejemplo:

PENDIENTE

Este método permite enviar un email rellenando los campos en el gestor de correo que tenga instalado el cliente. El usuario es responsable de pulsar el boton de enviar. Se puede adjuntar un fichero que esté en la carpeta files o en cualquier otra ruta si se le especifica completa.

Ejemplo:

function EnviarMail(adjunto) {
	var men="";	
	if (self.MAP_CORREO.length===0)
		men="Es obligatorio indicar el correo de destino";
 
	if (self.MAP_ASUNTO.length===0 && men.length===0)
		men="Es obligatorio indicar el asunto del correo";
 
	if (self.MAP_CUERPO.length===0 && men.length===0)
		men="Es obligatorio indicar el cuerpo del correo";
 
	if (men.length===0) {
		if (adjunto==="NO") {
			var ok=ui.msgBox ("¿Desea adjuntar un fichero?","Aviso",4);
	        if (ok===6){
	        	self.MAP_VISIBLE=1;
	        	ui.refresh("MAP_TEXTAT,boton0,boton1");
	        }else{
				ui.sendMail(self.MAP_CORREO, "direccion_con_copia@xone.es", self.MAP_ASUNTO, self.MAP_CUERPO, "");
	        }
 
		} else {
			if (self.MAP_TEXTAT.length===0)
				ui.msgBox("Error: Es Obligatorio indicar el fichero adjunto","AVISO",0);				
			else
				ui.sendMail (self.MAP_CORREO, "direccion_con_copia@xone.es", self.MAP_ASUNTO, self.MAP_CUERPO, self.MAP_TEXTAT);
		}
	} else {
		ui.msgBox ("Error: " + men ,"AVISO",0);				
	}
}

Este método permite enviar un SMS.

Obsoleto. Se recomienda usar el objeto XonePrinter para las acciones de impresión.

Inicializa y conecta con la impresora que se indica por parámetro.

Ejemplo:

Function ImprimirPrinterServer
	ui.StartPrint "datecs"
	ui.PrintLine "test"
	ui.Print "Sin hacer salto de linea"
	ui.PrintLine "Pues es verdad"
	ui.PrintLine "Prueba de texto lo suficientemente largo más o menos, supongo, no sé, sólo para ver qué pasa si lo hago."
	ui.PrintLine "-------------------------------------------------------------------------------------------------------------------"
	ui.PrintImage "test.png", 300, 300, "center", 0
	ui.EndPrint
End Function

Inicia la réplica desde un script.

Ejemplo:

	self.MAP_T_USUARIO = self.getOwnerCollection().getVariables("##LOGIN_LASTUSER##");
				ui.startReplica();
            </script>

function sendMessage(colMUser,obj,title,isFromUser){
	if(obj[title].length != 0 ){
	  	var CollCV=appData.getCollection("MensajesReader");
		var ObjCV=CollCV.createObject();
		if(isFromUser){
			ObjCV.USUARIOTO = self.MAP_CCUSUARIO;
			ObjCV.USUARIOFROM = user.LOGIN;
		}else{
			ObjCV.USUARIOTO = user.LOGIN;
			ObjCV.USUARIOFROM = self.MAP_CCUSUARIO;
		}
		ObjCV.FECHA = new Date();
		ObjCV.MENSAJE = self[title];
		ObjCV.TIPO = self.MAP_TIPO;
		ObjCV.IDCHAT = self.MAP_IDCHATSEL;
		ObjCV.save();
 
		ui.startReplica();
 
		colMUser.unlock();
		addUserMessage(colMUser,ObjCV,-1,ObjCV.ROWID);
		colMUser.lock();
 
		//limpiamos
		self[title] = "";
		ObjCV = null;
		CollCV.clear();
		CollCV = null;
 
		ui.refresh("MensajesUsuarios",title);

Detiene la réplica.(Usar el objeto Réplica), pero el STOP no se usa, en su lugar, si no se quiere replicar alguna operación, usar colecciones sin réplica
Ejemplo:

appdata.Error.Clear
ObjRP("MAP_RUTAC")=This("MAP_RUTAC")
ui.StopReplica

replica.stop(); 
	ui.stopReplica();

Inicia módulo para la captura de firma. ui.StartSignature (“PROPDESTINO”, nTotalAncho, nTotalAlto, sImagenFondoRuta). El último parámetro es opcional e indica una imagen de fondo que se plasmará también en la firma resultante.

Ejemplo:

imageDrawing.save("temporal_ImagenFondoFirma.png");
	ui.startSignature("MAP_FIRMA", 640, 480, "temporal_ImagenFondoFirma.png");
}
 
 
 

Método:

Muestra una notificación en la barra de notificaciones de los dispositivos.

Ejemplos:

    Ej1:
  ui.showNotification(1, "Título", "Notificación #1");
 
    Ej2: 
   ui.showNotification(1, "Título", "Notificación #1", “Mensaje nuevo”);
 
    Ej3:
   ui.showNotification(3, "Título", "Notificación #3", "Mensaje nuevo", self, "mensajeria");
 

Método que mostrará por pantalla un reloj.

Ejemplos:

   Ej2:
   var params = {
          		initialHour: 20,
          		initialMinute: 22,
          		is24HoursMode: true,
          		title: "Seleccione fecha",
          		onTimeSet: function(nHours, nMinutes) {
          			/*Aquí ponemos el script que queramos ejecutar*/
          		}
          	};
   ui.showTimePicker(params);
 
    Ej3:
   var params = {
   targetProperty: "MAP_TEXTO_FLOAT_TOOLTIP_USUARIO",
          		initialHour: 20,
          		initialMinute: 22,
          		is24HoursMode: true,
          		title: "Seleccione fecha"
          	};
   ui.showTimePicker(params);

Muestra el drawer, si está oculto.

Ejemplo:

 ui.showNavigationDrawer();

Método que mostrará por pantalla un calendario.

Ejemplos:

    Ej2:
    var params = {
          		initialYear: 2038,
          		initialMonth: 2,
          		initialDay: 15,
          		title: "Seleccione fecha",
          		onDateSet: function(nYear, nMonth, nDay) {
          			/*Aquí ponemos el script que queramos ejecutar*/
          		}
          	};
     ui.showDatePicker(params);
 
    Ej3:
   var params = {
  targetProperty: "MAP_TEXTO_FLOAT_TOOLTIP_USUARIO",
          		initialYear: 2038,
          		initialMonth: 2,
          		initialDay: 15,
          		title: "Seleccione fecha"
          	};
    ui.showDatePicker(params);
 

Muestra un mensaje en la parte inferior de la pantalla con duración definida por el usuario.

Ejemplos:

    Ej1:
    ui.showSnackbar("Soy un snackbar");
 
    Ej2:
   var params = {
            	color: "#ff0000",
            	duration: "short”,
            	width: "100%",
            	height: "10%",
            	text: "Soy un snackbar",
            	textColor: "#FFFF00",
            	actionText: "Hola",
            	actionTextColor: "#00FF00",
            	actionMethod: function() {
            		/*Aquí ponemos el script que queramos ejecutar*/
            	}
            };
    ui.showSnackbar(params);

<after-edit show-wait-dialog="false">
        <action name="runscript">
          <script language="javascript">
				ui.showSnackbar("Tiene " + self.getContents("IncidenciasList").count().toString() + " incidencias asignadas");
		  </script>
        </action>
      </after-edit>

Mostrar teclado de software

Ejemplos:

     <script language="VBScript">
                if appData.globalmacro("##DEVICE_OS##")&lt;&gt;"android" then
          		    ui.showkeyboard true
          		end if

Lanza un mensaje en la parte inferior central de la pantalla que desaparece después de unos segundos.

Ejemplo:

    ui.showToast(“Mensaje que queremos mostrar");
 
 
    'ui.showtoast "MAP_INDICE: "+cstr(this.ownercollection.ownerobject("MAP_INDICE"))
                'ui.showtoast "VALOR: "+cstr(this("VALOR"))

Si se muestra un mensaje de un SnackBar , los props que sean floating=”true” y tengan definido el atributo behavior-target=”snackbar”, estos props se desplazarán junto con el SnackBar y cuando éste se oculte, volverán a su posición inicial.

Permite mostrar mensaje mientras se está produciendo un proceso que requiere tiempo de espera a que se realice totalmente.

Ejemplos:

    <action name="runscript">
		    <script language="javascript">
    		    try{
		        var variable1 = "Generando PDF";
		        ui.showWaitDialog(variable1);
		        if(self.MAP_DOPDF == 0){
		            self.MAP_DOPDF = 1;
    				var pdf01 = createObject("XOnePDF");
    				GenerarPDF1("basico.pdf",pdf01,0);
    				pdf01 = null;
		            self.MAP_DOPDF = 0;
		        }
    		    }finally{
    		        ui.hideWaitDialog();
    		    }
			</script>
		</action>

var viewEdit= ui.getView(self);
    viewEdit.showWaitDialog("Comprobando matrícula...");

Permite cambiar y establecer nuevo mensaje definido en un previo showWaitDialog mientras se está produciendo un proceso que requiere tiempo de espera.

Ejemplo de modificación de diálogo predefinido en con ui.showWaitDialog:

ui.showWaitDialog("Abriendo solicitud...");
ui.setWaitDialogText("Descargando Ficheros...");
ui.hideWaitDialog();

En este caso se visualiza primero “Abriendo solicitud….”, en el mismo dialog sale “Descargando Ficheros….” y finalmente se cierra el dialog.

Ejecuta un tiempo de espera, antes de continuar otra acción.

Ejemplo:

	if (self.MAP_BANDERA==0)
     {
			self.MAP_BANDERA=1;
   			if (self.MAP_AUTO==1)     
           				//ui.showToast("lo pongo auto");
     				systemSettings.setBrightnessMode("automatic");
    				//ui.sleep(2);
	     				self.MAP_BRILLO = systemSettings.getBrightness();
 

var vTimer=0;
	while (checkResult == null) {
		ui.sleep(0.3);
 
		if (vTimer++>15)
			break;
	}	  

Ejemplo:

<script language="javascript">
				//ui.speak("es", "hola");
				ui.speak("en", self[prop2]);
				ui.refresh(prop2);
			</script>
        </action>
      </leerTexto>
 
      <escucharTexto show-wait-dialog="false" refresh="true">
        <action name="runscript">
          <param name="prop1" />
            <script language="javascript">
 
 
            ui.speak("Diga número de servicio");
 
            let jsParams = {
 
 

Permite iniciar una grabación. ui.StartAudioRecord (“grabacionok”, “MAP_PROPDESTINO”, duración). El primer parámetro indica el nodo a ejecutar cuando termine de grabar, el segundo es la propiedad donde guardará el fichero resultante. Si la duración es cero, seguirá grabando sin bloquear hasta invocar StopAudioRecord. En versiones de Android inferiores a la versión 4.1 Jelly Bean, generará un fichero .3gp. En versiones superiores generará un fichero .mp4 encodeado en formato AAC de mejor calidad.

Ejemplo:

ui.startAudioRecord("onrecordfinished","MAP_RECORD_FILE", 0);

Detiene la grabación iniciada anteriormente con StartAudioRecord

<script language="javascript">
		if ( accion == "REC" ){
		//Si pulsamos el boton de grabacion 
		// 1.- Preguntamos si ya estabamos grabando para parar la grabacion.
		// 2.- Ponemos como imagen la de grabar por si quiere hacer otra grabacion
	  	if ( self.MAP_RECORD_ON == 99){
		  ui.stopAudioRecord();  
		  self.MAP_RECORD_ON = 0;
		  self.MAP_IMGBOTONAUDIO = "record.png";
		  ui.refresh("MAP_BOTONGRABAR");

Detiene la reproducción iniciada anteriormente con PlaySoundandVibrate

Lanza la cámara para leer el código de barras.

Ejemplo:

 <camera show-wait-dialog="false" refresh="false">
    <action name="runscript">
      <script language="javascript">
  		ui.startCamera("MAP_ADJUNTORESPUESTA","photo");
  		ui.refresh("MAP_ADJUNTORESPUESTA");
 
  		// ui.getView(self).refreshAll("MAP_ADJUNTORESPUESTA","frmFloatingFoto","frmTitleOrdenes2","ContentAdjuntos");
  		</script>
    </action>
  </camera>
 

Obsoleto. Se recomienda usar el objeto XonePrinter para las acciones de impresión.

Imprime la cadena que recibe por parámetro.

Ejemplo:

printer01.print(sText);

Obsoleto. Se recomienda usar el objeto XonePrinter para las acciones de impresión.

Imprime la cadena que recibe por parámetro y provoca un salto de línea.

Obsoleto. Se recomienda usar el objeto XonePrinter para las acciones de impresión.

Imprime archivo tipo PDF

Salir de la aplicación

Ejemplo:

<onback show-wait-dialog="false" refresh="false">
        <action name="runscript">
          <script language="javascript">
			    var vResult=showMsgBox("¿Está seguro de que quiere salir de la aplicación?", "CONFIRMACIÓN!!",1,0);
			    if (vResult==6 )
				{
					ui.quitApp();
				}
	  	</script>
        </action>
      </onback>

Para refrescar las propiedades que queremos sean refrescadas en un momento determinado de la aplicación, la cual se pasa como parámetro

Ejemplo:

function doChangeMapPois(sMapControl) {
    let mapContent = self.getContents("ClientesCoord");
    if (mapContent.getFilter() == "t1.NOMBRE = 'Madrid'") {
        mapContent.setFilter("");
    } else {
        mapContent.setFilter("t1.NOMBRE = 'Madrid'");
    }
    mapContent.unlock();
    mapContent.clear();
    mapContent.loadAll();
    mapContent.lock();
    ui.refresh(sMapControl);
 

Cuando queremos refrescar uno o solo algunos registros de un content, sin tener que refrescar el content en su totalidad, podemos utilizar dos métodos de appData.userInterface, los cuáles son: ui.refreshContentRow y ui.refreshContentSelectedRow

El ui.refreshContentRow en el nodo que vamos a ejecutar, tenemos que poner el refresh=“false” in para no refrescar todo, solo lo que especifiquemos.

Ejemplo:

<contentRow refresh="false" >
	<action name="runscript">
		<script language="javascript">
			var mContentUsuarios = self.getContents("ContentUsuarios");
			mContentUsuarios.loadAll();
 
			<-- Con el getItem(1) cogemos el segundo registro del contents, el primero sería el 0. -->
			var mObjItem = mContentUsuarios.getItem(1);
 
			mObjItem.LOGIN = "paquito";
			mObjItem.MAP_COLORVIEW = "#0000FF";
 
			<!-- Los parámetros son el name del prop del contents y el índice en el array de objetos del contents. -->
			ui.refreshContentRow('@MAP_CONTENT', 1); 
 
		</script>
	</action>
 
 

var obj = self.getContents("TipoFotoShow").getItem(self.MAP_IDXTIPOFOTO);
	if (obj)
	{
		obj.MAP_FORECOLOR = appData.getCurrentEnterprise().getVariables("FORECOLOR_SEL");
		obj.MAP_FOTO=newName;
		obj.MAP_ADD=1;
		obj=null;
		ui.refreshContentRow("@TipoFotoShow", self.MAP_IDXTIPOFOTO); 
	}

En el nodo que queremos que se ejecute, tenemos que poner el refresh=“false” para no refresh todo, sino solamente lo que se specifica.

En este caso ,se ejecuta el selecteditem del contents y tenemos que dar como parámetro el nombre del prop del contents que queremos refrescar, no es necesario pasar el ID del array con la posición del record que queremos refrescar como es el caso del ui.refreshContentRow,ya que el selectitem se ejecuta sobre los records que el usuario seleccionó.

Ejemplo:

<selecteditem refresh="false" show-wait-dialog="false" >
	<action name="runscript">
		<script language="javascript">
			<!-- Cambiamos algunos valores del registro -->
			self.MAP_COLORVIEW = "#00FF00";
			//ui.showToast(self.LOGIN);
			self.LOGIN = "john";
 
			<!-- Le decimos que refresque únicamente la fila actual del contents -->
			ui.refreshContentSelectedRow('@MAP_CONTENT');
		</script>
	</action>
</selecteditem>
 
 

<selecteditem show-wait-dialog="false" refresh="false">
        <action name="runscript">
          <script language="javascript">
				if (self.MAP_SELECTED)
				{
					//si el check MAP_SELECTED estaba marcado, desmarcarlo y refrescar ese registro

Si queremos cambiar solo alguna propiedad y el aspecto visual sin variar (fuente, visibilidad, frente y colores de fondo, etc) podemos usar “refreshValue” método de la userInterface que es mucho más rápida y eficiente.

Ejemplo:

ui.refreshValue("PROP1,PROP2"); //If we do it with JAVASCRIPT
 

Obsoleto. Se recomienda usar el objeto XonePrinter para las acciones de impresión.

Realiza tantos saltos de línea como se indiquen por parámetro.

Ejemplo:

printer01.lineFeed(3);

Obsoleto. Se recomienda usar el objeto XonePrinter para las acciones de impresión.

Imprime comandos específicos de la impresora, mediante la cadena que recibe por parámetro.

La sintáxis puede ser:

  1) Para escribir texto normal y que el control los interprete como ASCII, sería:\\
  appdata.userinterface.printCommand "##TEXT##hola 130 15 ##END_TEXT##"
  appdata.userinterface.printCommand "##TEXT##! 0 200 200 210 1##END_TEXT##"
  2) Cualquier valor que vaya entre comas sin las macros anteriores, será interpretado como un valor ASCII:
  appdata.userinterface.printCommand "32,35,104,111,108,97,10" sería igual a: appdata.userinterface.printCommand "32,35,##TEXT##hola##END_TEXT##,10"

Obsoleto. Se recomienda usar el objeto XonePrinter para las acciones de impresión.

Imprime un código de barras del tipo especificado por parámetro.

Ejemplo:

 printer01.printBarcode("code128", self.CODSYSANULA, 400, 200);

Obsoleto. Se recomienda usar el objeto XonePrinter para las acciones de impresión.

Imprime un código BIDI del tipo especificado por parámetro.

Arranca un contador de tiempo.

Para el contador de tiempo.

Retorna el tiempo transcurrido, en milisegundos, desde que se arrancó el temporizador o desde la última llamada a chronoValue.

Escribe la cadena de texto, que se pasa por parámetro, a la pantalla de depuración.

Ejemplo:

appData.writeConsoleString("Aqui probando mandar algo a la consola de replica y ver que se muestra");

Lanza o conecta el scanner para la lectura de códigos 2d, al realizarse la lectura se asignara el valor a la propiedad con atributo barcode =”true”. Se ha implementado posteriormente un tercer parámetro que nos permite especificar la propiedad destino de la lectura del código de barras, tenga ésta o no el atributo barcode=“true”. Este comando, para su correcto funcionamiento buscará una aplicación llamada “Barcode Scanner” by ZXing. Si no está instalada, nos abrirá el market para que la instalemos.

Ejemplo de uso:

<button name="ScannerCamera" group="1" caption="Lanzar scanner" visible="1"  labelwidth="10" lmargin="6"  method="ExecuteNode (StartScanner)” />
 
<StartScanner>
	<action name="runscript">
		<script language="javascript">
 
			<!-- Este comando lee TODOS los tipos de códigos soportados  -->
			ui.startScanner("zxing", "", "MAP_CODIGOBARRAS");
 
			<!-- Sólo para leer códigos QR y ponemos la lectura en el campo "MAP_CODIGO -->	
			ui.startScanner("zxing", "QRCODE", "MAP_CODIGO");
 
			<!-- Sólo para leer códigos ISBN -->
			ui.startScanner("zxing", "ISBN");
 
			<!-- Sólo para leer códigos QR, EAN e ISBN -->
			ui.startScanner("zxing", "QRCODE,EAN,ISBN");
 
		</script>
	</action>
</StartScanner>

Retorna el estado del bluetooth.

Asigna el nuevo estado del bluetooth.

Esta función muestra un grupo de la colección con una transición mediante script.

(*)Los TIPOS DE ANIMACIONES que pueden ponerse en los parametros de “animación de entrada” y “animación de salida”:

• “##ALPHA_IN##“ - Degradado de menos a más para efecto de entrada
• ”##ALPHA_OUT##“ - Degradado de más a menos para efecto de salida
• ”##LEFT##“ Entrada por la izquierda
• ”##LEFT_OUT##“ Salida por la izquierda
• ”##PUSH_IN##“ Entrada por la parte inferior
• ”##PUSH_OUT##“ Salida por la parte superior
• ”##RIGHT##“ Entrada por la derecha
• ”##RIGHT_OUT##“ Salida por la derecha
• ”##ROTATE_IN##“ Rotación 2D para entrada
• ”##ROTATE_OUT##“ Rotación 2D para salida
• ”##ROTATE3D_IN##“ Rotación 3D para entrada
• ”##ROTATE3D_OUT##“ Rotación 3D para salida
• ”##ZOOM_IN##“ Entrada de menor a mayor
• ”##ZOOM_OUT##“ Salida de mayor a menor

Ejemplos de Uso:

<action name="runscript">
	<script language="javascript">
		// Entrada del group id="3" con rotación 3D y tiempo de espera de 1000 ms 
		ui.showGroup("3","##ROTATE3D_IN##",1000,"##ROTATE3D_OUT##",1000);
 
		//Entrada del group id="1" con difuminado con duración de 600 milisegundos 
		ui.showGroup( "1","##ALPHA_IN##",600,"##ALPHA_OUT##",600);
 
		// Entrada del group id="2" con Zoom de entrada y salida y duración de 1000 ms 
		ui.showGroup( "2","##ZOOM_IN##",1000,"##ZOOM_OUT##",1000);
	</script>
</action>

También se puede definir en la cabecera de los grupos o en los frames el efecto de entrada que se quiere por defecto para el grupo,

  <group name="General" id="1" height="100%" animation-out="animación de salida" animation-in="animación de entrada" >
  <frame name="frmFlotante" floating="true" top="300px" left="200px" width="600px" height="300px" class="FrameAnimateFromRight" >

.FrameAnimateFromTop
{
	animation-in-delay:500;
	animation-out-delay:500;
 
	/* Entra y sale por arriba. */
	animation-in:##PUSH_DOWN_IN##;		/* Aparece por arriba */
	animation-out:##PUSH_OUT##;		/* Se va por arriba */
}
 
.FrameAnimateFromBottom
{
	animation-in-delay:500;
	animation-out-delay:500;
 
	/* Entra y sale por abajo. */
	animation-in:##PUSH_IN##;		/* Aparece por abajo */
	animation-out:##PUSH_DOWN_OUT##; 	/* Se va por abajo */
}
 
.FrameAnimateFromRight
{
	animation-in-delay:500;
	animation-out-delay:500;
 
	/* Entra y sale por la derecha. */
	animation-in:##RIGHT_IN##;
	animation-out:##LEFT_OUT##;
}
 
.FrameAnimateFromLeft
{
	animation-in-delay:500;
	animation-out-delay:500;
 
	/* Entra y sale por la izquierda. */
	animation-in:##LEFT_IN##;
	animation-out:##RIGHT_OUT##;
}
 
.FrameAnimateRotate3D
{
	animation-in-delay:500;
	animation-out-delay:500;
 
	/* Entra y sale rotando en 3D. */
	animation-in:##ROTATE3D_IN##;
	animation-out:##ROTATE3D_OUT##;
}
 
.FrameAnimateAlpha
{
	animation-in-delay:500;
	animation-out-delay:500;
 
	/* Aparece y desaparece;. */
	animation-in:##ALPHA_IN##;
	animation-out:##ALPHA_OUT##;
 
	/* ZOOM. */
	animation-in:##ZOOM_IN##;
	animation-out:##ZOOM_OUT##;
}
 
.FrameAnimateZoom
{
	animation-in-delay:500;
	animation-out-delay:500;
 
	/* ZOOM. */
	animation-in:##ZOOM_IN##;
	animation-out:##ZOOM_OUT##;	
}

Cumple las mismas macros que el script.

También puedes ocultar la ventana de espera que sea por defecto en la ejecución de los script para que el efecto sea más limpio.

En la cabecera del nodo de script pones los atributos:

show-wait-dialog="false" refresh="false"

Eso permite que no se muestre el diálogo de espera y que tampoco se refresque la pantalla. Ya lo hará la animación de forma automática.
Ejemplo de Uso:

<button1_Click show-wait-dialog="false" refresh="false">
	<action name="runscript">
		<script language="javascript">
			ui.showGroup ("3","##ROTATE3D_IN##",1000,"##ROTATE3D_OUT##",1000);
		</script>
	</action>
</button1_Click>

Esta función comprueba si está habilitado el adaptador inalámbrico. Esto no significa que se haya conectado a una red. Devuelve 1 si es cierto, 0 en caso contrario.

Ejemplos de Uso:

Function wifionoff()
 
If ui.isWifiEnabled>0 Then
  ' apagamos
  This("MAP_NOMBREBOTON")="Encender Wifi"
  This("MAP_COLORBOTON")="#FFFFFF"
  appdata.CurrentEnterprise.Variables("WifiOn")=0
  ui.stopWifi
Else
  ' encendemos
  This("MAP_NOMBREBOTON")="Apagar Wifi"
  This("MAP_COLORBOTON")="#58ACFA"
  appdata.CurrentEnterprise.Variables("WifiOn")=1
  ui.startWifi
  ui.ShowToast "ENCENDIENDO LA WIFI, ESPERE..."
End If

Esta función activa el wifi. Debe usarse con muchísimo cuidado el usuario puede considerar esta función bastante intrusiva.

Ejemplos de Uso:

   This("MAP_COLORBOTON")="#58ACFA"
  appdata.CurrentEnterprise.Variables("WifiOn")=1
  ui.startWifi
  ui.ShowToast "ENCENDIENDO LA WIFI, ESPERE..."
 

Esta función desactiva el wifi. Lo mismo que la anterior, pero esta incluso podría cortar alguna descarga en curso.

Ejemplo:

This("MAP_NOMBREBOTON")="Encender Wifi"
This("MAP_COLORBOTON")="#FFFFFF"
appdata.CurrentEnterprise.Variables("WifiOn")=0
ui.stopWifi
'appdata.FailWithMessage -11888,"##WIFIOFF####ENABLECONNECTION2##"
End Function

Permite hacer captura de una imagen, hacer foto.

Ejemplo:

Cambia el estado de visibilidad del grupo.

Ejemplo:

<prop name="MAP_ICON_DRAWER" type="B" onclick="javascript:ui.toggleGroup(999);" newline="false" labelwidth="0" class="DrawerIcon"/>

Con estos métodos uno puede bloquear la pantalla actual para que el usuario no salga de ella. Sin ejecutarse dentro de nuestro kiosko puede salir de todas formas con una combinacion de teclas (tecla back y recientes), pero sigue siendo útil.

Ejemplo:

function doStartKioskMode() {
    ui.startKioskMode();
}
 
function doStopKioskMode() {
    ui.stopKioskMode();
}

Desinstalar aplicación.

Ejemplo:

Realiza la llamada desde un Script al numero insertado como parametro en la función.

Ejemplos:

ui.makePhoneCall("123456789");

case 'llamada':
            //ver a quien llamamos
            //si es unico, es decir, personal, se llama al USUARIO
            //si es grupo: mostrar frame flotante, para llamar a uno de ellos
            if(self.MAP_PHONE.toString().length == 0){
                ui.msgBox("La persona con la que quiere contactar no tiene relleno el número de teléfono","Notificación",0);
            }else{
                ui.makePhoneCall(self.MAP_PHONE);
            }
            break;

Si está visible, oculta el teclado en pantalla de android.

Si se define este método en un nodo de botón tal y como se muestra en el ejemplo, se sustituirá la ventana de cargando al ejecutar el script por otra con una barra de progreso y título. Útil cuando se carga un script demasiado pesado.

<AbrirFiltro show-progress-dialog="true">
  <action name="runscript">
    <script language="javascript">
      ui.updateWaitDialog("Ciclo 1",20);
      [script aqui]
      ui.updateWaitDialog("Ciclo 2",30);
      [script aqui]
      ui.updateWaitDialog("Ciclo 2.1",50);
      [script aqui]
      ui.updateWaitDialog("Ciclo 3",70);
      [script aqui]
      ui.updateWaitDialog("Ciclo 4",90);
      [script aqui]
      ui.updateWaitDialog("Ciclo 5",100);
    </script>
  </action>
</AbrirFiltro>

Combinado con la función anterior, este método ajusta el máximo de la barra de progreso.
Es útil para no tener que calcular el aumento en cada updateWaitDialog.
Si, por ejemplo, quisiéramos recorrer una colección y cada vez que se procese un registro o varios aumentar sólo uno, guardamos primero el número de pasadas que daremos, lo ajustamos como el máximo y después en cada vuelta aumentamos el progreso.

<AbrirFiltro show-progress-dialog="true">
  <action name="runscript">
    <script language="javascript">
      var aumento=0;
      ui.setMaxWaitDialog(50);
      [bucle aquí]
        ui.updateWaitDialog("Generando PDF...", aumento);
        aumento = aumento + 1;
      [fin bucle]
    </script>
  </action>
</AbrirFiltro>
 
<barraprogreso show-progress-dialog="true">
	<action name="runscript">
	  <script language="javascript">
			//Para poner una barra de progreso en pantallla
			var cont=0;
			ui.setMaxWaitDialog(15000);
			for (i==1;i=15000;i++) {
			  ui.updateWaitDialog("Generando lo que sea",cont);
			  cont=cont+1;
			}
		</script>
	</action>
</barraprogreso>

Modifica el led del dispositvo, este led solamente será mostrado si tiene una notificación en la barra de notificación y el dispositivo está bloqueado.

Ejemplo:

    ui.setNotificationLed("#00FF00", 1000, 1000);

Configura una selección.

Compartir Datos

Ejemplo:

case "compartir":
    ui.captureImage ("captureimg","group4Frame");
    ui.shareData ("Compartir byXOne:" + (self.MAP_COMPARTIR),"",self.captureimg);
					break;

Para mostrar la consola de réplica

Ejemplo:

<btnreplica show-wait-dialog="false">
        <action name="runscript">
          <script language="javascript">
				replica.start();
				ui.showConsoleReplica();
		  </script>
        </action>
      </btnreplica>
 
 

Este método permite lanzar un sonido con o sin vibración, y hacer que se repita n veces. El sonido puede ser cualquiera que pueda reproducir el dispositivo, mp3, wav, etc. Por defecto, el sonido se busca en la carpeta files del proyecto. También se puede reproducir el tono de notificación que se tenga configurado en el dispositivo así como si está activa la vibración o no con la macro ##DEFAULT##.

//El archivo de sonido tiene que estar en la carpeta files del proyecto
ui.playSoundAndVibrate("bultonoencontrado.wav", "###DEFAULT##",1);
 
'Ejecuta el tono que tenga configurado el dispositivo 5 veces.
ui.playSoundAndVibrate( "##DEFAULT##", "##DEFAULT##", 5);
 
'Lo mismo que el anterior pero sin vibración
ui.PlaySoundAndVibrate( "##DEFAULT##", "", 5);

<detenersonido>
	<action name="runscript">
		<script language="javascript">
			//Detiene la reproducción. No pasa nada si no hay nada reproduciéndose.
			ui.stopPlaySoundAndVibrate();
		</script>
	</action>
</detenersonido>

Con este código mostramos únicamente un mapa embebido con los POI que tengamos en la tabla correspondiente.

	<prop name="MAP_MAPA" zoom-to-my-location="false" visible="1" type="Z" contents="ClientesCoord" onchange="Refresh" mask="2" viewmode="mapview" mapview-embedded="true" width="80%" height="80%" zoom="true" />
	<contents name="ClientesCoord" src="ClientesCoord" />

El siguiente código lo ponemos dentro de la colección del contents que contiene los datos con las direcciones de los POI, si bien podríamos ponerlo también en un botón o en cualquier otra parte.

Código javascript:

<selecteditem refresh="false">
	<action name="runscript">
		<script language="javascript">
			/* ui.showToast("Soy el selecteditem del mapview: " + self.DIRECCION) */
			/* Esto pinta una ruta desde la ciudad de Lugo (43.0069, -7.5699) hacia la posición del POI que se ha pulsado */
			ui.drawMapRoute("MAP_MAPA", self.LATITUD, self.LONGITUD, 43.0069, -7.5699, "driving", "#FF0000");
		</script>
	</action>
</selecteditem>

Modifica el color del led de los dispositivos que lo tengan, este led solo se verá si tiene una notificación en la barra de notificaciones y si está el dispositivo bloqueado.

Ejemplo:

    ui.setNotificationLed("#00FF00", 1000, 1000);

<notificar show-wait-dialog="false">
        <action name="runscript">
          <script language="javascript">
				ui.showNotification(1, "Título", "Esto es una notificación", "Aviso de recepción de datos");
			</script>
        </action>
      </notificar>
 

Inicializa y conecta el GPS del dispositivo para capturar las coordenadas GPS para su posterior tratamiento en un script.

Ejemplos de uso:

<!-- El onlogon es un nodo "especial" de la colección Empresas, y se ejecuta cuando nos logueamos en la aplicación. -->
<onlogon>
	<action name="runscript">
		<script language="javascript">
			ui.startGps();
		</script>
	</action>
</onlogon>

function GetPosGPS(tipo,auxcollobj) {
	var latitud=0;
	var longitud=0;
	var distinta=0;
	//Activamos el GPS
	ui.startGps();	
	// Capturamos las coordenadas GPS	
	var collGPS =appData.getCollection("ContentConectarGPS");
	collGPS.startBrowse();

Finaliza y cierra el GPS del dispositivo.

<!-- El onlogoff es un nodo "especial" de la colección Empresas, y se ejecuta cuando finaliza la ejecución del programa. -->
<onlogoff>
	<action name="runscript">
		<script language="javascript">
			ui.stopGPS();
		</script>
	</action>
</onlogoff>

Función asociada al control del GPS. Obtiene la última precisión.

Ejemplo:

</action>
      </activargps>
      <getlastknownlocation refresh="false">
        <action name="runscript">
          <script language="vbscript">
                ui.ShowToast "GetLastKnownLocation: " + ui.GetLastKnownLocation
            </script>
        </action>
      </getlastknownlocation>