BLOG of Helmut Obertanner

Windows7 tastes good!

Helmut Obertanner — Mon, 08 Mar 2010 09:09:00 GMT

More...

Windows7 schmeckt gut!

Helmut Obertanner — Mon, 08 Mar 2010 09:07:24 GMT

Kollegen lieben MVPs!

Outlook Personal Folders File Format specification available

Helmut Obertanner — Mon, 08 Mar 2010 07:57:23 GMT

Microsoft released documentation for the Outlook PST-File format.

You can download the documentation as PDF-Files from this site:
http://msdn.microsoft.com/en-us/library/ff385210.aspx

Dokumentation für Outlook PST-Format veröffentlicht

Helmut Obertanner — Mon, 08 Mar 2010 07:51:54 GMT

Unter folgendem Link:

http://msdn.microsoft.com/en-us/library/ff385210.aspx

Steht seit kurzem die Dokumentation für das Microsoft Outlook PST Datei-Format zur Verfügung.
Im Rahmen der Interoperabilitätsoffensive steht jetzt in der MSDN Library die angekündigte Dokumentation für das PST-Dateiformat der Outlook-Datendateien zum Abruf bereit. Somit ist der Zugriff auf E-Mails, Kalender, Kontakte und andere Outlook-generierte Daten auch außerhalb dokumentierter APIs geöffnet. Selbstverständlich stehen auch die Seiten bereits veröffentlichter Dokumentationen der Office- und Windows-Dateiformate und -Protokolle weiterhin kostenfrei zur Lektüre bereit.

10 Licenses for free – 30% off

Helmut Obertanner — Fri, 29 Jan 2010 20:01:25 GMT

Instyler Software developed an Outlook-Add-in for managing Business traveling times.
The Add-in is a must-have for business travelers and freelancers and gives support for managing traveling times.
http://www.instyler.com/

Due to the good cooperation between X4U and Instyler I can give away 10 licenses (max. 1 license per user) for free to my blog readers.
First 10 readers that drop me a mail with subject: Travel Add-in via the Feedbackformular, receive a free Travel Add-in license.

If you are not a lucky winner and still like this software, you can use a voucher code: TRAVELX4U
to get 30% of the normal price.

The Add-in can be downloaded and tested without any restrictions for 30 days after installation.

Helmut Obertanner

10 Lizenzen zu verschenken – 30% Rabatt

Helmut Obertanner — Fri, 29 Jan 2010 19:51:13 GMT

Instyler Software hat ein Outlook-Add-in zur Verwaltung von Fahrtzeiten entwickelt.
Das Add-in ist ideal für Geschäftsreisende und Freiberufler und unterstützt bei der Fahrtzeitenplanung.
http://www.instyler.com/

Dank der guten Zusammenarbeit kann ich meinen treuen Blog-Lesern freundlicherweise 10 Lizenzen (Max. 1 Lizenz pro Benutzer) gratis zur Verfügung stellen.
Die ersten 10 Leser welche eine Email mit Betreff: Travel Add-in über das Feedbackformular an mich senden, erhalten eine Travel Add-in Lizenz gratis.

Wenn Sie nicht zu den Gewinnern zählen und Ihnen die Software trotzdem gefällt, können Sie beim Kauf den
Gutscheincode: TRAVELX4U
angeben, sie erhalten auf jede Lizenz einen Rabatt von 30% auf den aktuellen Kaufpreis.

Das Add-in kann heruntergeladen werden, und vor dem Kauf 30 Tage ohne Einschränkungen getestet werden.

Helmut Obertanner

Kostenloses SharePoint eMagazin

Helmut Obertanner — Mon, 18 Jan 2010 20:04:46 GMT

Die Niederländische Benutzergruppe (DIUWG) hat ein SharePoint eMagazin herausgegeben. Das Magazin richtet sich an Entwickler, IT-Profis und Power-Benutzer. Es ist die erste Ausgabe des Magazins und es ist pro Jahr 4 eMagazine und 4 Magazine im Papierformat herauszugeben.

Das Magazin ist in englischer Sprache.

http://www.sdn.nl/IW/FreeMagazine/tabid/139/Default.aspx

Viel Spaß.

Free SharePoint eMagazine

Helmut Obertanner — Mon, 18 Jan 2010 20:00:15 GMT

The Dutch Software Development Network Usergroup (DIWUG) has published an SharePoint eMagazine free for download. It's their first eMagazine and they are planning to release 4 paper and 4 eMagazines per year.

A free magazine for IT-Pro's, Developers and End (power) Users and optimized to read in eReaders.

http://www.sdn.nl/IW/FreeMagazine/tabid/139/Default.aspx

Happy reading.

Outlook Formular per Code schliessen

Helmut Obertanner — Fri, 08 Jan 2010 20:06:23 GMT

In diesem Beispiel möchte ich über meine Erfahrungen zum über das Schliessen eines Formulars per Programmcode berichten.

Vor kurzem habe ich ein Beispiel zum Überprüfen und Absichern von Geschäftsregeln in einem Outlook Add-in berichtet:
http://www.outlooksharp.dehttp://www.x4u.de/Home/tabid/36/EntryId/54/Geschaftsregeln-fur-Outlook-Formulare.aspx

Das Problem:

Implementiert man eine Lösung zum Sicherstellen von Geschäftsregeln möchte man den Benutzer darauf hinweisen, dass irgendetwas nicht korrekt ausgefüllt ist. Dazu kann man dem Benutzer einen modalen Dialog(MessageBox) anzeigen. Ist eine der Regeln ungültig, kann der Benutzer weder speichern – noch das Formular schliessen. Man sollte dem Benutzer aber immer die Möglichkeit geben einen Vorgang abzubrechen. Zu diesem Zweck kann man dem Benutzer im der Close-Benachrichtigung einen Dialog mit zwei Schaltflächen anzeigen z.B. Ok und Abbrechen. Klickt der benutzer in diesem Fall auf Abbrechen – soll das Formular einfach geschlossen werden ohne die modifizierten Daten zu speichern.
Prinzipiell sieht die Lösung wie folgt aus:

///

/// Flag is used to close the Form when Cancel is clicked

///

bool _closeAfterCancel = false;

///

/// Validates the BusinessRules and returns true if all rules are valid

///

/// If true, a OK/Cancel MessageBox is displayed to the user

/// true when all rules are valid

public bool Validate(bool showCancelButton) {

if (Item.Saved) return true;

// Default value

_closeAfterCancel = false;

// if every business rule is valid we return true

if (_BusinessRules.TrueForAll(X4UBusinessRule.IsRuleValid)) return true;

// no ?

// show a warning to the user and

StringBuilder message = new StringBuilder(500);

message.AppendLine("You can't save this Item, because the following requirements are not met:");

foreach (X4UBusinessRule rule in _BusinessRules) {

if (!rule.IsValid()) message.AppendLine(rule.Description);

}

// display a message to the user what's wrong.

DialogResult messageBoxResult = MessageBox.Show (new OutlookWin32Window(Inspector),

message.ToString(), // Message

"Warning!", // Caption

showCancelButton ? MessageBoxButtons.OKCancel : MessageBoxButtons.OK, // Which Buttons should we display

MessageBoxIcon.Exclamation, // The Icon

MessageBoxDefaultButton.Button1 // The Default Button

);

// when OK-Button is clicked, we cancel the Operation

if (showCancelButton && messageBoxResult==DialogResult.Cancel ){

_closeAfterCancel = true;

}

return false;

}

Wenn eine der geschäftsregeln nicht eingehalten wird, liefert die Validate-Methode false zurück.
Klickt der Benutzer auf die Abbrechen-Schaltfläche im angezeigten Dialog, soll das Formular ohne die Daten zu speichern geschlossen werden.
Um das zu erreichen wird ein Flag _closeAfterCancel auf true gesetzt. Normalerweise könnte man jetzt einfach die Methode Inspector.Close(Outlook.OlInspectorClose.OlDiscard) im Item_Close event aufrufen.

///

/// This Method is called when the Item is going to be closed

///

void Item_Close(ref bool Cancel) {

if (!_closeAfterCancel) {

Cancel = !Validate(true); // MessageBox with OK + Cancel Button

if (_closeAfterCancel) {

Inspector.Close(Outlook.OlInspectorClose.olDiscard);

}

Leider musste ich feststellen, dass dies so nicht funktioniert. Anstatt das Formular zu schliessen, wird ein "Möchten Sie die Änderungen Speichern"-Dialog angezeigt.
Außerdem wurden im Outlook Objekt Model(OOM) einige Änderungen durchgeführt, welche eine korrekte Funktion verschiedener Methoden im Close-Event verhindern, siehe KB929593.
Als Lösungsansatz kann man einen Timer starten und im Timer_Tick event die Methode Inspector.Close aufrufen.
So sieht der modifizierte Programmcode dazu aus:

///

/// Used to call Close() out of the Item_Close event.

///

Timer _closeTimer;

///

/// This Method is called when the Item is going to be closed

///

void Item_Close(ref bool Cancel) {

if (!_closeAfterCancel) {

Cancel = !Validate(true); // MessageBox with OK + Cancel Button

if (_closeAfterCancel) {

_closeTimer = new Timer();

_closeTimer.Tick += new EventHandler(_closeTimer_Tick);

_closeTimer.Start();

}

void _closeTimer_Tick(object sender, EventArgs e) {

_closeTimer.Stop();

_closeTimer.Dispose();

// Close the current Form without saving

Inspector.Close(Outlook.OlInspectorClose.olDiscard);

}

Jedoch wenn man dies ausführt kommt folgendes Resultat:

Es wird kein "Möchten Sie die Änderungen Speichern"-Dialog angezeigt
Das Formular wird geschlossen
Die Daten werden gespeichert

Es funktioniert einfach nicht wie gewünscht.
Nach meinen Erkenntnissen ist die einzig funktionierene Form anstatt der Inspector.Close(olDiscard)- die Item.Close(olDiscard)-Mehtode aufzurufen.
Der korrekte Code sieht dementsprechend aus:

void _closeTimer_Tick(object sender, EventArgs e) {

_closeTimer.Stop();

_closeTimer.Dispose();

// Close the current Form without saving

Item.Close(Outlook.OlInspectorClose.olDiscard);

}

Nur mit dieser Implementierung wird das Formular geschlossen ohne die Daten zu speichern.

Herzlichen Dank an Ken Slovak, durch Ihn bin ich auf die korrekte Lösung gekommen.

Viele Grüße – Helmut Obertanner
http://www.x4u.de

Closing an Outlook Inspector by code

Helmut Obertanner — Fri, 08 Jan 2010 19:35:04 GMT

In this post I will share some tips about closing an Inspector without saving changed data programmatically.

Recently I blogged about enforcing BusinessRules within Outlook here:
http://www.outlooksharp.dehttp://www.x4u.de/Home/tabid/36/EntryId/53/Enforcing-business-rules-for-Outlook-Items.aspx

The problem:

If you use BusinessRules in your AddIn and validate the rules at the Item_Write and the Item_Close event you may cancel the current operation and display the user a MessageBox that something went wrong. If the rule isn't successfully validated, the user can't close this form. So you need to give the user the opportunity to close the Form without saving the modified values(discard changes). For this case we can display a MessageBox with two buttons (OK/Cancel) to the user. When the user clicks on Cancel, we just want to close the Form without saving the data.
To archive this, you can use the following code snippet:

///

/// Flag is used to close the Form when Cancel is clicked

///

bool _closeAfterCancel = false;

///

/// Validates the BusinessRules and returns true if all rules are valid

///

/// If true, a OK/Cancel MessageBox is displayed to the user

/// true when all rules are valid

public bool Validate(bool showCancelButton) {

if (Item.Saved) return true;

// Default value

_closeAfterCancel = false;

// if every business rule is valid we return true

if (_BusinessRules.TrueForAll(X4UBusinessRule.IsRuleValid)) return true;

// no ?

// show a warning to the user and

StringBuilder message = new StringBuilder(500);

message.AppendLine("You can't save this Item, because the following requirements are not met:");

foreach (X4UBusinessRule rule in _BusinessRules) {

if (!rule.IsValid()) message.AppendLine(rule.Description);

}

// display a message to the user what's wrong.

DialogResult messageBoxResult = MessageBox.Show (new OutlookWin32Window(Inspector),

message.ToString(), // Message

"Warning!", // Caption

showCancelButton ? MessageBoxButtons.OKCancel : MessageBoxButtons.OK, // Which Buttons should we display

MessageBoxIcon.Exclamation, // The Icon

MessageBoxDefaultButton.Button1 // The Default Button

);

// when OK-Button is clicked, we cancel the Operation

if (showCancelButton && messageBoxResult==DialogResult.Cancel ){

_closeAfterCancel = true;

}

return false;

}

So, if rules are failing the Validate-Method returns false.
If the user clicks on Cancel in the MessageBox, the Form should be closed without saving the data.
To archive this a flag _closeAfterCancel is set to true. Basically you will just call Inspector.Close(Outlook.OlInspectorClose.OlDiscard) in the Item_Close event.

///

/// This Method is called when the Item is going to be closed

///

void Item_Close(ref bool Cancel) {

if (!_closeAfterCancel) {

Cancel = !Validate(true); // MessageBox with OK + Cancel Button

if (_closeAfterCancel) {

Inspector.Close(Outlook.OlInspectorClose.olDiscard);

}

I found out that this just won't work. Instead the AskForSave Dialog is displayed to the user.
Also there where some changes in the Outlook Object Model that prvents that methods working correctly in the Item_Close event, see KB929593.
So I tried to get it working using a timer, and call Inspector.Close in the Timer_Tick event.
See the modified code:

///

/// Used to call Close() out of the Item_Close event.

///

Timer _closeTimer;

///

/// This Method is called when the Item is going to be closed

///

void Item_Close(ref bool Cancel) {

if (!_closeAfterCancel) {

Cancel = !Validate(true); // MessageBox with OK + Cancel Button

if (_closeAfterCancel) {

_closeTimer = new Timer();

_closeTimer.Tick += new EventHandler(_closeTimer_Tick);

_closeTimer.Start();

}

void _closeTimer_Tick(object sender, EventArgs e) {

_closeTimer.Stop();

_closeTimer.Dispose();

// Close the current Form without saving

Inspector.Close(Outlook.OlInspectorClose.olDiscard);

}

When running this code:

no AskForSave dialog is shown
the Form is closed
the data is saved

It just won't work.
The only way to get it working is to call the Item.Close method instead.
So – the correct method would look like this:

void _closeTimer_Tick(object sender, EventArgs e) {

_closeTimer.Stop();

_closeTimer.Dispose();

// Close the current Form without saving

Item.Close(Outlook.OlInspectorClose.olDiscard);

}

Only this way you can correctly close the current Form without saving the data.

My special thanks to Ken Slovak who pointed me to the correct solution.

Greets – Helmut Obertanner
http://www.x4u.de