5G单站验证远程交付：GC平台如何实现报告自动生成与数据规整

简介一份面向无线网优工程师与5G单站验证人员的GC平台远程交付工具操作指导书系统讲解华为NR(5G)环境下如何借助该工具完成自动化测试与远程验证从而降低现场测试成本、提高交付效率文档为DOCX格式共1个文件压缩包大小约525KB。正文先梳理操作指导模块覆盖工参、配置数据、路测数据及其他辅助数据的定义与用途随后聚焦报告输出详细拆解新建任务、参数设置、选择数据、报告下载以及QA常见问题处理最后介绍关联ISDP的站点调度、站点信息模板下载与系统对接流程。文中还保留了一线实操经验如5G单验定制方法、深圳平台入口与用户权限开通等说明可帮助读者规避常见踩坑点。已有870人学习过这份资料适合从事5G单站验证远程交付、熟悉GC平台工具应用的工程师参考。1. 5G单站验证从“现场跑测”到“远程交付”GC平台这套工具到底省了什么5G单站验证的交付链路里最耗时的一环从来不是跑测试而是跑完之后的报告整理工参要对齐、路测数据要按站点规整、配置数据要自检频点稍不留神就得整站返工。华为这个基于GC平台的远程交付工具就是把“数据准备—报告生成—与ISDP对接”这条链路搬到了网页上现场工程师只需把路测文件按要求打包上传平台自动完成字段匹配、报告模板填充和站点调度关联。如果你负责5G新建站单验执行、或者带着网优团队做批量交付这套流程能砍掉至少一半的报告整理时间。我拆这份使用说明书时最深的感受是远程交付的价值不在“自动化”三个字而在数据规范和数据一致性。下面按实际操作顺序把整条流程捋一遍。2. 第一次进平台要做对三件事建项目、开权限、对接ISDP这套工具整体托管在华为GC平台上但很多人第一次接触时卡在入口明明有账号进去却看不到5G单验模块。根源在于平台是多项目隔离的机制——你看到的菜单由你所在的项目决定。所以首次使用的第一步不是传数据而是把项目、账号权限和ISDP关联这三件事做通。2.1 建项目为什么只能建单独NR项目不能混4GGC平台的入口地址是https://genexcloud-sz.huawei.com/genexcloud/portal/index.do深圳站点登录后先确认自己所在的项目。5G单验入口不是对所有项目可见的必须存在一个“单独NR项目”才会出现对应菜单。目前平台策略是只支持单独NR项目不支持4G/5G混合项目。这个限制在你建项目时就要想清楚别图省事把5G单验需求塞进现有的4G项目里后台上压根不给你入口。实际操作时项目创建一般由平台管理员或项目TL操作进入项目管理页面选择新建项目项目类型勾选“NR”然后指定项目的有效周期和归属部门。建完之后当前账号退出重登左侧菜单才会刷新出5G单验相关功能。注意一个细节如果你同时有4G单验需求不要尝试建两个混合类型项目按平台现在的规则单验工具只认纯NR项目。2.2 新增加用户与激活邮件报告输出权限的前提项目建好了但现场网优兄弟还是登录不了因为没被加进项目用户列表。很多团队在这里翻车——数据都准备好了进入报告输出环节时系统提示“无操作权限”再回头补权限整个交付节奏全被打乱。加用户的正确路径是走平台管理门户https://genexcloud-sz.huawei.com:8445/genexcloud/managerportal/index.do按以下流程操作用管理员账号登录上述管理门户地址左侧找到“项目管理”点进你的NR项目选择“用户管理”这里支持两种方式单个用户新增或批量导入单个新增时“用户类型”要严格区分自有人员选“内部用户”合作方员工选“外部员工”员工类型选“本地员工”。这个字段看似不起眼但选错了会导致激活邮件发不出去批量导入时先下载平台提供的批量模板模板里每一列都有格式要求尤其是工号/手机号/邮箱有个别单元格格式不符导入时会提示失败。常见的坑是Excel里手机号被自动转成科学计数法建议在模板里把该列设为文本格式再填保存后回到用户管理界面勾选该用户发送激活邮件。用户只有点击邮件里的激活链接并设置密码后才能正常登录GC平台输出报告。邮件激活这一步常被忽略。很多人以为用户加进去了就能用结果现场兄弟登录时一直提示密码错误原因就是激活链接没点过。另外激活邮件有有效期过期后需要重新发送。2.3 对接ISDP站点调度与模板下载入口这一版工具比较特殊的一点是GC平台与ISDP做了联动要求工参里的可选字段“制式Duplex Model”也按实际情况填写不再允许留空。所以对接ISDP不只是流程要求它直接影响工参模板的字段约束。进入ISDP关联有三个入口按使用顺序分别是ISDP站点调度在这里查看当前待交付的站点列表确认哪些站点进入单验环节。站点状态会被同步到GC平台作为报告输出的站点来源站点信息模板下载从ISDP侧下载站点基础信息表这张表里包含了工参模板需要的部分字段可以直接复制到工参里减少手动录入关联ISDP在GC平台的5G单验模块中选择站点并绑定对应ISDP任务绑定完成后报告输出的站点归属关系就固定了后续ISDP侧可以回读GC生成的报告状态。有一点要提醒关联ISDP的绑定关系做好之后不要随意解绑尤其是批量交付阶段解绑会导致报告状态无法回传站点在ISDP侧一直显示“未交付”。如果确实绑错了先确认该站点是否已经生成过报告再走解绑流程。3. 工参与配置数据决定报告能否生成的隐性地基远程交付工具整个逻辑里工参和配置数据属于“输入质量决定输出质量”的部分。报告能不能一次生成成功、生成出来的指标和小区信息对不对90%在数据准备阶段就已经定了。很多人把这步当成“传个文件上去就行”这是最大的误解。3.1 工参模板的必填字段逻辑第一步是从平台下载5G工参模板。模板里绿色背景标注的是必填字段不能为空。必填字段至少包括站号、站名、PCI、频点、小区ID此外由于对接ISDP制式Duplex Model也需要按实际填写。实操里最容易出问题的是“字段一致性”工参里填的站号、PCI、频点、小区ID必须和路测数据里记录的信息完全一致差一个数字都可能导致小区匹配失败。这里的一致性是精确匹配不是肉眼看着差不多就行——比如频点要区分NR绝对频点号类似6300这种不要填成带宽或中心频点的MHz值否则报告里所有小区级别的指标都会错位。字段是否必填常见填错项站号是与路测文件站点不一致多0少0站名是和工参模板模板格式不符PCI是物理小区标识和路测数据不一致频点是填了MHz值而不是NR绝对频点号小区ID是引入了前导0或空格Duplex Model是对接ISDP后留空或填制式代码3.2 工参上传后的字段匹配策略工参准备好之后打开GC平台本地上传工具使用说明书里统称“安装完成后打开”在特性选择里选“NR单站验证”再从本地选择工参文件。上传后系统会自动做字段匹配但自动匹配不等于全部匹配成功。必填字段必须全部匹配未自动匹配上的字段右键点击“请匹配-”做手动映射。实操时建议按这个顺序排查先看必填字段里哪些字段标红了优先手动匹配再看可选字段——对接ISDP后制式字段也建议匹配上否则后续关联站点时可能校验不过匹配完成后保存回到主界面确认工参状态为“已生效”。手动匹配这一步很多老手也会漏。自动匹配通常能对上站号、PCI这类数字型字段但像制式这种用中文描述的字段系统识别率不高不手动匹配也不报错但到报告输出阶段会出现“缺少制式信息”的提示。与其后面卡住不如上传时多花两分钟做一次完整校核。3.3 配置数据的格式、自检与上传配置数据是容易被轻视的第三类数据。它支持的格式是.xml或.xml.gz其他格式一律不识别。上传前要做两项自检一是内容是否包含频点、频段、制式信息。经常有人导出一份空壳配置文件里面没有载频配置上传时工具不报错但生成的报告里频点栏全是空的。二是频点信息是否与路测数据一致。这份配置数据里配置的频点和工参里的频点必须能对上号。比如工参里规划的是6300频点配置数据里却只配置了另一个频段报告生成后邻区关系表就会异常甚至整个小区无法匹配。上传路径的操作逻辑是点击“新增” → 选择“NR-设备侧数据”类型 → 新建上传位置或选择已有目录 → 从本地选择文件。注意目录层级最多5层超过这个层级会上传失败或者上传后无法正常识别。这个限制在后续整理大量站点数据时特别容易踩到后文单独展开。4. 避坑数据准备的五个高频翻车点与排查顺序从工参模板到路测数据这四类数据的坑我全部踩过一轮。这里按出现频率列五条每条按现象、原因、解决的顺序写。4.1 工参必填字段漏填导致上传校验不过现象工参上传后系统直接提示校验失败且不给出具体是哪个字段。原因平台对必填项做整表扫描只要有一行的小区ID为空整张表就打回。很多人的工参是从别的项目复制来的模板里附带了旧数据看着每行都有值实际上站号列存在看不见的空格或换行符字符型字段视为非空数字型字段匹配异常。解决上传前用文本编辑器或脚本做一次全表清洗检查每个单元格是否有不可见字符。我一般会先统一转成CSV再用脚本遍历把工参必填字段逐个判空同时用正则去掉首尾空白。下面这段Python脚本用来做上传前的字段完整性预检import csv import re from pathlib import Path required_fields [站号, 站名, PCI, 频点, 小区ID, Duplex Model] path Path(工参预检.csv) bad_rows [] with open(path, encodingutf-8-sig) as f: reader csv.DictReader(f) for i, row in enumerate(reader, start1): for field in required_fields: val row.get(field) if val is None or str(val).strip() : bad_rows.append((i, field, row)) else: row[field] str(val).strip() if bad_rows: print(f发现 {len(bad_rows)} 个问题单元格) for i, field, row in bad_rows[:10]: print(f第{i}行 {field} 为空或全空白: {row}) else: print(必填字段校验通过) # 全表清洗后回写 with open(path, w, newline, encodingutf-8-sig) as f: writer csv.DictWriter(f, fieldnamesreader.fieldnames) writer.writeheader() for row in reader: for k, v in row.items(): if v is not None: row[k] str(v).strip() writer.writerow(row)这段脚本先遍历每一行、逐一判断必填字段是否为空再把所有字段的可视空白去掉。utf-8-sig是为了兼容用 Excel 另存的带 BOM 头的 CSV读取时自动去掉 BOM避免站号第一个字符出现\ufeff导致匹配失败。跑完脚本再去平台上传能省掉大部分来回打回的试错。4.2 站号、PCI、频点与路测数据不一致现象工参和路测文件都能上传成功报告也能生成但小区级指标异常比如邻区指标全为空、某些小区没有KPI记录。原因路测数据里的站号与工参不一致或PCI、频点信息在采集时发生了重配置。最典型的场景是测试当天基站做了RF优化PCI被远程修改路测文件里记录的是新PCI工参还是规划值。解决数据准备工作必须加一道“三方核对”工参、配置数据、路测数据的站号/PCI/频点逐项比对。核对优先级是频点 小区ID PCI因为同一站点下PCI复用率高频点错了影响面最大。比对这一步不要靠肉眼用脚本从路测文件名和工参表里各抽出一列做差集能在提交前就把不一致的站抓出来。这是远程交付流程里性价比最高的一个动作比在报告生成后再返工强十倍。4.3 配置数据缺频点、频段或制式现象配置数据上传成功报告生成后“频段”列全空或显示异常值。原因从设备侧导出的配置数据是精简版本缺失了载频配置段落。特别是使用.xml.gz压缩包时文件能解压、能解析但内部缺少NR载频配置工具读取后频点列表为空。解决上传前检查配置数据的自检项就两个点配置数据里是否含频点、频段、制式信息频点是否与路测数据相同。检查方式可以用文本工具直接搜dlFrequency、arfcn、frequency这类关键标签有值且与工参频点对应才放行。别信上传成功的绿勾绿勾只代表文件格式没问题不代表内容完整。4.4 目录层级超5层与站点文件夹命名不规范现象批量上传路测数据时整个批次的导入任务失败或某个站的gen文件在报告中找不到。原因工具对上传目录的层级限制是5层超过限制就拒绝导入。更常见的是站点文件夹命名不符合“站号_站名”规范比如用了中文下划线、空格或下划线前后顺序颠倒工具对文件夹名做拆分解析时直接跳过。解决上传前批量修正文件夹名。站在工程落地的角度我通常先让脚本把文件夹全部规整一遍再用脚本检查目录深度#!/bin/bash # 路测目录规整与层级检查 for dir in /data/route_test/*/; do # 目录名规范为: 站号_站名站号在_之前 base$(basename $dir) if ! echo $base | grep -qE ^[0-9]_.$; then echo [命名异常] $base fi done # 检查目录层级超过5层直接列出 find /data/route_test -type d -maxdepth 6 | awk -F/ NF6 {print $0}grep的匹配规则是“站号在前、下划线连接、站名至少一个字符”只要不符合这个规则的文件夹都会被列出来。find限定最大深度6是因为第6层已经超过平台5层的限制列出后人工确认哪些需要提前打平目录结构。如果脚本查出大量不符合命名的文件夹不建议手动改名写个循环批量改完再上传这类问题集中在大量站点打包上传的场景里发生一改就是几十个目录手动操作容易改错。4.5 激活邮件收不到或链接过期现象用户加了提示激活邮件已发送但现场兄弟一直收不到或者收到后点击链接提示“链接失效”。原因两块。一是邮件被企业邮箱拦截进了垃圾箱二是管理员加用户时填了外部邮箱但员工的邮箱服务器做了域名白名单限制。另一个常见原因是激活链接有时效管理员提前几天加了人现场用的时候链接已经过期。解决加用户尽量用员工的企业邮箱减少被拦截的概率加完当天提醒对方查收并激活。如果过期了在用户管理列表勾选这个人重新“发送激活邮件”新邮件会生成新的链接旧的失效就失效了。建议团队把这一步写成验收单的一项——激活成功才算账号开通避免上线当天卡在登录环节。5. 从任务创建到报告下载把单站验证的输出流程跑通数据准备这一步走完后面就是标准化的报告流水线。这一章按照“创建任务 → 参数设置 → 选择数据 → 报告下载”的顺序讲并把定制需求提交的路径也一并说清楚。5.1 新建任务与参数设置要点进入NR单站验证模块后先“新建任务”。任务模型是“一个任务对应一个站点的一次完整单验交付”。所以建任务之前先确认平台上已经上传了该站点的工参、配置数据和路测数据且数据状态都正常否则任务建了也选不了数据。参数设置是这一环节的核心。操作界面里需要设置的参数主要包括测试场景类型区分好点、切换、Attach、ping等不同测试场景平台会根据这些参数选择对应的模板数据挖掘开关是否启用在路测数据上的无线参数自动识别报告模板选择默认使用平台标准模板部门有定制模板时可切换站点归属这个任务关联哪个站点数据来源是ISDP同步的站点列表。参数设置完成后进入数据选择。此时工具会把该站点下已上传的工参、配置数据、路测数据统一列出来按步骤勾选即可。勾选时留意数据版本如果一个站点的数据更新过多次要确认选到的是最新版本。5.2 数据规格、报告效率与选择数据报告输出前有几个效率相关的预期需要提前对齐。数据规格指的是平台输出报告的字段范围和精度比如包含小区基本参数、SSB RSRP/RSRQ、上下行速率、邻区关系表、事件 LOG 等。报告效率不是固定值受三方面影响路测数据文件的大小和gen文件数量文件越多解析耗时越长同时运行的任务数建议每批次控制在20个站以内超过这个量任务会排队看起来像卡住了实际是在等待调度路测数据的内部质量比如空口信号异常导致的无效数据量偏大时工具需要更多时间做数据清洗。一块很重要的经验是不要一个站点的所有场景文件塞成一个任务。路测数据准备阶段不同类型测试数据文件要通过文件名关键字区分——“_好点”、“_切换”、“_Attach”、“_ping”等。选择数据时按场景逐个勾选平台才能准确生成对应场景的分析页。如果你贪快全选平台会把所有场景数据揉在一起分析报告里好点速率会被切换事件数据稀释数值失真。5.3 报告下载与输出物清单报告生成后在任务列表里对应行的状态会变为“完成”。这时候去“报告下载”区按任务维度下载。下载下来的报告是一个压缩包内含的内容一般包括单站验证主报告PDF或Word格式指标汇总Excel表路测数据LOG的摘要文件若启用了ISDP关联还会附带站点交付状态回传的确认信息。报告下载完之后建议按“站号_站名_日期”的格式重新命名压缩包并归档。原因有两个一是平台下载的文件名是任务ID不具备可读性二是后续若需要关联ISDP做站点交付人工核对时按照统一命名能省掉不少沟通成本。5.4 定制需求提交RNAC-tools的路径标准模板满足不了所有场景的时候不要自己在报告上手动加工平台提供了定制通道在RNAC-tools上提交定制需求。提交后会有专人联系确认需求细节并且可以跟踪定制进度。根据使用说明书里的说明定制诉求一般由项目TL统一提交一线网优把需求描述清楚即可。定制需求提交的一个关键点是在需求描述里写清楚是“加字段”还是“改计算逻辑”。加字段只需要说明字段名和数据来源改计算逻辑则需要把期望的计算方式描述到可实现的颗粒度比如“好点定义从SINR3改为SINR5”——像这样写具体数值的实现速度远比“把好点定义优化一下”要快。6. 从单站到批量把远程交付流程固化成团队套路单站跑通之后真正的效率提升来自批量交付时的流程固化。我做了三个调整对团队整体的交付节奏影响最大可以对照着落地。第一个调整是建一份“站级数据核查清单”提前到报告生成之前做。清单按“工参完整度 → 配置数据自检 → 路测数据命名 → 三方字段比对 → 目录层级”五列铺开每传一个站在清单上打勾。这个动作看起来很原始但远程交付模式下现场团队和后台分析团队不是一个人凡是能写进清单的环节都不依赖个人经验。数据准备四个动作里最容易漏的就是“配置数据自检”因为它不强制、不校验、错了也不立刻报错——把这一项写进清单让执行人强制确认能规避掉最多的隐性返工。第二个调整是所有接口人在批量上传前统一跑一遍脚本摸底。目录命名检查、字段空值检查、深度检查一次性把整批站点过掉符合条件才允许上传。因为平台校验是在上传时逐个文件进行的一批50个站如果中间有3个目录超深度整个批次会反复失败后台逐个排查非常低效。批量前摸底和平台校验的差异点只剩网络抖动这类偶发问题排障范围大大缩小。第三个调整是报告下载后立即做“文件名二次规整”。凡是和ISDP关联的站点下载完改成“站号_站名_日期”再放到ISDP要求的归档路径下。第一次远程交付时我没做这一步两个月后回看记录面对几十个任务ID命名的压缩包完全分不清哪个是哪个后来只能逐个打开确认。从那以后我每次批量下载完报告都强制走一遍改名和归档流程这个习惯救过我很多次。工具本身不复杂复杂的是把数据规则讲清楚并让每个人都执行。这份使用说明书最值得细读的不是操作步骤而是“划重点”那几句——单独NR项目、字段一致性、目录命名规范——全是在长期交付实践里反复踩出来的硬性要求。希望帮到你。本文还有配套的精品资源点击获取