Índice
Introducción
El Gestor de Recursos ha sido creado para simplificar y asistir a los usuarios de Blip en la creación de recursos personalizados dentro de la plataforma. La creación de estos recursos se realiza de manera sencilla e intuitiva, sin necesidad de interactuar con JSON.
A pesar de las ventajas significativas y la posibilidad de tener recursos dentro de la plataforma Blip para organizar, estandarizar y crear contenido que pueda ser fácilmente utilizado en el generador, el proceso de desarrollar un JSON puede resultar tedioso, llevando tiempo y resultando agotador según su tamaño. ¿Pero alguna vez has pensado que con acciones simples y básicas podrías crear un recurso para utilizar en la construcción de tu contacto inteligente sin necesidad de lidiar con JSON, aprovechando al máximo la herramienta y ahorrando tiempo y energía?
Aquí es donde entra en juego el Gestor de Recursos. Ahora puedes contar con él para ahorrar tiempo, mejorar la agilidad y la organización. Además, te permite importar, exportar y gestionar tus recursos de manera sencilla y eficiente.
¿Cómo funciona?
La extensión "Gestor de Recursos" ha sido desarrollada con el objetivo de simplificar, asistir y organizar la construcción de los contenidos de recursos en la plataforma Blip. Esto permite crear varios tipos de contenido sin la necesidad de
preocuparse por el JSON, ya que con tan solo unos clics, el propio gestor se encargará de ello.
Las siguientes funcionalidades están disponibles:
- Registro de recursos únicos personalizados.
- Registro de colecciones de recursos personalizados.
- Posibilidad de registrar recursos de diferentes tipos, como: texto, selección, lista de texto, lista de objetos, encendido/apagado y archivos.
- Importación de recursos e elementos a través de un archivo JSON.
- Listado de recursos registrados.
- Listado de elementos de cada uno de los recursos.
- Posibilidad de importar nuevos elementos a un recurso.
- Exportación de elementos y/o estructura de los recursos registrados.
Instalación
Para utilizar la extensión "Gestor de Recursos", debes acceder al contrato en el que deseas instalarla. Luego, ingresa a la Blip Store, abre la pestaña de "Extensiones" y busca "Gestor de Recursos". Una vez que lo encuentres, actívalo e instálalo.
Una vez activada e instalada, la extensión estará lista para su uso.
Manual de Uso
Usuarios con permisos de administrador tienen la capacidad de realizar todas las funciones de la extensión, las cuales incluyen el registro de recursos personalizados de diversos tipos, así como la importación y exportación de recursos, elementos y estructuras.
Una vez que la extensión "Gestor de Recursos" haya sido instalada y activada, y el usuario posea los permisos de administrador necesarios, al acceder a la misma, estará habilitado para utilizar la extensión y se encontrará con la siguiente pantalla:
En la pantalla inicial de la extensión, todos los recursos registrados se mostrarán en una lista. A través de esta pantalla, ya podrás realizar varias acciones, como registrar un recurso, copiar sus claves primarias, editarlos, eliminarlos o acceder a los datos de cada uno. También podrás importar nuevos recursos o incluso utilizar uno de ellos como referencia para registrar uno nuevo a través de la exportación. Es importante tener precaución al editar los datos y, sobre todo, al eliminar elementos. Las acciones son permanentes. Pero no te preocupes, en este tutorial, repasaremos todas ellas.
Además, te invito a ver este video de presentación de la extensión para que puedas entender un poco más sobre ella antes de continuar con el manual de uso:
Registro de Recursos e Ítems
En esta etapa, aprenderás cómo registrar un nuevo recurso, personalizado según tus necesidades. Después de crearlo, se mostrará en la lista de recursos y podrás acceder a él para gestionar tus ítems, incluso tienes la opción de registrar nuevos ítems.
Registro de Recursos
Paso 1) En la pantalla principal de la extensión Gestor de Recursos, deberás hacer clic en "Crear Recurso", como se muestra a continuación:
Una vez hecho esto, verás un modal donde podrás registrar tu recurso, como se muestra en el siguiente ejemplo:
Ahora que el modal ha aparecido, es importante completarlo de acuerdo a tu objetivo deseado.
Paso 2) Ingresa el nombre de tu recurso en el campo "Nombre". Esto se utilizará únicamente para que puedas visualizarlo de manera organizada.
Paso 3) Coloca en el campo "Clave" el nombre de la clave que deseas usar en tu recurso. La entrada que coloques en este campo se usará para recuperar el valor del contenido por parte del servidor.
Paso 4) Después de llenar los dos campos anteriores, deberás seleccionar el tipo de recurso que deseas crear. Puede variar entre una colección (conjunto de recursos) o un único recurso, como se muestra en la imagen:
La forma de registrar los dos tipos es muy similar, pero para evitar dudas, puedes obtener una comprensión más detallada sobre estos dos tipos en los siguientes videos:
Recurso del Tipo Colección:
Recurso del Tipo Único:
Paso 5) Una vez hecho esto, ahora podrás completar los campos deseados en tu recurso, como "Título", "Clave" y "Tipo". Donde el campo "Título" será solo para el nombre, el campo "Clave" se usará para recuperar el valor del contenido por parte del servidor, y el campo "Tipo" te permitirá elegir el tipo de campo deseado, que puede ser: texto, selección, lista de texto, lista de objetos, encendido/apagado y archivo. Como se muestra a continuación:
¿Cómo funcionan cada uno de los tipos de campos?
Todos los tipos de campos tienen algunas diferencias, pero comparten una característica en común: todos pueden ser utilizados.
Campo del Tipo Texto
Al optar por registrar un recurso con un campo de tipo texto, podrás agregar el texto deseado al recurso. Luego, podrás utilizar este texto en el contacto inteligente simplemente llamando a la clave del recurso registrado a través de la variable correspondiente que controla los recursos en Blip. Este tipo inserta un texto en JSON.
Campo del Tipo Selección
Al elegir registrar un recurso con un campo del tipo selección, podrás ingresar las opciones deseadas en el recurso. Cuando registres el ítem del recurso, podrás seleccionar una de las opciones proporcionadas en la creación. Este tipo inserta un texto en JSON.
Campo del Tipo Lista de Texto
Cuando registres un recurso con un campo del tipo lista de texto, después de completar el registro, simplemente haz clic en "Acceder a los datos", como se indica para todos los recursos que requieren selección y adiciones posteriores. Después de eso, haz clic en el botón de edición. Una vez hecho esto, se abrirá un modal donde podrás agregar los elementos de tu lista. Es importante recordar que este tipo de recurso inserta una matriz de textos en JSON. Si necesitas agregar otro elemento a la lista, simplemente haz clic en "Agregar".
Cuando hayas terminado, simplemente haz clic en el botón "Hecho". De esta manera, tu lista de texto se almacenará.
Una vez hecho esto, podrás ver tu lista de inmediato.
Campo del Tipo Lista de Objetos
Si deseas registrar un recurso con un campo del tipo lista de objetos, deberás insertar una matriz de objetos en JSON. Tan pronto como selecciones este tipo, el modal se expandirá mostrando también los campos del objeto que debes completar, como se muestra en la imagen:
Para completar esta información, simplemente sigue lo que se presentó anteriormente y ten en cuenta tus conocimientos sobre los tipos de campos. Si deseas agregar otro objeto, simplemente haz clic en "Nuevo campo" dentro del cuadro que hace referencia a él, como se muestra a continuación:
Campo del Tipo Encendido/Apagado
El campo Encendido/Apagado se refiere a un campo de tipo booleano, que puede tener valores verdaderos o falsos, activos o inactivos. Al optar por utilizarlo, ingresarás un valor booleano en JSON y podrás utilizarlo de diversas formas, como por ejemplo, para decidir si deseas realizar una encuesta de satisfacción al final de la atención o no.
Después de ingresar la información adecuada y finalizar el registro, deberás hacer clic en "Acceder a los datos" en el recurso deseado. Entonces podrás habilitar o deshabilitar el campo, resultando en verdadero (habilitado) o falso (deshabilitado), como se muestra en el ejemplo a continuación:
Campo del Tipo Archivo
No es una novedad que haya cierto trabajo al cargar un archivo en la nube para luego editarlo y poder usarlo en Blip. ¡Pero ahora tus problemas han terminado! Al optar por registrar un recurso con un campo de tipo archivo, podrás agregar el archivo deseado y, una vez registrado, podrás utilizar el enlace directamente desde Blip.
Después de haber registrado el campo del tipo archivo, simplemente haga clic en "Acceder a los datos" de su recurso y haga clic en el ícono del lápiz para editarlo.
Luego, aparecerá un modal en el que deberá hacer clic en el botón a continuación para cargar su archivo:
Una vez que haya subido su archivo, ya tendrá un enlace para él:
Después de eso, simplemente haga clic en "Hecho", y el archivo quedará registrado y el enlace ya estará disponible para su uso.
Listo, ahora que ya sabe cuáles son los tipos de recursos, solo debe completarlos correctamente para pasar al siguiente paso.
Paso 6) Ahora, con los datos del recurso completados, simplemente revise la información y, si todo está en orden, haga clic en "Hecho" y su recurso quedará registrado.
Por lo tanto, tu recurso estará ya disponible en la lista de visualización.
Registrando elementos
Paso 1) Para registrar elementos en tu recurso, deberás hacer clic en "Acceder a los datos" en el recurso deseado, como se muestra en la imagen:
Paso 2) Una vez hecho esto, simplemente selecciona el botón "Crear elemento":
Después de hacer clic en "Crear elemento", te encontrarás con un modal de registro que sigue los campos del tipo de recurso que creaste anteriormente.
Paso 3) Rellena los campos del modal de acuerdo al elemento deseado y haz clic en "Hecho", como se muestra en la imagen a continuación:
Después de hacer esto, podrás ver el elemento registrado en su recurso correspondiente.
Importación y Exportación de Recursos e Ítems
Siguiendo esta ruta, podrás importar recursos e ítems mediante un archivo JSON, que puede haber sido creado por ti o incluso exportado desde nuestra extensión. Para ayudarte, consulta el siguiente tutorial:
Aunque hayas visto el video, si aún tienes alguna pregunta, solo sigue los siguientes pasos:
Importando recursos
Paso 1) En la pantalla principal, haz clic en el botón "Importar", como se muestra en la siguiente imagen:
Paso 2) Una vez que hagas clic en "Importar", aparecerá un modal de importación, como se muestra en la imagen:
Por lo tanto, podrás colocar tu archivo JSON de dos formas, como se indica, arrastrándolo al modal o haciendo clic en el enlace sugerido y seleccionando el JSON deseado.
Paso 3) Una vez que coloques el JSON deseado, tendrás dos opciones, "Cancelar" y "Hecho". Si deseas detener el procedimiento, simplemente haz clic en "Cancelar", como se muestra en la imagen:
En este caso, si no deseas cancelar y deseas continuar con la importación, simplemente haz clic en "Hecho", como se muestra a continuación:
Si tu archivo JSON está en el formato correcto, se importará con éxito y podrás visualizarlo:
Importación de elementos
Tendrás la capacidad de utilizar archivos de importación para incorporar nuevos elementos al recurso. Inmediatamente, estos elementos serán procesados y añadidos a tu lista de elementos.
Paso 1) Para importar elementos a tu recurso, será necesario hacer clic en "Acceder a datos" en el recurso deseado, tal como se muestra en la imagen:
Paso 2) Después de hacer eso, simplemente selecciona el botón "Importar elementos":
Después de hacer clic en "Importar elementos", te encontrarás con un modal de importación, donde simplemente tienes que arrastrar o hacer clic en el enlace mostrado para agregar tu JSON.
Paso 3) Coloca tu JSON en el modal, como se muestra a continuación:
Si has seleccionado el archivo incorrecto, simplemente haz clic en el ícono de la papelera al lado y se eliminará. Sin embargo, si tu JSON está en el formato correcto, solo tienes que hacer clic en "Hecho" y tus elementos serán añadidos a tu recurso. Mira el ejemplo a continuación:
Exportando recursos
En esta etapa, comprenderás cómo exportar los datos de un recurso para utilizarlos en otro lugar o incluso importarlos en otro recurso en cualquier momento. Puedes exportar solo los elementos, solo la estructura del recurso o ambos. Al exportar, se creará un archivo JSON y se iniciará automáticamente la descarga.
Paso 1) Para exportar elementos de tu recurso, deberás hacer clic en "Acceder a los datos" en el recurso deseado, como se muestra en la imagen:
Paso 2) Después de hacer eso, simplemente selecciona el botón "Exportar":
Paso 3) Después de hacer clic en "exportar", deberás elegir qué deseas exportar, opta por la opción deseada, que puede variar entre "Elementos y Estructura", "Solo Estructura" y "Solo Elementos", como se muestra en el modal a continuación:
Luego de esto, podrás ver el archivo en tus descargas.
Extras
Además de lo que ya has podido ver en el tutorial, aquí hay algunos ejemplos básicos de botones también utilizados.
Para eliminar un recurso:
Para copiar las claves de un recurso:
Para editar un recurso:
Para visitar la documentación:
Soporte
Si tienes alguna pregunta o encuentras algún problema con la extensión, por favor contáctanos a través del correo electrónico blippartner@sharkdev.com.br o al número +55 (35) 98802-9321.
Vídeos de demostración
Podrá ver demostraciones en los siguientes videos:
- Extensão Gerenciador de Recursos - Blip - Apresentação
- Extensão Gerenciador de Recursos - Blip - Recursos de Tipo Unico
- Extensão Gerenciador de Recursos - Blip - Recurso do Tipo Coleção
- Extensão Gerenciador de Recursos - Blip - Importacao e Exportacao
Para obtener más información, acceda a la discusión sobre el tema en nuestra comunidad o los videos en nuestro canal. 😃