Auto-provisioning POP3 or Exchange mail via UC Mini how-to.

---

As you all know, a lot of new ROMs (including mine) are shipping with UC support built in.

Now for a while, I've been pondering how I could use UC to auto-create my email account on each flash - to easily setup my testing. Ponder no more.

In the SDConfig.txt file, you need to have an entry to the XML file we create later on. This will be a line like:

XML: \Storage Card\Setup\Email.xml

Within this Email.xml file, we want to setup the user account. For exchange, we use the following:

<wap-provisioningdoc>
   <characteristic type="Sync">
        <characteristic type="Settings">
        <parm name="SyncWhenRoaming" value="1"/>
        </characteristic>
        <characteristic type="Connection">
            <parm name="Domain" value="mydomain"/>
            <parm name="Password" value="mypassword"/>
            <parm name="SavePassword" value="1"/>
            <parm name="Server" value="my.exchange.server.com"/>
            <parm name="User" value="My Name"/>
            <parm name="URI" value="Microsoft-Server-ActiveSync"/>
        <parm name="UseSSL" value="1"/>
        </characteristic>
        <characteristic type="Mail">
            <parm name="Enabled" value="1"/>
        <parm name="EmailAgeFilter" value="3"/>
        </characteristic>
        <characteristic type="Calendar">
            <parm name="Enabled" value="1"/>
        <parm name="CalendarAgeFilter" value="5"/>
        </characteristic>
        <characteristic type="Contacts">
            <parm name="Enabled" value="1"/>
        </characteristic>
   </characteristic>
</wap-provisioningdoc>

After replacing the required details, this should setup all that is required for Outlook Mobile to query your Exchange server.

Ah you say, but my mail account is POP3. Ah ha I reply, you'll need to use the following code in Email.xml.

<wap-provisioningdoc>
   <characteristic type="EMAIL2"> 
     <characteristic type="{4FE84006-9E8A-4158-864D-A2E1E98C3786}">
        <parm name="SERVICENAME" value="My Account Mail" /> 
        <parm name="SERVICETYPE" value="POP3" />
        <parm name="INSERVER" value="pop.server.com" />
        <parm name="OUTSERVER" value="smtp.server.com" />
        <parm name="AUTHNAME" value="myusername" /> 
        <parm name="AUTHSECRET" value="mypassword" /> 
        <parm name="DOMAIN" value="" /> 
        <parm name="REPLYADDR" value="myusername@domain.com" />
        <parm name="NAME" value="My Name" />
     </characteristic>
   </characteristic> 
</wap-provisioningdoc>

"Ahhhh" I hear you say not wanting to be out done, "but I use POP3 over SSL!". You see me chuckle, as you realise I have an answer. Use the following between AUTHSECRET and DOMAIN:

      <characteristic type="TAGPROPS">
        <parm name="8128000B" value="1"/>
        <parm name="812C000B" value="1"/>
      </characteristic>

8128000B is for incoming SSL, while 812C000B is for outgoing SSL.

Oh, and if you want to use SMTP auth for sending mail, add in the following after OUTSERVER:

      <parm name="AUTHREQUIRED" value="1"/>

Here my children ends the lesson on auto-provisioning email accounts the UC way. Go forth and use this knowledge to make your lives much, much easier.

Happy Flashing.

Same works fine for IMAP, can be found in the UC thread

Great job CRCinAU, you should Wiki this!

Heh - I have enough on my plate at the moment... Just drawing my testing to a close on Release 10.3 of my ROM - including a new battery driver that does readings in 1% increments I'll hopefully have it ready for release in about an hour.

Your wisdom astounds me O sage philosoph! So I come to you with true hope rising in my heart. In many lands have I sought this answer and truly despair had threatened to overtake me.

Can it be that light breaks through the clouds of my despondency? Are you the promised one, he who holds "the answer?"

can UC be configured to populate the device name and owner information fields so that we need not repeat that ritual after every flash?

I promise to shower you with praise should you deign to craft the spell that will accomplish this feat!

Your humble and unworthy servant.

if you need a tool which creates the provisioning files for you, try
Personal OEMIZER
which can be found here: www.tierman.net

Originally Posted by cyberscribe

Your wisdom astounds me O sage philosoph! So I come to you with true hope rising in my heart. In many lands have I sought this answer and truly despair had threatened to overtake me.

Can it be that light breaks through the clouds of my despondency? Are you the promised one, he who holds "the answer?"

can UC be configured to populate the device name and owner information fields so that we need not repeat that ritual after every flash?

I promise to shower you with praise should you deign to craft the spell that will accomplish this feat!

Your humble and unworthy servant.

if u go to the uc thread i think post 17 it mentions a tool which can do exactly that all though idk about all the poetry but yea check it out in the development forum

Dude, you ROCK!

download size limit

---

does someone know how to set the download limit of emails (size) ?
with these settings all attachements will be downloaded also, or am i wrong ?

Originally Posted by petervbeck

does someone know how to set the download limit of emails (size) ?
with these settings all attachements will be downloaded also, or am i wrong ?

Ahhh, a worthy question!

The answer you seek is a reverent one. Add the following below the NAME parm.

<parm name="RETRIEVE" value="0" />

Now with all true options in life, there are multiple values you may use. Specify a value of 0 to say that you only want to download headers. Specify a value of -1 (or 4294967295) if you want to download all messages.

I can also see more questions brewing, so I shall also list you these.

<parm name="KEEPMAX" value="0" />

Specifies the maximum size (in KB) for message attachments to be downloaded. Attachments that are larger will remain on the server, but the message itself will still be downloaded. Use a value of 0 to specify that you do not want any message attachments. Use a value of -1 (or 4294967295) to specify that you want all message attachments, no matter how large.

<parm name="LINGER" value="0" />

How often perform scheduled sends/receives in minutes. Beware however, if a value is not provided for LINGER, the automatic connection sync setting defaults to every 15 minutes. You should set the LINGER parameter to 0 to never connect automatically.

<parm name="FORMAT" value="1" />

Specifies which format to use for downloading and composing new e-mail messages (1 for Plain Text, and 2 for HTML). The default is HTML, however a true sage will only ever require Plain Text