DBWEB: How to Create a Custom Update DBX (154867)


The information in this article applies to:

  • Microsoft dbWeb 1.0
  • Microsoft dbWeb 1.1
This article was previously published under Q154867

SUMMARY

Microsoft dbWeb provides a default form that you can use as your Update form. However, with a text editor you can create a custom HTML document to use as your Update form. You can design the look of the form so that it resembles other HTML documents on your web site.

MORE INFORMATION

The following example uses the Employees table in the sample database Nwind.mdb and the dbnwind data source. Before you begin the example, make sure you can query the Employees sample schema in the dbnwind data source of the dbWeb administrator.

CAUTION: Following the steps in this example will modify the sample database Nwind.mdb and the Employees sample schema. You may want to back up the Nwind.mdb and Dbweb.mdb files, or use a copy of them for this example.

Creating a Custom Update Form

NOTE: The HTML example below uses /scripts as the cgi files folder. That is the default folder for Internet Information Server (IIS). If you use a different web server, the folder may be different. Change the path as appropriate for your web server. Also, if you are using dbWeb 1.0, replace dbwebc.dll with $dbwebc.exe in the following example.

  1. Using Notepad or your favorite HTML editor, type the following text into a new file: 
          <HTML>
      <HEAD><TITLE>Update Employee Information</TITLE></HEAD>
      <BR>

      <BODY>
      <H2 ALIGN=CENTER>Update Employee Information</H2>
      <BR>

      <FORM ACTION="/scripts/dbweb/dbwebc.dll/Employees?update"
      METHOD="POST">
      <INPUT TYPE="hidden" NAME="11,Employees,Employee ID"
      VALUE="\tobj\tEmployees\tcol\tEmployee ID\t">

      <TABLE>
      <TR><TH>Last Name:</TH><TD><INPUT TYPE="text" SIZE=20 MAXLENGTH=256
      NAME="1,Employees,Last Name" VALUE="\tobj\tEmployees\tcol\tLast
      Name\t"></TD></TR>
      <TR><TH>First Name:</TH><TD><INPUT TYPE="text" SIZE=20 MAXLENGTH=256
      NAME="1,Employees,First Name" VALUE="\tobj\tEmployees\tcol\tFirst
      Name\t"></TD></TR>
      <TR><TH>Title:</TH><TD><INPUT TYPE="text" SIZE=20 MAXLENGTH=256
      NAME="1,Employees,Title"
      VALUE="\tobj\tEmployees\tcol\tTitle\t"></TD></TR>
      <TR><TH>Address:</TH><TD><INPUT TYPE="text" SIZE=20 MAXLENGTH=256
      NAME="1,Employees,Address"
      VALUE="\tobj\tEmployees\tcol\tAddress\t"></TD></TR>
      <TR><TH>City:</TH><TD><INPUT TYPE="text" SIZE=20 MAXLENGTH=256
      NAME="1,Employees,City"
      VALUE="\tobj\tEmployees\tcol\tCity\t"></TD></TR>
      <TR><TH>Region:</TH><TD><INPUT TYPE="text" SIZE=20 MAXLENGTH=256
      NAME="1,Employees,Region"
      VALUE="\tobj\tEmployees\tcol\tRegion\t"></TD></TR>
      <TR><TH>Postal Code:</TH><TD><INPUT TYPE="text" SIZE=20 MAXLENGTH=256
      NAME="1,Employees,Postal Code" VALUE="\tobj\tEmployees\tcol\tPostal
      Code\t"></TD></TR>
      <TR><TH>Country:</TH><TD><INPUT TYPE="text" SIZE=20 MAXLENGTH=256
      NAME="1,Employees,Country"
      VALUE="\tobj\tEmployees\tcol\tCountry\t"></TD></TR>
      <TR><TH>Home Phone:</TH><TD><INPUT TYPE="text" SIZE=20 MAXLENGTH=256
      NAME="1,Employees,Home Phone" VALUE="\tobj\tEmployees\tcol\tHome
      Phone\t"></TD></TR>
      <TR><TH><INPUT TYPE=submit VALUE="Submit Update"></TR></TH>
      </TABLE>

      </FORM>
      </BODY>
      </HTML>
  2. Save the file as Upempinf.htm in the dbweb subfolder of the HTML document root folder (\inetsrv\wwwroot\dbweb, if IIS is your web server).

Modifying the Schema

  1. Start the dbWeb Administrator.
  2. Double-click the dbnwind data source.
  3. Double-click the Employees schema.
  4. Click the Schema tab, and then click to select the Update check box.
  5. Click the QBE tab.
  6. In the "Data columns in selected tables" box, select Employee ID, and then click Add.
  7. Click the Ins/Upd/Del tab.
  8. In the "Data columns in selected tables" box, select each of the following fields, and then click Add: 
           Employee ID
       Last Name
       First Name
       Title
       Address
       City
       Region
       Postal Code
       Country
       Home Phone
  9. In the "Update data columns" box, select Employee ID, and then click Properties.
  10. Under Column Properties, set the Key property to Key(non updateable).
  11. Click the DBX tab.
  12. In the "Single record result output custom format file" box, click Browse to find the Upempinf.htm file (in the \inetsrv\wwwroot\dbweb folder, if IIS is your server).
  13. Click Apply.

View the custom update form:

  1. Open your favorite browser, and type the URL path to the Employees schema using the getxqbe method. For dbWeb 1.1, the default path is /scripts/dbweb/dbwebc.dll/Employees?getxqbe. For dbWeb version 1.0, the default path is /scripts/dbweb/$dbwebc.exe/Employees?getxqbe.
  2. On the Employees QBE page, type 1 in the Employee ID field.
  3. Click the Submit Query button to run the query and invoke your custom Update form.
  4. Change some information on the form, and then click Submit Update. You will receive a success or failure message.
NOTE: If Submit Query returns more than one record, you will not see the custom Update form you created. In this example, you must limit the query results to one record. However, it is possible to use this form for multiple record queries. Just set Upempinf.htm as the "Multi record result output custom format" file on the DBX tab of the Employees schema.
Modification Type:MajorLast Reviewed:9/26/2003
Keywords:kbhowto kbusage KB154867
©2003 Microsoft Corporation. All rights reserved.