USP_DATAFORMTEMPLATE_EDITLOAD_PARTICIPANTWIDGET

The load procedure used by the edit dataform template "Participant Widget Edit Data Form"

Parameters

Parameter Parameter Type Mode Description
@ID uniqueidentifier IN The input ID parameter used to load the fields defined on the form.
@DATALOADED bit INOUT Output parameter indicating whether or not data was actually loaded.
@TSLONG bigint INOUT Output parameter indicating the TSLONG value of the record being edited. This is used to manage multi-user concurrency issues when multiple users access the same record.
@WIDGETID int INOUT WidgetID
@REGISTRANTID uniqueidentifier INOUT RegistrantID
@DISPLAYTEXT nvarchar(4000) INOUT DisplayText
@ISACTIVE bit INOUT IsActive

Definition

Copy

            CREATE procedure dbo.USP_DATAFORMTEMPLATE_EDITLOAD_PARTICIPANTWIDGET(
                @ID uniqueidentifier,
                @DATALOADED bit = 0 output,
                @TSLONG bigint = 0 output,
                @WIDGETID int = null output,
                @REGISTRANTID uniqueidentifier = null output,
                @DISPLAYTEXT nvarchar(4000) = null output,
                @ISACTIVE bit = null output
            )
            as

                set nocount on;

                -- be sure to set these, in case the select returns no rows
                set @DATALOADED = 0
                set @TSLONG = 0

                -- populate the output parameters, which correspond to fields on the form.  Note that
                -- we set @DATALOADED = 1 to indicate that the load was successful.  Otherwise, the system
                -- will display a "no data loaded" message.  Also note that we fetch the TSLONG so that concurrency
                -- can be considered.
                select
                    @DATALOADED = 1,
                    @TSLONG = TSLONG,
                    @WIDGETID = WIDGETID,
                    @REGISTRANTID = REGISTRANTID,
                    @DISPLAYTEXT = DISPLAYTEXT,
                    @ISACTIVE = ISACTIVE        
                from dbo.PARTICIPANTWIDGET
                where ID = @ID

                return 0;