入门 - 格式化文本表

欢迎光临 本综合指南将帮助您快速开始使用 Power BI 的格式化文本表可视化功能，该功能具有多平台标记解析、智能格式检测、安全消毒、特定列配置和企业内容集成等特点。

📋全面功能概览

🔍 多平台解析 ✨

支持 9 种以上企业标记语言
智能格式自动检测
与 Confluence、Jira、Slack、Teams 和 GitHub 集成
支持 Markdown、HTML 和 RTF 格式
性能优化的解析引擎

🎨 专业格式化 ✨

保留原始标记样式
Power BI 主题集成
栏目特定格式配置
响应式表格布局
在表格单元格中呈现富文本

特定于列的控件 ✨

每栏标记格式选择
单列宽度调整
栏目特定的安全级别
标题样式和格式
灵活的列重新排序

智能内容检测 ✨

自动格式识别
后备解析器层次结构
内容验证和消毒
优雅降级的错误处理
性能指标和监测

企业安全

内置 XSS 保护
可配置的安全级别
内容净化引擎
CSP 合规性检查
安全呈现外部内容

🎯 Power BI 集成

原生桌面视觉体验
主题感知造型
支持标准上下文菜单
响应式设计原则
AppSource 合规性

增强的数据设置和要求

⚠️ 重要： 每一列都应包含一致的标记格式，以获得最佳解析和显示结果。

增强型数据模型结构

- 增强的数据结构，内容格式化 ✨

选择 

    项目编号、

    'h1.Project Overview\nStatus：{{color:green}}Active{{color}}\nPriority: High' as ConfluenceContent、

    'Current Sprint\n- [x] Requirements gathering\n- [ ] Development\n- [ ] Testing' as MarkdownContent、

    '：white_check_mark：Completed\n:warning：Review needed\n:x: ~Blocked~' as SlackContent、

    '{rtf1\ansi\deff0 {\fonttbl{f0 Times New Roman;}}{\colortbl;\red255\green0\blue0;}\f0\fs24 \cf1 Priority Item\cf0}' as RTFContent

FROM 项目表

支持的标记格式参考

格式	平台	现状	说明	示例
Markdown	通用, GitHub	✅ 第 1 级	带有 GitHub 扩展的标准标记符	粗斜体代码
汇流维基	Atlassian	✅ 第 1 级	Confluence 维基标记格式	粗斜体 {{color:red}}text{{color}
Jira 维基百科	Atlassian	✅ 第 1 级	Jira 问题和评论格式化	粗斜体 {颜色：红色}文本{颜色｝
Slack Markdown	松弛	✅ 第 1 级	带有表情符号的 Slack 专用格式	粗斜体 :emoji: ~strikethrough~
团队 Markdown	微软团队	✅ 第 1 级	团队信息格式	粗斜体~~删除线~~
超文本标记语言	网络/电子邮件	✅ 第 1 级	经过净化的 HTML 内容	<b>豪迈</b> <i>斜体</i>
RTF	微软办公软件	✨ 增强	富文本格式文件	{rtf1\ansi\b bold text\b0}
纯文本	通用	回退	未格式化的文本内容	简单的文本内容

⚙️ 综合配置指南

步骤 1：准备内容数据

清洁内容： 确保标记语法对每个平台都有效
格式一致： 在各栏中使用一致的标记格式
测试语法： 导入前验证原始平台中的标记
手柄编码： 确保特殊字符采用正确的 UTF-8 编码
尺寸优化： 将内容大小控制在合理范围内，以保证性能

数据准备示例：

ConfluenceContent = 

"h2.Status Update\n\n" +

"项目：数字转型 "+

"状态：{{color:green}}On Track{{color}}\n" +

"下一个里程碑：{{color:blue}}第二阶段完成{{color}}/n\n" +

"h3.关键指标/n" +

"||度量||值||趋势||/n" +

"| Completion | 75% | |\n" +

"| 预算 | 92% | → |"

步骤 2：配置 Basic Visual

添加视觉效果： 在报告中插入格式化文本表格视觉效果
地图专栏： 将包含标记的文本列拖动到 "值 "字段中
设置列标题： 配置有意义的列标题
测试基本显示： 验证内容是否符合基本格式

步骤 3：启用增强功能 ✨

🎨 栏格式配置

访问栏设置： 格式 "窗格 > "列格式化
选择格式： 为每一栏选择特定的标记格式
设置自动检测： 启用智能格式检测
测试渲染： 验证格式设置是否正确

💬 安全配置

安全等级： 从严格、适度或放任中选择
内容过滤： 配置允许的 HTML 标记和属性
XSS 保护： 启用高级安全扫描
测试安全： 验证可能不安全的内容是否经过适当消毒

📊 栏布局设置

列宽： 设置各栏宽度比例
文本对齐： 配置每列的左、中、右对齐方式
标题设计： 自定义标题外观和格式
Row Styling： 配置交替行的颜色和间距

性能优化

启用缓存： 格式窗格 > 性能 > 启用解析器缓存
设定限制： 配置每个单元格的内容大小限制
监控性能： 审查解析性能指标
优化大型表格 考虑对大型数据集进行分页处理

格式检测设置

自动检测： 启用自动格式识别
后备命令： 配置解析器优先级结构
定制图案： 添加自定义格式检测模式
手动超控： 为已知内容类型设置特定格式

✅ 配置完成： 现在你应该拥有一个完全配置好的格式化文本表，它支持多平台标记、安全消毒和专业的表格样式。

高级功能使用指南

🔍 多平台解析 ✨

支持的格式功能

汇合： 彩色文本、表格、宏、面板和维基标记
Jira： 问题格式、彩色文本、表格和维基语法
Slack： 表情符号、提及、格式化和主题式内容
团队信息格式、提及和协作内容
Markdown： 带有代码块和表格的 GitHub 风格标记符
HTML 具有安全保护功能的净化网页内容
RTF： 字体、颜色和格式丰富的文本文档

🎨 专列配置 ✨

每栏设置

格式选择： 为每一列选择特定的标记解析器
安全等级： 为每一列设置单独的安全级别
宽度控制： 配置列宽比例和限制条件
结盟： 设置每列的文本对齐方式（左对齐、居中对齐、右对齐
风格覆盖： 为特定列应用自定义 CSS 类
内容限制： 设置每列内容的最大尺寸

💡 专业提示： 使用特定的列设置，优化不同内容类型的显示--外部内容严格安全，内部文档宽松。

智能格式检测 ✨

智能内容识别

模式匹配： 基于标记模式的自动检测
优先等级： 可配置的解析器优先处理模棱两可的内容
信心评分： 格式检测的解析器置信度
后备链： 在需要时优雅地降级为更简单的格式
手动超控： 自动检测失败时强制指定格式
性能优化： 通过缓存进行高效格式检测

💡 商业价值： 自动处理来自多个企业平台的混合内容，无需手动指定格式。

💬 安全与消毒 ✨

企业安全功能

XSS 保护： 高级跨站脚本防护
内容过滤： 可配置允许/阻止的 HTML 元素
CSP 合规性： 内容安全策略验证
安全渲染 隔离渲染外部内容
审计日志： 安全违规跟踪和报告
风险评估： 内容风险评分和建议

🔄 性能与缓存

优化功能

解析器缓存 缓存已解析的内容，以便重复使用
懒加载： 只在视口中可见时加载内容
内容限制： 可配置的大小限制可防止出现性能问题
批量处理： 高效处理大型数据集
内存管理 自动清理未使用的解析内容
性能指标： 实时解析性能监控

⚡ 高级表格控件

全面的餐桌造型

📁 表格部分：

🎨 标头（分组）： 标题样式、字体和颜色
行（分组）： 行距、交替颜色和边框
📝 内容（分组）： 文本样式、对齐和格式化
⚙️ 布局（分组）： 列宽、响应式行为

可用控制器：

响应式设计 针对不同屏幕尺寸自动调整栏
主题整合： 自动采用 Power BI 主题颜色
定制造型： 用自定义 CSS 覆盖默认样式
无障碍环境： 符合 WCAG 标准的表格结构和导航

企业集成

数据源连接： 与企业平台直接集成
内容同步： 来自源系统的实时更新
批量进口： 高效处理大量内容
格式保存： 保持原始格式和样式
审计跟踪： 跟踪内容更改和解析历史

🔧 综合故障排除指南

格式检测问题 ✨

验证内容是否包含目标格式的可识别标记模式
检查 "格式 "窗格 >"列格式"，手动覆盖格式
使用简化内容进行测试，以隔离解析问题
审查绩效小组中的格式检测置信度评分
确保特殊字符的内容编码为 UTF-8

内容未显示 ✨

检查安全级别设置 - 严格模式可能会阻止内容
验证内容大小是否在配置的限制范围内
检查安全违规日志，查看是否存在受阻元素
使用纯文本内容进行测试，以验证基本功能
检查列宽设置 - 内容可能被隐藏

❌ 性能问题 ✨

在格式窗格 > 性能中启用解析器缓存
减少大型数据集的内容大小限制
检查解析性能指标是否存在瓶颈
考虑对多行表格进行分页处理
查看内存使用情况并启用自动清理功能

❌ 安全警告 ✨

查看安全违规日志，查找具体问题
调整安全级别，在安全性和功能性之间取得平衡
检查网络内容的 CSP 合规性设置
验证内容源是否可信，以确保许可安全
使用经过消毒的内容进行测试，以隔离安全冲突

❌ 格式未保留

验证已为列选择正确的标记格式
检查源平台中的原始内容语法
测试特定格式的功能（颜色、表格、链接）
审查针对复杂格式化的特定解析器限制
确保 Power BI 主题不会覆盖关键样式

❌ 表格布局问题

在格式窗格 > 布局中检查列宽比例
验证不同屏幕尺寸的响应式设计设置
测试各栏的文本对齐设置
检查标题和行的样式是否存在可见性问题
确保格式化内容有足够的视觉空间

🎉先进的最佳做法

内容准备 ✨

验证原始平台中的标记语法
在每一列中使用一致的格式
优化内容大小，提高性能
使用具有代表性的样本数据进行测试
为不同内容类型规划栏目布局

安全与合规 ✨

对内容源使用适当的安全级别
定期检查安全违规日志
彻底测试内容消毒
对内容更改实施审计跟踪
验证网络内容的 CSP 合规性

性能优化 ✨

为重复内容启用解析器缓存
监控解析性能指标
为大型数据集使用分页
优化内容类型的列宽
考虑对大型表格进行懒加载

企业集成 ✨

直接连接企业内容平台
实现自动内容同步
对混合内容源使用格式检测
规划实时内容更新
创建全面的文档仪表板

🚀 准备好开始了吗？ 这一全面的可视化工具可将企业平台上难看的原始标记转换为格式精美的专业表格内容，既能保持原始样式，又能支持在 Power BI 仪表板中安全、高性能地显示！