Contenido
- Lista de plantillas
- Creación de plantillas
- plantillas de copia
- Eliminar plantillas
- Plantillas de pedido
- Condiciones de transacción en orden
- Editar una plantilla
- Panel de detalles
- Panel de datos
- Panel de editor
- Panel de errores
- Panel de vista previa (no disponible en TemaPltes del tipo de pedido)
- Panel de documentación
- Pestaña de probador de reglas (solo disponible para el tipo de pedido)
- Guardar y reversiones
- Plantilla de impresión en agencias
Imprimir plantillas
Puede habilitar plantillas de impresión en el área de administración Configuración de impresión. Una vez habilitado, puede seleccionar una colección de plantillas de la lista. Observe que la mayoría de las colecciones de plantillas se usan solo en el canal de backoffice para fines de impresión y para otros canales o para adjuntar al correo electrónico se utilizará la colección "predeterminada".
Una vez que habilite las plantillas de impresión, puede crear sus propias plantillas. Puede comenzar copiando una plantilla existente desde cualquiera de las colecciones (recomendadas) o intentarlo desde cero.
Escribe las plantillas usando la notación JSON que necesita la biblioteca MakEPDF mientras usa LiquidJS para la sintaxis de plantilla.
El líquido se mejora con algunas extensiones propietarias de Betterez que harán que algunas cosas sean más fáciles, como mostrar cantidades monetarias y tratar con problemas de multicurrencias.
Navegue a Administración> Impresión> Imprimir plantillas.
Puede configurar Imprimir plantillas anulaciones para usar diferentes impresoras para diferentes configuraciones de plantillas de impresión. Esto es útil cuando tiene diferentes impresoras para diferentes tipos de boletos o documentos.
Lista de plantillas
La lista de plantillas mostrará todas las plantillas para la colección de plantillas predefinidas (predeterminada, Zebra, Epson, etc.) y cualquier plantilla personalizada definida a nivel de cuenta.
La lista de plantillas mostrará los temaplatos enumerados por relevancia, desde Higer hasta menor relevancia. Esto indicará qué plantilla se utilizará al imprimir un producto o artículo específico.
Las plantillas en las colecciones de plantillas predefinidas no se pueden editar o eliminar, pero se pueden copiar y una vez copiadas se pueden modificar.
Una propiedad importante que se muestra en esta lista es el estado de la plantilla, si el estado de la plantilla es borrador esa plantilla no se usará incluso si es relevancia es más alta que otras plantillas. El estado debe ser publicado para poder usarlo. Puede editar el estado en el editor de plantillas.
Creación de plantillas
Haga clic en el botón Agregar nuevo en la parte superior derecha de la pantalla.
Puede crear plantillas personalizadas para una combinación específica de impresora y producto. Seleccione la impresora, el producto y proporcione un nombre. Una vez creado, podrá comenzar a editar la plantilla y obtener una vista previa de los resultados en el editor de la construcción de plantillas.
Déle a la plantilla un nombre descriptivo para que pueda encontrarlo fácilmente en la lista de plantillas.
Seleccione el tipo de plantilla.
Si selecciona el tipo de "producto", verá dos opciones más.
La familia del producto (requerida) y el producto.
- Observe que el regreso abierto se muestra aquí como una familia de productos. Mientras que en realidad es un sabor de la familia de reservas, debemos mostrarlo aquí para poder diseñar plantillas específicas utilizadas para imprimir la parte de devolución abierta de ese tipo de reservas.
Las segundas opciones que se muestran se llenarán con los productos de la familia seleccionada anterior. Esto le permitirá diseñar plantillas personalizadas para un producto específico.
Esta opción se puede dejar vacía.
Para la opción de canales, si desea usar estas plantillas en todos los canales, déjelo como cualquier otro, o seleccione un canal específico.
La propiedad del consumidor indica si el tempalte será utilizado por todos los consumidores (cualquiera), solo la impresora (impresora) o cuándo el PDF se envía como un archivo adjunto en un correo electrónico (archivo adjunto).
- Vea a continuación cómo usar el editor de plantillas
plantillas de copia
Otra forma de crear una nueva plantilla es copiar una existente y modificar sus propiedades y la plantilla según sea necesario.
Puede modificar todas las propiedades de una plantilla después de hacer clic en el botón Copiar en la lista y aceptar copiar la plantilla.
Una vez guardada, la plantilla se mostrará en la lista como una plantilla "personalizada"
- Vea a continuación cómo usar el editor de plantillas
Eliminar plantillas
Puede hacer clic en el icono "Eliminar" en el lado derecho de una plantilla personalizada
Se mostrará una confirmación, haciendo clic en "Eliminar" eliminará la plantilla.
Esta acción no es reversible
Plantillas de pedido
Las plantillas de pedido son un tipo especial de plantillas consideradas meta plantillas.
Esta plantilla tiene un objeto de ítems 'y cada
propiedad' en el objeto de elementos se refiere a una plantilla real que debe imprimirse al imprimir el pedido.
El valor en las propiedades debe ser un objeto vacío, excepto la propiedad [de transacción](#transacciones-Condiciones en orden) que es un caso especial, ver más abajo
Por el momento, las propiedades compatibles son:
"transaction": {}
"pinpad": {},
"invoice": {},
"reservations": {},
"tickets": {},
"flexpasses": {},
"redeemableItems": {},
"paid_ins": {},
"parcels": {},
"gift_certificates": {},
"refunds: {}
Condiciones de transacción en orden
La propiedad Transaction
puede tener un objeto con la propiedad' Condiciones '.
Las reglas de soporte de Condiciones
en la forma aceptada por json-rules-ingine
El orden predeterminado tiene las siguientes reglas:
"conditions": {
"any": [
{
"fact": "parcels",
"operator": "greaterThan",
"value": 0,
"path": "$.length"
},
{
"fact": "refunds",
"operator": "greaterThan",
"value": 0,
"path": "$.length"
},
{
"fact": "flexPasses",
"operator": "greaterThan",
"value": 0,
"path": "$.length"
},
{
"fact": "transaction",
"operator": "greaterThan",
"value": 0,
"path": "$.transactionFee"
},
{
"fact": "transaction",
"operator": "lessThan",
"value": 0,
"path": "$.transactionFee"
},
{
"fact": "transaction",
"operator": "contains",
"value": "item",
"path": "$.summary[*].productFamily"
},
{
"fact": "transaction",
"operator": "contains",
"value": "loan",
"path": "$.summary[*].productFamily"
}
]
}
Esto significa que una transacción se imprimirá en un pedido si el pedido contiene al menos un paquete, reembolso o FlexPass.
O cuando el valor transacción.transactiofee
no es cero.
O cuando en el resumen de la transacción hay al menos un artículo con la empresa de productos de 'item o' préstamo
.
Observe la propiedad Path
en las reglas, siguen la sintaxis JSON-PATH.
Editar una plantilla
- Para orden plantillas ver arriba.
El editor en compuesto de cuatro paneles principales.
Los detalles y el panel de datos a la izquierda, el editor y el panel de erros en el centro, y el panel de vista previa y de documentación a la derecha.
Panel de detalles
Puede cambiar el nombre, el canal y, lo más importante, el estado de la plantilla. Una vez que cambie cualquiera de los valores, asegúrese de hacer clic en Guardar en la esquina superior derecha del editor.
Panel de datos
Tipo | Familia de productos | ID de |
---|---|---|
Transacción | Transacción | |
voucher | voucher | |
Certificado de regalo | Certificado de regalo | |
SRR | Reseervación con SSR | |
factura | factura | |
Locationclosure | Locationclosure | |
Manifiesto | Manifiesto | |
Orden | Orden | |
Parcelmanifest | Parcelmanifest | |
PassengersManifest | PassengersManifest | |
Balance de arranque | Balance de arranque | |
Producto | Reserva | Boleto |
Producto | Boleto | Boleto |
Producto | Paquete | Artículo de paquete |
Producto | Pase flexible | Pase flexible |
Producto | Pagado en | Pagado en el artículo |
Producto | Pagado | Artículo pagado |
Producto | Paquete | Artículo canjeable para un paquete |
Producto | Regreso abierto | Artículo redimible para una devolución abierta |
Una vez que ingrese el ID de elemento, puede hacer clic en el botón de carga y el editor intentará cargar la información para el tipo de plantilla en función de la ID.
Si la identificación del artículo es incorrecta, no imprimible o el estado no está disponible (ejemplo, ticket cancelado o cambiado). Verá el error anterior.
Si el ID es el correcto, los datos se mostrarán expandidos de forma predeterminada. Los datos mostrados serán diferentes en función del tipo de plantilla en la que está trabajando y representa todos los datos que la plantilla tendrá disponible.
Una vez que se cargan los datos, el panel de vista previa mostrará una vista previa de la plantilla utilizando los datos en este panel.
Tenga en cuenta que en algunos casos puede usar diferentes ID para diferentes elementos que pueden tener diferentes características, incluso si pertenecen al mismo producto y tipo. Por ejemplo: las reservas en la misma cuenta a veces tienen información del asiento y a veces no dependen del horario. Es posible que desee probar cómo se comporta su plantilla con las diferentes reservas.
Puede colapsar los datos para facilitar su vida mientras trabaja en las plantillas y solo centrarse en algunos de los datos a la vez.
Como se indicó anteriormente, a veces el mismo tipo o producto puede tener datos que son ligeramente diferentes del elemento que seleccionó para probar. Puede "editar" los datos utilizando el botón Editar datos.
Una vez que se editan los datos, el editor recargará la vista previa (ver más abajo).
La edición de datos no está previamente previa y no modifica ninguno de los datos en la cuenta. Recargar el elemento o el editor restablecerá los datos a su estado original.
Panel de editor
El panel del editor funciona con "Monaco", el editor de texto que también impulsa el código Visual Studio.
Esto proporciona algunas características agradables como resaltar sintaxis, finalización del código y colapsas de secciones. También presenta un mini mapa a la derecha del editor que puede ayudar al navegar plantillas largas.
Algunos de los errores de sintaxis se pueden ignorar ya que Mónaco tiene dificultades para comprender que estamos trabajando en un archivo JSON que también admite la sintaxis líquida.
Panel de errores
El error o el panel de terminal se asientan debajo del editor.
Cuando hay un error, mostrará que el código de estado intenta procesar la plantilla y el resultado una vez que la plantilla se procesó con los datos en el panel de datos.
Puede hacer clic en la flecha en la parte superior del panel Terminal para expandirla para que sea fácil de ver la información. Si tiene cuidado, generalmente puede encontrar el error del código generado al procesar la plantilla.
Panel de vista previa (no disponible en TemaPltes del tipo de pedido)
El panel de vista previa se cargará cada vez que se modifique la plantilla o los datos se vuelvan a cargar o editaran.
Esto permite una retroalimentación muy rápida en la que se ve en tiempo casi real cómo los cambios en la plantilla se reflejarán en el PDF.
Los datos deben cargarse para que funcione la vista previa.
Si hay un error en una plantilla de impresión (y por alguna razón el sistema no puede cargar la plantilla predeterminada), no imprimirá el PDF solicitado (ticket, transacción, factura, etc.). Esto también podría causar que el correo electrónico de confirmación no se envía ya que el sistema no puede producir el PDF adjunto que debe enviar. Si descubre que no puede imprimir o no se está enviando correo electrónico, asegúrese de que sus actualizaciones a las plantillas de impresión no estén lanzando un error. Si es así, corrija la plantilla e intente imprimir o enviar un correo electrónico de confirmación.
Panel de documentación
El panel de documentación es en realidad 3 paneles diferentes para plantillas normales y cambia un poco para las plantillas de pedido.
Pestaña de documentación #####
Para plantillas sin pedidos
Esta pestaña tiene documentación sobre las extensiones personalizadas Betterez.
para plantillas de pedido
Esta pestaña tiene documentación sobre la estructura necesaria para una plantilla de pedido.
Pestaña Documentos de líquido (no está disponible en TemaPltes del tipo de pedido)
Esta pestaña tiene documentación sobre Liquid JS
pestaña MakEpdf (no disponible en TemaPltes del tipo de pedido)
Esta pestaña tiene documentación sobre makepdf
Pestaña de probador de reglas (solo disponible para el tipo de pedido)
Puede usar esta pestaña para probar las reglas.
Crea una regla y escribe algunos datos de maqueta y haga clic en el botón de prueba.
Puede recibir errores si la regla que escribe no sigue el formato adecuado.
Si no tiene datos en la ventana de datos al probar la regla, obtendrá un "Undefined_Fact"
Si los datos no coinciden con la regla (aquí estamos buscando al menos un elemento en la propiedad de Parcels), obtendrá un resultado "inigualable".
Si todo funciona, debería ver un resultado "emparejado".
Guardar y reversiones
Una vez que haga clic en el botón Guardar, se creará una nueva revisión de la plantilla y también se conservará la versión anterior.
Si una plantilla tiene múltiples versiones, se mostrará un botón Rodback además del botón Guardar. Al hacer clic en este botón revertirá la plantilla al punto de guardado anterior.
Roolback elimina todo antes del punto de guardado anterior y no hay remojo o botón Rollforward.
específicamente para Plantilla de depósitos de turno parcial Para que la vista previa muestre el recibo específico, debe iniciar sesión como el usuario que desea ver, y el depósito parcial debe ser parte del cambio actualmente abierto para ese usuario. La identificación de pasar a la plantilla sería el integrador del depósito específico. Ex para el primer depósito sería 1. Si obtiene la información a través de API, encontrará el valor en el "PartialDepositorer" de la matriz de depósitos.
Plantilla de impresión en agencias
Puede establecer sus plantillas de impresión en el valor principal y asignarlas a sus agencias para que lo usen. O en orden las palabras dan el acceso (como lo hace con productos, tarifas, etc.) a la plantilla de impresión que desea que usen.
Estos son los pasos a seguir:
- En su cuenta principal: vaya a la administración / impresión / editar configuración de impresión y verifique la opción de usar la plantilla de impresión.
- En su cuenta principal: cree la plantilla de impresión que desea que la agencia use.
- En su cuenta principal: vaya a la administración / red / agencias e ingrese la agencia a la que desea asignarla. Desplácese hacia abajo hasta las opciones de plantilla de impresión y habilite la plantilla de la agencia.
- Inicie sesión en la agencia: vaya a la administración / impresión / editar configuración de impresión y verifique la opción de usar la plantilla de impresión.
También puede establecer una plantilla de impresión dentro de la agencia, pero para un mejor control y mantenimiento se recomienda hacerlo desde la cuenta principal.