Guía rápida de Protogrid

Transcripción

1 Guía rápida de Protogrid El equipo de Protogrid se alegra de que vd. desee aprender más sobre Protogrid. Este tutorial le guiará en sus primeros pasos con Protogrid. Punto de partida: Vd. ha registrado su entorno, ha recibido un , ha pulsado en el hipervínculo y ha entrado por primera vez en su entorno Protogrid. Ahora le gustaría crear su primera aplicación. Para asegurar que este tutorial mantiene su simplicidad, hemos desarrollado una aplicación muy simple. Una aplicación para introducir y almacenar documentos, ficheros y comentarios en una estructura simple. 1. Cómo se llamará su aplicación? Por favor, piense en un nombre auto-explicativo, con una longitud entre 20 y 40 caracteres. A continuación piense en un texto significativo (subtítulo) que aclare a un visitante novel qué hace su aplicación. A continuación, por favor, piense también en una abreviatura a modo de alias. Hemos elegido el nombre Repositorio documental, como subtítulo escogemos Aquí se almacenan documentos que estarán disponibles en dispositivos móviles. Como alias hemos escogido docu 2. Introduzca un nuevo rol para los futuros usuarios de la app Un rol describe un grupo de usuarios. El rol se puede usar más adelante para asignar privilegios de acceso. En otras palabras: los usuarios que tengan un cierto rol, tienen un acceso determinado a unas aplicaciones determinadas. Posibles privilegios que se pueden asignar son privilegios de edición, introducción de datos, lectura o borrado. Para cada aplicación, deberían existir como mínimo dos roles: 1. Los desarrolladores y administradores del app 2. Los futuros usuarios finales del app Vamos a definir ahora los roles de nuestra nueva app. Pulse sobre la app Roles de usuarios. En primer lugar nos gustaría introducir el rol de administrador del app. Para hacerlo, pulse sobre la opción Crear. En el campo Nombre del rol (en) introduzca un nombre para este rol. Se recomienda usar un nombre en español. Elija un nombre significativo, que no requiera ninguna aclaración. Elegimos Admin-docu como el administrador de la aplicación con el alias docu. El campo Comentario puede usarse para introducir una descripción corta del rol. Ponemos la siguiente descripción: Este rol pueden usarlo los administradores de la aplicación Repositorio documental. 1

2 El formulario cumplimentado (denominado card en Protogrid) se muestra así: Pulse en Almacenar & Cerrar. El nuevo rol registrado se muestra en la lista con el prefijo Role:. Del mismo modo, introducimos un rol para usuarios normales. Como nombre del rol escogemos StdUser-docu y como comentario Este rol puede usarse por los usuarios normales de la aplicación Repositorio Documental. 3. Crear la nueva aplicación Pulsar en Crear Aplicación Ahora, una nueva app vacía se ha generado y se muestra el primer card con las propiedades de la aplicación 2

3 4. Cumplimentar la card de propiedades de la app Las propiedades más importantes son: 1. Nombre para el URL: Buenas noticias: cada app Protogrid es una webapp desde el inicio, puede abrirse desde cualquier navegador de internet. Seleccione un alias explicativo de su app para su URL. Recuerde que el nombre debe ser lo más genérico posible, para que siga siendo un buen nombre cuando la app vaya incrementando su funcionalidad en el futuro. La utilidad consiste en que se pueda invocar la aplicación simplemente con un hipervinculo como miorganizacion.protogrid.com/miapp. Nosotros escogemos docu. 2. Título: Debería escoger un nombre fácilmente entendible para la app, que posteriormente los usuarios encontrarán en el Entorno. Escogemos Repositorio documental. 3. Color del tema: Aquí, puede escoger un color principal de una paleta de colores predefinidos. Los ingenieros de Protogrid escogen colores estéticos en los diversos dispositivos. 4. Descripción: Este campo se mostrará como subtítulo. Piense en una descripción significativa, corta y que describa lo que hace la aplicación. Escogemos Aquí se guardan documentos,que estarán disponibls en dispositivos móviles. 5. Asignar roles En la misma card de Propiedades, puede asignar diferentes roles a su app para controlar qué usuarios tienen qué privilegios. Rol con acceso total: Usuarios con este rol tienen todos los privilegios en esta aplicación. Escogemos el rol Admin-docu. Rol de acceso de usuario: Usuarios con este rol tienen acceso a los datos en esta aplicación. Si deja este campo vacío, todos los usuarios de su entorno tendrán acceso al app. Escogemos el rol StdUser-docu 3

4 6. Guardar por primera vez Pulse Amacenar. Después de guardar la nueva aplicación por primera vez, se muestra en el Entorno Protogrid y aparece alguna información adicional: Dos de los datos más importantes son la lista de todos los Protos y la lista de todas las entradas de menu. Pulse el botón Cerrar en la parte superior derecha de su pantalla. Para entender los próximos pasos, le ofrecemos un breve resumen de la estructura de Protogrid. 7. Resumen de la estructura de Protogrid Cards: Los cards son el elemento central de Protogrid. Son contenedores de información que es introducida por o facilitada a un usuario. El card contiene elementos de diseño como campos de texto, Tableviews, botones, relaciones y más. Proto: Los protos son los planes de diseño de las cards. Cada card está basada en un proto. Un proto define las dependencias de los cards y cómo deben ser. Un proto puede ser una máscara de entrada de datos o una Tableview o ambas cosas, incluso una máscara de datos con una o varias Tableviews. Con protos resulta muy sencillo desarrollar apps ya que el principal trabajo consiste en crear estos protos. Puede poner tantos elementos de diseño en un proto como desee. Los tipos de elementos de diseño más importantes son: 1. Campos de texto 2. Campos de fecha y hora 3. Campos numéricos 4. Tableviews Hay dos tipos de protos: 1. Data-Proto: contiene texto, datos, campos de tiempo, Tableviews, etc. 2. Overview-Proto: contiene únicamente Tableviews 4

5 Menu: Los menus son conjuntos de cards. Proveen un punto de inicio para abrir la aplicación así como la posibilidad de ordenar las cards de una forma arbitraria. 8. Creación de un Proto En el menú de la izquierda de su pantalla, pulse Protos en la sección Diseño Pulsar en Crear. Los siguientes campos deben cumplimentarse: Nombre (en): Aquí informe el nombre del proto. Seleccione un nombre significativo. Escogemos Documento. Nombre en plural (en): Informe aquí el nombre de arriba, pero en plural, en nuestro caso es Documentos. Permitir ficheros anexo: Aquí puede decidir, si quiere permitir anexos o no. Como el objetivo de la aplicación es almacenar ficheros, escogemos la opción Sí. Pulse Guardar. En la barra de menu de la izquierda Menú principal, aparece una entrada denominada Documentos. Si selecciona esta entrada aparece una lista vacía. 5

6 9. Cambiar un Proto El proto que hemos creado no puede hacer nada. Para cambiar esto, pulse de nuevo en la entrada de menú Protos. Ahí puede ver una lista que contiene dos protos. El proto de tipo Overview proto define la (hasta ahora vacía) Tableview, que puede obtener a través de la opción de menú Documentos. El proto de tipo Utility Proto define el card. Queremos ajustar este proto. Lo abrimos pulsando sobre él. En la parte baja del proto puede ver las propiedades Campos and Widgets. Pulse en Crear. En la ventana que se abre, escoja el tipo de definición Definición de campo de texto y pulse OK. SE abre una nueva card, donde se explican las propiedades de la Definición de campo de texto. Etiquetado: Aquí puede definir qué etiqueta se mostrará a los usuarios. Escogemos Título del documento Texto de ayuda: Aquí puede definir un campo de texto, que se mostrará bajo el campo en gris. Un texto de ayuda facilita al usuario información en caso de que no sepa que debe informar en un campo. Escogemos Escriba un título para su documento. El título no debe coincidir con el nombre del campo. Entrada de datos por usuario: Aquí puede escoger si este campo debe ser opcional u obligatorio. Como todo documento debería tener un título y no queremos tener cards sin título, escogemos Obligatorio. Pulse Almacenar & Cerrar para finalizar la creación del campo. 6

7 10. Subir un documento Ahora puede subir su primer documento. En el menú principal, seleccione la opción Documentos y pulse el botón Crear. La nueva card abierta la ha diseñado usted! Escoja un título para su primer documento. Nosotros escogemos Documento de prueba. Pulse Almacenar Las opciones de la parte superior derecha de su pantalla han cambiado, y en la parte inferior, aparece una nueva Tableview. Para subir el documento, pulse Añadir en las nuevas opciones. Ahora puede escoger un documento para subirlo. Nosotros escogemos un nuevo documento creado con el nombre DocumentoDeTexto.txt. Este fichero está ahora visible en la Tableview. Pulse la opción Cerrar. 11. Hecho! Ha creado su primera aplicación y guardado su primer documento en ella. Durante este proceso, ha creado diferentes roles, definido propiedades de la aplicación, creado y modificado un proto y subido un primer documento. Puede crear otros protos (paso 8), añadir otros campos a un proto (paso 9) y subir más documentos (paso 10). También es capaz de exportar sus aplicaciones como una app ios. En el menú, pulse Import Export en la sección Administración y escoja Xcode Project for ios rollout. 7

8 Se genera un fichero.zip que puede almacenar. Al abrir el fichero.zip encontrará un fichero denominado README.md donde se explican todos los pasos adicionales. Ahora, le deseamos que disfrute su primera aplicación Protogrid! 12. Iniciar aplicaciones. Algunas aplicaciones están preinsataladas en su entorno. Distinguimos dos tipos de aplicaciones preinstaladas: 1. Aplicaciones de sistema 2. Aplicaciones de inicio Las aplicaciones Roles de usuarios y Usuarios de Entorno forman parte de las aplicaciones de sistema. Son necesarias para usar Protogrid, y no se pueden modificar. Las aplicaciones Documentos, Acciones y PPAD son aplicaciones de inicio. Estas aplicaciones tienen como objetivo darle una idea de las posibilidades de Protogrid. Puede modificar estas aplicaciones si lo desea. Le damos ahora una pequeña introducción de esas aplicaciones: La aplicación Documentos almacena documentos y ficheros de diferentes tipos. Hay un proto denominado Documento, que define que documentos tienen una categoría. El proto Subdocumento define documentos, que pertenecen a otro documento. Como ejemplo tenemos el documento Descripción del edificio perteneciendo a la categoría Información del edificio con un subdocumento para la Oficina central. La aplicación PPAD puede usarse para almacenar proyectos, personas, tareas, documentos y más y vincular esos elementos. Esto permite una rápida visión de las tareas abiertas, de las correspondientes personas y compañías, así como los documentos correspondientes. La aplicación «Acciones» almacena tareas simples. Puede proveer una descripción de la tarea, una fecha, una persona responsable y un estado. Esta simple aplicación le ofrece una visión rápida de todas las tareas abiertas que tiene. 8