关于 Tekla Structures 操作的日志文件

当您执行某些操作（例如为模型编号或保存模型）时，Tekla Structures 会将有关 Tekla Structures 操作的信息写入日志文件中。


文件	描述
analysis.log	当您运行分析时，Tekla Structures 会将信息存储在此文件中。此文件还包含有关在分配荷载过程中发生的错误的信息。此日志文件保存在当前文件夹下的 \logs 文件夹中。
BCFTopics-<process ID>.log	包含有关 Trimble Connect BCF 主题的信息。此日志文件保存在 %LocalAppdata%\Trimble\Tekla Structures\%Version%\Logs 文件夹中。
check_database.log	当您在文件 > 校核和修正 > 模型中运行修复模型命令时，Tekla Structures 会将信息存储在此文件中。此日志文件保存在当前文件夹下的 \logs 文件夹中。
ClashCheck.log	包含最近一次碰撞校核中发现的碰撞。此日志文件保存在当前文件夹下的 \logs 文件夹中。
conflict.log	包含多用户模式下多个用户修改对象后发生的冲突。此日志文件保存在当前文件夹下的 \logs 文件夹中。
DocumentManager_<user>.log	包含与文档管理器相关的故障排除信息以及文档管理器中出现的任何错误。此日志文件保存在当前文件夹下的 \logs 文件夹中。
DPMPrinter_<PrintJob-ID>.log	包含与打印相关的故障排除信息，以及在将图纸或报告打印到打印机、打印文件或 PDF 文件时出现的任何错误。此日志文件保存在 %LocalAppdata%\Trimble\Tekla Structures\%Version%\Logs 文件夹中。
drawing_cloning.log	包含有关所克隆图纸的信息。此日志文件保存在当前文件夹下的 \logs 文件夹中。
drawing_history.log	包含有关图纸历史记录的信息。使用高级选项 XS_DRAWING_HISTORY_LOG_TYPE 可定义文件的内容。此日志文件保存在当前文件夹下的 \logs 文件夹中。
dstv_nc.log	每次创建 NC 文件时，Tekla Structures 都会将关于所处理构件的信息存储在此文件中。此日志文件保存在当前文件夹下的 \logs 文件夹中。
filetranerror.log	仅用于冷弯组件，例如 Albion、Ayrshire 和 Hispan。如果文件移动组件不按预期方式工作，Tekla Structures 会将错误消息存储在此文件中。此日志文件保存在当前文件夹下的 \logs 文件夹中。
LiveCollaboration-<process ID>.log	包含有关 Live Collaboration 的信息。此日志文件保存在 %LocalAppdata%\Trimble\Tekla Structures\%Version%\Logs 文件夹中。
modelsharing_<process ID>.log	包含在模型打开时 Tekla Model Sharing 中已执行的共享操作。例如，打开共享模型并读入其他用户所做的更改将存储在 modelsharing_<process ID>.log 文件中。此日志文件保存在当前文件夹下的 \logs 文件夹中。
numberinghistory.log	包含在模型上执行的每个编号会话的完整详细信息。每个会话的信息位于该文件的不同块中。此日志文件保存在当前文件夹下的 \logs 文件夹中。
PublishToTrimbleConnect.log	包含将 Tekla Structures 模型以 `.tekla` 文件形式上传到链接的 Trimble Connect 工程时产生的上传信息和发生的错误。此日志文件保存在当前文件夹下的 \logs 文件夹中。
save_history.log	每次保存模型时，Tekla Structures 都会将信息存储在此文件中。此日志文件保存在当前文件夹下的 \logs 文件夹中。
TeklaStructures_LicenseAndLoginEvents_<process ID>.log	包含与许可证和登录活动相关的事件。此日志文件保存在 %LocalAppdata%\Trimble\Tekla Structures\%Version%\Logs 文件夹中。
TeklaStructures-<process ID>.log	包含有关整个 Tekla Structures 会话（从打开模型到关闭模型）的信息。此日志文件保存在 %LocalAppdata%\Trimble\Tekla Structures\%Version%\Logs 文件夹中。该文件夹中会存储最近五次 Tekla Structures 会话的日志条目。
TeklaStructures-<process ID>.err	每当 Tekla Structures 中出现错误时，该错误将保存在错误日志文件中。错误日志文件包含特定时间出现的错误的描述。此日志文件保存在 %LocalAppdata%\Trimble\Tekla Structures\%Version%\Logs 文件夹中。
TmsClientLog_<process ID>_<date>_<instance>.log	包含与 Tekla Model Sharing 共享服务相关的诊断信息和错误消息，包括有关连接到共享服务及其状态的详细信息。日志文件保存在 %LocalAppdata%\Trimble\TeklaModelSharingFacade\ 文件夹中。
tsep-<process ID>.log	包含与 .tsep 文件相关的信息。此日志文件保存在 %LocalAppdata%\Trimble\Tekla Structures\%Version%\Logs 文件夹中。
wizard.log	Tekla Structures 当您运行图纸规则集（向导）文件时，将信息存储在此文件中。例如，此文件包含所创建图纸的错误和编号。此日志文件保存在当前文件夹下的 \logs 文件夹中。

查看日志文件

您可以在 Tekla Structures 日志查看器或与文件类型关联的应用程序（如 Microsoft 记事本）中查看日志文件。

如果日志文件包含有关零件或构件的信息，则可以查看模型中的零件或构件。在该日志文件中，选择包含零件或构件的行。

零件和构件的前缀是 guid。

Tekla Structures 将在模型中高亮显示该零件。如果某一行中有多个零件或构件，并且您选择了该行，Tekla Structures 会在模型中高亮显示所有这些零件。您还可以在不同行上选择零件。

提示：

通过右键单击包含零件或构件的行，可以从日志文件中打开零件或构件的右键单击菜单。Tekla Structures 将显示与您在模型中右键单击零件或构件时所显示的菜单相同的菜单。

打开要查看其日志历史记录的模型。
在文件菜单上，单击日志，然后选择一个日志文件。
- 碰撞检查历史记录日志 (ClashCheck.log)
- 会话历史记录日志 (TeklaStructures-<process ID.log)
- 编号历史记录日志 (numberinghistory.log)
- 正在保存历史记录日志 (save_history.log)
- 图纸历史记录日志 (drawing_history.log)
- 分析历史记录日志 (analysis.log)
通过以下方式之一查看日志文件：
- 要在日志查看器中查看日志文件，请选择文件 > 日志 > 使用 Tekla Structures 日志查看器查看。
- 要在与文件类型关联的应用程序中查看日志文件，请选择文件 > 日志 > 使用默认应用程序查看。

更改会话历史记录日志文件的名称和位置

您可以更改会话历史记录日志文件 TeklaStructures-<process ID>.log 的名称和位置。请注意，日志文件中始终包含进程 ID。更改文件名和文件位置并不是绝对必需的，因为日志不会被覆盖。

如果其他人管理您的 Tekla Structures 安装，除非有指示，否则请勿更改这些设置。

打开相应的初始化文件进行编辑。

例如，user.ini 或 company.ini。
要更改会话历史记录日志文件的名称，请将以下行添加到初始化文件中：

set XS_LOG_FILE_NAME=<name of the file>

例如：

set XS_LOG_FILE_NAME=sessionhistory

默认值为 TeklaStructures-<process ID>.log。
要更改会话历史记录日志文件的位置，请将以下行添加到初始化文件中：

set XS_LOGPATH=<location of the file>

如果没有设置其他位置，则文件存储在 \AppData\Local\Trimble\Tekla Structures\<version>\Logs 中。
保存初始化文件。
重新启动 Tekla Structures 以使更改生效。

为历史记录日志文件编号

numberinghistory.log 文件包含在模型上执行的每个编号会话的完整详细信息。每个编号会话的信息位于该文件的不同块中。

如果编号序列相互重叠，则会向日志文件中写入错误。

注：

如果您删除 numberinghistory.log 文件，Tekla Structures 将在您下次运行编号时生成一个同名的新文件。该新文件中不包含以前编号会话的历史记录。

示例

此示例显示了 numberinghistory.log 文件的内容。


1	编号的用户名、日期和时间。
2	编号方法。当您运行修改都系编号命令时，会显示 `Modified numbering`。当您运行为所选对象编号命令时，会显示 `Modified numbering for selected series`。在以下情况下，会显示 `Diagnose & Repair Numbering: All`：运行校核和修正编号:全部命令。在以下情况下，会显示 `Diagnose & Repair Numbering: Series of selected objects`：运行校核和修正编号:所选对象的序列命令。当您在编号设置对话框中选择全部重编号选项时，会显示`全部重编号`。
3	在编号设置对话框中设置的某些比较选项仅当设置的值与默认值不同时，才会显示在 numbering.history 日志文件中： `Compare modified to old parts` `Compare new to old part` `No holes comparing` `No part name comparing` `Beam orientation` `Column orientation`
4	编号选项。仅当您在编号设置对话框中选择了重新使用老的编号选项时，才会显示`使用老的编号`。仅当您在编号设置对话框中选择了校核标准零件选项时，才会显示`校核标准零件`。
5	容许误差在编号设置对话框中进行设置。
6	一个编号会话期间位置编号和编号序列的更改情况。

编号历史记录日志文件中的编号序列

Tekla Structures 会在 numberinghistory.log 文件中列出有关编号的零件和构件的信息。

示例 1

创建一个混凝土梁 B/20 并进行编号后的 numberinghistory.log 文件：


1	零件位置编号。 GUID 为 `ID510F595D-0000-0030-3133-353939383335` 的零件是编号序列 `Concrete_B-20/1` 的一个零件。该零件成为以下编号序列的第一个零件：`Concrete_B-20/0 -> Concrete_B-20/1`.
2	构件位置编号。此零件的构件 ID 是 `ID510F595D-0000-002F-3133-353939383335`。此零件属于 `B/20` 构件编号序列，该序列也是浇筑体编号序列。此零件获得构件位置编号：`B/20: B/0 -> B/20`.

示例 2

创建另一个混凝土梁 B/21 并进行编号后的 numberinghistory.log 文件：


1	新零件的零件位置编号。 ID 为 `ID510F595D-0000-0030-3133-353939383335` 的零件是编号序列 `Concrete_B-20/1` 的零件。该零件成为以下编号序列的第二个零件：`Concrete_B-20/0 -> Concrete_B-20/2`.
2	构件位置编号。此零件的构件 ID 是 `ID510F595D-0000-002F-3133-353939383335`。此零件属于 `B/20` 构件编号序列，该序列也是浇筑体编号序列。此零件获得构件位置编号：`B/20 B/0 -> B/21`.