How does one go about sending a supplemental document along with the document to sign?
the use case:
We are sending a contract for the user to sign, and would like to send the person som startup/welcome information aswell.
What ive tried:
Creating the attachment
Attachment attachment = new Attachment()
{
data = Convert.ToBase64String(docStorageDto.DocumentBlob),
name = ConversionUtil.MakeLegalFileName(docStorageDto.OrigFilename),
attachmentId = displayIndex.ToString() + index,
attachmentType= "pdf"
};
Tried to add it to the envelope
envelopeDefinition.attachments = new List<Attachment>(){ attachment };
envelopeDefinition.envelopeAttachments = new List<Attachment>(){ attachment };
Tried to add it to the "Signer" object
RecipientAttachment att = new RecipientAttachment()
{
data = attachment.data,
name = attachment.name,
attachmentId = attachment.attachmentId,
attachmentType = attachment.attachmentType
};
recipientSigner.recipientAttachments = new List<RecipientAttachment>(){att};
All with no luck, fields does not seem to be used? Where does one need to add the attachments/supplemental documents?
For future reference, Larry K is right.
supplemental documents does not use the attachment properties, but is just sent as a regular document. What i needed to set for it not to be included in the combined document etc. was to set these properties on the "Document" object:
includeInDownload = "false";
display = "modal";
A supplemental document does not use an attachment object.
To add a supplemental document to an envelope:
Read the docs.
Create a document object, same as for any other document.
Set the signerMustAcknowledge attribute of the document object to one of:
no_interaction No recipient action is required.
view The recipient is required to view the document.
accept The recipient is required to accept the document by selecting accept during signing, but is not required to view the document.
no_interaction No recipient action is required.
Related
I want to make a simple application C# with docusign.
I created a template on the site with several fields that the user will have to fill in. The application simply chooses the email address of the candidate.
I do like this for create my Envelope :
TemplateRole tRoleSigner = new TemplateRole();
tRoleSigner.Email = DSConfig.Signer1Email;
tRoleSigner.Name = DSConfig.Signer1Name;
tRoleSigner.RoleName = "Candidat";
TemplateRole tRoleCC = new TemplateRole();
tRoleCC.Email = DSConfig.Cc1Email;
tRoleCC.Name = DSConfig.Cc1Name;
tRoleCC.RoleName = "EnCopie";
List<TemplateRole> rolesList = new List<TemplateRole>() { tRoleSigner, tRoleCC };
EnvelopeDefinition envelopeDefinition = new EnvelopeDefinition
{
EmailSubject = "Signatures des documents relatifs à une promesse d'embauche",
TemplateRoles = rolesList,
TemplateId = DSConfig.TemplateID,
Status = "sent"
};
I tested but the fields do not appear on the document ...
However if I directly use the template via docusign the fields are there!
I know that we can create a tab in the C # code but I want to use the fields defined on the site!
I think I'm missing something ...
Without more information, including logs and IDs can't be sure what is the issue.
Possibilities:
RoleName is wrong/mismatch. Must be the one in the template that you use the ID for.
Fields are using anchor tags that are not found in document.
Template is in production and you are using developer account.
You can also try the web app ("directly") again and enable to see the API logs. The web app uses the same API that you do, and this way you can see exactly how it's done.
Hi We are trying to develop a mail sending system using MailKit. We have a set of Email Templates which are created using WORD and saved as MHTML files. The whole thing is working fine, when we use MailKit to create a MimeMessage from the MHT file.
But post creating this message, I am not able to see a way of adding attachments to this.
Currently we are trying the following.
private void SendEmail(string templatePath, List<string> attachments)
{
// Load the MHT Template
var mimeMessage = MimeMessage.Load(templatePath);
mimeMessage.From.Add(new MailBoxAddress("test#Test.com"));
mimeMessage.To.Add(new MailBoxAddress("test#Test.com"));
foreach (var attachment in attachments)
{
var fileAttachment = new MimePart()
{
ContentObject = new ContentObject(File.OpenRead(Path.Combine(attachment), ContentEncoding.Default),
ContentDisposition = new ContentDisposition(ContentDisposition.Attachment),
ContentTransferEncoding = ContentEncoding.Binary,
FileName = Path.GetFileName(attachment)
};
// Attachments is a read only Enumerable here.
mimeMessage.Attachments.Add
}
}
I add the attachment by the BodyBuilder:
BodyBuilder _body = new BodyBuilder
{
HtmlBody = message
};
_body.Attachments.Add(_fileName, _stream);
_email.Body = _body.ToMessageBody();
See this post stackoverflow
You will need to traverse the MIME tree structure of the message until you find the Multipart that you would like to add the "attachment" to and then use the Multipart.Add() method.
Keep in mind that a message is a nested tree structure and not a well-defined structure which has only 1 message body (or even just 2) and a list of attachments. It's a whole lot more complicated than that, so there's literally no way for MimeMessage.Attachments to "do the right thing".
For the general case, you can probably get away with something like this:
var message = MimeMessage.Load(fileName);
var attachment = new MimePart("application", "octet-stream") {
FileName = attachmentName,
ContentTransferEncoding = ContentEncoding.Base64,
Content = new MimeContent(attachmentStream)
};
if (!(message.Body is Multipart multipart &&
multipart.ContentType.Matches("multipart", "mixed"))) {
// The top-level MIME part is not a multipart/mixed.
//
// Attachments are typically added to a multipart/mixed
// container which tends to be the top-level MIME part
// of the message (unless it is signed or encrypted).
//
// If the message is signed or encrypted, though, we do
// do not want to mess with the structure, so the correct
// thing to do there is to encapsulate the top-level part
// in a multipart/mixed just like we are going to do anyway.
multipart = new Multipart("mixed");
// Replace the message body with the multipart/mixed and
// add the old message body to it.
multipart.Add(message.Body);
message.Body = multipart;
}
// Add the attachment.
multipart.Add(attachment);
// Save the message back out to disk.
message.WriteTo(newFileName);
I've been going thumbing through the documentation and searching the internet to find documenation on how to add attachments to created templates. I'm using darrencauthon's CSharp-Sparkpost to handle the API calls. So far what I have is not working. Does anyone have a working solution (possible?) or a better solution for C#? I'm not opposed to using a different library. This is the link to CSharp-Sparkpost
Here's what I've got so far:
var t = new Transmission();
t.Content.From.Email = "from#thisperson.com";
t.Content.TemplateId = "my-template-email";
new Recipient
{
Address = new Address { Email = recipient }
}
.Apply(t.Recipients.Add);
new Attachment
{
Data = //CSVDATA,
Name = "Table.csv",
Type = "text/csv"
}.Apply(t.Content.Attachments.Add);
var client = new SparkPost.Client(Util.GetPassword("sparkpostapikey"));
client.Transmissions.Send(t).Wait();
I've verified that I can send this attachment without a template and also verified that I can send this template without the attachment. So... the Email is getting sent; however, the content received is only the template and substitution data. No attachment with the template email.
Using Darren's library, and combining the requirements for my project, this is the solution I've come up with. I'm just making an additional API call to grab the template Html so I can build the transmission without having to send the template_id. Still using the CSharp-Sparkpost library to make all of the calls. I modified Darren's example SendInline program as such:
static async Task ExecuteEmailer()
{
var settings = ConfigurationManager.AppSettings;
var fromAddr = settings["fromaddr"];
var toAddr = settings["toaddr"];
var trans = new Transmission();
var to = new Recipient
{
Address = new Address
{
Email = toAddr
},
SubstitutionData = new Dictionary<string, object>
{
{"firstName", "Stranger"}
}
};
trans.Recipients.Add(to);
trans.SubstitutionData["firstName"] = "Sir or Madam";
trans.Content.From.Email = fromAddr;
trans.Content.Subject = "SparkPost sending attachment using template";
trans.Content.Text = "Greetings {{firstName or 'recipient'}}\nHello from C# land.";
//Add attachments to transmission object
trans.Content.Attachments.Add(new Attachment()
{
Data = Convert.ToBase64String(System.IO.File.ReadAllBytes(#"C:\PathToFile\ExcelFile.xlsx")),
Name = "ExcelFile.xlsx",
Type = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
});
Console.Write("Sending mail...");
var client = new Client(settings["apikey"]);
client.CustomSettings.SendingMode = SendingModes.Sync;
//retrieve template html and set Content.Html
var templateResponse = await client.Templates.Retrieve("template-email-test");
trans.Content.Html = templateResponse.TemplateContent.Html;
//Send transmission
var response = client.Transmissions.Send(trans);
Console.WriteLine("done");
}
Oh actually, I see now -- you are talking about adding attachments to templates, not attachments.
My answer to that is that back when I developed this library, attachment on templates was not supported by SparkPost itself.
My library allows you to try it, but that's because every template and non-template emails are considered "transmissions." So if you create a transmission, it has the option of adding attachments... but if you send the transmission with a template id, the attachment is ignored.
I could throw an error, or somehow design the API around this limitation, but what if they stopped ignoring the attachment but my library threw an error? I designed the library for flexibility as the SparkPost web API grew, and I didn't want my library to get in the way.
If you want to test if you're sending the attachment right, send your transmission without a transmission id, and instead with a subject and email body. If the email goes through and you get an attachment, then you know it's because of this template/attachment restriction from SparkPost.
NOTE: I'm putting this answer on Stack Overflow, and it's possible that this dated message will no longer be valid in the future.
I'm Darren Cauthon, the primary author of this library.
I have attachment support in my acceptance tests, which are run before each release. The link is below, but the code should be as simple as:
// C#
var attachment = File.Create<Attachment>("testtextfile.txt");
transmission.Content.Attachments.Add(attachment);
https://github.com/darrencauthon/csharp-sparkpost/blob/3a8cb1efbb8c9a0448c71c126ce7f88759867fb0/src/SparkPost.Acceptance/TransmissionSteps.cs#L56
I only need header and metadata of attachments from Gmail, I don't want to get email body or the content of the attachments, because they may be very big and I don't need them.
Is there a way to do so through AE.Net.Mail or gmail api? It seems only come with one option of of headers only, which will not fetch the attachment metadata for me.
MailMessage[] GetMessages(string startUID, string endUID, bool headersonly = true, bool setseen = false);
Eventually, I gave up on AE.Net.Mail and switched to Gmail API instead. And I am able to get attachment meta data from the Message Get Request, without getting the actual attachment file.
https://developers.google.com/gmail/api/v1/reference/users/messages/get
If you use MailKit instead of AE.Net.Mail, you can get the metadata of attachments using the following code snippet:
using (var client = new ImapClient ()) {
client.Connect ("imap.gmail.com", 993, true);
client.Authenticate ("username", "password");
client.Inbox.Open (FolderAccess.ReadWrite);
var summaries = client.Fetch (0, -1, MessageSummaryItems.UniqueId |
MessageSummaryItems.BodyStructure | // metadata for mime parts
MessageSummaryItems.Envelope); // metadata for messages
foreach (var summary in summaries) {
// Each summary item will have the UniqueId, Body and Envelope properties
// filled in (since that's what we asked for).
var uid = summary.UniqueId.Value;
Console.WriteLine ("The UID of the message is: {0}", uid);
Console.WriteLine ("The Message-Id is: {0}", summary.Envelope.MessageId);
Console.WriteLine ("The Subject is: {0}", summary.Envelope.Subject);
// Note: there are many more properties, but you get the idea...
// Since you want to know the metadata for each attachment, you can
// now walk the MIME structure via the Body property and get
// whatever details you want to get about each MIME part.
var multipart = summary.Body as BodyPartMultipart;
if (multipart != null) {
foreach (var part in multipart.BodyParts) {
var basic = part as BodyPartBasic;
if (basic != null && basic.IsAttachment) {
// See http://www.mimekit.net/docs/html/Properties_T_MailKit_BodyPartBasic.htm
// for more details on what properties are available.
Console.WriteLine ("The size of this attachment is: {0} bytes", basic.Octets);
Console.WriteLine ("The file name is: {0}", basic.FileName);
// If you want to download just this attachment, you can download it like this:
var attachment = client.Inbox.GetBodyPart (uid, basic);
}
}
}
}
client.Disconnect (true);
}
Keep in mind that since MIME is a tree structure and not a flat list, you'll realistically want to walk multiparts recursively.
I've noticed that when someone copy paste an email and then sends it the "src" value of the images changes. For example if the original email has an image which is an attachment and its contentId is: cid:companlyLogo. And then someone copy paste this email into a new draft and sends it this src value changes to: src="cid:image001.jpg#01CCF6B1.A4CA2FE0".
I have no clue whatsoever on how to get this image and save it in an image object in c#. Am currently using EWS api for doing this. Problem is that since its a copy paste it no longer has attachments as the original email.
Does anyone has any idea on how to retrieve the images of this types of emails?
Embedded images are treated as email attachments by Exchange. That means you can retrieve the images from the Item.Attachments property. The following example shows you how to do this using the EWS Managed API. Notice that EWS will not load the attachments unless you explicitly tell it to by calling LoadPropertiesForItems.
You can tell that an attachment is embedded by checking the Attachment.IsInline property. EWS lets you load the attachment and save it to disk by calling the FileAttachment.Load method.
ExchangeService service = GetService();
var view = new ItemView(1);
var searchFilter = new SearchFilter.IsEqualTo(EmailMessageSchema.Subject, "Some subject text");
var items = service.FindItems(WellKnownFolderName.Inbox, searchFilter, view);
service.LoadPropertiesForItems(items, new PropertySet(BasePropertySet.FirstClassProperties, EmailMessageSchema.Attachments));
var item = items.ElementAt(0) as EmailMessage;
for (int i = 0; i < item.Attachments.Count; i++)
{
var att = item.Attachments[i] as FileAttachment;
if (att.IsInline && att.ContentType.Contains("image"))
{
att.Load(String.Format(#"c:\temp\attachedimage_{0}.jpg", i));
}
}