ServiceNow

Para empezar

Muchas empresas tienen su inventario tecnológico del día a día en ServiceNow, normalmente en la CMDB (base de datos de elementos de configuración). 7lens guarda el Contexto (Context) de la empresa: una visión compartida con significados claros.

Esta guía explica cómo conectar los dos sin crear dentro de ServiceNow un segundo vocabulario de empresa que choque con el primero.

No hace falta ser experto en ServiceNow para leer las primeras secciones. Las tablas detalladas que vienen después son para quien configura las clases de la CMDB y de CSDM y los procesos de carga.

Lecturas relacionadas: estrategia de mapeo, modelo de datos, aplicaciones (en inglés).

Para quién es

Si eres…	Esta guía te ayuda a…
Responsable de la CMDB o de CSDM	Elegir clases y relaciones de ServiceNow que respeten el significado que ya tienen en ServiceNow
Ingeniero de integración	Diseñar la extracción, transformación y carga con las APIs comprobadas de 7lens y los mecanismos nativos de ServiceNow
Responsable de una aplicación o de un servicio	Ver qué reglas de responsabilidad e identidad no deben duplicarse mal
Arquitecto	Mantener 7lens como el lugar de los significados compartidos y tratar ServiceNow como un sistema relacionado mediante mapeo

Objetivo: una integración mantenible y basada en evidencias. No es una afirmación de que 7lens “sea” CSDM ni una certificación de ServiceNow.

Cómo leer las afirmaciones de esta guía

Tipo de afirmación	Qué significa
Documentado por ServiceNow	Lo que dicen la documentación de ServiceNow o el white paper de CSDM 5 (con cita).
Recomendación de 7lens	Cómo proponemos proyectar 7lens en ServiceNow para esta integración. No es una regla del producto ServiceNow.
Pendiente o decisión del cliente	Tu empresa tiene que decidirlo; esta guía no se inventa la respuesta.

Base de las citas de ServiceNow: la guía de CSDM 5 y las páginas de ServiceNow Docs revisadas para esta investigación (la página de correspondencias CSDM → CMDB se actualizó el 10 de septiembre de 2026). Antes de pasar a producción, compruébalo con la versión de tu instancia (por ejemplo, Yokohama, Xanadu o Washington DC).

CSDM es el Common Service Data Model de ServiceNow, su forma recomendada de estructurar los datos de la CMDB. Verás la sigla en las tablas.

Qué aporta 7lens y qué no

Primero, en pocas palabras:

• 7lens cubre los cuatro ejes del núcleo: quién es la empresa y dónde opera (Organización, Organization), cómo clasifica sus elementos (Grupos, Groups), sus capacidades tecnológicas (Tecnología, Technology) y sus aplicaciones de negocio (Negocio, Business, que incluye las aplicaciones, Applications).
• Un inventario (Inventory) completo de máquinas y activos descubiertos es una extensión opcional y no está implementado en la API actual del producto. No inventes aquí APIs de sincronización de activos.
• Los conceptos de catálogo y de definición de CSDM se pueden relacionar a nivel conceptual. Los elementos de ejecución de la CMDB, como Service Instance (el nombre que da CSDM 5 al antiguo Application Service), se quedan en el lado de ServiceNow salvo que tu empresa decida otra cosa; OSM los trata como EXTERNAL.

Leyenda de la columna Cobertura

Cobertura	Qué significa
Recomendado	El enfoque preferido para la mayoría de clientes
Parcial	Una unión o una referencia útil, pero el significado no coincide del todo
A investigar	Candidato; confírmalo según cómo hayas adoptado CSDM
Sin mapeo	Fuera de alcance o sin una proyección segura todavía
Externo	Pertenece a ServiceNow (u otro sistema); no se fuerza dentro del núcleo de 7lens

Tabla de mapeo 7lens → ServiceNow

Estas tablas son detalladas a propósito. Lee antes el resumen de arriba y usa las filas cuando configures.

Columnas: Concepto de 7lens | Concepto de ServiceNow | Mapeo recomendado | Campos o configuración adicionales | A tener en cuenta | Cobertura | Evidencia

Negocio y aplicaciones

Concepto de 7lens	Concepto de ServiceNow	Mapeo recomendado	Campos o configuración adicionales	A tener en cuenta	Cobertura	Evidencia
Dominio de negocio (anidable)	Business Capability o jerarquía de capacidades (dominio Design de CSDM), o la taxonomía propia del cliente	Relaciona los dominios con la taxonomía de capacidades o de portfolio que el cliente ya use en SPM o en arquitectura empresarial; no inventes una clase de CI para el dominio	Tabla de capacidades del cliente o nodo de la taxonomía de SPM, si se usa	Los dominios se pueden anidar; los niveles de capacidad de CSDM están limitados (white paper de CSDM 5: reglas de profundidad máxima). Confirma el nivel de detalle antes de cargar.	A investigar	White paper de CSDM 5 (Business Capability); semántica del dominio en 7lens-data-model.md
Dominio → entidad jurídica	Company / Business Unit / Department, según se usen para la responsabilidad	Relaciona la responsabilidad a través de la entidad jurídica del dominio; no inventes un CI aparte para el responsable del dominio	sys_id de la sociedad o del departamento como clave externa	En 7lens, la responsabilidad va de dominio → entidad jurídica → organización	Parcial	Reglas de responsabilidad de 7lens; las tablas de organización de ServiceNow varían por cliente
Aplicación	Business Application (cmdb_ci_business_app)	Cada aplicación de 7lens se corresponde con un CI de Business Application	Guarda el id de la aplicación de 7lens como atributo externo o de origen (el cliente elige el campo); guarda el sys_id de ServiceNow en 7lens solo si se acuerda una clave de extensión del cliente	Documentado por ServiceNow: los datos de Business Application van en cmdb_ci_business_app, no en cmdb_ci_app. Es un objeto de diseño lógico, no una instancia en ejecución.	Recomendado	CSDM → CMDB mapping (actualizado el 10-09-2026); white paper de CSDM 5
domainId de la aplicación	Relación o referencia de la Business Application a su capacidad o contexto de negocio	Conserva la pertenencia al dominio como relación o referencia, según lo que permita la práctica de CSDM del cliente	Evita sobrecargar la antigua referencia única a Business Process (CSDM 5 la considera heredada)	Mejor vínculos que admitan uno a muchos	Parcial	White paper de CSDM 5 (nota sobre Business Application ↔ Business Process)
consumes[].service de la aplicación	Business Application → Technology Management Service / Service Offering (mediante relaciones), no “consume una oferta” como dato de 7lens	Proyecta consumes como vínculos de la Business Application a las clases de ServiceNow que representan el servicio o la oferta relacionados	El tipo de relación es una decisión del cliente dentro de los tipos que permite CSDM	En 7lens, las aplicaciones consumen servicios, no ofertas. No inventes un consumes de aplicación a oferta.	Recomendado	Modelo de aplicaciones de 7lens; nota PARTIAL de CSDM en OSM
part_of de la aplicación	Relación de diseño Business Application ↔ Business Application	Relaciónalo con una relación entre Business Applications solo cuando ambos extremos lo sean; aplica en la transformación la regla de misma entidad jurídica	Tipo de relación: decisión del cliente (vínculo de diseño)	En 7lens: como mucho un padre, sin ciclos y en la misma entidad jurídica	Parcial	Reglas de part_of de 7lens
depends_on de la aplicación	Relación de dependencia entre Business Applications	Relaciona consumidor → dependencia; puede cruzar entidades jurídicas	Es distinta de part_of	No deduzcas composición a partir de una dependencia	Parcial	Reglas de depends_on de 7lens
Despliegues y puntos de entrada de la aplicación (modelo objetivo)	Service Instance, capa operativa de Application Service (familia cmdb_ci_service_auto)	No fusiones la aplicación lógica con el Service Instance. Si existen despliegues en 7lens, trata su proyección operativa como Service Instance de ServiceNow; es decisión del cliente hasta que los despliegues estén completos en producción	CSDM 5 cambió el nombre de Application Service a Service Instance; la relación Business Application ↔ Application Service / Service Instance es Uses::Used By en CSDM v5 (antes, Consumes::Consumed By). EA Workspace puede seguir necesitando Consumes::Consumed by para las líneas temporales de TPM/TRM.	Las herramientas de inventario y de descubrimiento no deben crear despliegues en 7lens sin control	A investigar	Documentación de relaciones de CI de ServiceNow; OSM: Service Instance EXTERNAL
accountable_person	Campos tipo Owned by / Managed by / Support group de la Business Application	Relaciónalo con los campos de responsabilidad de CSDM que use el cliente; en 7lens es opcional	La resolución de la persona o de sys_user depende del proveedor de identidad del cliente	No inventes una entidad Persona en el núcleo de 7lens	Parcial	Responsabilidad de las aplicaciones en 7lens; campos de responsabilidad de CI en ServiceNow
sourcing_model / delivery_model	Atributos tipo architecture type o install type de la Business Application (según los campos del cliente)	Relaciónalos solo si en ServiceNow existen atributos con el mismo significado; si no, usa un grupo o un atributo propio en ServiceNow	No los rellenes a partir del campo heredado application_type	En el modelo objetivo de 7lens son dimensiones independientes	A investigar	Sección 10 de 7lens sobre origen y modelo de entrega; los atributos de ServiceNow varían

Tecnología

Concepto de 7lens	Concepto de ServiceNow	Mapeo recomendado	Campos o configuración adicionales	A tener en cuenta	Cobertura	Evidencia
Stack tecnológico	Agrupación por portfolio, taxonomía o dominio técnico (taxonomía de SPM o propia)	Úsalo como contexto de clasificación; no es un CI obligatorio de la CMDB	Las referencias a marcos (TBM, TOGAF) pueden acabar como atributos	Los stacks son dominios operativos de competencia y se pueden anidar	A investigar	Modelo de Tecnología de 7lens; documentación de taxonomías de SPM
Servicio tecnológico	Technology Management Service (CSDM 5; antes Technical Service)	Relaciona el servicio de OSM o de 7lens con Technology Management Service, su destino más cercano de catálogo y gestión	Parámetro opcional de OSM / servicenow_csdm: csdm_service_class como referencia	Estado en OSM: PARTIAL. El servicio de 7lens es una definición, no un CI en ejecución	Recomendado	CSDM.md de OSM; catálogo de marcos servicenow_csdm
Oferta	Technology Management Service Offering	Relaciona la oferta con Technology Management Service Offering a nivel conceptual	OSM usa características y proveedores en lugar de las tablas de dimensiones de CSDM	Coincidencia semántica parcial	Parcial	CSDM.md de OSM
Plataforma (propia)	Tipos de arquitectura platform host / platform app de la Business Application, o elementos de Technology Management	Preferible: la plataforma sigue siendo un concepto de Tecnología y las aplicaciones consumen los servicios que presta. Si ServiceNow usa los tipos platform host / platform app en la Business Application, es una decisión de modelado de ServiceNow, no un cambio de la plataforma de 7lens	Opciones de tipo de arquitectura en la Business Application desde New York (white paper de CSDM)	En 7lens, una plataforma no se modela como aplicación	A investigar	White paper de CSDM 5 (architecture type); en 7lens, plataforma ≠ aplicación
Proveedor TIC	CI de Company / Vendor o concepto de Technology Provider	Relaciónalo con los datos maestros de sociedades o proveedores; vincúlalo desde el servicio o la oferta mediante la asociación de proveedor	sys_id como clave externa	En OSM, el proveedor TIC es un dato maestro del catálogo, no necesariamente un CI de sociedad en la CMDB	Parcial	CSDM.md de OSM; proveedor TIC en 7lens
Selección del marco servicenow_csdm en Grupos	No aplica (plano de control de 7lens)	Actívalo una vez en Grupos si usas 7lens como plataforma; Tecnología y Negocio lo heredan	Parámetros: csdm_service_class, cmdb_ci_class (claves de unión)	Seleccionar un marco indica una intención, no una certificación	Recomendado	@7lens/contracts osm-frameworks.ts, framework-catalogue.ts

Organización, geografía y grupos

Concepto de 7lens	Concepto de ServiceNow	Mapeo recomendado	Campos o configuración adicionales	A tener en cuenta	Cobertura	Evidencia
Organización / región / subregión / país / entidad jurídica	Jerarquía de ubicaciones (tipos de cmn_location) + Company	Relaciona la geografía con tipos de ubicación (región, país…) cuando sea útil; la entidad jurídica, con Company	Opciones de tipo de ubicación de CSDM 5	Las agrupaciones comerciales (EMEA, APAC) no son niveles geográficos de 7lens	Parcial	Atributos de ubicación de CSDM 5; modelo de Organización de 7lens
Grupos (dimensiones de clasificación)	Etiquetas, atributos dinámicos de CI, taxonomía de SPM, lista relacionada Teams, campos propios	Preferible: representar los valores de los grupos como clasificaciones en ServiceNow; no recrear el metamodelo de grupos dentro de la CMDB	Lista relacionada Teams para asociar grupos a CIs (CSDM 5)	En 7lens, los grupos fijan la responsabilidad y el acceso; el control de acceso de ServiceNow es aparte	A investigar	Grupos de 7lens; Teams en CSDM 5

Dependencias, consumo y límite del inventario

Concepto de 7lens	Concepto de ServiceNow	Mapeo recomendado	Campos o configuración adicionales	A tener en cuenta	Cobertura	Evidencia
consumes[].service canónico	Relaciones entre Business Application, Technology Management Service y Service Offering	La dependencia tecnológica de referencia es el consumes de 7lens	—	Las evidencias del inventario (cuando exista) no deben sustituir a consumes	Recomendado	Modelo de aplicaciones de 7lens
Activo del inventario	CI de la CMDB / Service Instance	Sin mapeo en esta versión: la extensión de inventario no está implementada en la API de 7lens	—	El descubrimiento y Service Mapping siguen en el lado de ServiceNow. No inventes una sincronización de activos.	Sin mapeo	README del producto: inventario no construido; CI en OSM: EXTERNAL
Grafo servicio → servicio (genérico)	Grafo de relaciones entre servicios de CSDM	No se fuerza dentro del catálogo tecnológico de 7lens	—	OSM-C-008: las relaciones servicio → servicio son externas a OSM	Externo	CSDM.md de OSM

Cómo abordar la integración

En resumen: acordar qué se relaciona con qué, acordar quién es dueño de cada campo, extraer de 7lens, cargar con las herramientas de importación nativas de ServiceNow y repasar la lista de comprobación del final.

Usa los mecanismos de carga nativos de ServiceNow antes que inventar un conector propio.

1. Analiza tu ServiceNow

Documenta qué versión y qué dominios de CSDM tienes adoptados (Foundation, Design, Manage, Consume), qué clases son la referencia y si usas APM, SPM, Discovery o Service Mapping.

2. Revisa y cierra el mapeo

Parte de la tabla anterior. Registra las decisiones del cliente (tipos de relación, campos de clave externa, nivel de detalle dominio → capacidad). Marca las filas con cobertura “A investigar” como aceptadas o aplazadas.

3. Acuerda identidades y responsabilidades

Para cada tipo de entidad, define:

• la clave natural en 7lens (un id estable);
• la clave de correlación en ServiceNow (sys_id, nombre único + clase, o ambos);
• el sistema de referencia de cada campo (7lens o ServiceNow);
• la política ante conflictos (gana 7lens, gana ServiceNow o revisión manual).

4. Prepara ServiceNow

Crea o confirma las clases de destino, las reglas de identificación (IRE), los transform maps y los tipos de relación. Usa tablas alineadas con CSDM (cmdb_ci_business_app y las clases Technology Management Service / Offering, según lo que tengas adoptado).

5. Conéctate a las APIs comprobadas de 7lens

Lectura y escritura de configuración comprobadas (sin endpoints inventados):

Capacidad	Rutas (comprobadas en @7lens/api)
Documento de configuración completo	GET/PUT /v1/config
Documentos y árboles por eje	GET /v1/config/organization, /technology, /business (+ /tree)
Altas, cambios y bajas de entidades por eje	colecciones GET/POST/PUT/DELETE /v1/config/...
Lectura del grafo	GET /v1/config/graph
Exportar e importar YAML	GET/PUT /v1/config/yaml
Validación	GET /v1/config/validation
Resolución de grupos	GET /v1/config/group-resolutions/:entityType/:entityId
Esquema de aplicaciones	GET /v1/schemas/applications
Estado del servicio	GET /v1/health

Hueco de autenticación (explícito): la autenticación de la API está pendiente. El x-source-id de la carga no se verifica (claimed_source_id). No expongas la API en producción con varios clientes hasta que esté implementada la autenticación (README del producto y de la API).

No disponible: APIs publicadas de activos del inventario; un conector propio “7lens ServiceNow”; sincronización bidireccional garantizada.

6. Relaciona y transforma

Transforma el JSON o YAML de 7lens en cargas de Import Set o de IntegrationHub ETL. Conserva la procedencia (id de 7lens, fecha y hora de la extracción, versión del mapeo).

7. Carga en ServiceNow (mejor con opciones nativas)

Valóralas en este orden (todas son capacidades de la plataforma ServiceNow, no productos de 7lens):

1. Service Graph Connector / IntegrationHub ETL, si hay un patrón adecuado o te vale un mapa propio de IH ETL (SGC Central, Integration Commons for CMDB).
2. Import Sets: CSV, XML o Excel a una tabla intermedia y transformación a la CMDB; las relaciones, mediante cmdb_rel_ci (Populating the CMDB).
3. CMDB Instance API: alta y actualización de CIs por programa cuando ETL no encaje (misma documentación de ServiceNow).
4. Conector propio: solo si las opciones 1 a 3 no cumplen los requisitos de latencia o de seguridad. Trátalo como un desarrollo del cliente, no como un producto documentado de 7lens.

Usa IRE para la identificación y la conciliación al cargar.

8. Valida

Repasa la lista de comprobación siguiente antes de dar la integración por terminada.

9. Opera

Programa las extracciones, vigila las transformaciones fallidas, versiona la tabla de mapeo y vuelve a validar después de cada cambio en el modelo de CSDM o de 7lens.

Lista de comprobación: integración terminada

La integración está terminada para un conjunto de entidades solo cuando se cumplen todos los puntos que apliquen.

Identidad y clases

• Cada aplicación de 7lens incluida tiene exactamente una Business Application en cmdb_ci_business_app (o una lista explícita de excepciones).
• Ninguna aplicación se ha escrito por error en cmdb_ci_app.
• Las claves de correlación (id de 7lens ↔ sys_id) están guardadas y se pueden recorrer en ambos sentidos.
• Los servicios tecnológicos se relacionan con Technology Management Service (o la desviación está documentada).

Significado

• Las proyecciones de consumes[].service coinciden con 7lens (solo servicios, sin destinos de oferta inventados).
• part_of y depends_on no se confunden, y la transformación aplica las reglas de entidad jurídica.
• Ninguna plataforma se ha convertido en aplicación, salvo excepción documentada.
• La capa de Service Instance / Application Service está fuera de alcance o se relaciona de forma explícita con los despliegues; no se iguala sin más a la aplicación lógica.

Responsabilidad y grupos

• Los campos de responsabilidad en ServiceNow coinciden con la cadena dominio → entidad jurídica (o la excepción está documentada).
• Las clasificaciones por grupos tienen un destino definido en ServiceNow (o están aplazadas).

Seguridad operativa

• Seguridad ha aceptado cómo se autentica el acceso a la API de 7lens (o ha reconocido el hueco si sigue pendiente).
• Las reglas de IRE evitan CIs duplicados al recargar.
• La política ante conflictos se ha probado con un caso controlado de edición en ambos lados.
• No se ha supuesto ni construido ninguna sincronización de inventario o de activos contra APIs de inventario de 7lens que no existen.

Evidencias

• La versión de la tabla de mapeo está fijada en el runbook.
• Las referencias a clases y relaciones de ServiceNow están registradas para la versión de la instancia.

Mantenimiento

Tema	Práctica
Citas	Guarda las URLs de ServiceNow Docs con su fecha; fija la versión del white paper de CSDM 5 que usáis en los talleres
Nativo, configurado o extensión	Etiqueta cada campo: estándar de ServiceNow / configurado en ServiceNow / propio en ServiceNow / núcleo de 7lens / extensión del cliente en 7lens
Cambios de modelo	Repite la lista de comprobación cuando lleguen los despliegues de aplicaciones de la v3 o cambien nombres en CSDM
Puntos pendientes	Regístralos en el registro de decisiones del cliente; no “arregles” sin avisar las filas marcadas “A investigar”

Huecos conocidos (esta versión)

1. La extensión de inventario de 7lens y las APIs de activos no están construidas; la sincronización de CIs de la CMDB desde activos de 7lens queda fuera de alcance.
2. La autenticación de la API de 7lens está pendiente; no se puede exponer en producción hasta resolverla.
3. No hay un conector propio 7lens ↔ ServiceNow; usa los mecanismos nativos de importación y ETL de ServiceNow.
4. El nivel de detalle dominio ↔ Business Capability depende de cada cliente (A investigar).
5. La proyección despliegue ↔ Service Instance depende de cómo avance la implementación de los despliegues de aplicaciones.
6. Las menciones de la estrategia de producto que no están en el catálogo de OSM ni en el de grupos (por ejemplo, NIS2 o Apptio) no tienen página aquí.

Fuentes

7lens / OSM

• docs/product/7lens-data-model.md, 7lens-data-model-business.md, 7lens-product-definition.md
• @7lens/contracts osm-frameworks.ts (servicenow_csdm), framework-catalogue.ts
• OSM models/service-management/CSDM.md (CSDM 5, estado PARTIAL)
• Rutas de @7lens/api; README.md raíz y packages/api/README.md (huecos de autenticación e inventario)

ServiceNow (documentación oficial)

• How CSDM concepts map to CMDB tables (actualizado el 10-09-2026)
• White paper de CSDM 5 (comunidad y guía de producto de ServiceNow)
• CI relationships in the CSDM (Uses::Used By entre Business Application y Application Service / Service Instance)
• Populating the CMDB (Import Sets, IntegrationHub ETL, CMDB Instance API, Service Graph Connectors)
• Exploring SGC Central