Day 6 ¿Que entendiste de los temas: Write Data with Custom Data Types y Query Your Data?

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.

    • Site: Para usuarios que tienen un Appian Login, es decir es para usuarios que cuenten con credenciales e inician sesión en la aplicación. Los sites siempre están hechos de acuerdo a las necesidades de cierto grupo de personas para que puedan completar su trabajo.
    • Portals: Para usuarios externos que no tienen acceso a la Appian App, es decir que es una web pública que permite ver y compartir información sin tener sesión iniciada..

    Sitios

    Son objetos construidos con las herramientas low-code.

    Se componen de:

    • Back-End
    • Front-End

    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::

    • Review Public Record
    • Registrarse para un evento
    • Pedir una cuenta
    • Request a Quote
    • Reportar información

    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.

    • Query: Es una expresión que te da acceso a información que mostraras basado en un criterio.
    • Query Editor: Una herramienta de Appian que nos permite crear y hacer test en Queries mediante una interfaz amigable.
    • Expression Rule: Una expresión almacenada que devuelve un valor el cual puede estar condicionado.

    Los queries se usan para llenar Forms, llenar opciones en un menú Dropdown, representar KPI.

    Los objetos a los que hacemos Query son:

    • Record Type (usamos “a!queryRecordType”): Se utilizan cuando se quiere mostrar Record Data.
    • Data Store Entity (usamos “a!queryEntity”, esto permite hacer query de información directamente de una base de datos)

    Hay dos formas de devolver información cuando hacemos query a un Record Type:

    • Selection Query: Devolver ciertos campos, es decir tuplas conteniendo información.
    • Aggregation Query: Devolver datos que han pasado por funciones Aggregate para obtener información basada en los records.

    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

    • Evitar valores nulos
    • Retornar datos entre dos fechas
    • Filtrar más de un solo campo

    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 # 7

    Step-by-Step # 7

    Step by Step #8

    Step-by-Step # 8

  • Fernando Fernández Morales

    Cree una experiencia de usuario con sitios y portales

    SITIOS

    Un sitio es una aplicación web donde los usuarios autenticados pueden acceder a sus datos y flujos de trabajo. La autenticación significa que estos usuarios deben iniciar sesión en Appian.

    Los usuarios pueden acceder a un sitio con una URL única o desde otros sitios. Cuando crea un sitio en Appian, el sistema genera una URL única y personalizable.

    Si un grupo de usuarios realiza la mayor parte o todo su trabajo en un sitio, puede configurar ese sitio como su página de inicio de usuario.

    Crear un sitio

    Al momento de crear el sitio se debe poner el nombre sin el prefijo de la aplicación, ya que se mostrará a los usuarios finales.

    Se deberán usar nombres cortos y significativos.

    Usa mayúsculas y minúsculas

    Appian usa el nombre para mostrar para construir un identificador de dirección web predeterminado para el sitio.

    Se puede crear primero el sitio y después la interfaz o viceversa

    Una vez que haya agregado una página, se crea el diagrama de jerarquía del sitio. Se mostrará cualquier interfaz, registro o acción utilizada en las páginas del sitio.

     

    Personalice un sitio para que coincida con su marca

    Se pueden ajustar los colores para que el diseño del sitio coincida con los de la marca

    Seguridad en un sitio

    Este nivel de seguridad controlará quién puede ver y editar su sitio

    Un usuario debe tener al menos permisos de Visor en un sitio para acceder a él.

    PORTAL

    Un portal es una aplicación web pública que permite a los usuarios sin un inicio de sesión de Appian ver y compartir información con un entorno de Appian. El acceso a un portal no requiere registro e inicio de sesión

    Casos de uso comunes

    En general, estos implican que los usuarios sin un inicio de sesión de Appian accedan a la información que necesitan y completen varias tareas de autoservicio.

    Un portal se crea utilizando las mismas herramientas de código disponibles en Appian Designer.

    Diseñará las interfaces y otros objetos que su portal pueda necesitar, y luego se usará el objeto del portal para agruparlos y publicar el portal como una aplicación web.

    Las configuraciones en las secciones Encabezado y Marca del objeto del portal le permitirán crear una experiencia de portal que sus usuarios puedan reconocer fácilmente.

    No necesita crear una contraseña para su portal. Un portal estará disponible para todos los que tengan la URL.

                    Configuración del portal

    Cuando se implementa un portal publicado en otro entorno, Appian lo publicara automáticamente.

    Se pueden agregar hasta 5 páginas en los portales.

    Se pueden aplicar logotipo y colores de la marca.

    Agregando una cuenta de servicio se puede conectarse a información y procesos seleccionados.

    Se puede ver el registro de actividad.

     

    La mejor manera de trabajar con datos en portales es usar Appian Records.

    Puede iniciar un proceso desde el portal configurando la interfaz subyacente con la función a!startProcess .

    Si su aplicación utiliza tipos de registros y desea que su portal muestre datos de Appian, configure la interfaz subyacente mediante la función a!queryRecordType

    Si su aplicación usa CDT, deberá crear una integración entre su aplicación y el portal, utilizando una API web y un objeto de integración.

     

    Publicación de un portal

    Solo necesita publicar su portal una vez. Después de publicarlo en su entorno de desarrollo, Appian publicará automáticamente el portal después de la implementación en un nuevo entorno.

    Si ya no desea que el portal esté disponible para los usuarios, puede anular su publicación fácilmente desactivando Publicar en la configuración del portal.

    Para limitar el acceso a un portal mientras trabaja en él, Appian agrega un UUID a las direcciones web de los portales en sus entornos de desarrollo y prueba. Esta configuración se puede cambiar en la Consola de administración.

    Una vez que se publica un portal, Appian lo volverá a publicar automáticamente si actualiza el objeto del portal.

     

    Consulta tus datos

                    Términos importantes

    Query = Una expresión que le permite acceder a sus datos para mostrarlos en diferentes partes de su aplicación.

    Query editor = Una poderosa herramienta que le permite crear y probar consultas utilizando una experiencia guiada.

    Expression Rule = Una expresión almacenada que devuelve un valor que puede estar influenciado por una o más entradas.

    ¿Qué es una consulta?

    Las consultas le permiten devolver datos en función de criterios específicos.

    Ejemplos

    Use una consulta para obtener datos del vehículo para mostrar en un formulario para actualizar la información de mantenimiento de un vehículo.

    Use una consulta para completar las opciones en un menú desplegable.

    Utilice los datos consultados en los componentes de la interfaz para mostrar indicadores clave de rendimiento.

    ¿Qué objetos consultar y porque?

    Record Type

    Consulta datos de un tipo de registro usando a!queryRecordType() . Esto le permite consultar datos de una base de datos, así como de Salesforce y otros servicios web cuando el tipo de registro tiene habilitada la sincronización de datos.

    Data Store Entity

    Esto le permite consultar datos directamente desde una base de datos. Se hace usando a!queryEntity()

     

    Consultas de selección

    Devuelven una sola fila de datos

    Consultas de agregación

    Devuelven las filas que tengan el valor en común filtrado

    a!queryRecordType() incluye los parámetros recordType, fields y pagingInfo. Entity es un parámetro de a!queryEntity().

    Generar una consulta de selección de entidad de almacén de datos

    1. Dentro de una nueva regla de expresión, inicie el editor de consultas seleccionando su icono ubicado en la parte superior del Editor de expresiones.
    2. Cambie la entrada Seleccionar fuente de datos a Data Store Entity
    3. Seleccione la constante que apunta a la entidad de datos que desea consultar
    4. Haga clic en CONTINUAR
    5. Desplácese hacia abajo hasta la sección Campos
    6. Haga clic en ELIMINAR TODO
    7. Haga clic en los campos que desea que se devuelvan
    8. Haga clic en CONSULTA DE PRUEBA
    9. Actualice las opciones de paginación y clasificación si es necesario
    10. Agregue condiciones de filtro si es necesario
    11. Haga clic en GENERAR CONSULTA
    12. Haga clic en REGLA DE PRUEBA y confirme que los resultados son los esperados
    13. Haga clic en GUARDAR CAMBIOS

     

    Agrupaciones de fecha

    Al agrupar por un campo de fecha u hora, puede configurar los parámetros de intervalo para agrupaciones directamente en el editor de consultas.

    Filtros de agregación en la medición

    Utilice el editor de consultas para configurar filtros en medidas al consultar un tipo de registro sin tener que editar una expresión a!queryRecordType().

    Filtro

    Un filtro le permite aplicar un conjunto de condiciones para que la consulta solo devuelva los datos que necesita.

                    Tipos de filtro:

                                   Filtrar valores nulos

                                   Devolver datos entre dos fechas

    Filtrar más de un campo

    Operador a!queryLogicalExpression()

    Puede usar otros operadores como “AND”, "OR" y "AND_ALL" directamente en el Editor de expresiones.

    Filtrar registros relacionados con a!relatedRecordData()

    Si está consultando un tipo de registro que tiene una relación de uno a varios, puede usar el parámetro relatedRecordData en su consulta para filtrar los datos devueltos por esa relación de uno a varios.

    Ordenar y limitar datos

    Si desea filtrar, clasificar o limitar los datos de registros relacionados de uno a varios, debe usar a!relatedRecordData() después de generar su consulta.

    Llamar a una regla de expresión

    Puede hacer referencia a sus consultas en todas sus aplicaciones para crear interfaces, informes, modelos de procesos y más.

    Usar una consulta de selección

    Un uso común de una consulta de selección es devolver un registro específico dada la identificación de ese registro.

    Este tipo de consulta es útil para probar interfaces, ya que se puede usar para crear casos de prueba basados ​​en registros con características conocidas.

    Usar una consulta de agregación

    Esta consulta se puede usar como etiquetas de elección y valores para un componente desplegable.

    Sin embargo, la consulta debe incluirse en una función index() con el parámetro index establecido


    Step-by-Step #7



    Step-by-Step #8

    Write Data with Custom Data Types
    CDT: Los CDT imitan la agrupación lógica de datos que se encuentran en su base de datos relacional y le permiten estructurar y escribir datos en su base de datos.
    Las aplicaciones generalmente se basarán en varias tablas de bases de datos y, por lo tanto, en múltiples CDT.
        Un almacén de datos conecta Appian con una base de datos relacional.
    Si una aplicación no tiene tipos de registro con la sincronización de datos habilitada, es probable que tenga varios CDT.
    Una aplicación sin tipos de registro con sincronización de datos habilitada necesita un almacén de datos para todas las tablas en una fuente de datos.
    El objetivo principal de un almacén de datos es conectar Appian a una base de datos externa.
    Hay cinco formas diferentes de crear un CDT
    •    Automáticamente cuando crea una acción de registro
    •    Tabla de base de datos existente
    •    Desde cero
    •    CDT existente duplicado
    •    Importar XSD
    Edición de un CDT
    Agregar campos
    Puede agregar un nuevo campo a su modelo de datos simplemente agregando un nuevo campo a la CDT.
    Edición de campos
    Complete las ediciones directamente en el archivo y luego cree una nueva versión del CDT a partir del archivo XSD actualizado. Los desarrolladores de Appian prefieren este enfoque porque proporciona más control sobre los CDT.
    •    Antes de editar los CDT, evalúe el impacto de sus ediciones en otros objetos. Utilice el botón Dependientes.
    •    El método más común para editar un CDT es implementar primero los cambios en la base de datos y luego actualizar el CDT usando el archivo XSD.

  • Crear una experiencia de usuario con sitios y portales

    Un sitio es una aplicación web diseñada para usuarios que tienen un inicio de sesión de Appian, mientras que un portal es una aplicación web para usuarios externos que no tienen un inicio de sesión para acceder a su aplicación de Appian.

    Sitios

    En el sitio los usuarios autenticados pueden acceder a sus datos y flujos de trabajo, en los cuales cada uno esta adaptado a las necesidades de trabajo de una persona.Proporcionan acceso rapido a las paginas, tareas o información que necesita, estos son obejtos con un front end que ven los usuarios finales y un back end que trabajan los diseñadores.

    Los usuarios pueden acceder a un sitio con una URL única o desde otros sitios. Cuando se crea un sitio en Appian, el sistema genera una URL única y personalizable. Los usuarios pueden marcar esa URL para facilitar el acceso.

    Para que un usuario pueda acceder al sitio, debe tener al menos permisos de visor para cada interfaz, informe, tipo de registro, modelo de proceso configurados como contenido de una pagina del sitio.

    Portal

    En un portal no se requiere un registro e inicio de sesión, por lo que se puede usar para que los usuarios se registren rápidamente en un evento, informen de un incidente o inicien un proceso de incorporación.

    Los portales se crean utilizando las herramientas low-code disponibles en Appian Designer, con las cuales se pueden diseñar interfaces y otros objetos que pueda necesitar nuestro portal y este se publique como una aplicacion web coherente en una URL publica.

    Al igual que los sitios, se pueden agregar hasta 5 paginas en un portal, los cuales necesitaran ciertos permisos para que los usuarios puedan interactuar, para controlar el acceso, se tiene que crear una cuenta de servicio, puesta esta actúa en nombre del usuario en el portal, proporcionando al portal permisos para conectarse a la información y los procesos seleccionados en Appian.

    La mejor manera de trabajar con datos en portales es utilizar Appian Records. Si su aplicación usa tipos de registro, puede implementar las funciones de Appian (a!startProcess y a!queryRecordType) para que los datos fluyan fácilmente entre su aplicación y el portal.

    Al momento de publicar un portal solo se hace una vez, pero antes de hacer esto se tiene que verificar que el entorno de destino este bien configurado, lo cual lo podemos verificar de la siguiente manera;

    • Compruebe que el entorno de destino tiene los grupos que utiliza el portal para los permisos.
    • Cree una cuenta de servicio con el mismo nombre que la cuenta de servicio en el entorno de origen.
    • Configure permisos para la cuenta de servicio que coincidan con los del entorno de origen.

    Una vez que se haya verificado lo anterior, podemos publicarlo para que Appian después lo pueda implementar en un nuevo entorno. Una vez publicado un portal, Appian lo volverá a publicar automáticamente si actualiza el objeto del portal o cualquier objeto precedente. Este comportamiento garantizará que el portal publicado esté actualizado con los cambios más recientes.

    Consulta tus datos

    • Query: Expresión para acceder a los datos y sean mostrados en diferentes partes de la aplicación (Consulta).
    • Query editor: Herramienta que permite crear y probar consultas.
    • Expression Rule: Expresión almacenada que devuelve un valor que puede estar influenciado por una o más entradas.
    • a!queryRecordType(): Permite consultar datos de una base de datos, asi como Salesforce y otros servcios web
    • a!queryEntity(): Permite consultar datos directamente desde una base de datos.

    Step-By-Step #7

    Step-By-Step #8

  • Create a User Experience with Sites and Portals

     

    Diferencia entre Site y Portal

     

    Site

    Un site es una aplicación web donde los usuarios autenticados pueden acceder a sus datos y flujos de trabajo. La autenticación significa que estos usuarios deben iniciar sesión en Appian

     

    Desde la perspectiva del desarrollador, se recomienda lo siguiente: Diseñar diferentes sites para diferentes grupos de usuarios y adaptará cada site a las tareas y actividades particulares de cada grupo.

     

    Un sitio puede contener hasta cinco paginas

     

    Portal

    Un portal es una aplicación web pública que permite a los usuarios sin un inicio de sesión de Appian ver y compartir información con un entorno Appian

     

    What is a site

     

    Sites son objetos creados con herramientas de código bajo en Appian Designer.

     

    Access and Navigate a Site

     

    Al crear un  site in Appian, El sistema genera una única y personalizada  URL

     

    Si muchos usuarios trabajan en un mismo sitio se puede definir por default como su start page a traves de la Administration Console

     

    Create a Site

     

    Al crear un sitio hay que considerar que

     

    • Que los Site names son internos y no serán vistos directamente por los usuarios finales(end users). Iniciar el site name con el prefijo de la aplicación(application prefix)

     

    • No inicie el display name con el prefijo de la aplicación(application prefix), porque los usuarios finales(end users) verán todo el display name.

    • Utilice un nombre corto(short name) que sea significativo para sus los usuarios finales(end users)

     

    • Usar title case

     

    Appian utiliza el display name para construir un default web address identifier para el site. Para refinar el site URL debemos editar el default web address identifier.

    Customize Site Branding

    Al configurar nuestro Site branding debemos evitar ocupar los siguientes colores:

     

    • Negro
    • White
    • Gray
    • Green
    • Red

    Una pagina en un site puede contener:

     

    • Action
    • Interface
    • Record List
    • Report.

     

    Establish Site Security

    Un usuario debe tener al menos permisos de viewer en un sitio para acceder a él.

    Portals

    Por definición es :

    Aplicación web pública que diseñada para conectar a los usuarios con los datos y workflows que ya tienes en Appian, sin necesidad de que inicien sesión

    Casos de uso comunes para los portals:

    1. Review public records

     

    1. Register for an event

     

    1. Request an account

     

    1. Request a quote

     

    1. Report information

     

    High-Level Workflow

    De la misma forma que un site un portal puede tener hasta 5 paginas

     

    Para proteger a tu portal debes de crear una cuenta de servicio (Service Account)

    La cual actúa en nombre de los usuarios del portal, proporcionando al portal permisos para conectarse a la información y los procesos seleccionados en Appian

     

    Todos los portales necesitas un portal object y al menos una interfaz

     

    Para comenzar un proceso desde nuestro portal debemos ocupar la funcion

    a!startProcess

     

    Publishing a Portal

     

    Consideraciones antes de publicar un Portal

     

    Solo necesita publicar su portal una vez

    • Compruebe que el entorno de destino tiene los grupos que utiliza el portal para los permisos.
    • Cree una service account con el mismo nombre que la service account en el entorno de origen.
    • Configurar permisos para la cuenta de servicio que coincidan con los del entorno de origen

     

    Unpublish a portal

    Si ya no se desea que el portal esté disponible para los usuarios, puede anular su publicación fácilmente desactivando 'Publicar' en el objeto del portal

    Testing and Access portal

    Debe publicar el portal para probarlo completamente, lo que significa que cualquier persona con la dirección web puede acceder a su portal.

    Updating a portal

    Una vez publicado un portal, Appian lo volverá a publicar automáticamente si actualiza el objeto del portal o cualquier objeto precedente.

     

    Query Your Data

    Las Queries son usadas para devolver datos basados en un conjunto específico de criterios.

    Puede consultar un tipo de registro o directamente a una base de datos relacional mediante un data store entity (DSE).

    Terminos importantes

    Query :

    Una expresión que le permite acceder a sus datos para mostrarlos en diferentes partes de su aplicación

    Query Editor:

    Una potente herramienta que permite crear y probar consultas mediante una experiencia guiada.

    Expression rule

    Expresión almacenada(stored expression) que devuelve un valor que puede estar influenciado por una o más entradas.

    Puedes hacer una query hacia dos tipos de objeto

    Record Type: Usando a!queryRecordType(). Esto le permite consultar datos de una base de datos, así como de Salesforce y otros servicios web cuando el tipo de registro tiene habilitada la sincronización de datos.

     

    Utilizar cuando necesitas ver datos en Interfaces, Reports Record views

    Data Store Entity: Usando a!queryEntity(). Esto le permite consultar datos directamente desde una base de datos.

    Query Methods

    Los parametros groupings y measures nos permiten realizar "aggreation"

    Apply Filters

    Podemos aplicar filtros en el query editar mediante la opcion "add filter"

     

    Un filtro le permite aplicar un conjunto de condiciones para que la consulta solo devuelva los datos que necesita.

     

    a!relatedRecordData()

     

    Si está consultando un tipo de registro que tiene una relacion de  one-to-many , Puedes utilizar el botón relatedRecordData parameter en la consulta para filtrar los datos devueltos.

     

    Sort and Limit Data

    Podemos Ocupar Sort para mostrar nuestra vista de manera ascendente o descendente

    Ejercicios Step by step 7 y 8

     

    Podemos ocupar Limit para acortar nuestra vista a una cantidad de registros especifica

    Use Queries in your applications

     

    Como práctica recomendada, se recomienda crear consultas en una regla de expresión(expression rule) para que sea más fácil mantener y hacer referencia a su consulta. 

    PDF

  • Jesús Reyes Hernández

    Experiencia de Usuario Personalizada y Centrada

    Un sitio es una interfaz definida personalizada para un conjunto preciso de usuarios que se centran en un conjunto particular de actividades. 

    Acceder y navegar en un sitio

    Cuando se crea un sitio, Appian genera una URL única y personalizable que se puede compartir con el usuario o grupo que utilizará el sitio.

    Los sitios también se pueden acceder a través de otros sitios.

    Una vez que haya agregado una página a su sitio, se creará el diagrama de jerarquía del sitio. Se mostrará cualquier interfaz, registro o acción utilizada dentro de las páginas del sitio. Si una página usa un modelo de proceso o un informe, también verá la interfaz detrás de él en el diagrama. Esto le permite comprender fácil y rápidamente las estructuras de cualquier sitio.

    Un portal es una aplicación web pública que permite a los usuarios sin un inicio de sesión de Appian ver y compartir información con un entorno de Appian.

    Seguridad del sitio

    Establecer la seguridad del sitio nos ayudará a controlará quién puede ver y editar su sitio.

    El usuario debe tener visibilidad de las páginas del sitio y al menos permisos de Espectador para cada interfaz, informe, tipo de registro, modelo de proceso y dato subyacente configurados como el contenido de una página del sitio.

    Portales

    Un portal es una aplicación web pública que diseñará para conectar a los usuarios con los datos y flujos de trabajo que ya tiene en Appian, sin necesidad de que inicien sesión.

    Casos de usos para los portales:

    • Revisar Registros Públicos
    • Regístrese para un evento
    • Solicitar una cuenta
    • Solicitar presupuesto
    • Informe de información

    El objeto del portal le permitirá orquestar todos los objetos de soporte (interfaces, modelos de procesos y otros) en un portal de trabajo.

    Publicar un portal

    Solo necesita publicar su portal una vez. Después de publicarlo en su entorno de desarrollo, Appian publicará automáticamente el portal después de la implementación en un nuevo entorno.

    Cualquier persona con la dirección web puede acceder a su portal. Para limitar el acceso a un portal mientras trabaja en él, Appian agrega un UUID a las direcciones web de los portales en sus entornos de desarrollo y prueba.

    Step-by-step #7

    Consulte sus Datos

    Las consultas le permiten devolver datos en función de criterios específicos. Puede usar esos datos devueltos para:

    • Rellenar un formulario
    • Completar opciones
    • Representar un KPI (Indicadores Clave de Desempeño)

    Puede consultar dos tipos de objetos:

    • Tipos de registros
    • Entidad de almacenamiento de datos

    Aplicar filtros

    Se pueden crear consultan añadiendo filtros para que no muestre la información requerida.

    Algunos ejemplos de filtros son:

    • Filtrar valores nulos
    • Devolver valores entre dos fechas
    • Filtrar más de un campo

    Puede utilizar el operador a!queryLogicalExpression() en los filtros para usar operadores como:

    • AND
    • OR
    • AND_ALL

    Si está consultando un tipo de registro que tiene una relación de uno a varios, puede usar el parámetro relatedRecordData en su consulta para filtrar los datos devueltos por esa relación de uno a varios.

    Clasificar y limitar datos

    Esto le permitirá organizar los resultados de su consulta de una manera poderosa para presentar datos utilizables a los usuarios sin necesidad de que interactúen con una cuadrícula o gráfico para tomar sus propias decisiones de clasificación. También puede limitar cuántos registros se devuelven.

    Utilizar consultas en las aplicaciones

    Puede llamar a las reglas de expresión en todas sus aplicaciones. Esto le permite mostrar los resultados de sus consultas en interfaces, informes, modelos de procesos y otros objetos.

    Ejemplo de consulta de selección

    Este tipo de consulta es útil para probar interfaces, ya que se puede usar para crear casos de prueba basados en registros con características conocidas.

    Utilizar consultas de agregación

    Step-by-step #8

  • Isaac Balam Lira Ramírez

    Write data with Custom Data Types

    Un Custom Data Type es un objeto user-definied data que estructuralmente imita una agrupación lógica de información creada en una tabla de una base de datos. Este objeto en conjunto con el almacenamiento de datos es lo que nos permite estructurar y escribir datos en una base de datos.

    La Data Store es una conexión que comunica los cambios de los record data desde un CDT hacia una base de datos.

    Si nuestra aplicación no cuenta con data sync activado deberemos usar CDT en lugar de Record Variables para actualizar, insertar o borrar datos en la base de datos.

    Para crear un CDT podemos hacerlo de las siguientes maneras.

    • Crear uno de manera automática cuando creamos un Record Type
    • Crear un CDT a partir de una tabla existente de una base de datos
    • Crear un CDT desde cero conjurando todas sus propiedades
    • Duplicar  un CDT ya existente
    • Importar un archivo XSD

    Cuando creamos un CDT es importante añadir el prefijo de nuestra aplicación al namespace, por ejemplo, “urn:com:appian:types:PREFIJO”. Los nombres de los CDT no llevan espacios en su lugar se usan guiones bajos “PREFIJO_nombre”. Todos los CDT deben tener una llave primaria.

    Los CDT heredan la seguridad de los objetos que lo usan. La Data Store se debe actualizar cada vez que te conectas a una nueva tabla para escribir.

    Se pueden editar los CDT pero hay que tener cuidado de configurar correctamente ya que recordemos que los CDT tienen relación con el Data Store.

    Appian Developer Project: Build an IT Application

    Nos da una simulación en un entorno controlado de cómo desarrollar una aplicación en Appian.

  • Jesús Reyes Hernández

    Write Data with Custom Data Types

    Un tipo de datos personalizado es un objeto de datos definido por el usuario que imita estructuralmente la agrupación lógica de datos relacionados creados dentro de la tabla de su base de datos relacional. Es, junto con el almacén de datos, lo que le permite estructurar y escribir datos en la base de datos.

    Si la aplicación usa tipos de registro sin la sincronización de datos habilitada, debe usar CDT en lugar de variables de registro al actualizar, insertar o eliminar datos de las tablas de la base de datos.

    Los CDT imitan la agrupación lógica de datos que se encuentran en su base de datos relacional y le permiten estructurar y escribir datos en su base de datos.

    Las aplicaciones generalmente se basarán en varias tablas de bases de datos y, por lo tanto, en múltiples CDT.

    Un almacén de datos conecta Appian con una base de datos relacional.

    5 formas de crear un CDT:

    • Automáticamente cuando crea una acción de registro
    • Tabla de base de datos existente
    • Desde cero
    • CDT existente duplicado
    • Importar XSD

    Todos los CDT a los que se hace referencia en un almacén de datos deben tener una clave principal.

    Un almacén de datos es responsable de la conexión de la aplicación a una base de datos relacional.

    Por lo general, una aplicación tendrá un almacén de datos para todas las tablas en una fuente de datos específica.

    Los CDT se agregan al almacén de datos como entidades.

    Vuelva a publicar el almacén de datos cada vez que agregue una nueva entidad.

    Configure la seguridad de su almacén de datos correctamente. Una configuración incorrecta podría impedir que los usuarios comerciales actualicen los datos en la tabla conectada.

    Antes de editar los CDT, evalúe el impacto de sus ediciones en otros objetos. Utilice el botón Dependientes.

    El método más común para editar un CDT es implementar primero los cambios en la base de datos y luego actualizar el CDT usando el archivo XSD.

  • Welcome to Write Data with Custom Data Type

     

    Custom data type

    Es un objeto de datos definido por el usuario que imita estructuralmente la agrupación lógica de datos relacionados creados dentro de la tabla de la base de datos relacional. Junto con el almacén de datos, es lo que le permite estructurar y escribir datos en la base de datos.

     

    Data Store

    El almacén de datos es la conexión que comunica los datos de registro modificados de un CDT a una base de datos relacional.

     

    Hay cinco firmas de crear un CDT

     

    Automatically when You Create a Record Action

    Appian puede generar automáticamente acciones de registro comunes para ese tipo de registro utilizando la información básica que usted proporcione.

    Existing Database Table

    Se creará un CDT para usted con todas las configuraciones necesarias para asignar automáticamente a esa tabla.

    From Scratch

    Crear un CDT desde cero requerirá que agregue cada campo de datos y configure los parámetros, incluidos: nombre, tipo, longitud, matriz y clave.

    Duplicate Existing CDT

    Todas las configuraciones existentes en el CDT original, incluidas las anotaciones de JPA, se duplicarán.

    Import XSD

    Utilice esta opción si tiene un archivo XSD que define su CDT.

    Editing a CDT(Adding Fields)

    Se puede modificar o añadir campos a tu CDT

    Editing Fields

    Antes de editar un campo en tu CDT debes de utilizar la opciones de dependants para ver el impacto que esto podria tener

  • Escribir datos con tipos de datos personalizados, me va a ayudar a imitar la estructura lógica de los datos creados en mi BD relacional, será lo que me va a permitir crear datos en mi base de datos. El DSE  es la conexión que comunica los datos de registros modificados desde un CDT a una base de datos relacional, y ayudará a conectar el proceso a la BD.

    En propias palabras, el CDT será la estructura o escritura de los registros, ya sea para una solo lectura o para una interface, y el DSE será el encargado de conectar toda esa información en mis procesos.

    No siempre vamos a partir desde un Record Type, las aplicaciónes pueden ser iniciadas con múltiples CDT´s y su DSE.

    Los CDT pueden ser creados desde cero, cuando creamos una acción de registro (fácil y no recomendable), desde una tabla de BD existente (recomendable), se puede duplicar una CDT existente o importando un XSD (solo admin).

    Para consultar nuestros datos existen 2 métodos:

    • Consulta de selección: devuelve registros por separado
    • Consulta de agregación: que devuelve grupos y mediciones, permiten agrupar campos por valor especifico

    También se permite el uso de filtros, que nos van a permitir ordenar nuestros datos de acuerdo a las necesidades comerciales y con un conjunto de condiciones.

    Es importante saber que primero debemos crear nuestra constante (query) apuntando a nuestro CDT y después nuestra regla de expresión para conectar nuestro DSE.

    Hecho por: Josué Quintero Silva

     

  • DIA 5

     

    Un process Model sólido debe ante todo tener un número razonable de nodos y variables de proceso,  debe estar configurado para expirar o ser reasignado después de un tiempo de inactividad. Un proceso largo debe dividirse en start processes o subprocesses. 

     

    Un proceso … 

    • Puede  crearse de inicio o duplicar alguno.  
    • Debe usar grupos para su seguridad 
    • Debe usar niveles de seguridad de administrador y viewer 
    • El administrador es el nivel mas alto 
    • Viewers pueden ver e iniciar un proceso pero no puede modificarlo. 

    Los Smart services son 

    • Send E-mail 
    • Integrate with web services 
    • Excecute robotic processes 

    Un proceso se debe archivar por tres días, y se debe establecer un deadline por cada nodo para que nunca se quede atorado, siempre debemos preveer que el procesos de terminarse. 

     

    Para los modelos de proceso: 

    • Para diseñar un modelo de procesos ejecutable podemos usar el designer view. 
    • Use the analytic view  para crear diagramas de alto nivel  de procesos 
    • Appian provee  a los desarrolladores con nodos de flujo, y procesos inteligentes de automatización. 
    • No olvide configurar alertas y data management en los procesos.