Share via

Data Tab, Pane Customization Dialog Box

  • Article

The Data tab contains the data that Web Page, HTML, and XML panes are based on.

  • Source
    Specifies the data source type for the pane. The five data source types are explained in the following table.

    Data source type

    Description

    Static Text

    Specifies that the data is well-formed XML. The default static text for XML Pane type is:

    <VFPData>
   <!-- CONTENT -->
</VFPData>

    You can type well-formed XML data instead of the comment. If the root pane has subsections, the default static text can remain because Visual FoxPro concatenates and places the XML data for the subsection here.

    If you need to wrap your subcontent in XML so that the content sections can be further transformed by the root before finally displaying on the pane, use the following syntax in the root content section.

    <VFPData>
   <!-- XMLCONTENT -->
</VFPData>

    This wraps each subcontent in XML CDATA sections with the content between <HTMLText> tags. For example, a pane with two subcontent records might look like the following example:

    <VFPData>
   <PaneContent id="uniqueid1">
   <PaneTitle>Content Title goes here</PaneTitle>
   <HTMLText><![CDATA[Transformed sub-content is placed here]]>
   </HTMLText>
   </PaneContent>
      <PaneContent id="uniqueid2">
   <PaneTitle>Content Title goes here</PaneTitle>
   <HTMLText><![CDATA[Transformed sub-content is placed here]]>
   </HTMLText>
   </PaneContent>
</VFPData>

    The root content section's transformation then determines whether to handle transforming this XML data or distribute an XML file in the files section.

    URL

    The data is contained in a file on the Internet. You can then push dynamic content to the pane from a file on the Internet.

    Script

    Specifies Visual FoxPro code to generate XML data. The code returns an XML string to be used as the data and accepts a parameter object to expose options set for the pane to the code.

    LPARAMTERS oContent

    The object exposes the following properties and methods:

    • CacheDir   The directory of the user's pane cache

    • ContentTitle   The name of the selected content section

    • Unique ID   The unique ID of the selected content section

    • TaskPaneID   The unique ID of the pane the content section belongs to

    • User   User data that is contained in the User field in the PaneContent table

    • GetOption(cOptionName , xDefaultValue)   Returns the value of the option specified. You can optionally specify the default value to be returned if the option is empty. All option values are returned as strings, unless xDefaultValue specifies a different data type.

    File

    Specifies a local file as the data source. This file is added to the list of associated files for the pane and copied to the pane's cache directory.

    Web Service

    Specifies that the data is obtained through an XML Web service on the Internet.

  • Modify
    Opens a window to modify the Visual FoxPro Code or XML data.

  • Edit Box
    Displays Visual FoxPro code or XML data.

  • Source of this content is from the Internet
    Specifies that a Visual FoxPro code script is downloading content from the Internet. This enables the Check for New Internet Content option for the pane.

  • File
    Specifies the name of the data file.

  • Ellipsis (...)
    Prompts you to select a data file.

  • WSDL URL
    Specifies the Web Services Description Language (WSDL) file URL for the XML Web service that provides the data for the pane. The WSDL describes the services offered by the server.

  • Method
    Specifies the XML Web service method to call. The appropriate parameters for the method must also be specified. To specify pane options, use the ## delimiters. For example, GetPaneXML(##daysold##) references the GetPaneXML XML Web service method and uses the DaysOld option for a pane as the parameter.

  • Service
    Specifies the service in the WSDL file that contains the operation specified in the Simple Object Access Protocol (SOAP) request. If this option is blank, the first service in the specified WSDL file is used when initializing the SoapClient object. (Optional)

  • Port
    Specifies the name of the port in the WSDL file that contains the operation specified in the SOAP request. If this option is blank, the first port in the specified service is used when initializing the SoapClient object. (Optional)

  • WSML
    Specifies the URL of the Web Services Meta Language (WSML) file. This is a required parameter only when using custom type mappers. For more information about custom type mappers, see the SOAP Toolkit documentation distributed with Visual FoxPro.

See Also

Reference

Pane Customization Dialog Box

Task Pane Manager