Day 6 ¿Que entendiste de los temas: Write Data with Custom Data Types y Query Your Data?
Discussion posts and replies are publicly visible
Isaac Balam Lira Ramírez
Create User Experience with Sites and Portals
Recordemos la diferencia entre un site y un portal.
Sitios
Son objetos construidos con las herramientas low-code.
Se componen de:
Acceder a un sitio
Los usuario acceden a los Sites con una URL única para cada uno, esta URL se genera automáticamente cuando se crea un sitio y se puede personalizar. Se puede personalizar la URL a la que acceden inmediatamente después de iniciar sesión.
Para navegar en el sitio se cuenta con una barra de navegación la cual contiene todas las páginas en un sitio, además se le permite al usuario acceder a otros espacios de Appian y a su Perfil.
Crear un Site
New > Site > Fill fields > Set Security > Configure > Save Changes.
Cuando creamos un Site debemos usar el prefijo para su nombre interno pero no para su display name.
Administra el contenido de un Site
Los sitios pueden tener hasta 5 tabs para páginas y las páginas pueden contener una acción, una interfaz, un reporte o un Record.
Para añadir una página podemos ir a la sección pages de un site y Add Pages, y configuramos los parámetros de la página como página y web address identifier entre otras configuraciones. Podemos crear interfaces antes de crear un sitio o incluso podemos crear el sitio primero.
Planear cómo se va a navegar en una página puede ser tardado, sin embargo se puede usar la vista jerárquica para ver cómo están relacionados los objetos dentro de un site y de esta forma podemos darnos una idea de su estructura.
Para actualizar una página rápidamente podemos activar la opción Show Objects y de esta forma podemos ver el objeto y abrir sus propiedades desde la vista.
Personalización
Se puede personalizar como luce de manera general un site para que tenga otros espectros de color o incluso cambiar los diseños.
Seguridad
Podemos configurar el nivel de seguridad de los objetos en un sitio; dicho nivel de control indicará quién puede ver o editar tu sitio.
Nora: Para que alguien pueda acceder a un sitio debe tener al menos permisos tipo Viewer
Portals
Los usos comunes para los portales son los siguientes::
Los portales también se crean con las herramientas low-code, solamente tienes que diseñar las interfaces y objetos que necesite tu portal, después se usa el objeto Portal para unirlas y publicar el portal como una web app
En su forma más simples los portales son una o más interfaces creadas en Appian y puestas en un URL público, aunque también puede contar con ciertos objetos de diseño.
Crear Portal
New > Portal > Fill fields > Create > Security > Save > Configure > Save Changes
Si nuestra aplicación trabaja con Records podemos usar “a!startProcess” o “a!queryRecordType” para hacer que fluyan los datos entre el portal y nuestra aplicación.
Query your data.
Los queries se usan para llenar Forms, llenar opciones en un menú Dropdown, representar KPI.
Los objetos a los que hacemos Query son:
Hay dos formas de devolver información cuando hacemos query a un Record Type:
Como generar un Record Type Selection Query
Tenemos que generar una Expression Rule y dentro de la s opción en la parte donde se escribe la regla debemos seleccionar el Query Editor. Después de eso necesitamos seleccionar la fuente de la información y editar a nuestro gusto qué campos serán devueltos, que filtros aplicar, etc.
Create Expression > Open Query Editor > Select Data Source > Select Fields to Include > Test Query > Generate Query
Actualizar Query
Para modificar un query solo es necesario abrir la expresión y seguido de ello abrir el Query Editor y realizar los cambios
Como Generar un Data Store Entity Selection Query
Nota: Cuando se quiere generar este tipo de Query es importante seleccionar una constante que apunte a la data store entity.
Parecido a como creamos el Query con el recorType hacemos el procedimiento pero cuando elegimos la data source, seleccionamos Data Store Entity y ponemos la constante que apunte a ella. Después de ello veremos que el Query quiere devolver todos los datos en la entidad por lo que borramos todos los campos y seleccionamos solo los que deseemos devolver, después continuamos con las opciones de configuración y generamos el Query.
Aggregate Queries
Para crear un Aggregate Query de un Record Type el procedimiento es similar en la primera parte de la creación pero cuando hacemos la configuración de campos debemos seleccionar Aggregate Record y ahí podemos configurar los campos por los que vamos a agrupar y cómo serán tratados.
Aplicar filtros
Para filtrar los Query después de que se generan usamos a!relatedQueryData.
Para aplicar filtros en el Query Editor, nos vamos a la pestaña filtro y seleccionamos añadir filtro y especificamos las condiciones del filtro.
Los filtros los puedes aplicar para
Operador “a!queryLogicalExpression”
Podemos personalizar el operador con el que se trabaja, por ejemplo cuando necesitan cumplirse dos condiciones se usa “And”, cuando se necesita que se cumpla una condición se usa “Or”, etc.
Filtrar con Related Record
Se usa la función “a!relatedRecordData” y se añade antes de “pagingInfo” en un query tipo RecordType.
Ordenar y limitar data
Podemos usar la pestaña Sort and Limit para seleccionar de qué forma queremos hacer la ordenación a partir de uno o varios campos, y decidir cuántos valores debe devolver nuestro query. Podemos añadir el ordenamiento mediante “a!sortInfo”.
Podemos utilizar la Related Data para ordenar de igual manera debemos incluir sor dentro de “a!relatedRecordData”
Usar Queries
Para usar nuestros queries se recomienda crearlos en Expression Rules para poder referenciarlos y hacerlos más fáciles de mantener. De esta manera podemos usarlos en interfaces y demás objetos necesarios.
Step by Step #7
Step by Step #8