Guía del usuario de
NiceLabel Cloud
Rev.-2022-11
Tabla de contenidos
1. Primeros pasos con NiceLabel Cloud ........................................................................................ 5
1.1. Introducción a NiceLabel Cloud ...................................................................................... 5
1.2. Activar NiceLabel Cloud ................................................................................................. 6
1.3. Cómo agregar usuarios .................................................................................................. 6
1.4. Administración de roles de acceso y permisos ................................................................ 6
1.5. Descarga y conexión de software ................................................................................... 6
1.6. Impresión de su primera etiqueta .................................................................................... 7
2. Infraestructura, seguridad y mantenimiento de NiceLabel Cloud ................................................ 8
2.1. Infraestructura .............................................................................................................. 8
2.1.1. Mantenimiento de una disponibilidad elevada ....................................................... 8
2.1.2. Disponibilidad web de NiceLabel Cloud ................................................................ 9
2.1.3. Redundancias y copias de seguridad .................................................................... 9
2.1.4. Impresión sin conexión ....................................................................................... 9
2.1.5. Evaluación y mitigación del riesgo ..................................................................... 10
2.2. Seguridad ................................................................................................................... 10
2.2.1. Seguridad por niveles ........................................................................................ 10
2.2.2. Acceso basado en roles .................................................................................... 11
2.2.3. Seguridad de bases de datos ............................................................................. 11
2.2.4. Cifrado de datos ............................................................................................... 12
2.2.5. Seguridad de API .............................................................................................. 12
2.2.6. Control de estado ............................................................................................. 13
2.2.7. Pruebas ........................................................................................................... 13
2.2.8. Pruebas internas ............................................................................................... 14
2.2.9. Evaluaciones de seguridad y pruebas de penetración externas ............................ 14
2.2.10. Aceptación en entornos regulados ................................................................... 14
2.3. Mantenimiento y actualizaciones .................................................................................. 14
2.3.1. Actualización de NiceLabel Cloud ...................................................................... 15
2.3.2. Cronograma de actualizaciones de versiones de NiceLabel Cloud ........................ 15
Ciclo de lanzamientos de NiceLabel Cloud Compliance ........................................ 17
2.3.3. Actualización de software alojado de forma privada ............................................ 17
2.4. Recuperación ante desastres ....................................................................................... 18
2.4.1. Términos y deniciones .................................................................................... 18
2.4.2. Diagrama de ujo .............................................................................................. 19
2.4.3. Inicio de incidente ............................................................................................. 19
2.4.4. Respuesta a incidentes ..................................................................................... 19
2.4.5. Elevación al nivel de desastre ............................................................................ 20
2.4.6. Recuperación ante desastres ............................................................................. 20
2.4.7. Plazos de recuperación ..................................................................................... 21
2.4.8. Revisiones de procesos ..................................................................................... 21
2.4.9. Pruebas periódicas ........................................................................................... 21
2.5. Recursos adicionales ................................................................................................... 21
3. Integración de datos en NiceLabel Cloud ................................................................................ 23
3.1. Vinculación a bases de datos ....................................................................................... 23
2
3.1.1. Vinculación a bases de datos de archivos ........................................................... 24
3.1.2. Vinculación de bases de datos de usuario de NiceLabel Cloud Azure SQL ............ 24
3.1.3. Vinculación a bases de datos externas ............................................................... 25
3.2. Integraciones directas ................................................................................................. 25
3.2.1. Impresión con desencadenadores en la nube ..................................................... 25
3.2.2. Operación ......................................................................................................... 26
3.2.3. Detalles técnicos .............................................................................................. 27
3.2.4. Impresión IoT con API en la nube ....................................................................... 28
3.2.5. Operación ......................................................................................................... 29
3.2.6. Detalles técnicos .............................................................................................. 30
3.2.7. Impresión de cliente ligero ................................................................................. 31
3.2.8. Operación ......................................................................................................... 32
3.2.9. Detalles técnicos .............................................................................................. 32
3.2.10. Transferencias de archivos SFTP ..................................................................... 33
3.2.11. Integraciones locales alternativas .................................................................... 34
3.3. Apéndice A: Paquete de integración .............................................................................. 34
3.3.1. Conguración del Centro de control ................................................................... 35
3.3.2. Cómo cargar archivos ....................................................................................... 35
3.3.3. Registro de aplicaciones web ............................................................................ 35
3.3.4. Creación de Integraciones en la nube ................................................................. 36
3.3.5. Registro de Integraciones en la nube del Portal de desarrolladores ...................... 36
3.3.6. Registro de impresoras en la nube ..................................................................... 37
3.3.7. Cómo congurar su sitio web de simulación ....................................................... 37
3.3.8. Cómo congurar su servidor de integración ........................................................ 38
3.3.9. Cómo congurar su Web Client .......................................................................... 40
3.3.10. Ejecución de integraciones de muestra ............................................................. 40
3.3.11. Impresión IoT con API en la nube ..................................................................... 41
3.3.12. Desencadenadores en la nube ......................................................................... 42
3.3.13. Ejemplo de clientes ligeros .............................................................................. 42
3.4. Apéndice B: API del desencadenador en la nube ............................................................ 43
3.4.1. Ejecución de API Cloud Trigger .......................................................................... 44
3.4.2. Registro como integradores ............................................................................... 44
3.4.3. Métodos de API ................................................................................................ 45
3.4.4. Método IMPRESORAS ....................................................................................... 45
3.4.5. Método IMPRIMIR ............................................................................................. 45
3.4.6. Método CATÁLOGODEETIQUETAS ..................................................................... 46
3.4.7. Método VISTA PREVIA ...................................................................................... 47
3.4.8. Método TRABAJODEIMPRESIÓN ....................................................................... 48
3.4.9. Método VARIABLES .......................................................................................... 49
3.4.10. Método ESTADODEIMPRESORAS ..................................................................... 49
3.4.11. Estructuras de datos ....................................................................................... 50
3.4.12. Cargas de datos entrantes ............................................................................... 50
3.4.13. Mensajes con comentarios .............................................................................. 53
4. Integración de la gestión de la cadena de suministro de Microsoft Dynamics 365 ..................... 56
4.1. Conguración de NiceLabel .......................................................................................... 57
4.1.1. 1. Obtenga su cuenta de NiceLabel Cloud ........................................................... 57
3
4.1.2. 2. Conecte impresoras a su cuenta de NiceLabel Cloud ....................................... 58
4.1.2.1. Conexión de impresoras en la nube ......................................................... 58
4.1.2.2. Conexión de impresoras clásicas ............................................................ 58
4.1.3. 3. Cree sus plantillas de etiquetas ...................................................................... 59
4.1.4. 4. Habilite las API REST ..................................................................................... 60
4.1.5. 5. Impresión de prueba ...................................................................................... 61
4.2. Integración de muestra de D365SCM ............................................................................ 62
4.3. Conguración de integración de impresión de NiceLabel ................................................ 63
4.3.1. Pestaña general ................................................................................................ 63
4.3.1.1. Código: Pestaña general ......................................................................... 64
4.3.2. Pestaña Impresoras .......................................................................................... 64
4.3.2.1. Código: NLPIntegrationParameters ......................................................... 64
4.3.2.2. Código: Conceptos básicos de la clase NLPrinting ................................... 65
4.3.2.3. Código: NLPrinting.NLGetPrinters ........................................................... 66
4.3.3. Pestaña Plantillas ............................................................................................. 67
4.3.3.1. Código: pestaña de plantillas .................................................................. 69
4.4. Impresión desde D365SCM .......................................................................................... 69
4.4.1. Código: DirPartyTable.NiceLabelPrinting ............................................................ 70
4.4.2. Código: DirPartyTable_NiceLabelPrinting.NLPrint_OnClicked (Part 1) ................... 71
4.4.3. Código: NLPPrintDialog ..................................................................................... 71
4.4.4. Código: DirPartyTable_NiceLabelPrinting.NLPrint_OnClicked (Part 2) ................... 72
4.4.5. Código: NLPrinting.GetTemplatePath ................................................................. 73
4.4.6. Código: DirPartyTable_NiceLabelPrinting.NLPrint_OnClicked (Part 3) ................... 73
4.4.7. Código: NLPrinting.NLPrintJSON ....................................................................... 76
4.4.8. Vericación de nombres de variables ................................................................. 77
4
1. Primeros pasos con NiceLabel Cloud
NiceLabel Cloud de Loftware es nuestro Label Management System basado en la nube.
Independientemente del tamaño de su empresa, puede usar NiceLabel Cloud para gestionar e imprimir
sus etiquetas desde cualquier lugar sin infraestructura de TI. Podrá acceder a NiceLabel Cloud Control
Center desde su navegador siempre que necesite gestionar e imprimir etiquetas.
NiceLabel Cloud permite que equipos grandes y pequeños diseñen nuevas etiquetas de manera eciente,
se mantengan al tanto de modicaciones legales, eviten retiros de productos y multas reglamentarias, y
modiquen rápidamente la escala de sus operaciones de etiquetado.
Podrá diseñar, gestionar e imprimir sus etiquetas con un solo sistema NiceLabel Cloud es una colección
de herramientas para ayudar a sus diseñadores, ingenieros de control de calidad, administradores de TI y
operadores de impresión a trabajar juntos y garantizar que los datos correctos se impriman en la etiqueta
correcta en el momento indicado.
La administración central en la nube de su sistema de etiquetado genera costes más bajos, le brinda
una garantía de calidad mejorada y permite plazos de comercialización más cortos sin inversiones
signicativas en hardware. Le proporciona un sistema de etiquetado seguro, expansible y estandarizado
para sus proveedores y toda su empresa.
NiceLabel Cloud brinda:
• Infraestructura de TI conable
• Medidas de seguridad avanzadas
• Planes de mantenimiento exhaustivos
• Procesos integrales de recuperación ante desastres
Las partes interesadas de su empresa, entre ellos los administradores de TI, los gerentes de control
de calidad y los gerentes de operaciones, se beneciarán de la infraestructura, seguridad y abilidad de
NiceLabel Cloud.
Para obtener más información, visite https://www.nicelabel.com/label-cloud o lea sobre NiceLabel Control
Center.
1.1. Introducción a NiceLabel Cloud
https://www.youtube.com/embed/xYlJJTrG8AY
Este video le ofrece una presentación de NiceLabel Cloud. Con él aprenderá los benecios de la gestión
de etiquetas alojada en la nube para empresas grandes y pequeñas, y verá el proceso por el que pasa una
etiqueta en NiceLabel Cloud, que incluye lo siguiente:
5
•Creación de un plantilla en Designer.
•Almacenamiento y gestión de plantillas de etiquetas en Control Center.
• Implementación de control de versiones y ujos de trabajo para el Aseguramiento de calidad en el
Control Center.
• Integración de su sistema de ERP y automatización de sus impresiones con la Automation.
•Impresión de sus etiquetas con NiceLabel Print y otras NiceLabel aplicaciones.
1.2. Activar NiceLabel Cloud
https://www.youtube.com/embed/I_uQwtPKr0U
Aprenderá cómo activar NiceLabel Cloud, lo que incluye:
• Dónde encontrar la información sobre la activación de NiceLabel Cloud.
• Cómo iniciar sesión en su cuenta de NiceLabel Cloud después de activarla.
1.3. Cómo agregar usuarios
Con este video, aprenderá:
• Las diferencias entre usuarios individuales (Usuarios invitados) y los Usuarios del directorio
organizacional.
• Cómo invitar a Usuarios invitados a NiceLabel Cloud.
• Cómo aceptar invitaciones de NiceLabel Cloud como Usuario invitado.
1.4. Administración de roles de acceso y permisos
https://www.youtube.com/embed/bfQ5_jenxGQ
Administre sus roles de acceso y permisos para asegurar NiceLabel Cloud. Aprenderá:
• Sobre la relación entre Usuarios, Roles de acceso y permisos.
• Cómo crear nuevos Roles de acceso con permisos.
• Cómo asignar Roles de acceso a sus usuarios.
1.5. Descarga y conexión de software
Aprenderá:
6
• Cómo lo ayudan a trabajar los diferentes tipos de software NiceLabel Cloud.
• Cómo mantener su software actualizado con la última versión.
• Cómo conectar su software a NiceLabel Cloud.
1.6. Impresión de su primera etiqueta
https://www.youtube.com/embed/sMo5XNQVmDM
NiceLabel Cloud lo ayuda a imprimir sus etiquetas desde cualquier lugar. Aprenderá:
• Cómo almacenar y compartir etiquetas.
• Cómo imprimir su primera etiqueta desde NiceLabel Cloud.
• Cómo controlar el progreso de la impresión.
7
2. Infraestructura, seguridad y
mantenimiento de NiceLabel Cloud
NiceLabel Cloud es el Sistema de administración de etiquetas basado en la nube de NiceLabel.
La administración en la nube le permite aprovechar todos los benecios de la transformación digital de su
etiquetado (entre ellos, costes más bajos, un control de calidad mejorado y plazos de comercialización
más cortos) sin inversiones iniciales signicativas en hardware. Garantiza un sistema de etiquetado
seguro, expansible y estandarizado para sus proveedores y toda su empresa con un ROI (rendimiento
de la inversión) en menos de 6 meses.
NiceLabel Cloud genera estos benecios comerciales al brindarle:
• Infraestructura de TI conable
• Medidas de seguridad avanzadas
• Planes de mantenimiento exhaustivos
• Procesos integrales de recuperación ante desastres
Las partes interesadas de su empresa, entre ellos los administradores de TI, los gerentes de control
de calidad y los gerentes de seguridad, se beneciarán de la infraestructura, seguridad y abilidad de
NiceLabel Cloud.
Obtenga más información sobre NiceLabel Cloud aquí: https://www.nicelabel.com/label-management-
system/label-cloud.
2.1. Infraestructura
2.1.1. Mantenimiento de una disponibilidad elevada
NiceLabel desarrolla NiceLabel Cloud en la plataforma able Azure de Microsoft, lo que garantiza una
infraestructura y disponibilidad de primer nivel.
Su Acuerdo de nivel de servicio garantiza una disponibilidad elevada de servicios tal como se dene en su
Contrato principal de servicios y suscripción de software.
La arquitectura de NiceLabel Cloud prioriza la disponibilidad elevada y elimina los puntos únicos de falla
con múltiples redundancias. Trabajamos en colaboración con los arquitectos de Microsoft para construir
NiceLabel Cloud según las mejores prácticas. Microsoft ha incluido a NiceLabel Cloud en su catálogo
global de soluciones basadas en Azure.
Podrá encontrar NiceLabel Cloud en Appsource y Azure Marketplace.
8
2.1.2. Disponibilidad web de NiceLabel Cloud
NiceLabel incorpora abilidad y redundancia en nuestra arquitectura web basada en la nube.
Los sitios web de NiceLabel Cloud se ejecutan en clústeres de máquinas virtuales (nodos). Cada nodo se
ejecuta dentro de diferentes Zonas de disponibilidad (lugares físicos separados dentro de los centros de
datos de Azure). Si un nodo falla, el clúster continúa funcionando en otros nodos.
NiceLabel Cloud se ejecuta en varios clústeres. En el caso de una falla a gran escala en todo el clúster,
podemos migrar sus cuentas de NiceLabel Cloud a diferentes clústeres.
2.1.3. Redundancias y copias de seguridad
NiceLabel Cloud utiliza Azure para brindar un nivel elevado de disponibilidad para sus aplicaciones y datos.
Sus datos se alojan en servidores de bases de datos redundantes para garantizar que no haya
interrupciones en el servicio. Si uno de los servidores de bases de datos falla, otro servidor de bases
de datos asume el control (servicio continuo).
Azure realiza copias de seguridad de la base de datos y almacena cada copia de seguridad en varios
lugares físicos. Podemos restaurar sus datos de cualquier momento en los últimos 30 días a partir de
copias de seguridad del servidor. NiceLabel Cloud crea copias de seguridad completas cada semana,
copias de seguridad diferenciales cada 12 horas y copias de seguridad del registro de transacciones cada
5 a 10 minutos.
2.1.4. Impresión sin conexión
La impresión ininterrumpida de etiquetas es el proceso más esencial de NiceLabel Cloud.
En caso de interrupciones, NiceLabel Cloud le permite imprimir desde aplicaciones en sus computadoras
sin conectarse al servidor de NiceLabel Cloud en Azure. Mediante la conguración del sistema, podrá
imprimir sin conexión por un plazo de hasta 5 días. NiceLabel Cloud sincroniza automáticamente sus
registros de impresión de las impresiones sin conexión.
NOTA
Recomendamos la ejecución de NiceLabel Cloud en conexiones de Internet ables. La
impresión sin conexión requiere que congure su sistema para que dependa de su caché
local y se limita a etiquetas almacenadas en caché y datos disponibles localmente.
El equipo de servicios profesionales de NiceLabel puede diseñar o asesorarlo sobre
conguraciones de soluciones basadas en las mejores prácticas para impresiones sin
conexión.
9
2.1.5. Evaluación y mitigación del riesgo
RIESGO MITIGACIÓN
SOBRECARGA
DE SERVICIO
Controlamos los datos de rendimiento. En caso de rendimiento deciente,
ampliamos los recursos o lo trasladamos a otro servidor web.
FALLO DE LA
BASE DE DATOS
DEL SISTEMA
Replicamos geográcamente su base de datos en otro lugar. En caso de falla de
la base de datos del sistema, su sistema cambia automáticamente a una copia
replicada geográcamente después de 1 hora. Su base de datos también tiene
copias de seguridad puntuales de los 30 días anteriores, por lo que, en caso de
corrupción de datos, podemos restaurar sus datos.
FALLO DE LA
BASE DE DATOS
DEL USUARIO
Su base de datos tiene copias de seguridad puntuales con replicación geográca
de los 30 días anteriores. En caso de corrupción o pérdida de datos, podemos
restaurar sus datos.
FALLO DE
AUTENTIFICACI
ÓN
Sus proveedores (Microsoft, Google) son responsables de la disponibilidad del
servicio. En caso de que la autenticación no funcione correctamente (es decir,
debido a errores), NiceLabel coopera con los proveedores para resolver los
problemas.
FALLO DEL
SERVIDOR WEB
Todos los sitios web se ejecutan en múltiples nodos (clústeres). Si uno de los
nodos falla, otro asume el control.
FALLO DEL
CENTRO DE
DATOS
Manejado por el proveedor de PaaS (Microsoft Azure). En caso de fallas en el
centro de datos, NiceLabel se comunica con Microsoft (solicitud de soporte)
para resolver los problemas. Si Microsoft no resuelve los problemas ni le brinda
inmediatamente tiempos de restauración estimados, NiceLabel restaura los
servicios en otro centro de datos.
FALLO DE DNS Microsoft garantiza el 100 % de disponibilidad de los servicios DNS.
2.2. Seguridad
NiceLabel realiza esfuerzos importantes para garantizar la seguridad de NiceLabel Cloud.
Implementamos las últimas normas de seguridad y realizamos comprobaciones de seguridad automáticas
y manuales de NiceLabel Cloud. Nos comprometemos a brindarle un servicio able mientras aplicamos
políticas, tecnologías y controles para proteger los datos que confía a NiceLabel Cloud.
2.2.1. Seguridad por niveles
NiceLabel garantiza la seguridad de sus sistemas y datos de varias maneras.
La mayoría de los fallos de seguridad no se producen cuando alguien ingresa a los centros de datos en la
nube. En cambio, los atacantes suelen explotar las vulnerabilidades de las aplicaciones en la nube. Para
prevenir ataques, combinamos varias estrategias de mitigación y controles de seguridad para proteger sus
recursos y datos.
10
Nuestra seguridad por niveles incluye lo siguiente:
• Educación de los empleados
• Seguridad física
• Seguridad de la red
• Seguridad web
• Seguridad en la nube basada en API
• Cifrado de datos
Al ejecutarse en Microsoft Azure, NiceLabel Cloud hereda muchos procesos de seguridad de plataforma
e infraestructura e implementaciones basadas en las mejores prácticas. Microsoft maneja la seguridad
central del centro de datos e inspecciona los ujos de datos de Internet para ayudar a proteger su red
contra intrusiones y ataques de malware.
Diseñamos aplicaciones en la nube según prácticas modernas de programación centradas en la
seguridad. Usamos técnicas de cifrado y ejecutamos procedimientos de prueba para desarrollar código
y comercializar productos.
Nuestros equipos de desarrollo completan la capacitación relacionada con la seguridad de TI en el
desarrollo de software para fortalecer sus conocimientos y experiencia en seguridad de la información.
2.2.2. Acceso basado en roles
NiceLabel Cloud se autentica con Microsoft y Google (Oauth2/OpenID Connect).
Integramos proveedores de conanza en la seguridad de NiceLabel Cloud para autenticar sus identidades
de usuario y proteger a sus usuarios contra ataques. Esto permite que NiceLabel se concentre en las
funciones principales y deja la identicación a los expertos que usted conoce.
Puede denir sus usuarios con servicios de directorio LDAP o usar sus cuentas de Microsoft Ofce 365
o Active Directory (AD) (disponible como Azure Active Directory para aplicaciones en la nube). NiceLabel
Cloud no incluye mecanismos de autenticación ni lógica de autenticación personalizada.
2.2.3. Seguridad de bases de datos
La separación de las bases de datos es esencial y garantiza que obtenga niveles adicionales de seguridad.
Solo podrá acceder a su propia base de datos de aplicaciones asignada. No podrá acceder a las bases
de datos de la aplicación directamente con las aplicaciones de administración ni a través de la API. La
propiedad de la base de datos evita que otros clientes lean sus datos o accedan a ellos.
Dependiendo de su suscripción a NiceLabel Cloud podrá acceder a bases de datos en la nube basadas
en usuarios para almacenar datos de impresión y para exportar datos maestros intermedios diarios desde
sistemas de ERP. No necesita tener acceso a bases de datos en la nube basadas en usuarios para ejecutar
las aplicaciones web de NiceLabel Cloud.
11
El acceso a las bases de datos de usuarios es completamente especíco del cliente. Cuando solicita su
base de datos de usuarios, creamos su primera cuenta administrativa para que pueda administrar su base
de datos y otorgar el acceso de usuario usted mismo.
2.2.4. Cifrado de datos
NiceLabel cifra sus datos para garantizar la seguridad de su negocio.
Sus datos pueden ocupar dos estados en NiceLabel Cloud: datos en tránsito y datos en reposo. Sus datos
pueden estar expuestos a riesgos en ambos estados. NiceLabel Cloud usa un sistema de cifrado para
proteger los datos en tránsito y en reposo del acceso no autorizado o el robo.
Los datos que se mueven activamente entre dispositivos o redes a través de Internet son datos en tránsito.
Protegemos sus datos en tránsito desde el almacenamiento local hasta su almacenamiento en NiceLabel
Cloud. Ciframos sus datos en tránsito en un extremo y los desciframos en el otro para evitar escuchas
ilegales de clientes no autorizados. NiceLabel Cloud utiliza protocolos de comunicación de cifrado de
datos modernos (TLS y HTTPS) para garantizar la privacidad y la integridad de los datos.
Ciframos sus datos cuando se conecta a NiceLabel Cloud con:
•Navegadores. Puede utilizar cualquier navegador web moderno para interactuar con nuestras
aplicaciones web.
•Clientes de NiceLabel. Todos nuestros clientes, incluidos los de Designer, Print, Automation y Web
Client, utilizan canales cifrados seguros para solicitar datos de NiceLabel Cloud y enviar registros y
actualizaciones.
Los datos que no se mueven activamente entre dispositivos o redes a través de Internet son datos en
reposo.
NiceLabel Cloud recibe y almacena sus datos en bases de datos Azure SQL exclusivas para usted.
Implementamos medidas de seguridad protectoras para evitar el acceso a sus datos en reposo o su
modicación o robo:
• Solo usted tendrá acceso a las bases de datos de productos de su propiedad.
• Sus bases de datos de Azure SQL usan un cifrado de datos transparente (TDE). El TDE permite el
cifrado y descifrado de bases de datos en tiempo real mediante algoritmos de cifrado AES 256.
2.2.5. Seguridad de API
El software NiceLabel utiliza API de Azure para intercambios de datos seguros y para la comunicación
entre aplicaciones.
•Service Bus: el sistema de comunicación entre aplicaciones de software que interactúan entre
sí en una arquitectura orientada a servicios. Usamos Service Bus para comunicarnos con su
infraestructura local, ya sea a través de impresoras IoT conectadas a la nube o desencadenadores en
12
la nube (que se ejecutan en NiceLabel Automation). Service Bus crea conexiones salientes desde su
servidor a NiceLabel Cloud y permite llamar a su servidor desde la nube.
•Funciones de Azure. Nuestras API publicadas para NiceLabel Cloud (API Cloud Print y API Cloud
Trigger) llaman a las funciones de Azure para un procesamiento adicional, que a su vez llama a las
terminales correctas de Service Bus. Por ejemplo, cuando ejecuta «imprimir» en la API Cloud Print,
NiceLabel Cloud genera una trabajo de impresión, sabe dónde está su impresora en la nube de IoT y
entrega su trabajo de impresión a su impresora. Contamos con límites de tráco para evitar el abuso
de las API.
2.2.6. Control de estado
NiceLabel controla continuamente el estado de su sistema alojado con Azure Insight.
Insight detecta automáticamente anomalías en el rendimiento e incluye potentes herramientas de análisis
para ayudarnos a diagnosticar problemas y mejorar los productos al comprender cómo nuestros clientes
usan NiceLabel Cloud.
Usamos Insight para:
• Controlar el tráco anómalo y responder rápidamente a posibles amenazas.
• Detectar y responder a mayores demandas de servicios.
• Mejorar continuamente el rendimiento y la estabilidad.
2.2.7. Pruebas
NiceLabel prueba todo el código exhaustivamente para garantizar la seguridad y un nivel elevado de
calidad.
Las vulnerabilidades de software comúnmente explotadas incluyen defectos, errores y fallas lógicas.
Nuestro equipo de desarrollo se esfuerza por producir código de calidad a través de técnicas basadas en
las mejores prácticas, que incluyen:
• Programación en pareja
• Revisiones de código recurrentes
• Cumplimiento de normas de seguridad de código
• Ejecución de múltiples pruebas
Nuestra política general es probar automáticamente todo lo que podamos. Realizamos pruebas de
regresión continuas para cada versión a lo largo del ciclo de vida de nuestro software para garantizar
el cumplimiento de las normas de calidad del sector.
Además de nuestros equipos experimentados de pruebas internas, contratamos continuamente
especialistas externos en evaluación de seguridad para garantizar que nuestro software sea seguro y esté
listo para usar.
13
2.2.8. Pruebas internas
Los equipos de desarrollo de NiceLabel diseñan y ejecutan una amplia gama de pruebas manuales y
automatizadas para cada nueva compilación de software.
Aumentamos la cantidad de pruebas y la cantidad de miembros del equipo de pruebas para las pruebas
nales antes de la comercialización. Cualquier fallo de seguridad que detectemos conduce al desarrollo de
nuevas pruebas automatizadas para evitar que los problemas vuelvan a surgir.
2.2.9. Evaluaciones de seguridad y pruebas de penetración externas
NiceLabel contrata a especialistas externos en seguridad de TI para versiones de productos principales y
secundarias.
Nuestros expertos en seguridad acceden a nuestro software como nuestros clientes, pero usan sus
conocimientos para evaluar nuestras aplicaciones web y de escritorio con el objetivo de identicar
vulnerabilidades explotables. Las pruebas implican la creación de perles de amenazas personalizados
para descubrir vulnerabilidades de seguridad especícas de nuestras aplicaciones y tecnología web.
Nuestros evaluadores externos de seguridad utilizan la Guía de pruebas OWASP para la ejecución
y vericación de pruebas. El Proyecto de seguridad de aplicaciones web abiertas (OWASP) es una
comunidad mundial gratuita y abierta centrada en mejorar la seguridad del software de aplicaciones.
2.2.10. Aceptación en entornos regulados
Las pruebas de NiceLabel cumplen con las normas y cuentan con la conanza de clientes en sectores
regulados.
Los clientes de NiceLabel Cloud en sectores regulados, entre ellos, los de servicios médicos, productos
farmacéuticos, fabricación de dispositivos médicos y alimentos y bebidas, confían en los resultados de las
pruebas que proporcionamos.
También trabajaremos con usted para realizar pruebas con sus propias herramientas y procedimientos de
prueba.
2.3. Mantenimiento y actualizaciones
NiceLabel lo mantiene actualizado.
Nuestro proceso controlado actualiza NiceLabel Cloud automáticamente, brindándole actualizaciones sin
complicaciones y sin tiempo de inactividad de la plataforma.
Realizamos actualizaciones con versiones principales de productos cada dos años, versiones secundarias
dos veces al año y versiones de servicios intermedios (según sea necesario):
14
TIPO DE
VERSIÓN
EJEMPLO DESCRIPCIÓN
PRINCIPAL NiceLabel 10 Las versiones principales de productos incluyen
importantes actualizaciones de funciones, mejoras de
rendimiento y correcciones de errores.
SECUNDARIA NiceLabel 10.1Las versiones secundarias incluyen actualizaciones de
funciones, mejoras de rendimiento y correcciones de
errores.
SERVICIO NiceLabel 10.1.1Las versiones de servicio incluyen correcciones de errores.
Para conocer los cronogramas completos de actualización y más detalles, lea nuestra Política sobre el
ciclo de vida de los productos.
2.3.1. Actualización de NiceLabel Cloud
NiceLabel proporciona nuevas implementaciones de NiceLabel Cloud para cada versión de software.
Preparamos y probamos cada nueva implementación antes de actualizar su suscripción, lo que permite
una actualización sin problemas y sin tiempo de inactividad. Actualizamos su suscripción simplemente al
transferirlo de su versión de implementación anterior a la nueva. Si tiene algún problema inesperado, lo
volveremos a transferir a su versión anterior mientras solucionamos cualquier problema que haya.
Contamos con planes de actualización transparentes y procedimientos claramente denidos para todos los
tipos de versión (principal, secundario y de servicio). Recibirá noticaciones por correo electrónico antes
de cualquier actualización de versión de NiceLabel Cloud, lo que le permite prepararse, probar y realizar un
seguimiento de cada actualización.
2.3.2. Cronograma de actualizaciones de versiones de NiceLabel Cloud
NOTA
Los días de lanzamiento son los días a partir de los cuales las versiones principales,
secundarias o de servicio están disponibles públicamente.
HORA ACONTECIMIEN
TO
DESCRIPCIÓN
DÍA DE
LANZAMIENTO
Noticación por
correo
electrónico
Recibe una noticación por correo electrónico que indica
que comenzaremos con el proceso de actualización de
NiceLabel Cloud. El correo electrónico incluye información
sobre la cuenta que se actualizará y la hora de la
actualización.
15
HORA ACONTECIMIEN
TO
DESCRIPCIÓN
LANZAMIENTO
+ 7 DÍAS
Noticación por
correo
electrónico
Recibe una noticación por correo electrónico que indica
que su cuenta de Essentials/entorno de pruebas Business/
entorno de pruebas Compliance de NiceLabel Cloud se
actualizará con la última versión en las próximas 24 horas.
NiceLabel Cloud
Essentials
Actualizamos su cuenta de NiceLabel Cloud Essentials
con la última versión. Esto no implica ningún tiempo
de inactividad del entorno de producción, simplemente
transferimos su cuenta.
NiceLabel Cloud
Business:
Actualizaciones
del entorno de
pruebas
Actualizamos su entorno de pruebas con la última versión.
Esto no implica ningún tiempo de inactividad del entorno de
pruebas, simplemente transferimos su cuenta.
Este procedimiento le permite ver cómo su entorno de
producción responderá a la actualización.
NiceLabel Cloud
Compliance:
Actualizaciones
de los entornos
de pruebas
Actualizamos su entorno de pruebas con la última versión.
Esto no implica ningún tiempo de inactividad del entorno de
pruebas, simplemente transferimos su cuenta.
Este procedimiento le permite ver cómo su entorno de
producción responderá a la actualización y permite una
evaluación de la validación de su sistema.
LANZAMIENTO
+ 14 DÍAS
Noticación por
correo
electrónico
Recibe una noticación por correo electrónico que indica
que su entorno de pruebas de NiceLabel Cloud Business se
actualizará con la última versión en las próximas 24 horas.
NiceLabel Cloud
Business: sin
entorno de
pruebas
Actualizamos su entorno de producción con la última
versión. Esto no implica ningún tiempo de inactividad
del entorno de producción, simplemente transferimos su
cuenta.
LANZAMIENTO
+ 28 DÍAS
Noticación por
correo
electrónico
Recibe una noticación por correo electrónico que indica
que su entorno de producción de NiceLabel Cloud Business
se actualizará con la última versión en las próximas 24
horas.
NiceLabel Cloud
Business:
Actualizaciones
del entorno de
producción
Actualizamos su entorno de producción con la última
versión. Esto no implica ningún tiempo de inactividad
del entorno de producción, simplemente transferimos su
cuenta.
LANZAMIENTO
+ 3 MESES
Noticación por
correo
electrónico
Recibe una noticación por correo electrónico que indica
que su entorno de producción de NiceLabel Cloud
Compliance se actualizará con la última versión en las
próximas 24 horas.
16
HORA ACONTECIMIEN
TO
DESCRIPCIÓN
NiceLabel Cloud
Compliance:
Actualizaciones
del entorno de
producción
Actualizamos su entorno de producción con la última
versión. Esto no implica ningún tiempo de inactividad
del entorno de producción, simplemente transferimos su
cuenta.
Ciclo de lanzamientos de NiceLabel Cloud Compliance
NiceLabel Cloud se actualiza una vez al año. Antes de actualizar el entorno de producción, proporcionamos
un período de prueba de tres meses. Durante el período de prueba, los usuarios pueden comunicarse con
el soporte técnico de NiceLabelpara evaluar y resolver posibles problemas abiertos antes de actualizar el
entorno de producción.
2.3.3. Actualización de software alojado de forma privada
Podrá alojar módulos de NiceLabel Cloud en su infraestructura privada con su suscripción:
1. Su Diseñador de etiquetas diseña etiquetas y congura su aplicación de impresión.
2. Su Cliente de impresión web ejecuta su aplicación de impresión a través de la web.
3. Su Sistema de integración integra su impresión.
Su software alojado de forma privada siempre se vincula sin problemas con su suscripción a NiceLabel
Cloud.
Actualizamos NiceLabel Cloud de forma periódica, pero su software alojado de forma privada no se
actualiza automáticamente. Nuestro servidor de NiceLabel Cloud actualizado todavía ejecuta versiones
anteriores de su software alojado de forma privada.
17
Hasta que actualice su software alojado de forma privada, es posible que no pueda usar algunas
características y funciones nuevas de NiceLabel Cloud. Para obtener todos los benecios de su suscripción
a NiceLabel Cloud actualice periódicamente su software alojado de forma privada a medida que lanzamos
versiones más nuevas de NiceLabel Cloud. Programe sus actualizaciones según sus requisitos de
mantenimiento y producción.
2.4. Recuperación ante desastres
NiceLabel Cloud es estable y seguro.
Pero si las cosas salen mal, NiceLabel cuenta con planes integrales de recuperación ante desastres.
Nuestros equipos trabajan arduamente para minimizar el tiempo de inactividad y ayudarlo a volver a la
normalidad lo antes posible.
2.4.1. Términos y deniciones
NOMBRE DEFINICIÓN
INCIDENTE Una situación que podría constituir o conducir a una interrupción, pérdida o
desastre.
DESASTRE Cualquier condición que tenga como consecuencia una incapacidad
prolongada de acceder a NiceLabel Cloud o usarlo. Un desastre requiere
una acción de recuperación para restaurar el funcionamiento normal.
EQUIPO DE
RESPUESTA A
INCIDENTES
Incluye a los miembros de nuestros equipos de soporte y desarrollo de
aplicaciones que responden a solicitudes de soporte de los clientes. Los
miembros del equipo de respuesta a incidentes reciben alertas de nuestro
sistema de control. Los equipos de respuesta a incidentes resuelven
incidentes o elevan incidentes al nivel de desastre.
EQUIPO DE
APROVISIONAMIENT
O
Incluye a miembros del equipo de desarrollo de aplicaciones responsables
de administrar NiceLabel Cloud. Además de la administración regular,
nuestro equipo de aprovisionamiento apoya a nuestro equipo de respuesta
a incidentes en la resolución de incidentes.
EQUIPO DE
RECUPERACIÓN
ANTE DESASTRES
Se reúne en caso de una situación de desastre para recuperar el servicio del
desastre. Incluye a miembros del equipo de aprovisionamiento.
EQUIPO DE GESTIÓN
DEL PROCESO
DE RECUPERACIÓN
ANTE DESASTRES
Supervisa, revisa y realiza cambios en los procesos de recuperación
ante desastres para garantizar su ecacia. Este equipo no participa
directamente en la respuesta a desastres, pero revisa cada situación de
desastre para mejorar los procesos.
18
2.4.2. Diagrama de ujo
2.4.3. Inicio de incidente
Los incidentes comienzan cuando nuestro equipo de respuesta a incidentes recibe información sobre
problemas que afectan a NiceLabel Cloud.
Esta información puede provenir de:
• Alertas del sistema de control
• Solicitudes de atención al cliente (por teléfono o correo electrónico)
• Otros acontecimientos que indican posibles problemas con NiceLabel Cloud
Realizamos un seguimiento de los incidentes con tickets de soporte según los procedimientos de soporte
estándar.
2.4.4. Respuesta a incidentes
Los equipos de respuesta a incidentes responden a incidentes. La respuesta incluye lo siguiente:
1. Evaluación de incidentes (revisión de alertas, informes de clientes).
2. Punto de decisión. Después de la investigación, los equipos deciden si elevar o no los incidentes al
nivel de desastre.
a. Los equipos de respuesta a incidentes consultan con el equipo de aprovisionamiento según
sea necesario.
19
b. Si los incidentes no requieren respuestas ante desastres, los equipos resuelven los
incidentes de acuerdo con los procesos de soporte estándar.
El manejo de incidentes y los tiempos de respuesta dependen de los procedimientos de soporte estándar
determinados por su nivel de SLA (Acuerdo de nivel de servicio).
2.4.5. Elevación al nivel de desastre
Los equipos de respuesta a incidentes se comunican con el equipo de aprovisionamiento para la
implementación de respuestas para la recuperación ante desastres. Nuestro equipo de aprovisionamiento
reúne un equipo de recuperación ante desastres para supervisar los procesos de recuperación ante
desastres.
2.4.6. Recuperación ante desastres
Los equipos registran todas las actualizaciones de estado en nuestro sistema interno para garantizar la
visibilidad de todos los equipos involucrados. Los equipos agregan la palabra clave [Desastre] a todas las
solicitudes de soporte relacionadas para organizar registros de desastres.
Nuestro equipo de recuperación ante desastres analiza los problemas y determina los próximos pasos
según nuestros procedimientos establecidos de recuperación ante desastres:
1. Identicar la escala, el impacto y la causa fundamental del problema.
2. Si el problema se debe a la infraestructura de nube subyacente de Azure, asegurarse de que
Microsoft esté resolviendo el problema:
a. Consultar las noticaciones de Microsoft en la sección Estado del servicio.
b. Abrir tickets de soporte según sea necesario.
c. Supervisar el progreso de Microsoft.
Si Microsoft resuelve el problema de manera oportuna, no se requiere ninguna medida de
recuperación adicional.
3. Si Microsoft no resuelve el problema, comenzar los procedimientos de recuperación según nuestra
guía de recuperación.
Mientras el equipo de recuperación ante desastres avanza en el proceso de recuperación ante desastres,
proporcionamos a los usuarios afectados actualizaciones de estado y plazos estimados de resolución.
Después de la recuperación, el equipo de recuperación ante desastres analiza las causas fundamentales
de las interrupciones y recomienda mejoras que se pueden realizar para evitar futuros incidentes. Sus
usuarios afectados reciben informes que incluyen notas de crédito de servicio cuando corresponde.
20
2.4.7. Plazos de recuperación
Nos comprometemos a restablecer el servicio lo más pronto posible. Los plazos de recuperación pueden
variar según la naturaleza y la escala del problema. NiceLabel trabaja con Microsoft para resolver
problemas relacionados con los servicios subyacentes proporcionados por Microsoft Azure.
2.4.8. Revisiones de procesos
Nuestro equipo de gestión de procesos de recuperación ante desastres revisa nuestros procesos de
recuperación:
• Después de cada situación de desastre
• Periódicamente (al menos una vez al año)
• Según sea necesario (durante mejoras planicadas o si se detectan deciencias fuera del alcance de
las pruebas periódicas)
Nuestro equipo de gestión de procesos de recuperación ante desastres determina si nuestros procesos
requieren cambios y puede delegar la implementación a nuestro equipo de aprovisionamiento. Noticamos
a los equipos afectados sobre todos los cambios.
2.4.9. Pruebas periódicas
Nuestro equipo de gestión de procesos de recuperación ante desastres prueba periódicamente nuestros
procesos de recuperación ante desastres para garantizar una ejecución correcta y medir su ecacia.
Nuestros equipos programan y realizan pruebas periódicas al menos una vez al año según los planes
establecidos. Los equipos analizan los resultados de las pruebas durante las revisiones de procesos.
2.5. Recursos adicionales
Loftware entrega la siguiente documentación a pedido.
NOTA
Algunos documentos están sujetos a Acuerdos de condencialidad o de mantenimiento de
software rmados.
1. Consensus Assessment Initiative Questionnaire (Cuestionario de iniciativa de evaluación de
consenso [CAIQ]). Muestra el cumplimiento con las mejores prácticas de CSA® (Cloud Security
Alliance). CSA STAR™ (CSA Security, Trust, Assurance and Risk) es el programa más efectivo del
sector para garantizar la seguridad en la nube. STAR™ abarca principios clave de transparencia,
auditoría rigurosa y armonización de estándares.
21
2. Documento CAIQ de Microsoft. NiceLabel Cloud se ejecuta en Microsoft Azure y hereda
automáticamente las especicaciones de seguridad de Azure: https://cloudsecurityalliance.org/
star/registry/microsoft/.
3. Matrices de trazabilidad. Listas de características que incluyen casos de prueba. Especicaciones
de funciones de NiceLabel Control Center. Las pruebas automatizadas de productos de NiceLabel
Cloud garantizan que no haya fallas ni errores de software en el software comercializado.
4. Informes de pruebas internas de equipos. Muestran las pruebas que realizamos y la cantidad total
de pruebas ejecutadas para cada versión de software.
5. Informes de pruebas de penetración. Evaluaciones de nuestra empresa de seguridad externa que
muestran las pruebas realizadas para NiceLabel Cloud, los intervalos de tiempo de las pruebas,
cualquier vulnerabilidad y sus conclusiones sobre la seguridad del software.
6. Certicado ISO 9001:2015. Loftware, junto con Euro Plus d.o.o., ha implementado y mantiene
un sistema de gestión que cumple con los requisitos de las normas ISO 9001:2015: https://
www.nicelabel.com/resources/les/doc/resources/ISO9001-certicate.pdf.
22
3. Integración de datos en NiceLabel
Cloud
NiceLabel Cloud le brinda varias formas de imprimir etiquetas con datos de sus aplicaciones comerciales
externas.
Dependiendo de sus políticas de seguridad de datos con respecto al acceso, podrá:
•Crear enlaces a sus bases de datos desde el software NiceLabel. Conectar bases de datos a
sus etiquetas y formularios. Utilizar interfaces de usuario personalizadas que cree en NiceLabel
PowerForms para imprimir etiquetas.
•Integrar las impresiones de NiceLabel en sus sistemas empresariales. Iniciar la impresión de
etiquetas desde sus aplicaciones existentes. NiceLabel Automation funciona como su motor de
impresión de fondo para procesar datos e imágenes de etiquetas.
3.1. Vinculación a bases de datos
Las aplicaciones comerciales con las que interactúa diariamente organizan y almacenan actualizaciones,
cambios y nueva información en bases de datos. Hay muchos tipos de bases de datos, pero nuestros
clientes suelen utilizar bases de datos relacionales para los datos de etiquetas. Las bases de datos
relacionales incluyen desde el almacenamiento simple basado en archivos como archivos de Microsoft
Access o Microsoft Excel hasta bases de datos SQL de alto rendimiento más sólidas.
El software NiceLabel puede leer datos de cualquier tipo de base de datos. Solo necesita:
• Conexiones de base de datos (controladores de base de datos).
• Permisos de base de datos (nombres de usuario y contraseñas).
Nuestro software proporciona varias formas de interactuar con los datos de su base de datos. Puede hacer
lo siguiente:
• Utilizar sus datos tal como están.
• Generar vistas personalizadas para ltrar datos de tablas individuales.
• Combinar datos de varias tablas en conjuntos de datos.
• Crear vistas de bases de datos visuales con herramientas de diseño gráco o instrucciones SQL.
Podrá usar campos de conjuntos de datos como fuentes de datos para etiquetas y formar objetos para
crear objetos dinámicos. Los objetos dinámicos actualizan el contenido de las etiquetas que imprime con
diferentes elementos en sus conjuntos de datos.
23
NOTA
Recomendamos crear conexiones de bases de datos únicas para sus soluciones
y conguraciones de impresión de etiquetas, y no para sus plantillas de etiquetas
individuales.
3.1.1. Vinculación a bases de datos de archivos
Para proyectos simples, las bases de datos de archivos suelen ser más fáciles de usar que las bases de
datos SQL profesionales. Tal vez almacene información sobre productos en bases de datos de Microsoft
Access o en hojas de cálculo de Microsoft Excel, o exporte datos de sus sistemas empresariales a bases
de datos de archivos. Ambas son prácticas comunes, pero tenga cuidado: el uso de bases de datos de
archivos puede indicar que su empresa no tiene una fuente única de verdad para sus datos.
NiceLabel Cloud almacena sus datos de etiquetado en su Sistema de gestión documental (DMS) en la
nube. Su DMS generalmente almacena plantillas de etiquetas e imágenes, pero su DMS también puede
almacenar sus bases de datos de archivos.
La desventaja de usar bases de datos de archivos es el acceso a archivos de solo lectura. No puede
escribir datos en bases de datos de archivos almacenadas en DMS. Para actualizar sus bases de datos con
nuevos datos, debe volver a cargar sus archivos.
Como alternativa, puede congurar sus soluciones de etiquetado para cargar datos de bases de datos
de archivos disponibles localmente. Al almacenar archivos de Microsoft Access y Microsoft Excel en
almacenamiento local o conectado a la red, puede acceder a sus archivos en modo de lectura y escritura y
modicar archivos directamente desde el software NiceLabel.
3.1.2. Vinculación de bases de datos de usuario de NiceLabel Cloud Azure
SQL
Las suscripciones de NiceLabel Cloud Business (y superiores) vienen con acceso a la base de datos de
Microsoft Azure SQL. Las bases de datos de Microsoft SQL están alojadas en entornos de Microsoft
Azure. Su edición de NiceLabel Cloud determina el tamaño de su base de datos.
Su base de datos de Azure SQL estará separada de las bases de datos de productos donde NiceLabel
Cloud almacena los activos de etiquetado de su suscripción y su historial de impresión. Tendrá acceso
completo a la base de datos de usuario de Azure SQL y podrá administrar su base de datos de forma
independiente con Microsoft SQL Server Management Studio. Podrá utilizar su base de datos Azure
SQL para sus propias necesidades de almacenamiento, incluido el almacenamiento de información sobre
productos.
Es posible que las políticas de seguridad de su empresa no otorguen a NiceLabel acceso directo a las
bases de datos de su sistema comercial, pero NiceLabel podrá acceder a su base de datos Azure SQL.
Nuestros clientes a menudo exportan los datos maestros de su sistema comercial a sus bases de datos
Azure SQL para que estos datos estén disponibles para el software NiceLabel.
24
3.1.3. Vinculación a bases de datos externas
Las aplicaciones de NiceLabel Cloud también pueden acceder a datos de otras bases de datos si tiene
los controladores de base de datos necesarios instalados en sus computadoras que ejecutan el software
NiceLabel. Por ejemplo, para usar la función de impresión de NiceLabel Web, instale controladores de
bases de datos en su servidor (si desea que su servidor inicie las conexiones de bases de datos) o en su
computadora (si desea que su computadora inicie las conexiones).
NiceLabel funciona con cualquier controlador de base de datos de Windows (como los controladores
ODBC y OLEDB).
3.2. Integraciones directas
Los sistemas empresariales basados en la nube que impulsan los procesos de su empresa suelen generar
una pregunta sobre la impresión de etiquetas: ¿Cómo puede su software en la nube imprimir etiquetas en
sus impresoras locales?
La respuesta es NiceLabel. Nuestro software en la nube se comunica tanto con sus sistemas
empresariales en la nube como con sus impresoras locales. Proporcionamos información, muestras y
pasos de conguración para permitirle imprimir etiquetas desde sus aplicaciones basadas en la nube.
Recibe archivos de muestra para explorar varias opciones de integración directa:
•Conguración de NiceLabel Automation (MISX)
• Etiqueta de muestra (NLBL)
• Sitio web de simulación del sistema en la nube (marco AngularJS). El sitio web de simulación
muestra las opciones de integración que explicamos a continuación.
3.2.1. Impresión con desencadenadores en la nube
La impresión con desencadenadores en la nube, también conocida como impresión proxy basada en
servidores, permite que sus aplicaciones en la nube se comuniquen con proxies basados en servidores
(NiceLabel Automation) que procesan e imprimen en las colas de impresión locales disponibles en sus
servidores. No es necesario modicar el rewall para permitir que los datos de sus aplicaciones en la nube
se transeran a NiceLabel Automation. Podrá enviar sus datos a las API en NiceLabel Cloud, que reenvían
sus datos a NiceLabel Automation de forma segura mediante Azure Service Bus.
BENEFICIOS
•Admite todas las marcas y modelos de impresoras.
•Proporciona enriquecimiento de datos (fusión de datos de varios sistemas externos en la misma
etiqueta).
•Brinda vistas previas de etiquetas.
25
REQUISITOS
• Instalación local de NiceLabel Automation (sistema de integración).
• Controladores de impresora para todas las impresoras instaladas en su servidor con NiceLabel
Automation.
• Impresoras conectadas a la red. La impresión en impresoras conectadas localmente (como
impresoras USB) solo es posible cuando se comparten en una red.
3.2.2. Operación
Cloud Trigger integra NiceLabel Cloud con sus sistemas empresariales existentes basados en la nube para
que pueda imprimir etiquetas en sus impresoras locales. Las impresoras IoT modernas se comunican
directamente con la nube, pero las impresoras tradicionales no. Para imprimir etiquetas en impresoras
tradicionales, instale nuestro sistema de integración local con sus impresoras.
Los sistemas empresariales basados en la nube no se comunican con el software y los dispositivos
locales. Los rewalls protegen sus redes locales de pedidos no solicitados de Internet.
26
Sus sistemas empresariales basados en la nube generan productos que usted envía a nuestras API Cloud
Trigger (proxies) alojadas en la nube de NiceLabel. Nuestras API transmiten los productos a su NiceLabel
Automation local para su procesamiento mediante mensajes seguros de Azure Service Bus (servicio de
mensajería en la nube de Microsoft). Podrá enviar mensajes como solicitudes HTTPS usando métodos
GET o POST.
NOTA
Las estructuras de las cargas que envía a las API deben coincidir con sus conguraciones
de NiceLabel Automation. Podrá congurar Automation para que se adapte a los mensajes
XML/JSON estándar que su sistema en la nube ya puede generar.
Su sistema de integración local combina plantillas de etiquetas del DMS (Sistema de gestión documental)
de NiceLabel Cloud con datos recibidos de sus sistemas empresariales en la nube para imprimir etiquetas
en sus impresoras locales.
Cloud Trigger integra de forma transparente y segura su impresión local de etiquetas con aplicaciones que
se comunican a través de Internet abierta ubicadas en redes diferentes a las de sus impresoras.
Flujo de trabajo:
1. Envíe datos desde su sistema basado en la nube a la API de NiceLabel en NiceLabel Cloud
(solicitudes HTTPS).
2. Su sistema de integración local recibe datos y procesa solicitudes siguiendo las conguraciones
denidas en los archivos de conguración de NiceLabel Automation.
3. Sus etiquetas se imprimen en impresoras locales. Las respuestas de estado se envían de vuelta a
su sistema basado en la nube. Las respuestas también pueden contener vistas previas de etiquetas
u otros datos personalizados que necesite.
3.2.3. Detalles técnicos
Realice solicitudes de impresión de API de NiceLabel a:
https://labelcloudapi.onnicelabel.com/Trigger/v1/CloudTrigger/{triggerId}
Proporcione:
•{triggerId}: su «identicador único» de Cloud Trigger (denido en su conguración de
Automation).
• Personalice el encabezado de la solicitud para proporcionar sus credenciales de usuario.
• Establezca Ocp-Api-Subscription-Key como su clave de suscripción.
• Etiquete datos en cadenas de consulta (método GET) o cuerpos de mensajes (método POST).
El sistema de integración procesa los datos de etiquetas que proporciona e imprime sus etiquetas. Podrá
elegir los formatos de entrada de datos, entre ellos, CSV, XML y JSON. Deberá crear conguraciones
27
de desencadenador de Automation coincidentes para analizar y procesar los datos que envía al
desencadenador.
Este ejemplo de paquete de integración envía mensajes JSON a las API de NiceLabel Cloud:
https://labelcloudapi.onnicelabel.com/api/CloudTrigger/Api-CloudIntegrationDemo-Print
Ejemplo de mensaje JSON saliente:
{
"FilePath": "/folder/label.nlbl",
"FileVersion": "",
"Quantity": "1",
"Printer": "",
"PreviewFormat": "PNG",
"Variables": [
{
"Product_name": "Syringe",
"GTIN": "00311234567901",
"LOT": "ABC123",
"BestBefore": "10.05.22",
"SSCC": "03831234560000001",
"Count": "10"
}
]
}
Este mensaje JSON le indica a NiceLabel Automation que:
• Cree una vista previa PNG de la etiqueta.nlbl.
• Usar pares clave-valor del objeto Variables.
Este ejemplo de conguración de NiceLabel Automation funciona con JSON. Sin embargo, podrá
crear conguraciones personalizadas de NiceLabel Automation para su situación especíca. Las
conguraciones personalizadas se adaptan a las estructuras de datos de su aplicación existente.
Para obtener más información sobre cómo congurar y ejecutar muestras de integración, lea la
Sección 3.3, “Apéndice A: Paquete de integración”.
Para obtener más información sobre las deniciones de API, lea la Sección 3.4, “Apéndice B: API del
desencadenador en la nube”.
3.2.4. Impresión IoT con API en la nube
La impresión IoT con API en la nube, también conocida como impresión directa, permite que sus
aplicaciones en la nube impriman directamente en sus impresoras habilitadas para la nube. La impresión
IoT con API en la nube no requiere ninguna presencia local de NiceLabel ni ningún software de NiceLabel
instalado localmente (como NiceLabel Automation o controladores de impresora).
28
BENEFICIOS
• Ninguna presencia local de NiceLabel.
REQUISITOS
• Impresoras habilitadas para la nube que pueden conectarse al servicio NiceLabel Cloud. Por ejemplo,
podrá imprimir con cualquier impresora Zebra Link-OS o impresoras SATO CL4NX/CL6NX.
NOTA
Algunas impresoras Zebra con Link-OS basicno es compatible con Cloud Print (por
ejemplo, Zebra ZD230). Verique la especicación de su impresora para el sistema
operativo de la impresora. Ver también el lista de impresoras de ADN Zebra. Print
DNA Basic Las impresoras no son compatibles con Cloud Print.
• Conexiones a Internet conables.
3.2.5. Operación
Las impresoras en la nube son impresoras de etiquetas inteligentes que se conectan a nuestro servicio
de impresión NiceLabel Cloud y reciben trabajos de impresión. La impresión en la nube permite imprimir
desde cualquier aplicación o dispositivo con impresoras conectadas a la nube, sin importar su ubicación.
La impresión en la nube también elimina la necesidad de los controladores de impresora. El servicio
Cloud Print crea y envía trabajos de impresión a las impresoras de destino mediante la nube.
29
El diagrama anterior muestra la arquitectura de impresión en la nube. Las impresoras se registran y se
conectan a nuestro servicio de impresión NiceLabel Cloud. Cuando envía solicitudes de impresión, su
servicio en la nube combina las plantillas de etiquetas del DMS con los datos recibidos para crear trabajos
de impresión coincidentes (por ejemplo, ZPL para impresoras Zebra, SBPL para impresoras SATO, etc.). Su
servicio en la nube entrega sus trabajos de impresión a través de Internet a las impresoras solicitadas.
3.2.6. Detalles técnicos
Las API Cloud Print estarán disponibles cuando habilite el complemento Cloud Print para su suscripción
a NiceLabel Cloud. Las API Cloud Print exponen varios métodos HTTP REST para la integración de la
impresión. Para usar estos métodos, registre sus impresoras habilitadas para la nube en NiceLabel Cloud
para que sean visibles para el servicio.
Por ejemplo, el método GET «Impresoras» recupera una lista de todas sus impresoras registradas y sus
estados activos. El método POST «Imprimir» imprime sus etiquetas seleccionadas desde el DMS a sus
impresoras en la nube con los datos de su aplicación en la nube.
Podrá proporcionar cargas de API como JSON o como datos XML.
Las API procesan los datos proporcionados de las etiquetas e imprimen las etiquetas. Sus etiquetas
siempre se cargan desde el DMS.
Realice solicitudes de impresión de API de NiceLabel a:
https://labelcloudapi.onnicelabel.com/Print/v1/Print/{printerName}
Proporcione:
•{printerName}: el nombre de su impresora conectada a la nube (denido en el registro de la
impresora). Para su lista de impresoras registradas, ejecute el método GetPrinters.
• Personalice el encabezado de la solicitud para proporcionar sus credenciales de usuario.
• Establezca Ocp-Api-Subscription-Key como su clave de suscripción.
• Etiquete los datos en cargas JSON o XML.
Sus cargas JSON pueden tener el siguiente aspecto:
{
"FilePath": "/folder/GS1-128.nlbl",
"FileVersion": "",
"Quantity": 1,
"Variables": [
{
"Product_name": "Syringe",
"GTIN": "00311234567901",
"LOT": "ABC123",
"BestBefore": "10.05.22",
30
"SSCC": "03831234560000001",
"Count": "10"
},
],
"PrinterSettings": ""
}
Para obtener más información sobre las deniciones de API, visite nuestro Portal de desarrolladores.
Para obtener más información sobre el registro de impresoras en la nube de NiceLabel Cloud y la
integración del Portal de desarrolladores, lea Impresoras en la nube.
3.2.7. Impresión de cliente ligero
Con la impresión de cliente ligero, también conocida como impresión proxy basada en el cliente, sus
aplicaciones en la nube se comunican con proxies locales (clientes de NiceLabel Web) que procesan e
imprimen etiquetas en las colas de impresión locales disponibles en sus computadoras.
BENEFICIOS
•Admite todas las marcas y modelos de impresoras.
•Permite el enriquecimiento de datos (fusión de datos de varios sistemas externos en la misma
etiqueta).
•Procesa localmente en sus computadoras.
•Imprime en todas las impresoras locales o de red con controladores instalados.
•Muestra vistas previas de etiquetas en su cliente web.
REQUISITOS
• Requiere presencia local de NiceLabel: debe instalar pequeños clientes ligeros en cada computadora.
31
3.2.8. Operación
Sus sistemas empresariales basados en la nube invocan a su NiceLabel Web Client, que ejecuta
su aplicación web personalizada de impresión de etiquetas. Usted invoca su aplicación web desde
aplicaciones en la nube a través de solicitudes de URI con datos de etiqueta proporcionados en sus
cadenas de consulta. Su aplicación web utiliza sus controladores de impresora instalados localmente para
imprimir los datos de su sistema empresarial en sus etiquetas.
Usted crea interfaces de usuario de aplicaciones web personalizadas en NiceLabel Designer y ejecuta sus
aplicaciones web personalizadas como soluciones PowerForms. La interfaz de usuario de la aplicación
web de muestra que incluimos en su paquete de integración es mínima y solo contiene opciones de
selección de impresora.
3.2.9. Detalles técnicos
NiceLabel Web Client registra esquemas URI personalizados en su computadora. La tecnología URI permite
que las aplicaciones basadas en la nube inicien aplicaciones de escritorio y les envíen datos.
En el siguiente ejemplo, su aplicación web le permite seleccionar impresoras de etiquetas
predeterminadas. Podrá personalizar las interfaces de usuario de la aplicación con las características
que necesita, incluidas las visualizaciones de vistas previas de etiquetas.
Los sistemas basados en la nube llaman con métodos URI como este:
32
nicelabelwebclient10:?server=https://<account>.onnicelabel.com/
print&openMode=2&application=<applicationame>&variable=Var1=123&variable=Var2=A
BC
Proporcione:
•<account> su nombre de cuenta de NiceLabel Cloud.
•<applicationame> el nombre de su aplicación web (denido en el Centro de control).
•openMode=2 cuando recibe nuevas solicitudes de Web Client, su aplicación web en ejecución recibe
nuevos valores de variables.
•variable=Var1=123 establece la variable Var1 en el valor 123.
Para obtener más información, lea Ajustar Web Printing.
Para obtener más información sobre su muestra de integración, lea la Sección 3.3, “Apéndice A: Paquete
de integración”.
3.2.10. Transferencias de archivos SFTP
Los Protocolos de transferencia de archivos SSH (SFTP) brindan capacidades seguras de transferencia
de archivos. Sus aplicaciones en la nube usan SFTP para transferir archivos a través de Internet. Las
conexiones entre los clientes y los servidores FTP están cifradas para que las contraseñas y demás
información condencial se puedan transferir de forma segura a través de la red.
NiceLabel Automation está congurado para monitorear carpetas, mientras que SFTP almacena los
archivos entregados. Su sistema de archivos debe montarse localmente y ser visible para NiceLabel
Automation. Cuando llegan los archivos, NiceLabel Automation los recoge para procesarlos.
BENEFICIOS
•Admite todas las marcas y modelos de impresoras.
•Proporciona enriquecimiento de datos (fusión de datos de varios sistemas externos en la misma
etiqueta).
•Brinda vistas previas de etiquetas.
REQUISITOS
• Instalación local de NiceLabel Automation (sistema de integración).
• Controladores de impresora para todas las impresoras instaladas en su servidor con NiceLabel
Automation.
• Impresoras conectadas a la red. La impresión en impresoras conectadas localmente (como
impresoras USB) solo es posible cuando se comparten en una red.
• NiceLabel Automation debe poder acceder al sistema de archivos donde se almacenan los archivos
de SFTP.
33
3.2.11. Integraciones locales alternativas
Cuando sus sistemas empresariales comparten redes locales con los sistemas de integración de
NiceLabel, tiene opciones de integración adicionales para entregar datos de impresión de etiquetas a
NiceLabel.
NiceLabel Automation acepta datos de las siguientes maneras:
•Transferencias de archivos. Sus aplicaciones guardan datos en carpetas locales o de red
seleccionadas. Podrá usar formatos de datos compatibles con sus aplicaciones para crear
conguraciones coincidentes y analizar datos en NiceLabel Automation (generalmente estructuras
XML, JSON o CSV, pero también puede usar otras).
•Puertos de serie. Los datos provienen de dispositivos conectados con puertos de serie RS-232, como
lectores de códigos de barras y balanzas.
•Bases de datos. NiceLabel Automation monitorea las bases de datos especicadas para detectar
cambios. Cuando Automation detecta nuevos registros, sus etiquetas se imprimen automáticamente.
NiceLabel también puede monitorear las bases de datos de su sistema empresarial directamente
con su autorización. Los datos maestros a menudo se exportan desde los sistemas empresariales a
bases de datos intermedias a las que puede acceder NiceLabel.
•Sockets TCP/IP. Permiten conexiones de datos sin procesar desde dispositivos de red. NiceLabel
puede operar en modo servidor o cliente.
•Servidores HTTP. Reciben datos de clientes que envían mensajes HTTP (método de comunicación de
aplicaciones web nativas). Los mensajes suelen tener formato JSON, pero NiceLabel admite todas
las demás estructuras de datos.
•Servicios web. Recibe mensajes SOAP de los clientes. El protocolo subyacente es HTTP y los
mensajes tienen formato XML.
3.3. Apéndice A: Paquete de integración
Su paquete de integración incluye una aplicación de simulación para demostrar los tipos disponibles de
impresión integrada con aplicaciones en la nube. Simulamos sus aplicaciones basadas en la nube con una
aplicación de simulación de JavaScript. Su aplicación de simulación puede enviar datos de impresión a:
•API Cloud Print para demostrar la impresión directa con impresoras habilitadas para la nube.
•API Cloud Trigger para demostrar la impresión basada en servidores con desencadenadores en la
nube.
•NiceLabel Web Client para demostrar la impresión de cliente ligero.
Le proporcionamos archivos de muestra en LabelCloudDataIntegrationPack.zip. Puede descargarlos aquí:
Para NiceLabel 10: https://ftp.nicelabel.com/software/demo/v10/LabelCloudDataIntegrationPack.zip
Para NiceLabel 2019: https://ftp.nicelabel.com/software/demo/v8/LabelCloudDataIntegrationPack.zip
34
Su muestra está congurada para la cuenta del «sistema de demostración» de NiceLabel Cloud. Siga los
pasos de las siguientes secciones para actualizar su aplicación de muestra para que funcione con su
cuenta de NiceLabel Cloud.
3.3.1. Conguración del Centro de control
3.3.2. Cómo cargar archivos
1. Inicie sesión en su Centro de control de NiceLabel Cloud. En su navegador, escriba:
https://<account>.onnicelabel.com/dashboard
NOTA
Reemplace <account> con su nombre de cuenta de NiceLabel Cloud.
2. Descargue e instale NiceLabel Web Client.
3. En Documentos, cree una nueva carpeta: /Demo/LabelCloudDataIntegration.
4. Abra LabelCloudDataIntegrationPack.zip (incluido).
5. Cargue el contenido de su carpeta de Almacenamiento de documentos en su carpeta de
Integración en la nube (en su DMS).
Sus archivos se cargan en el Centro de control y están listos para usar.
3.3.3. Registro de aplicaciones web
En Aplicaciones web, usted dene qué aplicaciones puede ejecutar NiceLabel Web Client. También
utilizamos Aplicaciones web para demostraciones de impresión de «cliente ligero».
Registre su Aplicación web:
1. Vaya a Aplicaciones > Aplicaciones web (a su izquierda) y haga clic en Agregar.
35
2. Para Nombre, escriba CloudIntegration-ThinClient.
3. Para Ruta (archivos de solución o etiqueta), haga clic en Examinar y seleccione: /Demo/
LabelCloudDataIntegration/ThinClient.nsln.
4. Para Usuarios y grupos autorizados, agregue al menos un usuario (usted mismo). Sus usuarios
recibirán invitaciones por correo electrónico y todos los usuarios que autorice pueden ejecutar la
Aplicación web en NiceLabel Web Client.
5. Haga clic en Guardar.
Su Aplicación web está registrada y lista para usar.
3.3.4. Creación de Integraciones en la nube
Las Integraciones en la nube que crea en el Centro de control autentican sus API Cloud Print y API Cloud
Trigger. Se utilizan las mismas Integraciones en la nube para la impresión IoT mediante demostraciones
de impresión de API de Cloud y Cloud Trigger.
Cree su Integración en la nube:
1. Vaya a Integraciones > Integraciones en la nube (a su izquierda) y haga clic en Agregar.
2. Para Nombre, escriba un nombre personalizado para su integración (puede escribir cualquier
nombre).
3. Haga clic en Guardar.
Su Integración en la nube se crea en el Centro de control y está lista para registrarse en el Portal de
desarrolladores.
3.3.5. Registro de Integraciones en la nube del Portal de desarrolladores
Antes de que pueda usar las API Cloud Print o las API Cloud Trigger, debe registrar su Integración en
la nube en el Portal de desarrolladores. El registro vincula su cuenta de NiceLabel Cloud con las API y
requiere claves de suscripción para autorizar sus llamadas a API.
Registre su Integración en la nube:
36
1. Abra su Guía del usuario del Centro de control.
2. Lea el capítulo API Cloud Print.
3. Siga las instrucciones proporcionadas para completar lo siguiente:
a. Congure su nueva cuenta en nuestro Portal de desarrolladores.
b. Cree su nueva suscripción.
c. Registre su suscripción al Portal de desarrolladores con su Integración en la nube (en el
Centro de control).
Debe usar su clave de suscripción activada en encabezados HTTP personalizados (Ocp-
Apim-Subscription-Key) con cada una de sus llamadas a API.
Su Integración en la nube está registrada en el Portal de desarrolladores y lista para el registro de
impresoras.
3.3.6. Registro de impresoras en la nube
Antes de poder ejecutar las API Cloud Print, debe registrar sus impresoras habilitadas para la nube con su
cuenta de NiceLabel Cloud.
Para obtener instrucciones e información adicional sobre el proceso de registro, lea nuestra guía del
usuario:
• Capítulo Funcionamiento de Cloud Print en la Guía del usuario del Centro de control.
3.3.7. Cómo congurar su sitio web de simulación
1. Abra LabelCloudDataIntegrationPack.zip (incluido).
2. Extraiga la subcarpeta del sitio web a una ubicación de disco temporal.
3. Abra la carpeta del sitio web extraída.
4. Abra index.html en su editor de texto.
5. Busque la cadena «nicelabelwebclient». Actualice la referencia URI:
37
nicelabelwebclient10:?server=https://demosystem.onnicelabel.com/print
NOTA
Reemplace «demosystem» con su nombre de cuenta de NiceLabel Cloud.
6. Guarde su archivo.
7. Abra scripts/cong.js en su editor de texto.
8. Escriba su clave de suscripción como valor de subscriptionKey.
NOTA
Puede obtener su subscriptionKey en el Portal de desarrolladores > Productos.
NOTA
No cambie los valores de label y uniqueIdentier:
•Label especica qué archivo de etiquetas usar.
•UniqueIdentier especica identicadores únicos de desencadenadores en la
nube (denidos en su conguración de Automation).
9. Guarde su archivo.
Su sitio web de simulación está congurado y listo para usar.
3.3.8. Cómo congurar su servidor de integración
1. Ejecute el NiceLabel Automation Manager.
2. Haga clic en Conectar en «Conectar a NiceLabel Cloud» para comenzar la activación.
38
3. Escriba su nombre de cuenta de NiceLabel Cloud.
NOTA
Reemplace «demosystem» en la captura de pantalla a continuación con su nombre
de cuenta real de NiceLabel Cloud.
4. Haga clic en Conectar.
5. Seleccione la autenticación de Microsoft o Google (dependiendo de cómo inició sesión en el Centro
de control desde su correo electrónico de invitación). NiceLabel se activa en su computadora.
6. En Automation Manager, haga clic en +Agregar. Vaya a su archivo de conguración de
Automation (.MISX) en Almacenamiento de documentos (Cargue el archivo que copió en /Demo/
LabelCloudDataIntegration).
7. Inicie todos los desencadenadores en su conguración.
39
Su servidor de integración está congurado y listo para usar.
3.3.9. Cómo congurar su Web Client
Congure su NiceLabel Web Client para la impresión de «cliente ligero»:
1. Abra ThinClient.nsln en NiceLabel Designer.
2. Seleccione el objeto Imagen «signo de interrogación».
3. Haga doble clic en el objeto Imagen «signo de interrogación» para abrir las propiedades del objeto.
4. En Eventos, haga clic en Acciones para el evento Al hacer clic.
5. En la acción Abrir documento/programa, dirija su nombre de archivo a la URL de su sitio web de
simulación.
NOTA
Si su sitio web de simulación se ejecuta desde su disco local y no a través de un
servidor web, puede eliminar la acción Abrir documento/programa por completo.
6. Guarde sus cambios.
NiceLabel Web Client está listo para la impresión de «cliente ligero».
3.3.10. Ejecución de integraciones de muestra
Ejecute su integración de muestra:
40
1. Vaya a la carpeta temporal en su disco con sus archivos extraídos de
LabelCloudDataIntegrationPack.zip.
2. Vaya la carpeta de su Sitio web.
3. Haga doble clic en index.html. La simulación de su sistema en la nube se abre en su navegador:
La consola de su navegador registra las solicitudes XML salientes y las respuestas entrantes. Para ver sus
registros:
1. Abra su navegador.
2. Presione F12.
3. Haga clic en Consola.
3.3.11. Impresión IoT con API en la nube
Para cada solicitud de Impresión, su sitio web de simulación escribe y envía mensajes JSON como
solicitudes HTTP a nuestra API Cloud Print. La API Cloud Print procesa los datos XML, crea trabajos de
impresión, envía trabajos de impresión a impresoras conectadas a la nube y proporciona comentarios.
Ejecute la impresión en la nube:
1. Para su método de integración, seleccione Impresión IoT usando la API Cloud.
2. Seleccione su impresora de la lista.
NOTA
Su lista muestra de forma dinámica las impresoras registradas en su cuenta de
NiceLabel Cloud. Si su lista está vacía, registre sus impresoras. Consulte Registro
de impresoras en la nube.
41
3. Haga clic en Imprimir para imprimir etiquetas.
Su impresión en la nube está congurada y lista para usar.
3.3.12. Desencadenadores en la nube
Para cada solicitud de Impresión o Vista previa, su sitio web de simulación escribe y envía mensajes XML
como solicitudes HTTP a nuestra API Cloud Trigger. La API Cloud Trigger redirige los mensajes a su
NiceLabel Automation local. Automation procesa los datos XML, ejecuta las acciones necesarias (como
imprimir o previsualizar) y proporciona comentarios.
Ejecute su integración basada en servidores:
3. Haga clic en Imprimir para imprimir etiquetas.
4. Haga clic en Vista previa para ver vistas previas de etiquetas.
NOTA
Su lista muestra dinámicamente las impresoras disponibles en la computadora
donde está instalado su sistema de integración NiceLabel (NiceLabel Automation).
5. Para su método de integración, seleccione Cloud Trigger.
6. Seleccione su impresora de la lista.
Su integración basada en servidores está congurada y lista para usar.
3.3.13. Ejemplo de clientes ligeros
Ejecute su integración basada en clientes:
1. Para su método de integración, seleccione Cliente ligero.
2. Haga clic en Imprimir para abrir NiceLabel Web Client.
NOTA
Debe tener Web Client instalado en la computadora donde se ejecuta su aplicación
web de simulación.
3. Inicie sesión en el Web Client con su cuenta de Microsoft o Google (seleccione Recordarme para
guardar sus credenciales). Web Client abre su aplicación de impresión web:
42
4. Elija una impresora de la lista desplegable para imprimir sus etiquetas.
5. Haga clic en Guardarpara recordar su impresora.
6. Mantenga su aplicación web en funcionamiento.
7. Haga clic en Imprimir en su aplicación de simulación para transmitir los datos de productos a su
Web Client en una cadena de consulta. Sus etiquetas se imprimen en su impresora local.
8. Si no tiene ningún controlador instalado, haga clic en Descargar controlador de impresora e instale
su controlador.
Su integración basada en clientes está congurada y lista para usar.
3.4. Apéndice B: API del desencadenador en la nube
Para habilitar la impresión con desencadenadores en la nube, se utiliza un sistema de integración
(NiceLabel Automation) instalado localmente para recibir y procesar datos de sus sistemas empresariales.
NiceLabel Automation expone las API a las que puede conectarse mediante las API Cloud Trigger desde
sus aplicaciones comerciales en la nube.
Además de la impresión de etiquetas, con las API podrá:
• Obtener vistas previas de etiquetas (PDF, PNG o JPEG)
• Informar estados en vivo de las impresoras de etiquetas
• Generar listas de todas las etiquetas en su Sistema de gestión documental (DMS)
• Obtener listas de impresoras disponibles
• Obtenga listas de variables denidas en su etiqueta
• Proporcionar trabajos de impresión (binarios)
IMPORTANTE
No tiene la obligación de usar ni de seguir estas muestras. Estas instrucciones se basan
en la conguración de muestra de NiceLabel Automation proporcionada en su paquete
de integración. Podrá modicar libremente su conguración o crear la suya propia desde
cero.
43
3.4.1. Ejecución de API Cloud Trigger
Cada desencadenador en la nube se identica con un nombre único. Debe hacer referencia al nombre
único en cada solicitud HTTP a nuestra API Cloud Trigger.
En el siguiente ejemplo, reemplace el «nombre_único_del_desencadenador_en_la_nube» con el nombre
del desencadenador en la nube único real denido en su conguración de NiceLabel Automation
(archivo .MISX).
Cada desencadenador en la nube denido en su conguración expone un método API. Se utilizan
diferentes desencadenadores para cada método. Un desencadenador para el método IMPRIMIR, otro para
el método VISTA PREVIA y otro más para el método IMPRESORAS, etc. Los nombres únicos le indican a
Automation qué desencadenador debe ejecutar.
Cuando carga e implementa/activa su conguración de Automation, Automation registra los
desencadenadores en la nube (nombres únicos) en su cuenta de NiceLabel Cloud. Podrá acceder a los
desencadenadores con las API Cloud Trigger. Cuando ejecuta API Cloud Trigger, su cuenta de NiceLabel
Cloud sabe dónde se está ejecutando su desencadenador de Automation registrado y reenvía los datos a
su desencadenador.
Puede tener varios servidores de NiceLabel Automation locales que ejecutan la misma conguración al
mismo tiempo con el equilibrio de carga rotatorio automático habilitado.
URL https://labelcloudapi.onnicelabel.com/Trigger/v1/CloudTrigger/
<unique_Cloud_Trigger_name>
Debe incluir el siguiente encabezado HTTP personalizado con cada solicitud:
Ocp-Apim-
Subscription-Key
<La clave de suscripción se genera en el Portal de desarrolladores cuando
registra el desarrollador de «Integración en la nube» desde el Centro de
Control>
Debe usar el método POST e incluir los datos JSON o XML en el cuerpo de su mensaje.
3.4.2. Registro como integradores
Para ejecutar las API Cloud Trigger, debe registrarse como desarrollador y obtener una clave de
suscripción. Podrá completar esta operación de autoservicio una vez que pueda iniciar sesión en su cuenta
de NiceLabel Cloud y cuando haya congurado su cuenta en nuestro Portal de desarrolladores.
Para obtener más información sobre el proceso de registro, lea nuestras guías de usuario:
• Capítulo Integraciones en la nube en la Guía del usuario del Centro de control de NiceLabel.
• Capítulo Cloud Trigger en la Guía del usuario de NiceLabel Automation.
44
3.4.3. Métodos de API
Nuestros métodos de API lo ayudan a probar y comprender las estructuras de los mensajes transferidos
entre sus aplicaciones comerciales y NiceLabel Automation. Incluimos ejemplos y descripciones de
solicitudes entrantes y estructuras de comentarios de NiceLabel Automation.
Podrá utilizar estructuras de datos JSON y XML con nuestros métodos API.
Para obtener más información sobre las cargas de datos entrantes, consulte el capítulo Estructuras de
datos.
3.4.4. Método IMPRESORAS
Este método recupera listas de impresoras disponibles que NiceLabel Automation puede usar. Sus listas
contienen nombres de controladores de impresora instalados en la computadora donde se ejecuta
NiceLabel Automation.
Debe enviar una carga de datos vacía para que la API determine qué tipo de respuesta necesita.
URL de solicitud
https://labelcloudapi.onnicelabel.com/Trigger/v1/CloudTrigger/CloudTrigger/Api-CloudIntegrationDemo-
Printers
Carga de datos JSON
{}
Carga de datos XML
<?xml version="1.0" encoding="utf-8"?>
3.4.5. Método IMPRIMIR
Este método imprime sus etiquetas. En las cargas de datos, usted proporciona:
• Nombres de etiquetas
• Versiones de etiquetas
• Nombre de impresoras
• Todos los datos de etiquetas para imprimir
URL de solicitud
https://labelcloudapi.onnicelabel.com/Trigger/v1/CloudTrigger/Api-CloudIntegrationDemo-Print
Carga de datos JSON
45
{
"FilePath": "/folder/label.nlbl",
"FileVersion": "",
"Quantity": “1”,
"Printer": " ZEBRA R-402",
"PrinterSettings": "",
"PrintJobName": "",
"Variables": [
{
"Name": "FIELD1",
"Value": "Value1"
},
{
"Name": "FIELD2",
"Value": "Value2"
}
]
}
Carga de datos XML
<?xml version="1.0" encoding="utf-8"?>
<PrintData>
<FilePath>/folder/label.nlbl</FilePath>
<FileVersion></FileVersion>
<Quantity>1</Quantity>
<Printer>ZEBRA R-402</Printer>
<PrinterSettings></PrinterSettings>
<PrintJobName></PrintJobName>
<Variables>
<Variable Name="FIELD1">Value1</Variable>
<Variable Name="FIELD2">Value2</Variable>
</Variables>
</PrintData>
3.4.6. Método CATÁLOGODEETIQUETAS
Este método devuelve listas de plantillas de etiquetas disponibles en carpetas (y subcarpetas) especícas
de su DMS.
URL de solicitud
https://labelcloudapi.onnicelabel.com/Trigger/v1/CloudTrigger/Api-CloudIntegrationDemo-LabelCatalog
Carga de datos JSON
{
"CatalogRoot": "/folder/subfolder",
46
"SubscriptionKey": "your_subscription_key"
}
Carga de datos XML
<?xml version="1.0" encoding="utf-8"?>
<PrintData>
<CatalogRoot>/folder/subfolder</CatalogRoot>
<SubscriptionKey>your_subscription_key</SubscriptionKey>
</PrintData>
NOTA
El campo SubscriptionKey es necesario para el NiceLabel Cloud Data Integration Pack
desarrollado para NiceLabel 10. Cuando usa la versión para NiceLabel 2019, no necesita
proporcionar una clave de suscripción.
3.4.7. Método VISTA PREVIA
Este método proporciona vistas previas de etiquetas en su formato requerido. Al igual que con el método
IMPRIMIR, debe proporcionar nombres de etiquetas, versiones y valores de datos. Los formatos de vista
previa admitidos incluyen PDF, JPG y PNG.
URL de solicitud
https://labelcloudapi.onnicelabel.com/Trigger/v1/CloudTrigger/Api-CloudIntegrationDemo-Preview
Carga de datos JSON
{
"FilePath": "/folder/label.nlbl",
"FileVersion": "",
"Quantity": “1”,
"Printer": "",
"PrinterSettings": "",
"PreviewFormat": "",
"Variables": [
{
"FIELD1": "Value1",
"FIELD2": "Value2"
}
]
}
Carga de datos XML
<?xml version="1.0" encoding="utf-8"?>
<PrintData>
47
<FilePath>/folder/label.nlbl</FilePath>
<FileVersion></FileVersion>
<Quantity>1</Quantity>
<Printer></Printer>
<PrinterSettings></PrinterSettings>
<PreviewFormat></PreviewFormat>
<Variables>
<Variable Name="FIELD1">Value1</Variable>
<Variable Name="FIELD2">Value2</Variable>
</Variables>
</PrintData>
3.4.8. Método TRABAJODEIMPRESIÓN
Este método devuelve sus etiquetas convertidas en trabajos de impresión para las impresoras de destino.
Por ejemplo, si su impresora de destino es Zebra, su contenido regresa en ZPL (lenguaje de programación
Zebra). Debe proporcionar nombres de etiquetas, versiones y valores de datos como con el método
IMPRIMIR.
URL de solicitud
https://labelcloudapi.onnicelabel.com/Trigger/v1/CloudTrigger/Api-CloudIntegrationDemo-PrintJob
Carga de datos JSON
{
"FilePath": "/folder/label.nlbl",
"FileVersion": "",
"Quantity": "1",
"Printer": "",
"PrinterSettings": "",
} "Variables": [
{
"FIELD1": "Value1",
"FIELD2": "Value2"
}
]
Carga de datos XML
<?xml version="1.0" encoding="utf-8"?>
<PrintData>
<FilePath>/folder/label.nlbl</FilePath>
<FileVersion></FileVersion>
<Quantity>1</Quantity>
<Printer></Printer>
<PrinterSettings></PrinterSettings>
48
<Variables>
<Variable Name="FIELD1">Value1</Variable>
<Variable Name="FIELD2">Value2</Variable>
</Variables>
</PrintData>
3.4.9. Método VARIABLES
Este método devuelve listas de las variables denidas en sus etiquetas especicadas. Es posible que
necesite conocer las variables denidas en su etiqueta para poder asignarles valores cuando ejecute el
método IMPRIMIR.
URL de solicitud
https://labelcloudapi.onnicelabel.com/Trigger/v1/CloudTrigger/Api-CloudIntegrationDemo-Variables
Carga de datos JSON
{
"FilePath": "/folder/label.nlbl",
"FileVersion": "",
}
Carga de datos XML
<?xml version="1.0" encoding="utf-8"?>
<PrintData>
<FilePath>/folder/label.nlbl</FilePath>
<FileVersion></FileVersion>
</PrintData>
3.4.10. Método ESTADODEIMPRESORAS
Este método le indica los estados de impresora en vivo informados por sus impresoras. No todas las
impresoras pueden informar sobre sus estados.
URL de solicitud
https://labelcloudapi.onnicelabel.com/Trigger/v1/CloudTrigger/Api-CloudIntegrationDemo-PrinterStatus
Carga de datos JSON
{
"Printer": "ZEBRA ZD420-300dpi ZPL"
}
Carga de datos XML
49
<?xml version="1.0" encoding="utf-8"?>
<PrintData>
<Printer>ZEBRA ZD420-300dpi ZPL</Printer>
</PrintData>
3.4.11. Estructuras de datos
Su conguración de API acepta cargas de datos JSON y XML. Su conguración determina
automáticamente su tipo de carga y responde usando el mismo tipo.
3.4.12. Cargas de datos entrantes
Las estructuras de datos a continuación incluyen todos los campos posibles. Los campos que usará
dependen de su método de API. Consulte el capítulo Métodos de API para obtener una lista de campos
aplicables a su método de API particular.
Estructura de carga JSON
{
"FilePath": "/folder/label.nlbl",
"FileVersion": "",
"Quantity": "1",
"Printer": "",
"PrinterSettings": "",
"PrintJobName": "",
"PreviewFormat": "",
"CatalogRoot": "",
"SubscriptionKey": "",
"Variables": [
{
"Variable1": "Value1",
"Variable2": "Value2"
}
],
"Report": [
{
"Pos": "01",
"Code": "100"
"Name": "Product 1"
},
{
"Pos": "02",
"Code": "200"
"Name": "Product 2"
}
50
]
}
Puede utilizar el objeto Informe JSON opcional cuando imprima documentos de envío como albaranes y
notas de entrega.
Los elementos dentro de los objetos Informe JSON se convierten en estructuras adecuadas para los
objetos de Informe en sus plantillas de etiquetas. Por ejemplo, las variables «Pos», «Código» y «Nombre»
del ejemplo se utilizan en el objeto Informe con los mismos nombres. También puede utilizar sus propios
nombres de variables. Si no tiene la intención de usar objetos Informe en su plantilla de etiqueta, puede
omitir el objeto Informe JSON.
Estructura de carga XML
<?xml version="1.0" encoding="utf-8"?>
<PrintData>
<FilePath>/folder/label.nlbl</FilePath>
<FileVersion>1</FileVersion>
<Quantity>1</Quantity>
<Printer></Printer>
<PrinterSettings></PrinterSettings>
<PrintJobName></PrintJobName>
<PreviewFormat></PreviewFormat>
<CatalogRoot></CatalogRoot>
<SubScriptionKey></SubscriptionKey>
<Variables>
<Variable Name="Variable1">Value1</Variable>
<Variable Name="Variable2">Value2</Variable>
</Variables>
<Report>
<Item>
<Pos>01</Pos>
<Code>100</Code>
<Name>Product 1</Name>
</Item>
<Item>
<Pos>02</Pos>
<Code>200</Code>
<Name>Product 2</Name>
</Item>
</Report>
</PrintData>
Descripciones de campo
51
NOMBRE DESCRIPCIÓN
FilePath Nombre completo de la ruta y nombre de la etiqueta del Almacenamiento de
documentos.
FileVersion Versión de archivo de etiquetas. Si utiliza versiones principales/secundarias,
escriba su versión como «0.1» o «1.1». Si utiliza versiones principales, escriba
su versión como «1» o «2».
Cuando no escribe valores, se utiliza la última revisión disponible. Si usa ujos de
trabajo de aprobación, se usa la última versión de etiqueta aprobada.
Cantidad Número de etiquetas para imprimir.
Impresora Nombre de la impresora donde se imprimen sus etiquetas. Este debe ser el
nombre exacto de la impresora instalada en su computadora con Windows con
NiceLabel Automation.
PrinterSettings Estructura DEVMODE codicada en Base64. Se utiliza para anular la
conguración de la impresora guardada en su plantilla de etiqueta o recuperada
desde su controlador de impresora.
NOTA
Puede crear aplicaciones PowerForms para congurar los
ajustes de la impresora y exportar los ajustes a DEVMODE.
También puede exportar la conguración a DEVMODE desde
el controlador de su impresora con una aplicación que puede
descargar desde nuestro sitio web (Descargas > Utilidades y
software de soporte).
PrintJobName Nombres de archivos de trabajo que se muestran en Windows Spooler. Si se
omite, el nombre de su trabajo es el nombre de su archivo de etiqueta por
defecto.
PreviewFormat Formato de vista previa de la etiqueta. Los formatos disponibles incluyen PDF,
PNG y JPEG. Si no se especica, PDF es su formato predeterminado.
CatalogRoot Carpeta de inicio donde crea su catálogo de etiquetas. Su catálogo también
incluye etiquetas de todas las subcarpetas.
NOTA
Si solicita catálogos de etiquetas de grandes repositorios de
Almacenamiento de documentos, le puede llevar varios minutos
completar su solicitud.
SubscriptionKey Una clave de suscripción para generar el catálogo de etiquetas. La conguración
de Automation consume el API de Documento para generar el catálogo de
etiquetas y necesita una clave de suscripción para la autenticación. Puede
obtener su Clave de suscripción del Portal de desarrolladores.
52
NOMBRE DESCRIPCIÓN
Variables Pares de nombre y valor para sus variables de etiqueta. Para cada «nombre»,
debe proporcionar un «valor» coincidente. Debe enviar todos los pares de
nombre y valor a su etiqueta para usarlos con variables denidas con el mismo
«nombre». El mapeo de valores se realiza automáticamente en función de
nombres coincidentes.
Informe Varios elementos que proporcionan pares de nombre y valor para las variables
utilizadas en el objeto Informe en la plantilla de etiqueta. Cada «elemento» se
utiliza como una nueva la en el objeto Informe. Este es un campo opcional.
3.4.13. Mensajes con comentarios
Automation proporciona resultados de procesamiento de datos a las aplicaciones comerciales en
respuestas sincrónicas. Las respuestas siempre coinciden con las estructuras de carga de datos entrantes.
Cuando envía solicitudes con formato JSON, recibe respuestas JSON. Cuando envía solicitudes con
formato XML, recibe respuestas XML.
•Ejecución exitosa. Si no hay errores de procesamiento de datos, los sistemas empresariales reciben
mensajes con formato JSON o XML. Su estructura de respuesta depende del método de API que
ejecute.
•Ejecución errónea. Si hay errores de procesamiento como «etiqueta no encontrada», «impresora
no disponible» o «datos incorrectos para objetos de etiqueta», su desencadenador de NiceLabel
Automation genera un error y envía detalles en la respuesta del desencadenador.
Para las cargas de datos XML, la API proporciona comentarios en el encabezado HTTP y en el cuerpo del
mensaje. Para las cargas de datos JSON, las respuestas contienen mensajes HTML sin detalles de error
(una próxima versión de NiceLabel incluirá respuestas JSON con detalles de error).
Puede ver registros de errores detallados en el NiceLabel Automation Manager para cada tipo de
respuesta.
Estructuras de lista de impresoras
Cada impresora tiene elementos de Impresora.
NOMBRE DESCRIPCIÓN
PrinterNam
e
Nombre del controlador de impresora de Windows visible para NiceLabel Automation.
Los usuarios de Windows pueden cambiar este nombre.
DriverNam
e
Nombre del modelo de impresora de Windows (denido por el controlador de la
impresora). Los usuarios de Windows no pueden cambiar este nombre.
Estructuras variables
Cada variable en su etiqueta contiene elementos Variables.
Para obtener más información, lea nuestra guía del usuario:
53
• Capítulo Cómo obtener información de etiquetas en la Guía del usuario de NiceLabel Automation.
NOMBRE DESCRIPCIÓN
Nombre Nombre de la variable.
Descripción Descripción de variable.
DefaultValue Valor predeterminado denido para su variable durante el diseño de la etiqueta.
Formato Tipos aceptables de contenido variable (caracteres).
IsPrompted Muestra si la variable se solicita en el momento de la impresión.
PromptText Texto que solicita a los usuarios que introduzcan valores.
CurrentValue Valor real utilizado para la impresión.
IncrementType Muestra si la variable está denida como contador. Si se identica como
contador, IncrementType muestra el tipo de contador.
IncrementStep Información sobre pasos del contador. El valor de su contador aumenta/
disminuye por este valor en su próxima etiqueta.
IncrementCount Información de aumento/disminución del valor del contador. Los contadores
suelen cambiar los valores de cada etiqueta, pero puede elegir incrementos
personalizados.
Longitud Número máximo de caracteres almacenados en la variable.
IsPickListEnable
d
Muestra si sus usuarios seleccionan valores de variables de una lista de
selección.
PickListValues Valores de lista de selección reales (seleccionables).
Estructuras de Catálogo de etiquetas
A continuación se muestra solo una estructura de muestra devuelta para el Catálogo de etiquetas.
• La conguración de Automation para NiceLabel 10 genera el catálogo de etiquetas utilizando la API
de Documento desde el Portal de desarrolladores (debe iniciar sesión para ver el contenido). La
muestra utiliza un pequeño subconjunto de lo que proporcionó la API de Documento.
• La conguración de Automation para NiceLabel 2019 utiliza una aplicación de ayuda CLI (interfaz de
línea de comandos), que tiene una funcionalidad limitada.
NOTA
Puede cambiar la estructura del catálogo de etiquetas devuelta para que se ajuste a sus
requisitos. Simplemente edite el desencadenador que genera el catálogo de etiquetas en la
conguración de Automation proporcionada.
La estructura de muestra que proporciona la conguración de NiceLabel 10 es la siguiente:
54
NOMBRE DESCRIPCIÓN
Id Identicación interna de las plantillas de etiquetas generadas en el Sistema de
gestión documental.
ItemPath La ruta completa y el nombre de archivo de la plantilla de etiqueta.
Creado Marca de tiempo de creación.
Modicado Marca de tiempo de modicación.
ModiedBy Identicación del usuario que modicó la plantilla de etiqueta por última vez.
VersionNumber La versión de la plantilla de etiqueta más reciente.
WorkowName El nombre de un ujo de trabajo denido para la carpeta en la que se guarda la
plantilla de etiqueta.
WorkowStepNam
e
El nombre del paso de ujo de trabajo que ocupa la plantilla de etiqueta.
La estructura que proporciona la conguración de NiceLabel 2019 es la siguiente:
NOMBRE DESCRIPCIÓN
Nombre Nombre de la etiqueta, incluida la ruta desde la carpeta raíz del Almacenamiento
de documentos. Los nombres de los servidores y los números de puerto no están
incluidos; NiceLabel Automation conoce las ubicaciones del DMS.
Ancho Ancho de etiqueta en 1/1000 milímetros.
Altura Altura de la etiqueta en 1/1000 milímetros.
PrinterName La impresora para la que está diseñada su etiqueta.
NOTA
Puede especicar diferentes impresoras para imprimir. NiceLabel
Automation adapta las plantillas de etiquetas para sus nuevos
tipos de impresoras.
Descripción Descripción de la etiqueta que puede congurar.
Revisiones Lista delimitada por comas de revisiones accesibles para NiceLabel Automation.
NOTA
El control de acceso basado en roles (RBAC) determina la
visibilidad de la etiqueta. Cuando ejecuta NiceLabel Automation
como Operador (práctica recomendada), solo puede acceder a
las revisiones de etiquetas aprobadas.
55
4. Integración de la gestión de la cadena
de suministro de Microsoft Dynamics 365
NOTA
Esta integración funciona con:
•Gestión de la cadena de suministro de Microsoft Dynamics 365 (D365SCM)
•Microsoft Dynamics 365 Finance
•Microsoft Dynamics 365 for Finance and Operations (nombre anterior)
•Microsoft Dynamics 365 for Finance and Operations Enterprise Edition (nombre
anterior)
Nos referimos a todas estas ediciones como D365SCM.
Esta integración no funciona con:
•Microsoft Dynamics 365 for Finance and Operations Business Edition
Aprenda a integrar la impresión NiceLabel en Microsoft Dynamics 365 Supply Chain Management
(D365SCM) con NiceLabel Cloud. Personalice el código de nuestra integración de muestra en GitHub
para habilitar la impresión NiceLabel directamente desde D365SCM en su entorno de impresión especíco.
Podrá descargar e implementar nuestra integración de muestra en D365SCM Lifecycle Services como otras
integraciones. Puede personalizar su código de integración para incluir la información de conguración de
su impresora y otros datos de D365SCM para usar en las etiquetas que imprima.
NiceLabel Cloud es un sistema de administración de etiquetas basado en la nube que le permite imprimir
en la nube y en impresoras clásicas.
• Las impresoras en la nube son dispositivos inteligentes que se conectan a NiceLabel Cloud sin
necesidad de instalar software. NiceLabel Cloud imprime en impresoras en la nube mediante API
REST Cloud Print con formatos de solicitud predenidos.
• Las impresoras clásicas requieren instalación en computadoras con Windows. NiceLabel Cloud
imprime con NiceLabel Automation. Instale NiceLabel Automation en su computadora para gestionar
el procesamiento de datos y la impresión con impresoras clásicas. Podrá activar la impresión con
API REST Cloud Trigger en cualquier formato de solicitud. Su conguración de Automation determina
cómo procesar las solicitudes.
Impresoras en la nube Impresoras clásicas
Solo impresoras compatibles con
NiceLabel Cloud.
Todas las impresoras compatibles con Windows.
56
Impresoras en la nube Impresoras clásicas
Sin presencia local. Computadora local con Windows y NiceLabel 10 y
controladores de impresora instalados.
Procesamiento de datos e impresión
predenidos.
Conguración de Automation para procesamiento de
datos e impresión personalizados.
Su integración se conecta a NiceLabel Cloud e imprime desde D365SCM con API REST. NiceLabel Cloud
combina datos de llamadas a API REST con plantillas de etiquetas almacenadas en NiceLabel Cloud para
crear etiquetas completas que imprime en la nube o en las impresoras clásicas que elija:
Cómo funcionan las integraciones de D365SCM.
4.1. Conguración de NiceLabel
4.1.1. 1. Obtenga su cuenta de NiceLabel Cloud
Para integrar la impresión en la nube de NiceLabel desde D365SCM, necesita una cuenta en la nube de
NiceLabel. Comuníquese con ventas para obtener una licencia o una cuenta de prueba.
Una vez que obtenga su cuenta, instale NiceLabel 10 en su computadora.
La conexión de impresoras en la nube no requiere software, pero necesita NiceLabel 10 para diseñar y
cargar nuevas plantillas de etiquetas.
Vaya al Centro de control de NiceLabel > Panel > Acciones comunes y haga clic en Descargar Nicelabel 10.
57
4.1.2. 2. Conecte impresoras a su cuenta de NiceLabel Cloud
Desde el Centro de control, podrá conectar:
• Impresoras en la nube compatibles con NiceLabel Cloud o
• Impresoras clásicas en computadoras con Windows
4.1.2.1. Conexión de impresoras en la nube
Conecte sus impresoras en la nube a NiceLabel Cloud para poder imprimir desde D365SCM con API REST
Cloud Print.
Para obtener más información, lea https://help.nicelabel.com/hc/articles/4407466158737-Cloud-Printers.
Incorporación de una impresora en la nube llamada ACME_A1.
4.1.2.2. Conexión de impresoras clásicas
1. Instale sus impresoras con controladores de impresora NiceLabel en la misma computadora donde
instaló NiceLabel 10. Esta computadora actúa como un servidor para su entorno de impresión
NiceLabel y debe permanecer encendida y conectada. Para obtener más información, lea https://
help.nicelabel.com/hc/en-001/categories/4408474153489-Printer-Driver-Installation.
2. Para ver su lista de impresoras instaladas, en su computadora, presione Windows+R y ejecute
printmanagement.msc.
Su lista de impresoras instaladas en su computadora con Windows en printmanagement.msc.
3. Descargue LabelCloudDataIntegrationPack.zip. Extraiga el archivo zip y abra la
carpeta Almacenamiento de documentos. Ejecute el archivo CloudIntegration-
CloudTrigger.misx, implemente la conguración e inicie los desencadenadores para permitir
que las API REST Cloud Trigger usen las impresoras instaladas en su computadora.
58
Ejecución de CloudIntegration-CloudTrigger.misx en Automation Manager.
Para habilitar la impresión con desencadenadores en la nube, consulte el tema API Cloud Trigger.
Para obtener más información, lea:
• el tema Cloud Trigger;
• el tema Paquete de integración;
• el tema API Cloud Trigger.
4.1.3. 3. Cree sus plantillas de etiquetas
59
Creación de una plantilla de etiqueta dinámica en NiceLabel Designer.
Las plantillas de etiquetas que crea en NiceLabel Designer pueden usar variables conectadas a datos de
D365SCM. Nuestra integración de muestra conecta datos de su libreta de direcciones global de D365SCM
para crear etiquetas de direcciones dinámicas a partir de plantillas almacenadas en el Centro de control de
NiceLabel.
Para imprimir etiquetas de dirección desde D365SCM con nuestra integración de muestra:
1. Cree una plantilla de etiqueta en NiceLabel Designer. Para obtener más información, lea https://
help.nicelabel.com/hc/articles/4406561608081-Label.
2. Agregue variables en su plantilla para usar con datos de su libreta de direcciones
global de D365SCM. Para obtener más información, lea https://help.nicelabel.com/hc/articles/
4402152654097-Variables.
3. Nombre su plantilla de etiquetas AddressLabel.nlbl.
4. Guarde el AddressLabel.nlbl en el Centro de control > Documentos > Etiquetas. Para obtener más
información, lea https://help.nicelabel.com/hc/articles/4402320800401-Documents.
Su plantilla de etiqueta guardada está lista para abrirse en su integración de muestra e imprimirse desde
D365SCM.
4.1.4. 4. Habilite las API REST
Incorporación de una nueva integración en el Centro de control.
Para realizar llamadas a API REST e imprimir etiquetas desde D365SCM, debe conectar su suscripción al
portal de desarrolladores de NiceLabel con el Centro de control:
1. Vaya al Centro de control > Integraciones > Integraciones en la nube.
2. Agregue una nueva Integración en la nube para D365SCM.
3. Regístrese en el Portal de desarrolladores.
4. En el portal de desarrolladores, agregue una nueva suscripción de producto y conéctela a su cuenta
de NiceLabel Cloud. Utilice esta suscripción con su entorno de producción D365SCM principal.
60
5. Abra Centro de control > Integraciones > Integraciones en la nube nuevamente y asegúrese de que
su integración esté conectada.
Para obtener instrucciones de conguración completas e información adicional, lea:
•Impresoras en la nube
•Integraciones en la nube.
4.1.5. 5. Impresión de prueba
En el portal de desarrolladores, pruebe imprimir sus etiquetas en sus impresoras conectadas con llamadas
a API REST. Si sus impresiones de prueba fallan, verique su conguración e intente nuevamente antes de
congurar su integración de muestra D365SCM.
• Para impresoras en la nube, llame a la función de impresión con los nombres de las impresoras en
https://developerportal.onnicelabel.com/docs/services/cloud-print/operations/put-printfunction.
• Para impresoras clásicas, llame a la función desencadenadora con el nombre de desencadenador
Api-CloudIntegrationDemo-Print en https://developerportal.onnicelabel.com/docs/services/cloud-
trigger/operations/put-cloudtriggerfunction.
Puede cambiar los valores de la ruta del archivo y la impresora a valores reales y probar la impresión de
una etiqueta con una solicitud JSON:
{
"Printer":"ACME_A1",
"FilePath":"/Labels/AddressLabel.nlbl",
"Quantity":1,
"Variables":[
{
"name":"A. Datum Corporation",
"address":"123 Main Street",
"city":"Sacramento",
"postCode":"94279",
"country":"United States"
}
]
Con su integración en la nube congurada correctamente en NiceLabel Cloud, puede comenzar su
conguración de integración D365SCM.
61
4.2. Integración de muestra de D365SCM
Etiqueta de dirección impresa.
Nuestra integración de muestra agrega una página de conguración de integración de impresión de
NiceLabel y un botón de impresión de NiceLabel a su página de libreta de direcciones global en D365SCM.
Nuestra integración de muestra le permite imprimir etiquetas NiceLabel directamente desde D365SCM
utilizando los datos de la libreta de direcciones global de D365SCM y las plantillas de etiquetas NiceLabel.
La integración utiliza impresoras en la nube o impresoras clásicas con conguraciones de Cloud Trigger y
solicitudes de Cloud Print predenidas. Para ejecutar nuestra integración de muestra en D365SCM, cargue
el paquete desplegable desde GitHub a su interfaz de Lifecycle Services.
Personalice su código de integración de muestra de D365SCM para su entorno y requisitos de impresión
especícos. Para editar y adaptar nuestra integración de muestra a sus propias necesidades, necesita una
máquina virtual con Visual Studio ejecutándose en su interfaz de Lifecycle Services. Para editar el código
fuente, necesita el complemento Dynamics 365 en su Visual Studio. Haga clic aquí para leer cómo importar
y exportar proyectos D365SCM en Virtual Studio. Incluya la información de conguración de su impresora
personalizada y otros datos de D365SCM para usar en las etiquetas que impriman sus usuarios. Agregue
los datos de D365SCM que desea usar en las variables de sus plantillas de etiquetas a su código de
integración.
Antes de que sus usuarios puedan imprimir con nuestra integración de muestra, establezca su
conguración de integraciones D365SCM con 3 pestañas de conguración para que sus usuarios puedan
imprimir registros seleccionados utilizando etiquetas seleccionadas en impresoras clásicas y en la nube
seleccionadas directamente desde D365SCM.
Nuestra integración de muestra llama a las API REST Cloud y envía los siguientes datos:
• Nombre de la impresora
• Plantilla de etiqueta
• Cantidad de impresión
• Datos de registros seleccionados para usar en la plantilla de etiqueta
62
4.3. Conguración de integración de impresión de
NiceLabel
Congure nuestra integración de muestra con los datos básicos que sus usuarios necesitan para realizar
llamadas a API REST de impresión al presionar el botón NiceLabel Print en D365SCM.
En D365SCM, vaya a Administración del sistema > Conguración > Integración de impresión NiceLabel
Cómo abrir la conguración de integración de impresión de NiceLabel en D365SCM.
Congure las siguientes 3 pestañas de conguración:
• General
• Impresoras
• Plantillas
Antes de comenzar, congure cuidadosamente cualquier dato que use para realizar llamadas a API REST
de impresión.
4.3.1. Pestaña general
La pestaña de conguración General incluye la información de su cuenta necesaria para cada llamada a
API REST.
63
• Establezca la URL del servicio en la ubicación de la API REST https://labelcloudapi.onnicelabel.com.
• Establezca como Clave de suscripción su clave de suscripción del Portal de desarrolladores. Utilice la
clave de suscripción para su entorno de producción principal.
4.3.1.1. Código: Pestaña general
El formulario NLPIntegrationParameters guarda sus parámetros en la tabla NLPGeneralParameters.
4.3.2. Pestaña Impresoras
Conguración de la pestaña de conguración de Impresoras para usuarios de D365SCM.
La pestaña de conguración de Impresoras permite a sus usuarios recuperar una lista de impresoras
conectadas a NiceLabel Cloud y las pone a disposición para su selección en el formulario de impresión.
En la pestaña Impresoras, haga clic en Actualizar para poder:
• Obtener una lista actualizada de impresoras conectadas a NiceLabel Cloud.
• Guardar su lista de impresoras en su base de datos de D365SCM.
Si congura su pestaña General correctamente, obtendrá una respuesta exitosa:
Si congura su pestaña General incorrectamente, obtendrá un error:
4.3.2.1. Código: NLPIntegrationParameters
Al hacer clic en Impresoras > Actualizar llama al método
NLPIntegrationParameters.RefreshButton_OnClicked. Este método tiene 3 funciones principales:
64
• Eliminar listas de impresoras existentes de la tabla NLPPrinterParameters.
• Obtener nuevas listas de impresoras de API REST.
• Guardar nuevas listas de impresoras en la tabla de NLPPrinterParameters.
Tenga en cuenta la clase NLPrinting en este método. Para obtener listas de impresoras conectadas, llame
a su método NLGetPrinters asociado.
public static void RefreshButton_OnClicked(FormControl sender,
FormControlEventArgs e)
{
// delete previous printers list
...
NLPrinting NLPrint = new NLPrinting();
System.String[] listOfPrinters = NLPrint.NLGetPrinters();
int numOfPrinters = listOfPrinters.Length;
...
// save new printers list
}
4.3.2.2. Código: Conceptos básicos de la clase NLPrinting
NLPrinting es un contenedor de C# para NLApiClient.dll. Personalice su integración al cambiar el valor del
parámetro useCloudPrinting para imprimir en impresoras en la nube con API Cloud Print o impresoras
clásicas conectadas a NiceLabel Automation con conguraciones predenidas de API Cloud Trigger
(.misx).
• Para usar impresoras en la nube, establezca useCloudPrinting en verdadero.
• Para usar impresoras clásicas, establezca useCloudPrinting en falso.
class NLPrinting
{
private boolean useCloudPrinting = true;
public boolean configValid;
private str NLPrintServiceURL;
private str NLPrintSubscriptionKey;
private NLApiClient.BaseIntegrator obj;
...
}
El constructor de la clase NLPrinting lee la URL del servicio y la Clave de suscripción de la tabla
NLPGeneralParameters y se asegura de que estén presentes. Estos dos parámetros obligatorios se
65
guardan en Conguración de integración > pestaña General. La vericación valida su instancia de clase de
integrador de la nube en función del parámetro useCloudPrinting. Su instancia de clase es responsable de
todas las llamadas a API REST.
class NLPrinting
{
...
void new()
{
this.NLPrintGetURLAndKey();
if(configValid)
{
if (useCloudPrinting)
{
obj = new NLApiClient.CloudPrintIntegrator(NLPrintServiceURL);
}
else
{
obj = new
NLApiClient.CloudTriggerIntegrator(NLPrintServiceURL);
}
}
else
{
obj = null;
}
}
...
}
4.3.2.3. Código: NLPrinting.NLGetPrinters
Se llama a la API REST en función de su conguración de UseCloudPrinting:
• Para Impresoras en la nube, use la API REST de impresoras GET. Puede probar esta llamada
en el portal de desarrolladores: https://developerportal.onnicelabel.com/docs/services/cloud-print/
operations/get-printersfunction
• Para Impresoras clásicas, utilice la API REST Cloud Trigger PUT con el nombre de
desencadenador Api-CloudIntegrationDemo-Printers. Puede probar esta llamada en el portal
de desarrolladores: https://developerportal.onnicelabel.com/docs/services/cloud-trigger/operations/
put-cloudtriggerfunction
public System.String[] NLGetPrinters()
{
if (configValid)
66
{
if (useCloudPrinting)
{
return (obj as
NLApiClient.CloudPrintIntegrator).GetPrintersArray(NLPrintSubscriptionKey);
}
else
{
return (obj as
NLApiClient.CloudTriggerIntegrator).GetPrintersArray(NLPrintSubscriptionKey);
}
}
else
{
return null;
}
}
4.3.3. Pestaña Plantillas
La impresión desde D365SCM con API REST utiliza plantillas de etiquetas almacenadas en NiceLabel
Cloud > Documentos. Para facilitar la selección de plantillas para sus usuarios, cree una lista de plantillas
de etiquetas y asigne a cada plantilla un nombre fácil de usar en la pestaña de conguración de Plantillas.
Cómo agregar y nombrar plantillas de etiquetas desde el Centro de control para usar en D365SCM.
Agregue rutas de plantillas de etiquetas desde sus archivos almacenados en Centro de control >
Documentos.
1. Haga clic con el botón derecho en un archivo de plantilla de etiqueta que desee incluir y seleccione
Obtener información. Se abre la ventana Información del archivo:
67
2. Copie la ruta del archivo después de su URL de NiceLabel Cloud:
3. Pegue la ruta en el campo Ruta de la plantilla para una nueva plantilla en la pestaña deD365SCM >
Conguración de integración de impresión NiceLabel > Plantillas.
68
4. Escriba un Nombre de plantilla único y fácil de usar para cada plantilla que agregue para que sus
usuarios sepan qué etiquetas seleccionar e imprimir desde D365SCM.
4.3.3.1. Código: pestaña de plantillas
El formulario NLPIntegrationParameters guarda las rutas de sus plantillas en la tabla
NLPGeneralParameters.
4.4. Impresión desde D365SCM
Nuestra integración de muestra agrega un botón de Impresión NiceLabel a D365SCM que abre una ventana
de Impresión NiceLabel para permitir que sus usuarios impriman etiquetas después de elegir su plantilla,
impresora y cantidad de impresiones y hacer clic en Aceptar.
Formulario de impresión personalizada dentro de D365SCM.
Para imprimir etiquetas desde D365SCM en nuestra integración de muestra, vaya a D365SCM > Módulos >
Común > Libreta de direcciones global.
1. Seleccione registros para imprimir.
2. Haga clic en Impresión NiceLabel en el menú superior. Se abre la ventana de Impresión NiceLabel.
3. Elija su Impresora. El menú desplegable muestra una lista de las impresoras recuperadas
anteriormente.
4. Elija su Plantilla de etiqueta.
5. Elija cuántas copias imprimir para cada registro seleccionado.
6. Haga clic en Aceptar.
69
Sus etiquetas seleccionadas se imprimen en su impresora seleccionada desde D365SCM. Verá un mensaje
de noticación de éxito.
Etiquetas de dirección impresas con datos de D365SCM.
Impresión exitosa de etiquetas desde D365SCM.
4.4.1. Código: DirPartyTable.NiceLabelPrinting
Esta integración de muestra amplía su libreta de direcciones global con la extensión
de formularioDirPartyTable.NiceLabelPrinting y agrega un botón de Impresión NiceLabel.
Cuando sus usuarios hacen clic en el botón Impresión NiceLabel, llaman al método
DirPartyTable_NiceLabelPrinting.NLPrint_OnClicked.
70
4.4.2. Código: DirPartyTable_NiceLabelPrinting.NLPrint_OnClicked (Part 1)
Al hacer clic en el botón Impresión NiceLabel, se crea un objeto NLPrinting y se verican los parámetros
de conguración desde Conguración de integración > pestaña General. Después de la vericación, el
proceso continúa al abrir el cuadro de diálogo NLPPrintDialog.
public static void NLPrint_OnClicked(FormControl sender, FormControlEventArgs
e)
{
// Verify REST API configuration
NLPrinting nlp = new NLPrinting();
if (!nlp.configValid)
{
error("Printing configuration is not valid!");
return;
}
// Open print dialog
NLPPrintDialog dialog = new NLPPrintDialog();
if(!dialog.prompt())
return;
// Collect basic print parameters
...
}
4.4.3. Código: NLPPrintDialog
Sus usuarios usan el NLPPrintDialog para escribir la información requerida para cada solicitud de
impresión:
• En qué impresoras imprimir.
• Qué plantillas de etiquetas usar.
• Cuántas copias imprimir.
NOTA
Si falta alguna parte de esta información, obtendrá errores de llamada a la API REST.
El NLPPrintDialog utiliza datos guardados en las pestañas de Conguración de integración para que sus
usuarios puedan seleccionar impresoras y nombres de plantillas de listas, y solo necesitan escribir una
cantidad para imprimir.
class NLPPrintDialog extends RunBase
{
71
public DialogField fieldPrinterName;
public DialogField fieldTemplateName;
public DialogField fieldQuantity;
public Object Dialog()
{
Dialog dialog;
dialog = super();
dialog.caption("@NiceLabelPrintingDemo:NLPPrint");
fieldPrinterName = dialog.addField(extendedTypeStr(NLPEDTPrinterId),
"@NiceLabelPrintingDemo:NLPPrinter");
fieldPrinterName.mandatory_RU(true);
fieldTemplateName = dialog.addField(extendedTypeStr(NLPEDTTemplateId),
"@NiceLabelPrintingDemo:NLPTemplate");
fieldTemplateName.mandatory_RU(true);
fieldQuantity = dialog.addField(extendedTypeStr(NLPEDTQuantity),
"@NiceLabelPrintingDemo:NLPQuantity");
fieldQuantity.mandatory_RU(true);
fieldQuantity.value(1);
return dialog;
}
}
4.4.4. Código: DirPartyTable_NiceLabelPrinting.NLPrint_OnClicked (Part 2)
Su entrada de usuario determina el siguiente paso del proceso de impresión:
• Los usuarios hacen clic en Cancelar para salir del proceso de impresión.
• Los usuarios hacen clic en Aceptar para continuar con la recopilación de valores de parámetros de
diálogo.
Puede usar los nombres de las impresoras seleccionadas y las cantidades de impresión proporcionadas
directamente, pero no para las rutas de las plantillas de etiquetas que obtiene con el método
NLPrinting.GetTemplatePath. Todos sus parámetros básicos de impresión estarán recopilados.
public static void NLPrint_OnClicked(FormControl sender, FormControlEventArgs
e)
{
...
// Open print dialog
NLPPrintDialog dialog = new NLPPrintDialog();
72
if(!dialog.prompt())
return;
// Collect basic print parameters
str selectedPrinter = dialog.fieldPrinterName.value();
str selectedTemplate = dialog.fieldTemplateName.value();
int selectedQuantity = dialog.fieldQuantity.value();
str templatePath = nlp.GetTemplatePath(selectedTemplate);
// Start building JSON print request
...
}
4.4.5. Código: NLPrinting.GetTemplatePath
Este método busca rutas de plantillas de etiquetas guardadas con los nombres de plantilla que
proporcione. Sus datos se guardan en la tabla NLPTemplateParameters desde Conguración de
integración > Plantillas.
public str GetTemplatePath(str templateName)
{
NLPTemplateParameters templateParameters;
select TemplatePath from templateParameters where
templateParameters.TemplateName == templateName;
return templateParameters.TemplatePath;
}
4.4.6. Código: DirPartyTable_NiceLabelPrinting.NLPrint_OnClicked (Part 3)
Sus parámetros básicos recopilados y preparados construyen sus solicitudes de impresión JSON. Sus
parámetros de impresión básicos se incluyen en raíces de objetos JSON y siempre deben estar presentes.
public static void NLPrint_OnClicked(FormControl sender, FormControlEventArgs
e)
{
...
// Start building JSON print request
StringWriter stringWriter = new System.IO.StringWriter();
JsonTextWriter jsonWriter = new
Newtonsoft.Json.JsonTextWriter(stringWriter);
jsonWriter.WriteStartObject();
73
// Add basic print parameters to JSON request
jsonWriter.WritePropertyName("Printer");
jsonWriter.WriteValue(selectedPrinter);
jsonWriter.WritePropertyName("FilePath");
jsonWriter.WriteValue(templatePath);
jsonWriter.WritePropertyName("Quantity");
jsonWriter.WriteValue(selectedQuantity);
// Add your variable parameters to JSON request
...
}
El objeto variables sigue sus parámetros básicos. Su integración de muestra llena los valores de las
variables con los valores reales de los registros seleccionados del libro de direcciones.
Sus variables se incluyen en objetos JSON raíz como matrices de objetos JSON. Cada objeto JSON en una
matriz de variables representa 1 conjunto de variables correspondientes a 1 registro D365SCM.
Por ejemplo, para imprimir 2 registros D365SCM, debe proporcionar 2 conjuntos de valores de variables.
public static void NLPrint_OnClicked(FormControl sender, FormControlEventArgs
e)
{
...
// Add your variable parameters to JSON request
jsonWriter.WritePropertyName("Variables");
jsonWriter.WriteStartArray();
DirPartyTable partyRecord;
DirPartyPostalAddressView addressRecord;
LogisticsAddressCountryRegionNameView countryRecord;
MultiSelectionHelper selection = MultiSelectionHelper::construct();
selection.parmDatasource(sender.formRun().dataSource(tableStr(DirPartyTable)));
partyRecord = selection.getFirst();
while (partyRecord.RecId != 0)
{
select Street, StreetNumber, City, ZipCode, CountryRegionId from
addressRecord
where addressRecord.IsPrimary == NoYes::Yes && addressRecord.Party
== partyRecord.RecId;
select ShortName from countryRecord
where countryRecord.CountryRegionId == addressRecord.CountryRegionId
74
&& countryRecord.LanguageId == CompanyInfo::languageId();
// add hard-coded en-us if there is no record for languageid()
jsonWriter.WriteStartObject();
jsonWriter.WritePropertyName("name");
jsonWriter.WriteValue(partyRecord.Name);
jsonWriter.WritePropertyName("address");
jsonWriter.WriteValue(addressRecord.Street + " " +
addressRecord.StreetNumber);
jsonWriter.WritePropertyName("city");
jsonWriter.WriteValue(addressRecord.City);
jsonWriter.WritePropertyName("postCode");
jsonWriter.WriteValue(addressRecord.ZipCode);
jsonWriter.WritePropertyName("country");
jsonWriter.WriteValue(countryRecord.ShortName);
jsonWriter.WriteEndObject();
partyRecord = selection.getNext();
}
jsonWriter.WriteEndArray();
// complete building JSON request
...
}
La incorporación de valores de variables completa sus objetos de solicitud JSON. Para imprimir, debe
llamar al método NLPrinting.NLPrintJSON.
public static void NLPrint_OnClicked(FormControl sender, FormControlEventArgs
e)
{
...
// complete building JSON request
jsonWriter.WriteEndObject();
// call REST API and perform print
info(nlp.NLPrintJSON(selectedPrinter, stringWriter.ToString()));
}
75
4.4.7. Código: NLPrinting.NLPrintJSON
Para realizar una impresión, envíe solicitudes JSON a la API REST. Su conguración UseCloudPrinting
determina la siguiente API REST que debe llamar:
• Las Impresoras en la nube usan la API REST Imprimir PUT. Puede probar esta llamada
en el portal de desarrolladores: https://developerportal.onnicelabel.com/docs/services/cloud-print/
operations/put-printfunction
• Las Impresoras clásicas usan el API REST Cloud Trigger PUT con el nombre de desencadenador
Api-CloudIntegrationDemo-Print. Puede probar esta llamada en el portal de desarrolladores: https://
developerportal.onnicelabel.com/docs/services/cloud-trigger/operations/put-cloudtriggerfunction.
public str NLPrintJSON(str printerName, str JSONContent)
{
if (useCloudPrinting)
{
return (obj as
NLApiClient.CloudPrintIntegrator).Print(NLPrintSubscriptionKey, printerName,
JSONContent);
}
else
{
return (obj as
NLApiClient.CloudTriggerIntegrator).Print(NLPrintSubscriptionKey, JSONContent);
}
}
Ejemplo de una solicitud de impresión JSON de integración de muestra para 2 registros seleccionados:
{
"Printer":"ACME_A1",
"FilePath":"/Labels/AddressLabel.nlbl",
"Quantity":1,
"Variables":[
{
"name":"A. Dantum Brasil Ltda",
"address":"Rua Azevedo Soares 1245",
"city":"São Paulo",
"postCode":"03322001",
"country":"Brazil"
},
{
"name":"A. Datum Corporation",
"address":"123 Main Street ",
"city":"Sacramento",
"postCode":"94279",
"country":"United States"
76
}
]
}
4.4.8. Vericación de nombres de variables
Cuando personalice su código de integración, especique qué datos de D365SCM usar como variables de
plantillas de etiquetas. Verique los nombres de las variables en sus plantillas de etiquetas y en D365SCM
para asegurarse de que sus datos coincidan y se usen correctamente en las etiquetas impresas.
1. Vaya a Centro de control > Documentos y seleccione su archivo de plantilla de etiquetas.
2. Haga clic con el botón derecho en su archivo y seleccione Vista previa de la etiqueta.
La ventana de Vista previa de la etiqueta muestra los nombres de las variables y genera vistas previas
utilizando valores de variables.
Vista previa de archivos de plantillas de etiquetas con variables en Centro de control > Documentos.
NOTA
Las API REST usan valores predeterminados para cualquier valor de variable no
especicado en las plantillas de etiquetas e ignoran las variables que no se usan en las
plantillas de etiquetas.
Personalice nuestro código de integración de muestra para su entorno de impresión para que sus usuarios
puedan imprimir registros que seleccionen utilizando plantillas de etiquetas seleccionadas en impresoras
seleccionadas directamente desde Microsoft Dynamics 365 for Supply Chain Management.
77
-
1
-
2
-
3
-
4
-
5
-
6
-
7
-
8
-
9
-
10
-
11
-
12
-
13
-
14
-
15
-
16
-
17
-
18
-
19
-
20
-
21
-
22
-
23
-
24
-
25
-
26
-
27
-
28
-
29
-
30
-
31
-
32
-
33
-
34
-
35
-
36
-
37
-
38
-
39
-
40
-
41
-
42
-
43
-
44
-
45
-
46
-
47
-
48
-
49
-
50
-
51
-
52
-
53
-
54
-
55
-
56
-
57
-
58
-
59
-
60
-
61
-
62
-
63
-
64
-
65
-
66
-
67
-
68
-
69
-
70
-
71
-
72
-
73
-
74
-
75
-
76
-
77
