入门 > 选择您的工作环境 > Windchill RV&S 客户端图形用户界面 > 环境变量(GUI)
  
环境变量(GUI)
在用户工具栏按钮下配置的外部程序可访问环境变量。使用这些变量时,名称必须为大写,否则 Windchill RV&S 将无法识别这些变量。
以下列表显示打开的每类窗口的关联环境变量:
所有
如果窗口具有服务器连接,则它将设置下列变量。
MKSSI_WINDOW
MKSSI_HOST
MKSSI_PORT
MKSSI_USER
如果没有活动的窗口或视图,则:
MKSSI_WINDOW=none
如果存在活动的窗口,则:
MKSSI_WINDOW=[archive|document|item|items|project|projecthistory|sandbox]
否则,值会设为特定于窗口的值:
MKSSI_WINDOW=archive
如果活动的窗口是不同的窗口,则:
MKSSI_WINDOW=unknown
例如,不生成任何特定环境变量的“项目修改”窗口:
MKSSI_WINDOW=unknown
* 
对于 noneunknown 值,不会设置任何其他变量。
由于 Windchill RV&S 支持与服务器的多个连接,您应在通过工具栏运行命令行操作时指定下列环境变量:
si <command> --host=$MKSSI_HOST --port=$MKSSI_PORT --user=$MKSSI_USER
文档
“项”窗口类型相同,加上下列修订版本变量:
MKSSI_REVISION_NAME=<revision name>
例如,1.2
MKSSI_REVISION_DATE=<revision date>
例如,Mon Mar 26 14:53:35
如果相应项的“自项版本修订以来的重要更改”字段为 true,则:
MKSSI_REVISION_DELTA=true
* 
MKSSI_REVISION_NAMEMKSSI_REVISION_DATEMKSSI_REVISION_DELTA 变量可导出根项信息。如果该项未进行版本修订或它没有修订版本历史记录,则不会导出任何变量。通过“文档” > “特性”菜单选项显示的窗口会导出与“编辑项”窗口相同的变量。
对于打开的“项详细信息”窗口:
MKSSI_NISSUE=<1>
MKSSI_ISSUE=<ID of selected item>
MKSSI_ISSUE0=<same ID as MKSSI_ISSUE>
MKSSI_REVISION_NAME=<revision name>
例如,1.2
MKSSI_REVISION_DATE=<revision date>
例如,Mon Mar 26 14:53:35
如果相应项的“自项版本修订以来的重要更改”字段为 true,则:
MKSSI_REVISION_DELTA=true
* 
如果该项未进行版本修订或它没有修订版本历史记录,则不会导出任何变量。
编辑项
对于打开的“编辑项”窗口:
MKSSI_ISSUE=<ID of item open for edit>
MKSSI_ISSUE0=<same ID as MKSSI_ISSUE>
MKSSI_REVISION_NAME=<revision name>
例如,1.2
MKSSI_REVISION_DATE=<revision date>
例如,Mon Mar 26 14:53:35
如果相应项的“自项版本修订以来的重要更改”字段为 true,则:
MKSSI_REVISION_DELTA=true
* 
如果该项未进行版本修订或它没有修订版本历史记录,则不会导出任何变量。
对于打开的“项”窗口:
MKSSI_NISSUE=<number of MKSSI_ISSUE objects>MKSSI_ISSUE[x]=<ID of selected item>
其中 [x] 的值始于 0,并随每个选定项递增。
MKSSI_QUERY=<current query for Items window>or
MKSSI_QUERY=<queryCreatorName>:<queryName>or
MKSSI_QUERYDEFINITION=<queryDefinition>
MKSSI_NFIELD=<number of columns in view>
MKSSI_FIELD[x]=<display name of each field displayed as columns
in the view>
打开的“项”窗口的列配置:
MKSSI_NFIELD=<number of visible fields>
MKSSI_FIELD[x]=<name of each visible field>
其中 [x] 的值范围为 1MKSSI_NFIELD
MKSSI_FIELD[x]_WIDTH=<width of each visible field>
其中 [x] 的值范围为 1MKSSI_NFIELD
MKSSI_SORTFIELD=<name of the field that the view is sorted by>
MKSSI_SORTASCENDING=[true|false]
如果视图按升序排序,则为 true;如果视图按降序排序,则为 false
关系
对于打开的“关系”窗口:
MKSSI_NISSUE=<number of MKSSI_ISSUE objects>
MKSSI_ISSUE[x]=<ID of selected item>
其中,[x] 的值始于 0,并随每个项的选定而递增。
MKSSI_REVISION_NAME[x]=<revision name>
例如,1.2
MKSSI_REVISION_DATE[x]=<revision date>
例如,Mon Mar 26 14:53:35
如果相应项的“自项版本修订以来的重要更改”字段为 true,则:
MKSSI_REVISION_DELTA[x]=true
* 
MKSSI_REVISION_NAME[x]MKSSI_REVISION_DATE[x]MKSSI_REVISION_DELTA[x] 变量仅导出选定项的修订版本信息。如果未修订相应 MKSSI_ISSUE[x] 的版本信息,则 [x] 的值始于 0,并支持间距。如果该项未进行版本修订或它没有修订版本历史记录,则不会为其导出任何特定于修订版本的变量。
成员历史记录
对于打开的“成员历史记录”窗口:
MKSSI_FILE=<pathname-relative to project/sandbox of archive>
如果从沙盒中打开窗口:
MKSSI_WORKINGFILE=<full-path-to-working-file>
MKSSI_SANDBOX=<full-path-to-sandbox>
MKSSI_PROJECT_CONFIG_PATH=<project-configuration-path-in-the-form
#/Project Name#Subproject Name>
* 
如果不存在工作文件,则不会设置 MKSSI_WORKINGFILE
如果从项目中打开窗口:
MKSSI_PROJECT=<server-path-to-project>
MKSSI_PROJECT_CONFIG_PATH=<project-configuration-path-in-the-form
#/Project Name#Subproject Name>
如果项目/沙盒是变型:
MKSSI_VARIANT=<variantName>
如果项目/沙盒是构建:
MKSSI_BUILD=<buildNumber>
如果修订版本已选定:
MKSSI_REVISION=<highest revision in selection>
MKSSI_REVISION[x]=<1.2>
即,从 MKSSI_REVISION1MKSSI_REVISION[x] 存在 n 个变量,包含每个选定的修订版本号。
项目
对于打开的“项目”窗口:
MKSSI_FILE=<server-side-project-path>
MKSSI_NMEMBER=<number of MKSSI_MEMBER[x] entries>
MKSSI_NSUBPROJECT=<number of MKSSI_SUBPROJECT[x] entries>
MKSSI_PROJECT_CONFIG_PATH=<project-configuration-path-
in-the form #/Project Name>
如果选定任何成员,则将应用以下变量:
MKSSI_MEMBER[x]=<path-relative-to-project>
MKSSI_MEMBER_PROJECT[x]=<server-side-project/subproject-path>
MKSSI_MEMBER[x]_PROJECT_CONFIG_PATH=<project-configuration-path-
in-the form #/Project Name#Subproject Name>
如果选定任何子项目,则将应用以下变量:
MKSSI_SUBPROJECT[x]=<path-relative-to-project>
MKSSI_SUBPROJECT_PROJECT[x]=<server-side-project/subproject-path>
MKSSI_SUBPROJECT[x]_CONFIG_PATH=<subproject-configuration-path-
in-the-form #/Project Name#Subproject Name>
即,如果存在选定的 n 个成员并且已选定 m 个子项目,则您会见到 MKSSI_MEMBER 出现 n 次,编号从 1n,并且数字 n 也会在 MKSSI_NMEMBER 中传递。MKSSI_SUBPROJECT 的出现次数也会介于 1m 之间,并且数字 m 也会在 MKSSI_NSUBPROJECT 中传递。
如果已选定子目录,则当作该子目录已递归展开(仅限目录,而非子目录)并且所有成员均已选定。
由于在视图中已打开的顶层项目中可能没有指定的成员,因此 MKSSI_MEMBERMKSS_SUBPROJECT 的每个变量均会具有 MKSSI_MEMBER_PROJECT[x]MKSSI_SUBPROJECT_PROJECT[x] 的相应条目。因此,每个 MEMBER/SUBPROJECT 变量与相应的 PROJECT 条目有关,而与 MKSSI_FILE 中指示的顶层无关。
例如:
i=1
while [ $i -le $MKSSI_NMEMBER ]
do
eval si command -P\${MKSSI_MEMBER_PROJECT$i}\${MKSSI_MEMBER$i}
let i=i+1
done
* 
如果已设置,则在调用具有选项 --devpath--projectrevisionsi command 时,还会导出环境变量 MKSSI_VARIANTMKSSI_BUILD
项目历史记录
对于打开的“项目历史记录”窗口:
MKSSI_FILE=<server-side-project-path>
MKSSI_PROJECT_CONFIG_PATH=<project-configuration-path-in-the-form
#/Project Name>
* 
设置 MKSSI_REVISION[x] 的方式与设置成员历史记录相同。
沙盒
对于打开的“沙盒”窗口:
MKSSI_FILE=<full-path-to-sandbox>
MKSSI_NMEMBER=<number of MKSSI_MEMBER objects>
MKSSI_NSUBPROJECT=<number of MKSSI_SUBPROJECT objects>
MKSSI_PROJECT_CONFIG_PATH=<project-configuration-path-in-the-form
#/Project Name>
如果在“沙盒”窗口中已选定成员:
MKSSI_MEMBER[x]_PROJECT_CONFIG_PATH=<project-configuration-path-
in-the-form #/Project Name#Subproject Name>
如果在“沙盒”窗口中已选定子项目:
MKSSI_SUBPROJECT[x]_CONFIG_PATH=<subproject-configuration-path-
in-the-form #/Project Name#Subproject Name>
MKSSI_SUBSANDBOX[x]=<local-Sandbox-path-of-the-currently-selected-
subsandbox-in-the-form C:\Sandbox Location\Project1\project.pj>
MKSSI_SUBSANDBOX[x]_PARENT=<local-Sandbox-path-of-the-parent-for-the-
currently-selected-subsandbox>
* 
变量 MKSSI_MEMBER[x]= 所采用的设置与项目窗口所用的设置相同。相应变量 MKSSI_MEMBER[x]_SANDBOX 也与项目的描述相同。如果适用,则还会设置 MKSSI_VARIANTMKSSI_BUILD
MKSSI_SUBPROJECT[x] 的环境变量会替换为 MKSSI_SUBPROJECT[x]_CONFIG_PATHMKSSI_SUBPROJECT[x]_SANDBOX 的环境变量会替换为 MKSSI_SUBSANDBOX[x]MKSSI_SUBSANDBOX[x]_PARENT
已注册项目
对于打开的“已注册项目”视图:
MKSSI_PROJECT[x]_CONFIG_PATH=<project-configuration-path-in-the-form
#/Project Name>
MKSSI_SUBPROJECT[x]_CONFIG_PATH=<subproject-configuration-path-
in-the-form #/Project Name#Subproject Name>
已注册沙盒
对于打开的“已注册沙盒”视图:
MKSSI_PROJECT[x]_CONFIG_PATH=<project-configuration-path-in-the-form
#/Project Name>
MKSSI_SUBPROJECT[x]_CONFIG_PATH=<subproject-configuration-path-
in-the-form #/Project Name#Subproject Name>
MKSSI_SUBSANDBOX[x]=<local-Sandbox-path-of-the-currently-selected-
subsandbox-in-the-form C:\Sandbox Location\Project1\project.pj>