SoftadminSnippet.BankId_Sign

Type: Stored procedure

When called from a snippet procedure, initiates Mobile BankID signing and shows the ongoing status. Will trigger a BankID Completed call for the snippet when the process is completed.
Uses the same configuration as the BankID component.

Examples

CREATE PROCEDURE Example.BankIdSnippet
	@IsFormSubmit bit = 0,

	@IsBankIdSign bit = 0,
	@PersonalNumber varchar(30) = NULL,
	@BankIdSignatureId int = NULL,
	@IsError bit = 0,
	@ErrorMessage varchar(MAX) = NULL
AS
BEGIN
	IF @IsFormSubmit = 1
	BEGIN
		EXEC SoftadminSnippet.BankId_Sign
			@CultureCode = 'en-US',
			@TextToSign = N'Sign this!';

		RETURN;
	END;

	IF @IsBankIdSign = 1
	BEGIN
		SELECT CONCAT('Personal number: ', ISNULL(@PersonalNumber, 'N/A'), ', ') AS Plaintext;

		IF @IsError = 1
		BEGIN
			SELECT CONCAT('Error: ', @ErrorMessage) AS Plaintext;
			RETURN;
		END;

		SELECT 'Success!' AS Plaintext;

		-- Add code to log success and associate @BankIdSignatureId with relevant data here.

		RETURN;
	END;

	EXEC SoftadminSnippet.Form
		@FormHtml = N'<input type="submit" value="Show QR code">';

	SELECT '<div id="BankIdErrorMessage"></div>' AS Html;
END;

See also

Parameters

@CssClass optional varchar
CSS class name to use for the BankID status indicator.

Never target HTML elements internal to the status indicator from your CSS. The HTML may change between versions.
@CultureCode optional varchar
The language used for status messages. Defaults to 'sv-SE'.
Possible value Description
en-US English.
sv-SE Swedish.
@FormattedTextToSign optional varchar
Formatted text to sign, shown in the user's BankID app.

Supports e.g. headings, lists, and tables.
See https://www.bankid.com/en/utvecklare/guider/formatera-text/syntax-specialtecken-atergivning for formatting options, and https://www.bankid.com/en/utvecklare/guider/formatera-text/formatera-text-exempel for examples.

Exactly one of @TextToSign and @FormattedTextToSign must be set.
@HiddenDataToSign optional varbinary
Additional data that will be signed but which is not shown to the user.

It might be tempting to include the entire document to sign (e.g. a PDF file) here, but it will require additional disk space. The data will be included in the signature (stored in SoftadminApi.BankIdSignature), which means that disk usage will increase proportionally to the size of the data.
@PersonalNumber optional varchar
Requires the user to have a BankID for the specified personal number.
Should consist of 12 digits. Hyphens are ignored.
Use SoftadminSnippet.BankId_PersonalNumber_IsValid to validate.
@TextToSign optional varchar
Text to sign, shown in the user's BankID app.

Exactly one of @TextToSign and @FormattedTextToSign must be set.