Sage 100 Cloud数据库笔记编辑换行不显示问题排查

问题背景 #

我开发了一个基于C# .NET 6.0的应用，用于编辑Sage 100 Cloud数据库中的笔记，修改的是dbo.F_COMPTETNOTE表的CT_Note列。现在发现换行符已经被记录到数据库中，但在Sage Gescom界面里不显示。

环境信息 #

• 开发框架：C# .NET 6.0
• 数据库排序规则：French_CI_AS
• 数据库连接库：Microsoft.Data.SqlClient

问题代码 #

执行更新的SQL代码如下：

request = "UPDATE F_COMPTETNOTE SET CT_Note = @Content, cbModification = @cbModification WHERE CT_Num = @CT_Num";
SqlCommand cmd = new SqlCommand(request, Program.connection.conn);
SqlParameter p1 = new SqlParameter("@Content", SqlDbType.VarChar);
p1.LocaleId = 0x040c;
cmd.Parameters.Add(p1).Value = cleanText;
cmd.Parameters.Add("@cbModification", SqlDbType.VarChar).Value = timeString;
cmd.Parameters.Add("@CT_Num", SqlDbType.VarChar).Value = NoteId;
cmd.CommandTimeout = 5;
int ret = cmd.ExecuteNonQuery();
cmd.Dispose();

我已经尝试过强制将文本转换为Utf16、Utf-8、ANSI或latin1，但都没有效果。

表结构（Edit1补充） #

USE [PROJI13]
GO

/****** Object:  Table [dbo].[F_COMPTETNOTE]    Script Date: 12/02/2024 18:04:58 ******/
SET ANSI_NULLS ON
GO

SET QUOTED_IDENTIFIER ON
GO

CREATE TABLE [dbo].[F_COMPTETNOTE](
    [CT_Num] [varchar](17) NOT NULL,
    [cbCT_Num]  AS (CONVERT([varbinary](18),[CT_Num])),
    [CT_Note] [varchar](max) NULL,
    [cbProt] [smallint] NULL,
    [cbMarq] [int] IDENTITY(1,1) NOT NULL,
    [cbCreateur] [char](4) NULL,
    [cbModification] [datetime] NULL,
    [cbReplication] [int] NULL,
    [cbFlag] [smallint] NULL,
    [cbCreation] [datetime] NULL,
    [cbCreationUser] [uniqueidentifier] NULL,
 CONSTRAINT [PK_CBMARQ_F_COMPTETNOTE] PRIMARY KEY CLUSTERED 
(
    [cbMarq] ASC
)WITH (PAD_INDEX = OFF, STATISTICS_NORECOMPUTE = OFF, IGNORE_DUP_KEY = OFF, ALLOW_ROW_LOCKS = ON, ALLOW_PAGE_LOCKS = ON, OPTIMIZE_FOR_SEQUENTIAL_KEY = OFF) ON [PRIMARY],
 CONSTRAINT [ICT_NOTE] UNIQUE NONCLUSTERED 
(
    [cbCT_Num] ASC
)WITH (PAD_INDEX = OFF, STATISTICS_NORECOMPUTE = OFF, IGNORE_DUP_KEY = OFF, ALLOW_ROW_LOCKS = ON, ALLOW_PAGE_LOCKS = ON, OPTIMIZE_FOR_SEQUENTIAL_KEY = OFF) ON [PRIMARY]
) ON [PRIMARY] TEXTIMAGE_ON [PRIMARY]
GO

ALTER TABLE [dbo].[F_COMPTETNOTE] ADD  DEFAULT ((0)) FOR [cbProt]
GO

ALTER TABLE [dbo].[F_COMPTETNOTE] ADD  DEFAULT ('CSQL') FOR [cbCreateur]
GO

ALTER TABLE [dbo].[F_COMPTETNOTE] ADD  DEFAULT (CONVERT([datetime2](0),getdate())) FOR [cbModification]
GO

ALTER TABLE [dbo].[F_COMPTETNOTE] ADD  DEFAULT ((0)) FOR [cbReplication]
GO

ALTER TABLE [dbo].[F_COMPTETNOTE] ADD  DEFAULT ((0)) FOR [cbFlag]
GO

ALTER TABLE [dbo].[F_COMPTETNOTE] ADD  DEFAULT (CONVERT([datetime2](0),getdate())) FOR [cbCreation]
GO

ALTER TABLE [dbo].[F_COMPTETNOTE]  WITH NOCHECK ADD  CONSTRAINT [FKA_F_COMPTETNOTE_CT_Num] FOREIGN KEY([CT_Num])
REFERENCES [dbo].[F_COMPTET] ([CT_Num])
GO

ALTER TABLE [dbo].[F_COMPTETNOTE] CHECK CONSTRAINT [FKA_F_COMPTETNOTE_CT_Num]
GO

非编码方向的排查思路 #

1. 验证Sage Gescom的换行符识别规则

   • Sage Gescom可能仅支持特定换行符组合，比如Windows标准的\r\n，而非Unix的\n。尝试将文本中的所有\n替换为\r\n后写入数据库，再验证显示效果；也可以测试老旧系统常用的\r换行符。

2. 对比Sage原生编辑的笔记格式

   • 通过Sage自带界面编辑一条带换行的笔记，然后查询数据库查看该笔记的存储内容，对比你写入的内容是否存在格式差异，比如是否有隐藏控制字符、特定前缀后缀等。

3. 检查数据库字段的实际存储内容

   • 用SQL语句检测换行符类型：执行SELECT CHARINDEX(CHAR(10), CT_Note), CHARINDEX(CHAR(13), CT_Note) FROM F_COMPTETNOTE WHERE CT_Num = @CT_Num，确认\n和\r是否被正确存储；也可以导出字段内容为十六进制，查看换行对应的字节值（\r\n对应0D 0A，\n对应0A）。

4. 修正参数化查询的类型匹配问题

   • 当前cbModification字段为datetime类型，但你用SqlDbType.VarChar传入字符串，可能导致隐式转换干扰Sage系统对记录的识别，建议改为SqlDbType.DateTime并直接传入DateTime对象。同时可以尝试不手动指定@Content的SqlDbType，让SqlClient自动推断类型，排除LocaleId设置的潜在影响。

5. 排查Sage中间层的文本处理逻辑

   • Sage 100 Cloud可能存在业务逻辑层或中间服务器，在读取数据库内容时过滤或转换了换行符。尝试使用Sage官方API（如果有）写入笔记，若能正常显示，则说明问题出在你的应用写入逻辑而非数据库存储。

6. 检查Gescom界面的渲染控件属性

   • 虽然概率较低，但可以确认Gescom显示笔记的控件是否支持换行（比如是否使用了允许自动换行的TextBox而非Label），不过由于原生编辑的换行能正常显示，此点可作为最后排查项。

内容的提问来源于stack exchange，提问作者LordKBX