CreateGraph Functions
The
CreateGraph and
CreateGraphSession functions generate a specified graph using the data in a specified System file. These two functions differ only in respect to parameters for login. For more information, see
Login Parameters.
When either of these functions run, the license for the product module specified in the graph is checked out. This means that to generate a FRACAS graph, a Windchill FRACAS license must be available.
The resulting graph is stored in the Temp folder on the web server in JPG format. Graphs generated by these functions are cleaned up in 24 hours.
Syntax
The following is the syntax for an HTTP request:
POST /WindchillRiskandReliability12.0/DataEngine.asmx/CreateGraph HTTP/1.1
Host: HostName
Content-Type: application/x-www-form-urlencoded
Content-Length: length
UserName=string&Password=string&GroupName=string&ProjectName=string
&SystemName=string&GraphTemplateName=string&ExtraParameter=string
&FilterParameters=string
Parameters
In addition to login parameters, both the CreateGraph and CreateGraphSession functions use these parameters:
• ProjectName—The name of the Windchill Risk and Reliability Project. This value is case-sensitive.
• SystemName—The name of the System file. This value is case-sensitive.
• GraphTemplateName—The name of the Graph Template file from which to generate the graph. Any file in the Common Library must be prefixed with (Common).
• ExtraParameter—For an FMEA or FTA graph, the identifier of the item that you want to graph. For an FMEA graph, this is the identifier of the FMEA to graph. For an FTA graph, this is the identifier for the gate or event to graph. This parameter is not required for a FRACAS graph.
• Width—The width of the desired graph in pixels. This parameter is required. If the specified width is less than or equal to 0, a default value of 800 pixels is used.
• Height—The height of the desired graph in pixels. This parameter is required. If the specified height is less than or equal to 0, a default value of 600 pixels is used.
• FilterParameters—The specific values that you want to use for the parameters required by an applied filter. If values are not specified, default values are used. To specify values, you must know the number and order of the required parameters. When passing values for multiple parameters, two colons (::) must separate each text string. You can see the required parameters in the Filter file in which the filter is stored. If passed values do not match or are unnecessary, they are ignored.
The following is an example of an HTTP POST request:
POST /WindchillRiskandReliability12.0/DataEngine.asmx/CreateGraph HTTP/1.1
Host: vm-test
Content-Type: application/x-www-form-urlencoded
Content-Length: length
UserName=Bill&Password=passwd&GroupName=Manager&ProjectName=Tablet PC &SystemName=Tablet PC&GraphTemplateName=(Common) FMEA Top 10 RPN &ExtraParameter=System Functional FMEA&Width=800&Height=600
Returns
If the user is authenticated, the required values are found, and Width and Height are specified, the name of the generated graph is returned.
If the call fails, the AdditionalData tag provides the reason for the failure.
FileAccessCookie is returned in result response while generating output that needs to be downloaded.