Practical Internet Web Designer 86/PIWD86.iso/pc/contents/dreamweaver/software/dwmx2004.exe/Disk1/data1.cab/Configuration_En/Commands/ServerBeh-ASPNET-SimpRS.js

JavaScript | 2003-09-05 | 16.2 KB | 620 lines

// Copyright 2002, 2003 Macromedia, Inc. All rights reserved.

// *************** GLOBALS VARS *****************

var helpDoc = MM.HELP_sbASPNetSimpleRecordset;

var SB_FILENAME = dwscripts.getSBFileName();
var RECORDSET_SBOBJ;  // SBRecordset argument to the command.
var CMD_FILENAME_ADV; // Command filename for the advanced recordset dialog.
var SQL_PARAM;          // Sql parameter info.

var _RecordsetName = new TextField(SB_FILENAME, "RecordsetName");
var _ConnectionName = new ConnectionMenu(SB_FILENAME, "ConnectionName");
var _TableName = new ConnectionTableMenu(SB_FILENAME, "TableName");
var _ColumnType = new RadioGroup(SB_FILENAME, "ColumnType");
var _ColumnList = new ConnectionColumnMenu(SB_FILENAME, "ColumnList", "", false);
var _FilterColumn = new ConnectionColumnMenu(SB_FILENAME, "FilterColumn", "", true);
var _FilterOperator = new ListMenu(SB_FILENAME, "FilterOperator");
var _FilterParameter = new ListMenu(SB_FILENAME, "FilterParameter");
var _FilterParameterValue = new TextField(SB_FILENAME, "FilterParameterValue");
var _SortColumn = new ConnectionColumnMenu(SB_FILENAME, "SortColumn", "", true);
var _SortDirection = new ListMenu(SB_FILENAME, "SortDirection");
var _FailureURL = new TextField(SB_FILENAME, "FailureURL");
var _DebugInfo = new CheckBox(SB_FILENAME, "Debug");

// ******************* API **********************

//--------------------------------------------------------------------
// FUNCTION:
//   commandButtons
//
// DESCRIPTION:
//   Returns the list of buttons which should appear on the right hand
//   side of the dialog
//
// ARGUMENTS:
//   none
//
// RETURNS:
//   Array - pairs of button name and function call
//--------------------------------------------------------------------

function commandButtons()
{
  return new Array(MM.BTN_OK,       "clickedOK()",
                   MM.BTN_Cancel,   "clickedCancel()",
                   MM.BTN_Test,     "clickedTest()",
                   MM.BTN_Advanced, "clickedAdvanced()",
                   MM.BTN_Help,     "displayHelp()");
}

//--------------------------------------------------------------------
// FUNCTION:
//   clickedOK
//
// DESCRIPTION:
//   This function is called when the user clicks OK
//
// ARGUMENTS:
//   none
//
// RETURNS:
//   nothing
//--------------------------------------------------------------------

function clickedOK()
{
  // Make sure at least one column is selected

  if (_ColumnType.getValue() == "some")
  {
    if (_ColumnList.getValues().length == 0)
    {
      alert(MM.MSG_SelectColumns);
      return;
    }
  }

  updateSBRecordsetObject();
  var fileName = window.document.URL;
  recordsetDialog.onClickOK(window, RECORDSET_SBOBJ, fileName.substring(fileName.lastIndexOf('/')+1));
}

//--------------------------------------------------------------------
// FUNCTION:
//   clickedCancel
//
// DESCRIPTION:
//   This function is called when CANCEL is clicked
//
// ARGUMENTS:
//   none
//
// RETURNS:
//   nothing
//--------------------------------------------------------------------

function clickedCancel()
{
  recordsetDialog.onClickCancel(window);
}

//--------------------------------------------------------------------
// FUNCTION:
//   clickedTest
//
// DESCRIPTION:
//   This function is called when the user clicks the TEST button
//
// ARGUMENTS:
//   none
//
// RETURNS:
//   nothing
//--------------------------------------------------------------------

function clickedTest()
{
  updateSBRecordsetObject();
  recordsetDialog.displayTestDialog(RECORDSET_SBOBJ);
}

//--------------------------------------------------------------------
// FUNCTION:
//   clickedAdvanced
//
// DESCRIPTION:
//   This function is called when the user clicks the ADVANCED button
//
// ARGUMENTS:
//   none
//
// RETURNS:
//   nothing
//--------------------------------------------------------------------

function clickedAdvanced()
{
  updateSBRecordsetObject();
  recordsetDialog.onClickSwitchUI(window,
                                  recordsetDialog.UI_ACTION_SWITCH_ADV,
                                  RECORDSET_SBOBJ,
                                  CMD_FILENAME_ADV);
}

//--------------------------------------------------------------------
// FUNCTION:
//   displayHelp
//
// DESCRIPTION:
//   This function is called when the user clicks the HELP button
//
// ARGUMENTS:
//   none
//
// RETURNS:
//   nothing
//--------------------------------------------------------------------

function displayHelp()
{
  dwscripts.displayDWHelp(helpDoc);
}

// ***************** LOCAL FUNCTIONS  ******************

//--------------------------------------------------------------------
// FUNCTION:
//   initializeUI
//
// DESCRIPTION:
//   This function is called in the onLoad event.  It is responsible
//   for initializing the UI.  If we are inserting a recordset, this
//   is a matter of populating the connection drop down.
//
//   If we are modifying a recordset, this is a matter of inspecting
//   the recordset tag and setting all the form elements.
//
// ARGUMENTS:
//   none
//
// RETURNS:
//   nothing
//--------------------------------------------------------------------

function initializeUI()
{
  var sqlObject = null;
  var args = dwscripts.getCommandArguments();

  RECORDSET_SBOBJ = args[0];
  CMD_FILENAME_ADV = args[1];

  var paramTypes = dwscripts.getParameterTypeArray(false);

  RECORDSET_SBOBJ.transformURLs(false);

  // Get the UI elements

  _RecordsetName.initializeUI();
  _ConnectionName.initializeUI();
  _TableName.initializeUI();
  _ColumnType.initializeUI();
  _ColumnList.initializeUI();
  _FilterColumn.initializeUI();
  _FilterOperator.initializeUI();
  _FilterParameter.initializeUI(paramTypes, paramTypes);
  _FilterParameterValue.initializeUI();
  _SortColumn.initializeUI();
  _SortDirection.initializeUI();
  _FailureURL.initializeUI();
  _DebugInfo.initializeUI();

  var rsName = RECORDSET_SBOBJ.getRecordsetName();

  if (!rsName)
  {
    rsName = RECORDSET_SBOBJ.getUniqueRecordsetName();
  }

  _RecordsetName.setValue(rsName);

  var connectionName = RECORDSET_SBOBJ.getConnectionName();

  if (connectionName)
  {
    _ConnectionName.pickValue(RECORDSET_SBOBJ.getConnectionName());
  }

  _FailureURL.setValue(RECORDSET_SBOBJ.getFailureURL());
  _DebugInfo.setCheckedState(RECORDSET_SBOBJ.getDebug());

  updateUI("Debug");

  var sqlParams = new Array();
  var sqlString = RECORDSET_SBOBJ.getDatabaseCall(sqlParams);

  SQL_PARAM = (sqlParams[0]) ? sqlParams[0] : (new Object());

  if (sqlString)
  {
    sqlObject = new SQLStatement(sqlString);
  }
  else
  {
    sqlObject = new SQLStatement("");
  }

  if (sqlObject.getType() == SQLStatement.STMT_TYPE_SELECT)
  {
    // select the correct table

    var tableNames = sqlObject.getTableNames();

    if (tableNames && tableNames.length > 0)
    {
      _TableName.pickValue(tableNames[0]);
    }

    // selet the correct columns

      var columnNames = sqlObject.getColumnNames();

      if (columnNames.length == 1 && columnNames[0] == "*")
    {
      _ColumnType.pickValue("all");
    }
    else
    {
      _ColumnType.pickValue("some");
      _ColumnList.setDisabled(false);
      _ColumnList.pickValues(columnNames);
    }

    // Select the correct filter column

    var filterInfo = RECORDSET_SBOBJ.getSimpleWhereInfo(sqlObject, sqlParams);

    if (filterInfo != null)
    {
      if (filterInfo.lval)
      {
        _FilterColumn.pickValue(filterInfo.lval);
      }

      if (filterInfo.operator)
      {
        _FilterOperator.pickValue(filterInfo.operator);
      }

      if (filterInfo.rval)
      {
        var param = sqlParams[0];
        var paramInfo = dwscripts.getParameterTypeFromCode(param.runtime);
        if (paramInfo != null)
        {
          _FilterParameter.pickValue(paramInfo.varType);
          _FilterParameterValue.setValue(paramInfo.varNameOrValue);
        }
      }
    }
    else
    {
      updateUI("FilterColumn", "onChange");
    }

    var orderByInfo = RECORDSET_SBOBJ.getSimpleOrderByInfo(sqlObject);

    if (orderByInfo != null)
    {
      if (orderByInfo.column)
      {
        _SortColumn.pickValue(orderByInfo.column);
      }

      if (orderByInfo.direction)
      {
        _SortDirection.pickValue(orderByInfo.direction);
      }
    }
    else
    {
      updateUI("SortColumn", "onChange");
    }
  }
  else
  {
    updateUI("ColumnType", "onChange");
    updateUI("FilterColumn", "onChange");
    updateUI("SortColumn", "onChange");
  }

  elts = document.forms[0].elements;
  if (elts && elts.length)
  {
    elts[0].focus();
    elts[0].select();
  }
}

//--------------------------------------------------------------------
// FUNCTION:
//   updateUI
//
// DESCRIPTION:
//   This function is called by the UI controls to handle UI updates
//
// ARGUMENTS:
//   control - string - the name of the control sending the event
//   event - string - the event which is being sent
//
// RETURNS:
//   nothing
//--------------------------------------------------------------------

function updateUI(control, event)
{
  if (control == "RecordsetName")
  {
  }
  else if (control == "Define")
  {
    _ConnectionName.launchConnectionDialog();
  }
  else if (control == "ConnectionName")
  {
    _TableName.updateUI(_ConnectionName, event);
  }
  else if (control == "TableName")
  {
    _ColumnList.updateUI(_TableName, event);
    _FilterColumn.updateUI(_TableName, event);
    _SortColumn.updateUI(_TableName, event);
    _ColumnType.pickValue("all");
  }
  else if (control == "ColumnType")
  {
    var value = _ColumnType.getValue();
    if (value == "all")
    {
      _ColumnList.setDisabled(true, true);
    }
    else
    {
      _ColumnList.setDisabled(false);
    }
  }
  else if (control == "FilterColumn")
  {
    if (_FilterColumn.getValue() == "")
    {
      _FilterOperator.setDisabled(true);
      _FilterParameter.setDisabled(true);
      _FilterParameterValue.setValue("");
      _FilterParameterValue.setDisabled(true);
    }
    else
    {
      _FilterOperator.setDisabled(false);
      _FilterParameter.setDisabled(false);
      _FilterParameterValue.setDisabled(false);
      _FilterParameterValue.setValue(_FilterColumn.getValue());
    }
  }
  else if (control == "SortColumn")
  {
    if (_SortColumn.getValue() == "")
    {
      _SortDirection.setDisabled(true);
    }
    else
    {
      _SortDirection.setDisabled(false);
    }
  }
  else if (control == "FailureURL")
  {
    var theFailureURL = dw.browseForFileURL("select", MM.LABEL_FileRedirect, 0, 0);

    if (theFailureURL.length > 0)
    {
      _FailureURL.setValue(theFailureURL);
    }
  }
  else if (control == "Debug")
  {
    _FailureURL.setDisabled(_DebugInfo.getCheckedState());
  }
}

//--------------------------------------------------------------------
// FUNCTION:
//   updateSBRecordsetObject
//
// DESCRIPTION:
//   Collects information from the UI and sets the SBRecordset object
//
// ARGUMENTS:
//   none
//
// RETURNS:
//   boolean - true if successful, false otherwise
//--------------------------------------------------------------------

function updateSBRecordsetObject()
{
  var connName = _ConnectionName.getValue();
  var sqlObject = new SQLStatement("");
  var colType = _ColumnType.getValue();

  RECORDSET_SBOBJ.setRecordsetName(_RecordsetName.getValue());
  RECORDSET_SBOBJ.setConnectionName(connName);

  sqlObject.addFrom(_TableName.getValue());

  if (colType != "all")
  {
    var columnNames = _ColumnList.getValues();

    for (var i=0; i < columnNames.length; i++)
    {
      sqlObject.addSelect(_TableName.getValue(), columnNames[i], true); // dont include table name
    }
  }

  var sqlParams = new Array();

  if (_FilterColumn.getValue() != "")
  {
    var databaseType = MMDB.getDatabaseType(connName);
    var paramType = _FilterParameter.getValue();
    var operatorType = _FilterOperator.getValue();
    var filterValue = _FilterParameterValue.getValue();
    var defaultVal = "";
    var submitAs = dwscripts.getDBColumnTypeAsString(_FilterColumn.getType(), databaseType);
    var runtime = dwscripts.getParameterCodeFromType(paramType,
                                                        filterValue,
                                                        defaultVal,
                                                        submitAs);

    // If we're filtering using begins with, ends with or contains,
    // then we need to alter the runtime value to include the %(s)

    switch (operatorType)
    {
      case "begins with":
        runtime = "(" + runtime + ") + \"%\"";
        break;
      case "ends with":
        runtime = "\"%\" + (" + runtime + ")";
        break;
      case "contains":
        runtime = "\"%\" + (" + runtime + ") + \"%\"";
        break;
    }

    var paramName = _FilterColumn.getValue();

    // If param name doesn't start with @, add one

    if (paramName[0] != '@')
    {
      paramName = "@" + paramName;
    }

    // If the database type is OleDb, then use "?" as the parameter
    // in the where clause, otherwise, use a named parameter.

    var whereParam = (databaseType.toLowerCase() == "oledb") ? "?" : paramName;

    RECORDSET_SBOBJ.addSimpleWhere(sqlObject, _FilterColumn.getValue(), operatorType, whereParam, true);

    var sqlParam = new Object();

    sqlParam.name = paramName;
    sqlParam.runtime = runtime;
    sqlParam.type = submitAs;
      sqlParam.size = (SQL_PARAM.size) ? SQL_PARAM.size : "";
      sqlParam.direction = (SQL_PARAM.direction) ? SQL_PARAM.direction : "";

    sqlParams.push(sqlParam);
  }

  if (_SortColumn.getValue() != "")
  {
    sqlObject.addOrderBy(_TableName.getValue(), _SortColumn.getValue(), _SortDirection.getValue(), true); // dont include table name
  }

  RECORDSET_SBOBJ.setDatabaseCall(sqlObject.getStatement(), sqlParams);
  RECORDSET_SBOBJ.setFailureURL(_FailureURL.getValue());
  RECORDSET_SBOBJ.transformURLs(true);
  RECORDSET_SBOBJ.setDebug(_DebugInfo.getCheckedState());
}

//--------------------------------------------------------------------
// FUNCTION:
//   canDisplayRecordset
//
// DESCRIPTION:
//   Returns true if the given recordset can be displayed in this
//   recordset dialog. Called by the recordsetDialog to determine which
//   dialog to display.
//
// ARGUMENTS:
//   sbRecordset - SBRecordset. the recordset to check.
//
// RETURNS:
//   boolean - true if can display the recordset.
//--------------------------------------------------------------------

function canDisplayRecordset(sbRecordset)
{
 var retVal = false;

  if (!sbRecordset)
  {
    retVal = true;
  }

  if (!retVal)
  {
    var sqlParams = new Array();
    var sqlString = sbRecordset.getDatabaseCall(sqlParams);

    if (!sqlString || (sqlString == ""))
    {
      retVal = true;
      return retVal;
    }

    var sqlObject = new SQLStatement(sqlString);

    // check for select statement
    if (sqlObject.getType() == SQLStatement.STMT_TYPE_SELECT)
    {
      // check that only one table is specified
      if (sqlObject.getTableNames().length == 1)
      {
        // check that the columns are simple values
        var columns = sqlObject.getColumnNames();
        var bSimpleNames = true;
        for (var i=0; i < columns.length; i++)
        {
          if (!sbRecordset.isSimpleColumnName(columns[i]))
          {
            bSimpleNames = false;
            break;
          }
        }

        if (bSimpleNames)
        {
          // check for no filter column, or filter is single param
          var whereInfo = sbRecordset.getSimpleWhereInfo(sqlObject, sqlParams);

          if ((sqlObject.getWhere() == "") ||
               ((whereInfo != null) &&
                 (!whereInfo.rval ||
                 (sqlParams.length == 1))))
          {
            // check for a single order by column
            var orderByInfo = sbRecordset.getSimpleOrderByInfo(sqlObject);

            if (orderByInfo != null)
            {
              // now check that the other clauses are empty
              if (!sqlObject.getHaving() && !sqlObject.getGroupBy())
              {
                retVal = true;
              }
            }
          }
        }
      }
    }
  }

  return retVal;
}