--- sourceDocument: Australia Telecom Service Operations Management sourceDocumentLink: https://www.servicenow.com/docs/r/australia/telecom-service-ops Release : - australia ft:locale : - en-US ft:publication_title : - Australia Telecom Service Operations Management ft:clusterId : - tsom bundleId : - tsom workflow : - Customer and Industry --- # Telecom Discovery Builder framework # Telecom Discovery Builder framework {#ariaid-title1} Release version: Australia Updated March 12, 2026 ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 minutes to read Summarize ![AI sparkle icon](https://servicenow.com/docs/portal-asset/ai-sparkle-icon) Summarized using AI This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete. ## Summary of Telecom Discovery Builder framework The Telecom Discovery Builder framework ETL is a reusable, schema-aligned component included with the Telecommunications Service Operations Management (TSOM) Core application. It standardizes the ingest process of telecom inventory data into the ServiceNow CMDB across multiple Service Graph Connectors (SGCs). Delivered as a generic ETL utility, it helps telecom connector development teams avoid building extraction, transformation, and loading logic from scratch by providing a consistent, customizable foundation aligned with the Telecommunications Network Inventory (TNI) data model. Show full answer Show less Once the TSOM Core plugin is activated, the framework is automatically provisioned within the Integration Hub ETL Studio, enabling reuse and adaptation for specific connector requirements. ## When to Use * Deploying new Service Graph Connectors in telecom environments without rebuilding ETL processes. * Maintaining schema-aligned and consistent data ingestion across multiple connectors and platform instances. * Ensuring discovery payloads and CI relationships comply with the Telecommunications Network Inventory (TNI) standards. * Customizing ETL behavior within the Service Graph Connector scope without altering core logic. * Leveraging predefined mappings, validated JSON schema support, and a UI-driven configuration interface. ## Key Features * **Auto-provisioned with TSOM Core:** Ready to use immediately after plugin activation for all telecom connectors. * **Generic Schema-Based Ingestion:** Supports a unified telecom CI data schema aligned with TNI. * **Duplication and Customization:** Easily duplicate and tailor ETL logic within Integration Hub ETL Studio for connector-specific needs. * **Flexible Field-Mapping Interface:** Configure import sets, data sources, targets, and transformations through an intuitive UI. ## Key User Roles Access and management of the TSOM Visibility and Assurance application scopes are controlled by specific roles that ensure security and compliance: * **tsomvisibilityadmin:** Manages operational tasks within the TSOM Visibility scope. * **tsomassuranceadmin:** Full operational and administrative rights within TSOM Assurance scopes. These roles include granular admin capabilities such as import management, connection configuration, CMDB administration, discovery configuration, usage monitoring, integration customization via ETL, certification auditing, and MID Server agent management. ## Benefits * Ensures consistent structuring and loading of telecom configuration items into the CMDB. * Promotes reusability and standardization across different connectors and deployments. * Guarantees compliance with industry-standard TNI schemas and discovery models. * Offers flexibility to extend and customize data transformations without impacting the core schema. The Telecom Discovery Builder framework ETL (Extract, Transform, Load) is a reusable and schema-aligned component delivered with the Telecommunications Service Operations Management (TSOM) Core application. It provides a consistent and extensible method for ingesting telecom inventory data into the ServiceNow configuration management database (CMDB) across multiple Service Graph Connectors (SGCs). The Telecom Discovery Builder framework ETL serves as a baseline data ingestion utility to handle telecom-specific configuration item (CI) data. It enables connector development teams to avoid building ETLs from scratch by offering a standardized transform logic that can be duplicated and customized for each connector. It provides a standardized, reusable foundation that promotes consistency across implementations. After the TSOM Core plugin is activated, the generic ETL is auto-provisioned and becomes available in the Integration Hub ETL Studio. You can reuse and adapt it to connector-specific needs. ## Why and when to use the Telecom Discovery Builder framework {#exploring-the-telco-generic-schema-etl-framework__section_rmr_xgy_dfc} Use the Telecom Discovery Builder framework when you want to do the following: * Deploy a new Service Graph Connector in a telecom environment and want to avoid building the ETL from scratch. * Maintain schema-aligned consistency across multiple connectors and platform instances. * Discovery payloads and CI relationships compliant with TNI (Telecommunications Network Inventory). For more information, see [Telecommunications Network Inventory](https://www.servicenow.com/docs/access?context=telecom-network-inventory&version=australia&pubname=australia-telecom-network-inventory&ft:locale=en-US). * Work within an SGC (Service Graph Connector) application scope and want to customize ETL behavior without modifying core logic. * Benefit from predefined mappings, validated JSON schema support, and a UI-driven configuration interface. {#exploring-the-telco-generic-schema-etl-framework__ul_c5x_zgy_dfc} ## Key capabilities and features {#exploring-the-telco-generic-schema-etl-framework__section_n34_vhy_dfc} * Auto-provisioned with TSOM core: Installs automatically and is ready to use across telecom connectors. * Generic schema-based ingestion: Supports a unified data schema for telecom CIs. * Supports duplication and customization: Duplicate the Telecom Discovery Builder ETL framework into your application scope using Integration Hub ETL Studio. * TNI support: Aligned to the TNI data model and the ETL logic can be extended to generate and link TNI entities. * Flexible field-mapping interface: Configure import sets, data sources, targets, and transformation logic through a UI-driven experience. {#exploring-the-telco-generic-schema-etl-framework__ul_zcm_xhy_dfc} ## Key user roles {#exploring-the-telco-generic-schema-etl-framework__section_gcw_2ld_fhc} The tsom_visibility_admin and tsom_assurance_admin roles provide granular access control across TSOM Visibility and Assurance application scopes, supporting stronger security and compliance in line with the Granular admin directive. * The tsom_assurance_admin role provides full operational and administrative access to TSOM Assurance application scopes. * The tsom_visibility_admin role manages the operational tasks for the TSOM visibility application. {#exploring-the-telco-generic-schema-etl-framework__ul_pfx_pvl_l3c} These roles control access to the TSOM Visibility and Assurance application scopes listed in the following table.{#exploring-the-telco-generic-schema-etl-framework__table_xrc_yc3_jhc__entry__2} | Scope name | Description | |-|-| | `sn_tsom_core` (Telecom Service Operations Core) | Includes the audit application and various system properties within that app scope. | | `sn_tsom_em_core`(Event Management Core) | Includes the monitoring and analysis of telecommunications network alerts and performance metrics from SD-WAN infrastructure. | | `sn_tsom_em_conns`(Event Management Connectors) | Include push connectors and connector definitions used to ingest alerts from external telecommunications network sources. | | `sn_tsom_patterns`(Telecom Discovery Patterns ) | Include the MID Server and system IP Service properties. | | `sn_sgc_aliplano`(Service Graph Connector for Nokia Altiplano) | Includes the application properties. | | `sn_sgc_meraki`(Service Graph Conenctor for Cisco Meraki Telco SD-WAN) | Includes the application properties. | | `sn_sgc_fortinet`(Service Graph Connector for Fortinet Telco SD-WAN) | Includes the application properties. | [Table 1. TSOM Visibility and Assurance application scopes] {#exploring-the-telco-generic-schema-etl-framework__table_xrc_yc3_jhc} The following table lists the roles contained in the tsom_visibility_admin role. {#exploring-the-telco-generic-schema-etl-framework__table_vjs_1b3_jhc__entry__2} | Role name | Description | |-|-| | `import_admin` | * Monitors scheduled data import executions, including viewing the hierarchy and flow of chained imports, accessing execution contexts, and diagnosing import issues. * Manages all aspects of import set records and imports. {#exploring-the-telco-generic-schema-etl-framework__ul_omn_k43_jhc} | | `connection_admin` | * Responsible for managing connections and credentials, especially for Integration Hub. * Create and configure HTTP and HTTPS connections, which are used by custom actions or activities to connect to external endpoints. These actions include setting up connection details such as credentials, connection aliases, URLs, MID Server options, and additional attributes. {#exploring-the-telco-generic-schema-etl-framework__ul_idy_2q3_jhc} | | `sn_cmdb_admin` | * Highest-level administrative role for CMDB privileges. * Grants full access to CMDB data, tools, and user interfaces. Enables administrators to configure policies such as class management and application service requirements that aren't available to editors. {#exploring-the-telco-generic-schema-etl-framework__ul_uqr_mq3_jhc} | | `discovery_admin` | * Grants access to the tables in the Discovery application. * Essential for configuring and executing discovery in your network. * Includes setting up MID Servers, managing credentials, defining discovery schedules, and validating results. {#exploring-the-telco-generic-schema-etl-framework__ul_j2r_3yj_khc} | | `usage_admin` | * For instances using Discovery, this role enables users to track the number of active users and hardware configuration items (CIs) discovered. * Monitors instance usage through dashboards, providing information to help your organization understand application adoption and usage patterns. {#exploring-the-telco-generic-schema-etl-framework__ul_syh_kr3_jhc} | | `cmdb_inst_admin` | * Enables users to create and customize integrations using Integration Hub ETL, including integrating third-party data into CMDB or supported non-CMDB tables. * Necessary to use the Integration Hub ETL store app and access CMDB Integrations. {#exploring-the-telco-generic-schema-etl-framework__ul_qmn_wr3_jhc} | | `certification_admin` | * Enables users to manage certification filters for auditing subsets of records. * Create, update, delete, and run certification audits, compare records against expected values, and assign follow-on tasks to remediate discrepancies. * Manage and reassign follow-on tasks from compliance audits and view all such tasks. Users with the certification role can access only tasks assigned to them. {#exploring-the-telco-generic-schema-etl-framework__ul_q1f_ds3_jhc} | | `agent_admin` | * Responsible for downloading and administering the system's built-in MID Server agent. * Enables users to manage scripts and properties related to the MID Server. {#exploring-the-telco-generic-schema-etl-framework__ul_zfq_zs3_jhc} | [Table 2. Visibility granular admin roles] {#exploring-the-telco-generic-schema-etl-framework__table_vjs_1b3_jhc} ## Key benefits {#exploring-the-telco-generic-schema-etl-framework__section_ypx_1ms_z2c} Benefits of the Telecom Discovery Builder framework ETL include: * Consistency in how telecom configuration items (CIs) are structured and loaded into the CMDB. * Reusability through duplication and customization across connectors. * Compliance with TNI schemas and discovery model requirements. * Flexibility to extend and tailor data transformations without compromising the base schema. {#exploring-the-telco-generic-schema-etl-framework__ul_m4l_cms_z2c} **Related concepts** * [Configure the Telecom Discovery Builder ETL](https://www.servicenow.com/docs/U9vj9DX~H1~z5pw4OPBFhA "Duplicate the prebuilt Telecom Discovery Builder framework ETL into your connector scope. Assign the appropriate data source and deploy it as part of a new service graph connector.") **Related tasks** * [Extend TNI entity support for duplicated ETLs](https://www.servicenow.com/docs/GfeBGZmaIVZ~~JBSEEjVcg "When Telecom Network Inventory (TNI) is enabled, every Configuration Item (CI) created by a duplicated ETL must have a corresponding TNI Entity.")