Using the ReadAttachment Web Method

reads the data of a specific attachment record, given its recid value request syntax frsheatintegrationreadattachmentresponse readattachment(string sessionkey, string tenantid, objectattachmentcommanddata commanddata) parameters sessionkey the session key from the connect web method tenantid the tenant for which the session key is authenticated commanddata a structure containing information about the attachment public class objectattachmentcommanddata { public string objectid; } objectid recid of the new attachment return value frsheatintegrationreadattachmentresponse object, defined as follows public class frsheatintegrationreadattachmentresponse { public string status { get; set; } public string exceptionreason { get; set; } public byte\[] attachmentdata { get; set; } } the frsheatintegrationreadattachmentresponse class has the following fields status provides a status about the state of the connection the table below contains a full description of the available status values exceptionreason contains exception information, if the application throws an exception when running this web method attachmentdata a byte array that contains the contents of the specified attachment the following table lists the available status values and describes how to interpret them status explanation success successfully retrieved the attachment from the tenant the attachment is available in the attachmentdata field notfound the tenant does not contain an attachment with the specified name ensure that the name of the attachment is spelled correctly and that it exists error an error was encountered during the execution of this web method inspect the corresponding exceptionreason field to determine why the web method has failed example byte\[] attachmentdata; const string filename = "c \\\temp\\\test png"; objectattachmentcommanddata data = new objectattachmentcommanddata() { objectid = "94069732037142e7bf3d81db02128289", // recid of the attachment record }; frsheatintegrationreadattachmentresponse response = frsvc readattachment(authsessionkey, tenantid, data); if (response status == "success") { attachmentdata = response attachmentdata; if (attachmentdata != null) { using (filestream fs = new filestream(filename, filemode create)) { using (binarywriter w = new binarywriter(fs)) { for (int i = 0; i < attachmentdata length; i++) { w\ write(attachmentdata\[i]); } } } } } else if (response status == "notfound") { console writeline("the attachment record with the specified recid, cannot be located in the tenant"); } else { console writeline("encountered the following error while reading the attachment from the record " + response exceptionreason); } increasing the size of allowed messages for microsoft net based web service clients, the application may run into the following error when retrieving large attachments, via the web service communication exception occurred the maximum message size quota for incoming messages (65536) has been exceeded to increase the quota, configure the maxreceivedmessagesize and maxbuffersize attributes in the app config file to accommodate the large attachment sizes for the microsoft net client application that consumes the web service see the following example \<binding name="ipcmservicesoap" closetimeout="00 01 00 " opentimeout="00 01 00 " receivetimeout="00🕙00" sendtimeout="00 01 00 " allowcookies="false" bypassproxyonlocal="false" hostnamecomparisonmode="strongwildcard" maxbuffersize="65536" maxbufferpoolsize="524288" maxreceivedmessagesize="65536" messageencoding="text" textencoding="utf 8" transfermode="buffered" usedefaultwebproxy="true"> \</binding> the size values above are represented in bytes