关于 Tekla Structures 操作的日志文件

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


文件	描述
analysis.log	在您运行分析时，Tekla Structures 会将信息存储在此文件中。此文件还包含有关在分配荷载过程中发生的错误的信息。此日志文件保存在当前模型文件夹中。
check_database.log	当您运行文件菜单 > 校核和修正 > 模型中的修复命令时，Tekla Structures 会将信息存储在此文件中。此日志文件保存在当前模型文件夹中。
ClashCheck.log	包含最近一次碰撞校核中发现的碰撞。此日志文件保存在当前模型文件夹中。
ClientLog_cat.txt ClientLog_dog.txt	客户端日志文件包含有关 Tekla Model Sharing 共享服务的诊断信息和错误消息，例如连接到共享服务或共享服务的状态。默认情况下，客户端日志文件保存在 \Users\<user>\AppData\Local\Tekla DataSharing 文件夹中。有两个客户端日志文件，每个文件的最大大小为 1 MB，因此信息不会占用太多磁盘空间。当一个文件达到最大文件大小时，日志写入更改到另一个文件。每次活动客户端日志文件发生更改时，在将任何新的日志信息写入日志文件之前，将清除先前保存在当前日志文件中的任何信息。
ComponentCatalog_<user>.log	包含与应用程序和组件目录相关的故障排除信息以及应用程序和组件目录中出现的任何错误。例如，目录定义文件中的错误存储在 ComponentCatalog_<user>.log 文件中。此日志文件保存在当前文件夹下的 \logs 文件夹中。与应用程序和组件目录相关的有限数量的旧日志消息将在 ComponentCatalog_<user>.bak.log 文件中存档和保存。此文件包含大约 1024 KB 的数据。
conflict.log	包含多用户模式下多个用户修改对象后发生的冲突。此日志文件保存在当前模型文件夹中。
DocumentManager_<user>.log	包含与文档管理器相关的故障排除信息以及文档管理器中出现的任何错误。此日志文件保存在当前文件夹下的 \logs 文件夹中。与文档管理器相关的有限数量的旧日志消息将在 DocumentManager_<user>.bak.log 文件中存档和保存。此文件包含大约 256 KB 的数据。
DPMPrinter_<user>.log	包含与打印相关的故障排除信息，以及在打印图纸中出现或报告到打印机、打印文件或 PDF 文件的任何错误。此日志文件保存在当前文件夹下的 \logs 文件夹中。与打印相关的有限数量的旧日志消息将在 DPMPrinter2_ <user>.log 文件中存档和保存。此文件包含大约 1024 KB 的数据。
drawing_cloning.log	包含有关所克隆图纸的信息。此日志文件保存在当前模型文件夹中。
drawing_history.log	包含有关图纸历史记录的信息。使用高级选项 XS_DRAWING_HISTORY_LOG_TYPE 可定义文件的内容。此日志文件保存在当前模型文件夹中。
dstv_nc.log	每次创建 NC 文件时，Tekla Structures 都会将关于所处理构件的信息存储在此文件中。此日志文件保存在当前模型文件夹中。
error_<user>_<YYYYMMDD>_<HHMMSS>.log	每当 Tekla Structures 中出现错误时，该错误将保存在错误日志文件中。错误日志文件包含特定时间出现的错误的描述。例如，如果在 2019 年 4 月 1 日上午 9:15:30 发生错误，则相关错误日志文件的名称为 error_<user>_20190401_091530.log。此日志文件保存在当前文件夹下的 \logs 文件夹中。
filetranerror.log	仅用于冷弯组件，例如 Albion、Ayrshire 和 Hispan。如果文件移动组件不按预期方式工作，Tekla Structures 会将错误消息存储在此文件中。此日志文件保存在当前模型文件夹中。
modelsharing.log	包含 Tekla Model Sharing 中已执行的共享操作。例如，打开共享模型并读入其他用户所做的更改将存储在 modelsharing.log 文件中。此日志文件保存在当前文件夹下的 \logs 文件夹中。
numberinghistory.txt	包含在模型上执行的每个编号会话的完整详细信息。每个会话的信息位于该文件的不同块中。此日志文件保存在当前模型文件夹中。
PublishToTrimbleConnect.log	包含将 Tekla Structures 模型以 `.tekla` 文件形式上传至链接的 Trimble Connect 工程时产生的上传信息和发生的错误。此日志文件保存在当前文件夹下的 \logs 文件夹中。
save_history.log	每次当您保存模型时，Tekla Structures 都会将信息存储在此文件中。此日志文件保存在当前模型文件夹中。
sharingfacade.log	当 Tekla Model Sharing 共享服务中发生错误时，包含客户端日志文件中的基本信息。此日志文件保存在当前文件夹下的 \logs 文件夹中。
TeklaStructures_<user>.log	包含有关整个 Tekla Structures 会话（从打开模型到关闭模型）的信息。例如，此文件包含有关所使用目录的错误和信息。此临时日志文件保存在 \TeklaStructuresModels 文件夹中，在关闭 Tekla Structures 时将删除此文件。
wizard.log	当您运行某个图纸规则组（快捷方式）文件时，Tekla Structures 会将信息存储在此文件中。例如，此文件包含所创建图纸的错误和编号。此日志文件保存在当前模型文件夹中。

查看日志文件

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

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

零件和构件的前缀是 guid。

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

提示：

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

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

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

您可以更改会话历史记录日志文件 (TeklaStructures_<user>.log) 的名称和位置。

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

Windows 用户名和 .log 文件扩展名始终添加在名称的可自定义部分之后。

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

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

set XS_LOG_FILE_NAME=<name of the file>

例如:

set XS_LOG_FILE_NAME=sessionhistory

如果 Windows 用户名是“achilles”，此示例将生成一个名为 sessionhistory_achilles.log 的日志文件。

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

set XS_LOGPATH=<location of the file>

如果未设置其它位置，则文件会存储在模型文件夹的父文件夹中（默认情况下为 c:\TeklaStructuresModels）。
保存初始化文件。
重新启动 Tekla Structures 以使更改生效。

为历史记录日志文件编号

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

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

注：

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

示例

此示例显示了 numberinghistory.txt 日志文件的内容。


1	编号的用户名、日期和时间。
2	编号方法。当您运行修改都系编号命令时，会显示 `Modified numbering`。当您运行为所选对象编号命令时，会显示 `Modified numbering for selected series`。在以下情况下，会显示 `Diagnose & Repair Numbering: All`：运行校核和修正编号:全部命令。在以下情况下，会显示 `Diagnose & Repair Numbering: Series of selected objects`：运行校核和修正编号:所选对象的序列命令。当您在编号设置对话框中选择了全部重编号选项时，会显示 `Renumber all`。
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	编号选项。仅当您在编号设置对话框中选择了重新使用老的编号选项时，才会显示 `Use old numbers`。仅当您在编号设置对话框中选择了校核标准零件选项时，才会显示 `Check for standard parts`。
5	容许误差是在编号设置对话框中设置的。
6	一个编号会话期间位置编号和编号序列的更改情况。

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

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

示例 1

创建一个混凝土梁 B/20 并进行编号后的 numberinghistory.txt 日志：


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.txt 日志：


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`.