staxprocessactionfactory.java

Software Testing Automation Framework (STAF)的开发代码

"<!ELEMENT command             (#PCDATA)>\n" +
"<!ATTLIST command\n" +
"          mode        CDATA   \"'default'\"\n" +
"          shell       CDATA   #IMPLIED\n" +
">\n" +
"\n" +
"<!--\n" +
"     The parms element specifies any parameters that you wish to\n" +
"     pass to the command.\n" +
"     The value is evaluated via Python to a string.\n" +
"-->\n" +
"<!ELEMENT parms               (#PCDATA)>\n" +
"<!ATTLIST parms\n" +
"          if        CDATA     \"1\"\n" +
">\n" +
"\n" +
"<!--\n" +
"     The workload element specifies the name of the workload for\n" +
"     which this process is a member.  This may be useful in\n" +
"     conjunction with other process elements.\n" +
"     The value is evaluated via Python to a string.\n" +
"-->\n" +
"<!ELEMENT workload            (#PCDATA)>\n" +
"<!ATTLIST workload\n" +
"          if        CDATA     \"1\"\n" +
">\n" +
"\n" +
"<!--\n" +
"     The title element specifies the program title of the process.\n" +
"     Unless overridden by the process, the title will be the text\n" +
"     that is displayed on the title bar of the application.\n" +
"     The value is evaluated via Python to a string.\n" +
"-->\n" +
"<!ELEMENT title               (#PCDATA)>\n" +
"<!ATTLIST title\n" +
"          if        CDATA     \"1\"\n" +
">\n" +
"\n" +
"<!--\n" +
"     The workdir element specifies the directory from which the\n" +
"     command should be executed.  If you do not specify this\n" +
"     element, the command will be started from whatever directory\n" +
"     STAFProc is currently in.\n" +
"     The value is evaluated via Python to a string.\n" +
"-->\n" +
"<!ELEMENT workdir             (#PCDATA)>\n" +
"<!ATTLIST workdir\n" +
"          if        CDATA     \"1\"\n" +
">\n" +
"\n" +
"<!--\n" +
"     The vars (and var) elements specify STAF variables that go into the\n" +
"     process specific STAF variable pool.\n" +
"     The value must evaluate via Python to a string or a list of \n" +
"     strings. Multiple vars elements may be specified for a process.\n" +
"     The format for each variable is:\n" +
"       'varname=value'\n" +
"     So, a list containing 3 variables could look like:\n" +
"       ['var1=value1', 'var2=value2', 'var3=value3']\n" +
"     Specifying only one variable could look like either:\n" +
"       ['var1=value1']      or \n" +
"       'var1=value1'\n" +
"-->\n" +
"<!ELEMENT vars                (#PCDATA)>\n" +
"<!ATTLIST vars\n" +
"          if        CDATA     \"1\"\n" +
">\n" +
"\n" +
"<!ELEMENT var                 (#PCDATA)>\n" +
"<!ATTLIST var\n" +
"          if        CDATA     \"1\"\n" +
">\n" +
"\n" +
"<!--\n" +
"     The envs (and env) elements specify environment variables that will\n" +
"     be set for the process.  Environment variables may be mixed case,\n" +
"     however most programs assume environment variable names will\n" +
"     be uppercase, so, in most cases, ensure that your environment\n" +
"     variable names are uppercase.\n" +
"     The value must evaluate via Python to a string or a list of \n" +
"     strings. Multiple envs elements may be specified for a process.\n" +
"     The format for each variable is:\n" +
"       'varname=value'\n" +
"     So, a list containing 3 variables could look like:\n" +
"       ['ENV_VAR_1=value1', 'ENV_VAR_2=value2', 'ENV_VAR_3=value3']\n" +
"     Specifying only one variable could look like either:\n" +
"       ['ENV_VAR_1=value1']      or \n" +
"       'ENV_VAR_1=value1'\n" +
"-->\n" +
"<!ELEMENT envs                (#PCDATA)>\n" +
"<!ATTLIST envs\n" +
"          if        CDATA     \"1\"\n" +
">\n" +
"\n" +
"<!ELEMENT env                 (#PCDATA)>\n" +
"<!ATTLIST env\n" +
"          if        CDATA     \"1\"\n" +
">\n" +
"<!--\n" +
"     The useprocessvars element specifies that STAF variable\n" +
"     references should try to be resolved from the STAF variable\n" +
"     pool associated with the process being started first.\n" +
"     If the STAF variable is not found in this pool, the STAF\n" +
"     global variable pool should then be searched.\n" +
"-->\n" +
"<!ELEMENT useprocessvars      EMPTY>\n" +
"<!ATTLIST useprocessvars\n" +
"          if        CDATA     \"1\"\n" +
">\n" +
"\n" +
"<!--\n" +
"     The stopusing element allows you to specify the method by\n" +
"     which this process will be STOPed, if not overridden on the\n" +
"     STOP command.\n" +
"     The value is evaluated via Python to a string.\n" +
"-->\n" +
"<!ELEMENT stopusing           (#PCDATA)>\n" +
"<!ATTLIST stopusing\n" +
"          if        CDATA     \"1\"\n" +
">\n" +
"\n" +
"<!--\n" +
"     The console element allows you to specify if the process should\n" +
"     get a new console window or share the STAFProc console.\n" +
"\n" +
"     use    Must evaluate via Python to a string containing either:\n" +
"            - 'new' specifies that the process should get a new console\n" +
"              window.  This option only has effect on Windows systems.\n" +
"              This is the default for Windows systems.\n" +
"            - 'same' specifies that the process should share the\n" +
"              STAFProc console.  This option only has effect on Windows\n" +
"              systems.  This is the default for Unix systems.\n" +
"-->\n" +
"<!ELEMENT console             EMPTY>\n" +
"<!ATTLIST console\n" +
"          if        CDATA     \"1\"\n" +
"          use       CDATA     #REQUIRED\n" +
">\n" +
"\n" +
"<!--\n" +
"     The focus element allows you to specify the focus that is to be\n" +
"     given to any new windows opened when starting a process on a Windows\n" +
"     system.  The window(s) it effects depends on whether you are using\n" +
"     the 'default' or the 'shell' command mode:\n" +
"       - Default command mode (no SHELL option):  The focus specified is\n" +
"         given to any new windows opened by the command specified.\n" +
"       - Shell command mode:  The focus specified is given only to the\n" +
"         new shell command window opened, not to any windows opened by\n" +
"         the specified command.\n" +
"\n" +         
"     The focus element only has effect on Windows systems and requires\n" +
"     STAF V3.1.4 or later on the machine where the process is run.\n" +
"\n" +
"     mode   Must evaluate via Python to a string containing one of the\n" +
"            following values:\n" +
"            - 'background' specifies to display a window in the background\n" +
"              (e.g. not give it focus) in its most recent size and position.\n" +
"              This is the default.\n" +
"            - 'foreground' specifies to display a window in the foreground\n" +
"              (e.g. give it focus) in its most recent size and position.\n" +
"            - 'minimized' specifies to display a window as minimized.\n" +
"-->\n" +
"<!ELEMENT focus               EMPTY>\n" +
"<!ATTLIST focus\n" +
"          if        CDATA     \"1\"\n" +
"          mode      CDATA     #REQUIRED\n" +
">\n" +
"\n" +
"<!--\n" +
"     The username element specifies the username under which \n" +
"     the process should be started.\n" +
"     The value is evaluated via Python to a string.\n" +
"-->\n" +
"<!ELEMENT username            (#PCDATA)>\n" +
"<!ATTLIST username\n" +
"          if        CDATA     \"1\"\n" +
">\n" +
"\n" +
"<!--\n" +
"     The password element specifies the password with which to\n" +
"     authenticate the user specified with the username element.\n" +
"     The value is evaluated via Python to a string.\n" +
"-->\n" +
"<!ELEMENT password            (#PCDATA)>\n" +
"<!ATTLIST password\n" +
"          if        CDATA     \"1\"\n" +
">\n" +
"\n" +
"<!-- The disabledauth element specifies the action to take if a\n" +
"     username/password is specified but authentication has been disabled.\n" +
"\n" +
"     action  Must evaluate via Python to a string containing either:\n" +
"             - 'error' specifies that an error should be returned.\n" +
"             - 'ignore'  specifies that any username/password specified\n" +
"               is ignored if authentication is desabled.\n" +
"             This action overrides any default specified in the STAF\n" +
"             configuration file.\n" +
"-->\n" +
"<!ELEMENT disabledauth        EMPTY>\n" +
"<!ATTLIST disabledauth\n" +
"          if        CDATA     \"1\"\n" +
"          action    CDATA     #REQUIRED\n" +
">\n" +
"\n" +
"<!--\n" +
"     Specifies that a static handle should be created for this process.\n" +
"     The value is evaluated via Python to a string.  It will be the\n" +
"     registered name of the static handle.  Using this option will also\n" +
"     cause the environment variable STAF_STATIC_HANDLE to be set\n" +
"     appropriately for the process.\n" +
"-->\n" +
"<!ELEMENT statichandlename    (#PCDATA)>\n" +
"<!ATTLIST statichandlename\n" +
"          if        CDATA     \"1\"\n" +
">\n" +
"\n" +
"<!--\n" +
"     The stdin element specifies the name of the file from which\n" +
"     standard input will be read.  The value is evaluated via\n" +
"     Python to a string.\n" +
"-->\n" +
"<!ELEMENT stdin               (#PCDATA)>\n" +
"<!ATTLIST stdin\n" +
"          if        CDATA     \"1\"\n" +
">\n" +
"\n" +
"<!--\n" +
"     The stdout element specifies the name of the file to which\n" +
"     standard output will be redirected.\n" +
"     The mode and filename are evaluated via Python to a string.\n" +
"-->\n" +
"<!ELEMENT stdout              (#PCDATA)>\n" +
"<!--  mode  specifies what to do if the file already exists.\n" +
"            The value must evaluate via Python to one of the\n" +
"            following:\n" +
"            'replace' - specifies that the file will be replaced.\n" +
"            'append'  - specifies that the process' standard\n" +
"                        output will be appended to the file.\n" +
"-->\n" +
"<!ATTLIST stdout\n" +
"          if        CDATA     \"1\"\n" +
"          mode      CDATA     \"'replace'\"\n" +
">\n" +
"\n" +
"<!--\n" +
"     The stderr element specifies the file to which standard error will\n" +
"     be redirected. The mode and filename are evaluated via Python to a\n" +
"     string.\n" +
"-->\n" +
"<!ELEMENT stderr              (#PCDATA)>\n" +
"<!-- mode   specifies what to do if the file already exists or to\n" +
"            redirect standard error to the same file as standard output.\n" +
"            The value must evaluate via Python to one of the following:\n" +
"            'replace' - specifies that the file will be replaced.\n" +
"            'append'  - specifies that the process's standard error will\n" +
"                        be appended to the file.\n" +
"            'stdout'  - specifies to redirect standard error to the\n" +
"                        same file to which standard output is redirected.\n" +
"                        If a file name is specified, it is ignored.\n" +
"-->\n" +
"<!ATTLIST stderr\n" +
"          if        CDATA     \"1\"\n" +
"          mode      CDATA     \"'replace'\"\n" +
">\n" +
"\n" +
"<!--\n" +
"     The returnstdout element specifies to return in STAXResult\n" +
"     the contents of the file where standard output was redirected\n" +
"     when the process completes.\n" +
"-->\n" +
"<!ELEMENT returnstdout        EMPTY>\n" +
"<!ATTLIST returnstdout\n" +
"          if        CDATA     \"1\"\n" +
">\n" +
"\n" +
"<!--\n" +
"     The returnstderr element specifies to return in STAXResult\n" +
"     the contents of the file where standard error was redirected\n" +
"     when the process completes.\n" +
"-->\n" +
"<!ELEMENT returnstderr        EMPTY>\n" +
"<!ATTLIST returnstderr\n" +
"          if        CDATA     \"1\"\n" +
">\n" +
"\n" +
"<!--\n" +
"     The returnfiles (and returnfile) elements specify that the\n" +
"     contents of the specified file(s) should be returned in\n" +
"     STAXResult when the process completes.  The value must evaluate\n" +
"     via Python to a string or a list of strings.  Multiple returnfile(s)\n" +
"     elements may be specified for a process.\n" +
"-->\n" +
"<!ELEMENT returnfiles         (#PCDATA)>\n" +
"<!ATTLIST returnfiles\n" +
"          if        CDATA     \"1\"\n" +
">\n" +
"\n" +
"<!ELEMENT returnfile          (#PCDATA)>\n" +
"<!ATTLIST returnfile\n" +
"          if        CDATA     \"1\"\n" +
">\n" +
"\n" +
"<!--\n" +
"     The process-action element specifies a task to be executed\n" +
"     when a process has started.\n" +
"-->\n" +
"<!ELEMENT process-action      (%task;)>\n" +
"<!ATTLIST process-action\n" +
"          if        CDATA     \"1\"\n" +
">\n" +
"<!--\n" +
"     The other element specifies any other STAF parameters that\n" +
"     may arise in the future.  It is used to pass additional data\n" +
"     to the STAF PROCESS START request.\n" +
"     The value is evaluated via Python to a string.\n" +
"-->\n" +
"<!ELEMENT other               (#PCDATA)>\n" +
"<!ATTLIST other\n" +
"          if        CDATA     \"1\"\n" +
">\n";

} // end Class