Services Edit Page Routines

services\include\edit_handlers.asp

The following customer and partner services utility routines are related to handling edit page processing, and are defined in this file:

• DeleteAllActionHandler
  This sub checks the user action on the DeleteAll message box page, and redirects to the profile list page with the appropriate parameters.
• DeSelectAllActionHandler
  This sub redirects the user in a "Select All" action.
• GetStatusFieldAndID
  This sub updates the status message for the "Save" action.
• htmAddActionHandler
  This function renders a blank edit page for any profile, and serves as a wrapper function to the htmRenderBlankEditPage function.
• htmChangePasswordActionHandler
  This function is called by EDIT-type pages for changing the user_security_password property. It is called before the execution is passed to the change_password.asp page.
• htmCloseActionHandler
  This function provides rendering for the "Close" action handler.
• htmCopyActionHandler
  This function provides rendering for the "Copy" action handler.
• htmDeleteActionHandler
  This function provides rendering for the "Delete" action handler.
• htmEditAction
  This function provides the "Edit" action handler. It supports single-edit, multi-edit, and SelectAll+Edit scenarios. Business logic to prepare for this display is in the PrepareEditAction subroutine.
• htmEditAllProfiles
  This function serves as a wrapper function for the htmRenderEditPage function, and renders the edit page contents.
• htmInsertProfile
  This function renders the edit page by calling the htmRenderEditPage function if the profile has been successfully inserted during the profile save operation that calls this function; otherwise, it renders the edit page by calling the htmRenderBlankEditPage function.
• htmSaveActionHandler
  This function checks if the user is saving profiles returned by the search criteria in the corresponding list page, then calls an appropriate handler to handle the following cases: SELECTALL_ACTION; ADD_ACTION; COPY_ACTION; EDIT_ACTION.
• htmSaveAllActionHandler
  This function renders the "Save All" action output.
• htmSaveProfiles
  This function renders the "Save Profiles" action output.
• htmSelectActionHandlerForEdit
  This function renders the "Select" action.
• htmSelectedActionHandlerForEdit
  This function renders the "Selected" action.
• PrepareAddAction
  This sub initializes its five parameters in preparation for adding a user in Partner Services.
• PrepareCloseAction
  This sub prepares for the call to the function htmCloseActionHandler by initializing the values of all of the passed parameters other than the first two.
• PrepareCopyAction
  This sub prepares for the call to the function htmCopyActionHandler by initializing the values of all of the passed parameters other than the first two.
• PrepareDeleteAction
  This sub prepares for the call to the function htmDeleteActionHandler by initializing the values of the last two parameters.
• PrepareDeleteAllAction
  This sub prepares for the call to the sub DeleteAllActionHandler by initializing the value of its one parameter.
• PrepareDeselectAllAction
  This sub prepares for the call to the sub DeSelectAllActionHandler by initializing the value of its one parameter.
• PrepareEditAction
  This sub prepares for the call to the function htmEditAction by initializing the values of the last two parameters.
• PrepareEditAllAction
  This sub initializes the parameters passed to it.
• PrepareInsertProfile
  This sub prepares for the call to the function htmInsertProfile by initializing the values of all parameters other than sSubAction and sProfileIDs.
• PrepareSaveAction
  This sub currently performs no processing at all, but is called before calls to the function htmSaveActionHandler. If you modify the latter function and need to perform special preparation before calling it, consider adding the preparation code to this function.
• PrepareSaveAllAction
  This sub prepares for the call to the function htmSaveAllActionHandler by initializing the values of the parameters passed to it. When the profile changes are found to be valid, the sub SaveAllSelectedProfiles is called to save the changes.
• PrepareSaveProfiles
  This sub prepares for the call to the function htmSaveProfiles by initializing the values of all parameters passed to it other than the first three.
• PrepareSelectActionHandlerForEdit
  This sub prepares for the call to the function htmSelectActionHandlerForEdit by initializing the values of all parameters passed to it other than the first three.
• PrepareSelectAllAction
  This sub prepares for the call to the sub SelectAllActionHandler by initializing the value of the sProfileListPage parameter.
• PrepareSelectedAction
  This sub prepares for the call to the function htmSelectedActionHandlerForEdit by initializing the values of the last three**parameters.
• SelectAllActionHandler
  This sub provides the "Select All" action handler.

services\include\render_edit_blank.asp

The following customer and partner services utility routines are related to preparing blank edit page content for rendering, and are defined in this file:

• formRenderBlankEditPageBody
  This function prepares the HTML that will render a blank profile editing form.
• htmRenderBlankEditPage
  This function renders a blank edit page for any profile.
• rowRenderBlankProperty
  This function prepares the HTML that will render a row in a table that corresponds to a blank property. This row contains three cells: either an image or a checkbox, the display name, and the value, respectively.
• tableRenderBlankProfile
  This function prepares the HTML that will render tables for blank editing pages.

services\include\render_edit_common.asp

The following customer and partner services utility routines are related to preparing edit page content for rendering, and are defined in this file:

• colRenderForeignKeyProperty
  This function renders hidden fields that contain a variety of content, depending on whether a pre-existing profile exists, whether a new profile is being created, and so on. A button is rendered to allow the user to submit the selected information.
• colRenderPasswordProperty
  This function prepares the rendering of the value for the user_security_password property.
• colRenderPrimaryKeyProperty
  This function prepares the rendering of the value for the primary key property.
• colRenderProperty
  This function prepares the rendering of a property.
• colRenderPropertyTip
  This function prepares a warning message for a property that fails validation.
• colRenderUniqueKeyProperty
  This function prepares the rendering of the value for the unique key property.
• formRenderEditPageBody
  This function prepares the HTML that will render a profile editing form.
• htmRenderEditPage
  This function renders the contents of any EDIT-type page.
• rowRenderHiddenProperty
  This function prepares the HTML that will include hidden properties as INPUT elements with their TYPE attribute set to "HIDDEN".
• rowRenderProperty
  This function prepares the HTML that will render a row in a table that corresponds to a property that is accessible to the current user. This row contains three cells: either an image or a checkbox, the display name, and the value, respectively.
• rowRenderPropertyGroup
  This function prepares the HTML that will render a row containing a property group heading.
• rowRenderPropertyTip
  This function examines the specified property, and if found to have an error associated with it, adds a table row that displays an error message in the third of three cells.
• rowRenderReadOnlyProperty
  This function prepares the HTML that will render a row in a table that corresponds to a read-only property. This row contains three cells: blank, the display name, and the value, respectively.
• sRenderHTMLPreFixForProperty
  This function renders the "Required" icon or check box (for multi-edits) before each property in an EDIT-type page.
• tableRenderEditPageTasks
  This function renders tasks buttons for the current page.
• tableRenderProfiles
  This function renders an edit page for a profile.
• varGetPropertyValue
  This function determines the profile property value to display.
• varGetValueFromPropertyDictionaries
  This function gets the property value from a list of property dictionaries.
• varGetValueFromRequestObject
  This function gets the property value from the underlying Request object (URL or HTML FORM).
• varUpdateValueForCurrentAction
  This function gets the property value based on the current action type as stored in the global variable sAction.

Copyright © 2005 Microsoft Corporation.
All rights reserved.