Attachment File - Download

Download a ServiceNow attachment file using SQL Server

Prerequisites:

See SQLHTTP easy setup for ServiceNow
See API Call documentation for parameter values and other information
Create the stored procedure documented below

Stored Procedure:


CREATE PROCEDURE usp_ServiceNow_Attachment_File_Fetch(
		@Profile nvarchar(100),
		@Sys_id varchar(50),
		@Response nvarchar(MAX) OUTPUT,
		@StatusCode int OUTPUT,
		@StatusDescription nvarchar(MAX) OUTPUT)

AS

DECLARE @URL nvarchar(MAX)
DECLARE @QueryString varchar(MAX)
DECLARE @UserName nvarchar(4000)
DECLARE @Password nvarchar(4000)
DECLARE @HTTPSessionID uniqueidentifier

SET @URL =  SQLHTTP.net.AuthParam(@Profile, 'Domain')

EXEC SQLHTTP.net.UrlBuilder 	@URL OUTPUT,
				@Profile,
				'api', 'now', 
				'attachment', @Sys_id, 'file'

EXEC SQLHTTP.net.HTTPSession @HTTPSessionID OUTPUT

SET @UserName = SQLHTTP.net.AuthParam(@Profile, 'UserName')
SET @Password = SQLHTTP.net.AuthParam(@Profile, 'Password')

EXEC SQLHTTP.net.BasicAuthHeader @HttpSessionID, @UserName, @Password

EXEC SQLHTTP.net.HTTPRequest    @HttpSessionID,
				@URL = @URL,
				@Method = 'GET',
				@Accept = '*/*',
				@StatusCode = @StatusCode OUTPUT,
				@StatusDescription = @StatusDescription OUTPUT,
				@Response = @Response OUTPUT

GO

CREATE PROCEDURE usp_ServiceNow_Attachment_File_Fetch(

@Profile nvarchar(100),

@Sys_id varchar(50),

@Response nvarchar(MAX) OUTPUT,

@StatusCode int OUTPUT,

@StatusDescription nvarchar(MAX) OUTPUT)

DECLARE @URL nvarchar(MAX)

DECLARE @QueryString varchar(MAX)

DECLARE @UserName nvarchar(4000)

DECLARE @Password nvarchar(4000)

DECLARE @HTTPSessionID uniqueidentifier

SET @URL = SQLHTTP.net.AuthParam(@Profile, 'Domain')

EXEC SQLHTTP.net.UrlBuilder @URL OUTPUT,

@Profile,

'api', 'now',

'attachment', @Sys_id, 'file'

EXEC SQLHTTP.net.HTTPSession @HTTPSessionID OUTPUT

SET @UserName = SQLHTTP.net.AuthParam(@Profile, 'UserName')

SET @Password = SQLHTTP.net.AuthParam(@Profile, 'Password')

EXEC SQLHTTP.net.BasicAuthHeader @HttpSessionID, @UserName, @Password

EXEC SQLHTTP.net.HTTPRequest @HttpSessionID,

@URL = @URL,

@Method = 'GET',

@Accept = '*/*',

@StatusCode = @StatusCode OUTPUT,

@StatusDescription = @StatusDescription OUTPUT,

@Response = @Response OUTPUT



Sample Usage:


DECLARE @Response nvarchar(MAX)
DECLARE @StatusCode int
DECLARE @StatusDescription nvarchar(MAX)

DECLARE @FilePath varchar(MAX)
DECLARE @FileContent varchar(MAX)

SET @FilePath = 'E:\DownloadedImage.png'

EXEC usp_ServiceNow_Attachment_File_Fetch
		@Profile = 'My ServiceNow',
		@Sys_id = 'ec99c7500f03030041ea06ace1050eae',
		@Response = @Response OUTPUT, 
		@StatusCode = @StatusCode OUTPUT, 
		@StatusDescription = @StatusDescription OUTPUT

IF @StatusCode >= 400
	EXEC SQLHTTP.net.RaiseHttpError @StatusCode, @StatusDescription, @Response
ELSE
	BEGIN
		
		SET @FileContent = SQLHTTP.net.String_To_Base64(@Response)
		
		EXEC SQLHTTP.net.FileWrite @FilePath, @FileContent, 'Base64'

		SELECT  @StatusCode AS StatusCode, 
                        @StatusDescription AS StatusDescription

	END

DECLARE @Response nvarchar(MAX)

DECLARE @StatusCode int

DECLARE @StatusDescription nvarchar(MAX)

DECLARE @FilePath varchar(MAX)

DECLARE @FileContent varchar(MAX)

SET @FilePath = 'E:\DownloadedImage.png'

EXEC usp_ServiceNow_Attachment_File_Fetch

@Profile = 'My ServiceNow',

@Sys_id = 'ec99c7500f03030041ea06ace1050eae',

@Response = @Response OUTPUT,

@StatusCode = @StatusCode OUTPUT,

@StatusDescription = @StatusDescription OUTPUT

IF @StatusCode >= 400

EXEC SQLHTTP.net.RaiseHttpError @StatusCode, @StatusDescription, @Response

ELSE

BEGIN

SET @FileContent = SQLHTTP.net.String_To_Base64(@Response)

EXEC SQLHTTP.net.FileWrite @FilePath, @FileContent, 'Base64'

SELECT @StatusCode AS StatusCode,

@StatusDescription AS StatusDescription

END

StatusCode StatusDescription

----------- -------------------

200 OK



IMPORTANT DISCLAIMER

CODE/SQL ON THESE PAGES ARE PROVIDED AS-IS AND ARE AVAILABLE FOR ILLUSTRATIVE PURPOSES ONLY.

USERS ARE REQUIRED TO ABIDE BY THE TERMS AND CONDITIONS FOR USING REFERENCED THIRD PARTY WEBSITES AND/OR APIs FROM THEIR RESPECTIVE WEBSITES. WE DO NOT CONDONE ANY VIOLATION OF THIRD PARTY WEBSITES AND/OR APIs TERMS AND CONDITIONS USING OUR SOFTWARE.

USERS SHALL BE SOLELY RESPONSIBLE AND BE SOLELY LIABLE FOR VIOLATION OF ANY RULES SPECIFIED BY THIRD PARTIES FOR USING THEIR WEBSITES AND/OR APIs, OR INFRINGEMENT OF RIGHTS OF SUCH THIRD PARTIES.