Fax Cover Sheet On Off

Hello,

I am submitting fax jobs, and some require a cover sheet, while others don't. I know about the coversheet yes/no switch, but how do you advice that I flag a job to use or not use a cover sheet? Is there a way to link inserts with the C# code?

Thanks.

Find more posts tagged with

Comments

thuneke

Cover sheet yes/no does that. A setting of no causes no use of a cover sheet.

You can pass inserts in a csv file, the field names will depend on the field names in the cover sheet. If you are sending to multiple recipients you can personalize each one doing this.

It can also be done in the C# code. Heree is a sample':

EMsgAPI_Demo.EMsgAPI_JobSubmit201101.FaxCoversheetOptionType CoverSheet = new EMsgAPI_Demo.EMsgAPI_JobSubmit201101.FaxCoversheetOptionType();

CoverSheet.UseCoversheet = EMsgAPI_Demo.EMsgAPI_JobSubmit201101.YesNo.yes;

EMsgAPI_Demo.EMsgAPI_JobSubmit201101.EncodableStringType JS_Attn = new EMsgAPI_Demo.EMsgAPI_JobSubmit201101.EncodableStringType();

JS_Attn.Value = "Test Fax using API";

CoverSheet.CoversheetAttn = JS_Attn;

You can also set CoverSheetFrom and CoverSheetTo. This method causes each recipient to receive the same items. You must make sure the cover sheet has the field names Attn, To, and From.b

thuneke

I have attached a sample csv file. This assumes the cover sheet has fields such as INS_1, INS_2, INS_3, and INS_4.

sampleinsertfax.csv

ndajani

Hello again,

I understand setting the yes/no switch in the C# code, my question though is pertaining to, when using the API code, how can I know if a submitted CSV file for a fax job requires a cover sheet or not? The requirement I am working with is that the customer will send three types of fax jobs: 2 that don't require a cover sheet, while one will require a cover sheet. So based on what "flag" do I use the setting:

CoverSheet.UseCoversheet = EMsgAPI_Demo.EMsgAPI_JobSubmit201101.YesNo.yes;
or
CoverSheet.UseCoversheet = EMsgAPI_Demo.EMsgAPI_JobSubmit201101.YesNo.no;

I can include something in the name of the CSV file to tell me if a cover sheet is needed or not. But is there another way? Can the C# code read an insert value as the flag? For example, have an INS_1 that contains 1 or 0, and the C# code can check that value. 0 would be for no cover sheet, and 1 would be for cover sheet. If so, what is the syntax in the C# code to capture an insert value from a CSV file?

ndajani

Hello,

Any update on this issue please?

Thank you.

thuneke

You could put a "1" in the name and just look for that in your code. Your customer would have to know not to use a "1" in the name for aany thing else.

Or you could put it in the CSV file. You would have to make sure you don't use a field namee that is on the cover. You would have to write the code to parse the CSV file for that field.

thuneke

Using the ile name would be the easyist, you couldf use an if staement:

if (csvname.Contains("1"))

ndajani

Yes, these were the two options I thought of as well, but I prefer the latter option to parse the CSV. And that's my question, what's the C# syntax to parse a field in the CSV file?

I tried to use the CSV field SUBJECT and check for it if it has a value or not. If the CSV field exists, then we need a cover sheet. So, my test code is here, but the first three lines below don't work because it's not getting the value correctly from the CSV file:

EncodableStringType JS_Subject = new EncodableStringType();
JS_Subject.Value = "(SUBJECT)";
CoverSheet.CoversheetAttn = JS_Subject;

So if the CSV Subject field exists
{
FaxCoversheetOptionType CoverSheet = new FaxCoversheetOptionType();
CoverSheet.UseCoversheet = YesNo.yes;
JS_FaxOptions.FaxCoversheet = CoverSheet;
CoverSheet.CoversheetName = "pnmcover";
}

Any help with how to capture a CSV field value in the C# code would be greatly appreciated. It can be an "insert" field, or another name mapped field.

Thanks.

thuneke

Do a search in Google for "C# read CSV file". You will get a lot of hits for it.

ndajani

I'm able to capture insert values from the email jobs API code for the email subject line, for example:

EmailOptions_Subject.Value = "(i99)";

So I thought I can do the same with fax, but it seems not I guess.

I'll go the route of the file name contains a certain string value then.

Thanks for all your help with this.