DrGraph®软件
考试接口文档手册
产品名称： | 图形博士(DrGraph®) |
用户单位： | 昆明XX行业 |
编写人员： | 陈昊明 |
时 间: | 2013年8月 |
欢迎使用图形博士(DrGraph®)软件！
本手册适用于指导用户安装DrGraph®及后续对DrGraph®软件的操作，它将是用户工作的指南。
本手册目前由很多人持续地维护，其中的内容需要不断地更新。如果您有兴趣参加这项工作，请发邮件到 ChenBinWen@gmail.com 进行联系，也可以通过QQ：282397369 或msn: ChenBinWen@hotmail.com 在线联系。如果您希望得到一份印刷版本的手册，也请通过上述方式联系。
热忱欢迎志同道合的朋友们，我们可以在技术、市场等领域全方位合作。
本手册与软件将持续完善更新，您可以随时访问以下地址，以获取最新版本的文档与演示程序。
开发组
2013年8月
目 录
概述
结构
考试系统分两大部分：管理系统与图形博士软件
硬件系统包括考试控制端、考生端、评委端、主持人端、投影大屏幕
准备工作
- 在目标计算机上安装DrGraph软件，并注册
- 在C盘根目录下创建1.sch文件
- 将考试题库中相应的库文件拷贝到安装目录
- 编辑安装目录下的cbw.graph.cfg，根据三屏投影大屏最左端屏幕的左端位置，确定UIConfig节点中的StartMonitorIndex的属性值，缺省为0，表示起始的屏幕号。
使用流程
- 用户提前出题，保持在服务端
- 考试时，控制端从服务端读取题目并展示
- 考生作答
- 评委评分
与图形博士软件接口相关逻辑
- 用户出题时，需按规范格式出题
- 控制端相关逻辑
- 解析判断：若解析判断为图形相关题目时，需解析出其中的文件名称FileName.sch及参数Params
- 文件拷贝：拷贝FileName.sch文件(若FileName.files目录存在，也一并拷贝)到目标地址
- 参数构造：根据逻辑(详见下章)构造出参数，通过ShellExecute调用图形博士
接口说明
概述
- 字符串接口
字符串接口为一个字符串，其结构为两部分，即文件名 参数，文法表示为
FileName.sch[ paramName=paramValue]*
*表示包含[]中部分零个或多个
[]中部分表示参数，格式为参数名=参数值
文件名，后缀固定为.sch
文件名为Windows合法文件名称，可包含路径
paramName与paramValue均为字母与/或数字组合
- 考试管理系统判断逻辑
考试系统读取得到字符串接口时，需要判断一下该字符串中是否存在.sch，若存在，则表示为图形博士相应逻辑，需进行相应处理
bool __fastcall IsDrGraphLogic(AnsiString interfaceString) {
int pos = interfaceString.Pos(".sch");
bool result = pos != 0;
return result;
}
- 考试系统从字符串接口中取得文件名称、参数列表逻辑
考试系统读取得到字符串接口时，若判断为图形博士逻辑，则可取出图形文件名称及参数列表
AnsiString __fastcall GetDrGraphFileName(AnsiString interfaceString) {
AnsiString result = "";
if(IsDrGraphLogic(interfaceString))
result = interfaceString.SubString(1, interfaceString.Pos(".sch") + 3).Trim();
return result;
}
AnsiString __fastcall GetDrGraphParams(AnsiString interfaceString) {
AnsiString result = "";
if(IsDrGraphLogic(interfaceString))
result = interfaceString.SubString(interfaceString.Pos(".sch") + 3, interfaceString.Length()).Trim();
return result;
}
- 考试系统拷贝文件逻辑
拷贝图形博士文件时，首先拷贝文件，若存在对应的.files目录，则将该目录下的文件相应拷贝
void __fastcall DoCopyFile(AnsiString fileName, AnsiString destDirectory) {
AnsiString destFileName = destDirectory + ExtractFileName(fileName);
CopyFile(fileName, destFileName, true);
AnsiString directoryName = ChangeFileExt(fileName, ".files");
destDirectory += ExtractFileName(directoryName) + "\";
if(DirectoryExists(directoryName)) {
TStrings * fileNames = new TStringList;
BrowDirectory(fileNames, directoryName, "*.*", true);
for(int i = 0; i < fileNames->Count; ++i) {
AnsiString fileName = fileNames->Strings[i];
DoCopyFile(fileName, destDirectory);
}
}
}
void __fastcall BrowDirectory(TStrings * strings,
AnsiString PathName, AnsiString extName,
bool OnlyFileFlag) {
TSearchRec sr;
// 列举所有的目录
if (FindFirst(PathName + "*.*", faAnyFile, sr) == 0) {
do {
if ((sr.Attr & faDirectory) && sr.Name != "." && sr.Name != ".." &&
!OnlyFileFlag)
BrowDirectory(strings, PathName + sr.Name + "\", extName,
OnlyFileFlag);
}
while (FindNext(sr) == 0);
FindClose(sr);
}
// 列举所有文件
if (FindFirst(PathName + extName, faAnyFile, sr) == 0) {
do {
if (SameText(sr.Name, "Thumbs.db"))
continue;
if (!(sr.Attr & faDirectory)) {
AnsiString n = sr.Name;
if (n.Length())
strings->Add(PathName + n);
}
}
while (FindNext(sr) == 0);
FindClose(sr);
}
}
- 考试系统调用图形博士逻辑
考试系统构造出接口字符串后，可按以下方式调用图形博士
void __fastcall CallDrGraph(AnsiString interfaceString) {
if(IsDrGraphLogic(interfaceString))
{
char exeFileName[MAX_PATH];
FindExecutable( "C:\1.sch", NULL, exeFileName);
if (!FileExists(exeFileName))
return;
ShellExecute(NULL, "Open", exeFileName, interfaceString.c_str(), NULL, SW_SHOW);
}
}
参数说明
见前述说明
字符串接口为一个字符串，其结构为两部分，即文件名 参数，文法表示为
FileName.sch[ paramName=paramValue]*
*表示包含[]中部分零个或多个
[]中部分表示参数，格式为参数名=参数值
文件名，后缀固定为.sch
文件名为Windows合法文件名称，可包含路径
paramName与paramValue均为字母与/或数字组合，本节就本参数进行说明。调用方式见前述说明，本节仅列出参数内容，即ShellExecute(NULL, "Open", exeFileName, interfaceString.c_str(), NULL, SW_SHOW)语句中的interfaceString的内容，[]中的内容表示在本段说明中不关注的内容
文件名
文件名即FileName.sch，即字符串接口中第一个空格前的内容。DrGraph软件将打开该文件，即，只要DrGraph收到传入参数，则将会打开该文件，用户需要确保该文件存在。
如，用户调用时传入interfaceString为：
D:WorkQianTechInstallScriptResourcesGeneralExample红石.sch [….]
则运行后，DrGraph软件将打开该图形文件
打开指定脚本
用户可以通过以下参数要求图形博士软件打开图形后，调用指定名称的脚本并运行之
ScriptName=abcd
注意：此处的流程必须存在，否则将没有动作，并提示出错。
如，用户调用时传入interfaceString分别为：
D:WorkQianTechInstallScriptResourcesGeneralExample红石.sch scriptName=未命名流程!
运行过程一个截图界面为：
指定屏幕
用户可以通过以下参数指定待显示的屏幕：
destMonitors=1/2/3/1,2/2,3/1,2,3…
若用户参数未指定屏幕，则图形博士软件将以上次退出的尺寸位置进行显示。
其中，序号表示监视器在Windows桌面中的显示序号，可通过显示属性查看各监视器的序号值。
可以指定多个连续的监视器，则DrGraph将显示在该相应的多个屏幕上。
如，以下三张图片表示用户调用时传入interfaceString为：
D:WorkQianTechInstallScriptResourcesGeneralExample红石.sch destMonitors=1,2 [….]
D:WorkQianTechInstallScriptResourcesGeneralExample红石.sch destMonitors=1 [….]
D:WorkQianTechInstallScriptResourcesGeneralExample红石.sch destMonitors=2 [….]
其运行结果分别为：
全屏显示
用户可以通过以下参数指定是否以全屏方式显示界面
FullScreenFlag=true/false，若不指定，缺省将以非全屏方式显示
如，用户调用时传入interfaceString为：
D:WorkQianTechInstallScriptResourcesGeneralExample红石.sch destMonitors=1 FullScreenFlag=true [….]
D:WorkQianTechInstallScriptResourcesGeneralExample红石.sch destMonitors=2 FullScreenFlag=true [….]
D:WorkQianTechInstallScriptResourcesGeneralExample红石.sch destMonitors=1,2 FullScreenFlag=true [….]
显示结果分别为：
随机出题
用户可以通过以下参数要求图形博士软件打开图形(必须为流程图)后，调用指定名称的脚本进行随机出题：
blankNumber=n1 faultNumber=n2 moveNumber=n3
如，用户调用时传入interfaceString分别为：
F:.sch destMonitors=1 blankNumber=5
原始正确流程图为
合并显示
AttachFile=A.sch
A.sch为待合并显示的文件名称
