addedValuesDocs

 
 
 

Available Postprocessors

Name Changed Enabled Description
configureUserTransaction 2006.08.15 Yes Allows configuring any user transaction from an addedValues form in this user transaction.

For scalar (single valued) variables, set the user transaction default value by enterign a value for the varibnale.

For multiple valued variables, eachg value becomes a pre-defined value.

cornershop 2006.08.15 Yes Adds an item to the cornershop basket
createAsite 2007.02.9 Yes Creates a new Manila website.
emailForm 2003.11.24 Yes Sends an email from a user transaction, to a designated email address. Can also send a different email to the browser end user. Works by calling an addedValues report to create the body of the mail message(s)

Information about destination, subject, etc, is all retrieved from the variables in each instance of the transaction. The transaction must have variables called

  • mailTo - the email address of the recipient
  • mailSubject - the subject of the email
  • mailBodyTemplate - the name of a report that creates the text of the email from the values of the current instance

and the values must be non-blank.

The user transaction may have variables called

  • mailSender - the email address of the sender (the From address). Defaults to an ME email address
  • mailReplyTo - the email address of the user filling the form (sets Reply-To)
  • mailCC - a string of one or more email addresses to receive carbon copies of the email
  • mailBCC - a string of one or more email addresses to receive blind carbon copies of the email
  • mailMimeType - a mime type that overrides the default of text/plain, if the mailBodyTemplate creates sophisticated emails; for example text/html allows HTML formatted emails.
  • confirmMailBodyTemplate - the name of a report that creates the text of the email from the values of the current instance that goes to the end user. Ignored unless mailReplyTo exists.

which are used when the email is sent if they exist and have values.

To add a member to the site's membership group create the following variables.

  • memberAutoEnter - boolean, used to decide whether to signup a member or not.
  • memberName - will set the personalInfo name of the member.
  • memberBulletins - will set the bulletins enabled flag of the member.
  • memberHTMLBulletins - will set the bulletins in HTML flag of the member.
If memberAutoEnter is true, and mailReplyTo exists and is non-empty, the membership entry for the user with member key mailReplyTo will be created or udpated from these variables.

As a convenience, if no variable called memberName is defined, an attempt will be made to concatenate variables firstName and lastname to provide a value for the name of the member

FAQFormToMessage 2003.06.21 Yes Calls the emailForm post processor to send emails from a JustAskForm transaction, then adds a story for the question.
formToAudit 2004.08.31 Yes Looks for an audit table whose name if same as the groupname of the user transaction, it then compares the variables names in the user transaction to those in the audit table. The values of variables with matching names are are copied from the user transaction to the audit table.
muswettbewerb06Vote 2006.08.26 Yes
parametricQuery 2006.09.24 Yes Calls a query using the query macro and stores the result in the transaction variable responseText. The parameters to the query macro are taken from transaction variables, if they are defined. Any other parameters are taken as run time paramaters of the query itself, and are incorporated into the parameterValues string.

The transaction must have variables called

  • queryID - the query to run
  • reportID - the report to send the results to
  • responseText - a varibale to store the current page of results

and queryid, and reportid must be non-blank.

The user transaction may have variables called

  • sortBy - will be the sortBy parameter for the query macro
  • sortDirection - will be the sortDirection parameter for the query macro
  • dateFormat - will be the dateFormat parameter for the query macro
  • flTrimSortedByDuplicates - will be the flTrimSortedByDuplicates parameter for the query macro
    • All other variables in the user transaction are assumed to be parameters of the query itself, and they are passed as ampersand delimited name=value pairs to the query macro.

pictureUpload 2008.05.16 Yes Uploads a picture, similar to how Manila does it, BUT is open to all members.

The transaction must have variables called

  • thePicture - a picture shorcut
  • thePictureTitle - the subject of the picture message, not the shortcut

The user transaction may have variables called

  • thePictureDescription - the text of the picture message.
saveSearchAsFeed 2006.11.17 Yes Saves a query into the member record, which uses the values added to a search form. Adds a query/report name pair to a row in the members myFeed row placeholder table. The report must be an RSS report.

The transaction must have variables called

  • searchCustomKey - the customkey for the search form that creates the query
  • queryName - the name you assign to the query
  • reportname - the RSS report name that defiens teh query
  • statusText - a variable to store erro messages if any

and searchCustomKey, queryName and reportname must be non-blank.

The user transaction may have variables called

  • sortBy - will be the sortBy parameter for the RSSlink macro calls
  • sortedByTransform - will be the sortedByTransform parameter for RSSlink macro calls
  • redirectOnSaveOK - a shortcut of the page to redirect to after a successful save
    schemaObjectTable 2008.02.8 Yes Builds a read only table of all definable addedValues objects in the website;
    setAuthorTo 2006.09.20 Yes Changes the member (owner) of the message of the CURRENT page to a new memberKey taken from variable setAuthorTo. Two errors are detected, if string variables called invalidMemberErrorText and invalidMessageErrorText exist, they will be used preferentially. You would normally assign these as default values. This allows for localised error messages

    invalidMemberErrorText is displayed if there is no member with key setAuthorTo. invalidMessageErrorText is displayed if the message number of the current page cannot be identified.

    To transfer a message to a known fixed member Key; make a new group, declare string variable setAuthorTo, with the default value of the known key. Make a form which is only a submit button and include that in the template or content for each page of interest. Set the postprocessor to setAuthorTo, and the next action as desired.

    You can also allow the user to enter the member to transfer to, by adding setAuthor to in the form. In this case, set value must be to email address and and empty default value.

    If there are no variables to include in the form, addedValues won't allow you to set the layout; you will need to make a dummy variable; and include it in the form , and place it in the layout with something like [[dummy("foo")]].

    setNextForm 2006.05.1 Yes Changes the course of the user transaction by setting the next form to present.
    tropeInstaller 2005.10.30 Yes Used by addedValues to export a Trope and install it on a remote website.



    Create your own Manila site in minutes. Everyone's doing it!