Date Time Strings in URL Parameters
Top |
You can create a URL that will pass in specific date and time values as symbol values. For example, a URL can be set up to pass values to a Time chart so that when the display is accessed, the data associated with a specific start and end time is accessed and plotted on the chart. Two steps are required for this scenario:
Create symbols for the date time values. For example, if you want to load start and end times for a Time chart, you must enable the chart's Parameter symbols (both StartDateTime and EndDateTime). You will use the symbol names in the URL. For detailed information on configuring symbols, see To configure display symbols.
Create the URL and include the symbols with the specific date time values you want passed in.
You must use the same date and time formats as those that are set for the display, unless you are using the DATETIMEFORMAT parameter in the URL. See DATETIMEFORMAT Parameter for more information on using this parameter.
NOTE: If the date/time format you use
in the URL is not the same as the date/time format used by Proficy
Portal, you will see the error indicator 
in the upper left on your display.
Additionally, the symbols that are used for the date/time
parameters will fail to be resolved, unless the display is
configured to load default symbols that resolve the parameters. If
there are unresolved symbols, they are also reported as errors on
the error page (error indicator).
The date and time must be enclosed between <! and !>
Example: <!12/04/2004 14:30:00!>
If you have to specify the time zone, you must use the DATETIMEFORMAT parameter; otherwise, the display's default time zone is used.
The following example URL loads the TimeChart display that will pass a specific start and end time to a chart's start and end time parameters. ChartStartTime and ChartEndTime are the chart's start and end time parameter symbols.
http://localhost/ProficyPortal/Default.htm?DISPLAY="Users\jsmith\displays\TimeChart"
&ChartStartTime=<!12-06-2004
14:04:00!>&ChartEndTime=<!12-06-2004 14:10:00!>