Verteilen von elektronischen Visitenkarten in Outlook 2007

Pakete mit Beispiellösungen

Die Beispiellösungen sind als IExpress-Dateien gepackt. Wenn Sie auf das IExpress-Paket doppelklicken, werden Sie aufgefordert, einen Speicherort für die Dateien anzugeben.

Die Beispiellösung zur Bereitstellung elektronischer Visitenkarten mithilfe einer Office SharePoint Server 2007-Website heißt Beispiel für die Bereitstellung von elektronischen Visitenkartenvorlagen auf SharePoint . Die Beispiellösung zur Bereitstellung von Visitenkarten mithilfe von .NET heißt Beispiel für die Bereitstellung von elektronischen Visitenkartenvorlagen auf .NET.

Hinweis:
Technische Informationen zu den Outlook-vCard-Spezifikationen können hilfreich sein, wenn Sie eine Lösung zur Verteilung elektronischer Visitenkarten anpassen. Weitere Informationen zu Outlook-vCards finden Sie im Whitepaper Outlook-Erweiterungen für das vCard 2.1-Format, das im Downloadpaket enthalten ist.

Die folgenden Dateien und Ordner sind im SharePoint-Beispiellösungspaket (EBCSharePoint.exe) enthalten:

Die folgenden Dateien und Ordner sind im .NET-Beispiellösungspaket (EBCNet.exe) enthalten:

Übersicht: Arbeiten mit der SharePoint-Beispiellösung

Die Schritte zum Arbeiten mit der SharePoint-Beispiellösung werden nachfolgend beschrieben. Ausführliche Beschreibungen des Beispielcodes finden Sie unter Verwenden einer SharePoint-Website zum Verteilen von Visitenkarten weiter unten in diesem Thema.

Installieren und konfigurieren Sie die folgende Umgebung, um mit der SharePoint-Beispiellösung zu arbeiten:

• Office SharePoint Server 2007 muss auf einem lokalen Computer unter Microsoft Windows Server 2003 oder höher installiert sein.

• Eine Office SharePoint Server 2007-Website muss verfügbar sein und konfigurierte Benutzerprofile enthalten.

Wenn diese Anforderungen erfüllt sind, gehen Sie folgendermaßen vor, um die Lösung für die Umgebung Ihrer Organisation zu installieren und zu konfigurieren. Konfigurieren Sie zunächst die Datei Web.config.

1. Öffnen Sie die Datei Web.config aus dem Downloadpaket in einem Editor, und legen Sie SiteURL auf die URL der SharePoint-Website fest (z. B. IhreSharePointURL).

2. Öffnen Sie die Datei Web.config für Ihre SharePoint-Website in einem Editor, und kopieren Sie den Abschnitt AppSettings aus der Datei Web.config im Downloadpaket in den Abschnitt AppSettings der Datei Web.config der SharePoint-Website. Die Datei Web.config der Website befindet sich im SharePoint-Basisverzeichnis.

3. Speichern Sie die beiden Web.config-Dateien, und beenden Sie die Editoren.

Befolgen Sie diese Anweisungen, um die Datei Web.config für die SharePoint-Website zu suchen.

So ermitteln Sie das Basisverzeichnis einer SharePoint-Website

1. Klicken Sie in Windows im Menü Start auf Verwaltung.

2. Klicken Sie auf Internetinformationsdienste-Manager, und erweitern Sie den Knoten für Ihren Computer.

3. Erweitern Sie Websites, und klicken Sie mit der rechten Maustaste auf die entsprechende Webanwendung (z. B. SharePoint (80)).

4. Klicken Sie auf Eigenschaften.

5. Klicken Sie auf die Registerkarte Basisverzeichnis.

Nachdem Sie die Datei Web.config konfiguriert haben, kompilieren Sie die Lösung, und legen Sie die erforderlichen Dateien in den richtigen Ordnern ab.

So kompilieren Sie die Lösung

1. Öffnen Sie EBCDeploymentExample.sln in Microsoft Visual Studio 2005.

2. Kompilieren Sie das Projekt.

3. Kopieren Sie die kompilierte Assembly, die sich standardmäßig im Ordner bin\debug oder, beim Kompilieren im Releasemodus, im Ordner bin\release befindet, in den globalen Assemblycache. Ausführlichere Anweisungen finden Sie unter Kopieren der Lösung in den globalen Assemblycache im Abschnitt "Verwenden einer SharePoint-Website zum Verteilen von Visitenkarten" weiter unten in diesem Thema.

4. Kopieren Sie EBCDeploymentExample.aspx und den Ordner Templates nach <SharePoint-Installationslaufwerk>\Programme\Gemeinsame Dateien\Microsoft Shared\Web Server Extensions\12\TEMPLATE\LAYOUTS.

Möglicherweise müssen Sie die Berechtigungen für EBCDeploymentExample.aspx ändern, um diese Datei zu kopieren.

Navigieren Sie zu http://IhreSharePointURL/_layouts/EBCDeploymentExample.aspx, um die Beispiellösung anzuzeigen.

Wenn Benutzer auf das Bild einer Karte klicken, wird ein Dialogfeld ähnlich wie in folgendem Beispiel angezeigt:

Wenn Benutzer auf Öffnen klicken, wird die Visitenkarte zu den Kontakten in Outlook hinzugefügt und mit den persönlichen Kontaktinformationen der Benutzer aktualisiert.

Übersicht: Arbeiten mit der .NET-Beispiellösung

Die Schritte zum Arbeiten mit der .NET-Beispiellösung werden nachfolgend beschrieben. Ausführliche Beschreibungen des Beispielcodes finden Sie unter Verwenden einer internen .NET 2.0-Website zum Verteilen von Visitenkarten weiter unten in diesem Thema.

Für die Arbeit mit der .NET-Beispiellösung muss Microsoft Visual Studio 2005 auf dem lokalen Computer installiert sein. Es ist außerdem hilfreich, beim Arbeiten mit der Beispiellösung eine lokale Website zu verwenden.

Konfigurieren Sie die Umgebung für die Verwendung der Beispiellösung.

1. Öffnen Sie in Visual Studio eine vorhandene Website, und wählen Sie den Beispielordner aus.

2. Klicken Sie im Menü Website auf Verweis hinzufügen, und wählen Sie System.DirectoryServices aus.

3. Klicken Sie im Menü Website auf Verweis hinzufügen, und wählen Sie System.Drawing aus.

4. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf EBCDeploymentExample.aspx, und wählen Sie Als Startseite festlegen aus.

5. Bearbeiten Sie die Datei Web.config aus dem Downloadpaket in einem Editor, und legen Sie userName und password auf einen gültigen Benutzernamen und ein gültiges Kennwort für Ihre Domäne fest.

   Hinweis:
   Die Angabe eines Benutzernamens und Kennworts in Klartext in einer Datei ist keine sichere Lösung. Informationen zu einer Lösung mit höherer Sicherheit finden Sie in den folgenden Artikeln: Verwenden des ASP.NET-Dienstprogramms zum Verschlüsseln von Anmeldeinformationen und Verbindungszeichenfolgen mit dem Sitzungsstatus und NET Framework-Entwicklerhandbuch: ASP.NET-Identitätswechsel.

6. Legen Sie in Web.config die Einstellung für ADPath auf einen gültigen Active Directory-Verzeichnisdienst in Ihrem Netzwerk fest.

7. Speichern Sie die Datei Web.config, und beenden Sie den Editor.

Nachdem Sie diese Konfigurationsschritte abgeschlossen haben, können Sie die Beispiellösung anzeigen. Klicken Sie dazu auf Ausführen, um die Website in Visual Studio auszuführen.

Wenn Benutzer auf das Bild einer Karte klicken, wird ein Dialogfeld ähnlich wie in folgendem Beispiel angezeigt:

Wenn Benutzer auf Öffnen klicken, wird die Visitenkarte zu den Kontakten in Outlook hinzugefügt und mit den persönlichen Kontaktinformationen der Benutzer aktualisiert.

Erstellen einer Visitenkarte in einem neuen Outlook-Kontakt

Der erste Schritt beim Bereitstellen einer elektronischen Visitenkarte, die Benutzer herunterladen können, besteht darin, eine Visitenkarte als Vorlage zu entwerfen. Erstellen Sie hierzu eine Visitenkarte in einem neuen Outlook-Kontakt.

So erstellen Sie eine elektronische Visitenkarte in Outlook

1. Zeigen Sie im Menü Datei auf Neu, und klicken Sie auf Kontakt.

2. Geben Sie einen Namen für den Kontakt ein (z. B. Beispielvisitenkarte).

3. Geben Sie die Informationen ein, die auf den Visitenkarten erscheinen sollen. Angenommen, die Visitenkarten sollen folgende Angaben umfassen:

   • Vollständiger Name

   • Position

   • Firma

   • Telefon geschäftlich

   • Fax geschäftlich

   • E-Mail-Adresse

Schließen Sie alle Elemente ein, die auf der Visitenkarte angezeigt werden sollen. Spezifische Elemente für eine Person werden mit den persönlichen Informationen dieser Person aufgefüllt, wenn diese die Visitenkarte herunterlädt. Andere Elemente, z. B. die geschäftliche Faxnummer, können für jeden in der Organisation gleich sein.

Nachdem Sie die Visitenkarten mit den Beispielinformationen erstellt haben, klicken Sie auf der Multifunktionsleiste des Kontaktelements auf Visitenkarte, um den Editor für elektronische Visitenkarten zu öffnen.

Entwerfen Sie im Editor das Layout und die gewünschten Features der Visitenkarte. Sie können beispielsweise ein Unternehmenslogo importieren. Klicken Sie dazu im Bereich Kartenentwurf auf Ändern. Passen Sie das Layout, den Bereich und die Ausrichtung des Bilds an, bis das Logo an der gewünschten Position auf der Karte angezeigt wird.

Passen Sie die Textfelder so an, dass der Text in der gewünschten Reihenfolge und in der richtigen Größe und Farbe angezeigt wird. Sie können auch die Hintergrundfarbe ändern.

Klicken Sie auf Speichern und schließen, um die Änderungen zu speichern.

Speichern einer elektronischen Visitenkartenvorlage auf einem Webserver

Als Nächstes speichern Sie die Visitenkarte als Datei auf dem Webserver, auf dem sich die Website befindet, von der Visitenkarten in der Vorschau angezeigt und heruntergeladen werden.

So speichern Sie eine elektronische Visitenkarte als Datei auf dem Webserver

1. Klicken Sie auf den Kontakt, den Sie erstellt haben, um ihn zu markieren.

2. Klicken Sie im Menü Datei auf Speichern unter.

3. Wechseln Sie in der Liste Speichern in in einen Ordner auf dem Webserver, in dem die Vorlagen gespeichert werden sollen.

4. Geben Sie im Feld Dateiname einen beschreibenden Namen für die Datei ein, z. B. büro.vcf.

5. Klicken Sie in der Liste Dateityp auf vCard-Dateien (*.vcf)|.

Erstellen eines Vorschaubilds der elektronischen Visitenkarte

Wenn Sie mehrere Visitenkartenentwürfe haben, können Sie den Benutzern die Entscheidung erleichtern, indem Sie Vorschaubilder der Visitenkartenvorlagen bereitstellen.

So stellen Sie ein Vorschaubild einer Visitenkartenvorlage bereit

1. Öffnen Sie in Outlook das Kontaktelement mit der Visitenkarte, die Sie entworfen haben und als Vorlage verwenden möchten.

2. Klicken Sie im geöffneten Kontaktelement mit der rechten Maustaste auf das Visitenkartenbild.

3. Klicken Sie im Kontextmenü auf Bild kopieren.

4. Klicken Sie in Microsoft Paint im Menü Extras auf Bearbeiten.

5. Klicken Sie auf Einfügen, um das Vorschaubild einzufügen.

6. Klicken Sie im Menü Extras auf Datei.

7. Klicken Sie auf Speichern, und wählen Sie den Ordner aus, in dem Sie die vCard zuvor gespeichert haben.

Erstellen eines C#-Klassenbibliothekprojekts

Durch das Erstellen einer Klassenbibliothek wird Ihr Projekt für das Kompilieren einer Assembly konfiguriert. Die kompilierte Assembly kann später in den globalen Assemblycache (GAC) kopiert werden. Damit EBCDeploymentExample.aspx und EBCDeploymentExample.aspx.cs in SharePoint zusammen funktionsfähig sind, muss EBCDeploymentExample.aspx auf eine Assembly im GAC verweisen, die den kompilierten C#-Code aus EBCDeploymentExample.aspx.cs enthält.

So erstellen Sie ein neues C#-Assemblyprojekt in Visual Studio

1. Klicken Sie in Visual Studio im Menü Datei auf Neu und dann auf Projekt.

2. Klicken Sie im Dialogfeld Neues Projekt im Bereich Projekttypen auf Visual C#.

3. Klicken Sie im Bereich Vorlagen auf Klassenbibliothek.

4. Geben Sie im Feld Name einen Namen für das Projekt ein (z. B. EBCDeploymentExample). Geben Sie einen Speicherort an, oder verwenden Sie den Standardspeicherort.

5. Klicken Sie auf OK.

   
   

Signieren der Assembly mit einem Schlüssel für einen starken Namen

Damit die kompilierte Assembly in SharePoint vertrauenswürdig ist, muss sie mit einem Schlüssel für einen starken Namen signiert werden. Sie können die kompilierte Assembly mithilfe des Schlüssels für einen starken Namen signieren, der in der Beispiellösung in der Datei ExampleAssembly.snk enthalten ist, oder Sie können einen eigenen Schlüssel für einen starken Namen erstellen.

So signieren Sie eine kompilierte Assembly mit dem Schlüssel für einen starken Namen aus dem Beispiel

1. Öffnen Sie in Visual Studio den Projektmappen-Explorer.

2. Klicken Sie mit der rechten Maustaste auf EBCDeploymentExample, und klicken Sie auf Eigenschaften.

3. Aktivieren Sie auf der Registerkarte Signieren das Kontrollkästchen Assembly signieren.

4. Klicken Sie in der Liste Schlüsseldatei mit starkem Namen auswählen auf Durchsuchen.

5. Navigieren Sie im Dialogfeld Datei öffnen zur Datei ExampleAssembly.snk, und klicken Sie auf Öffnen.

6. Klicken Sie im Menü Datei auf Speichern, um die Änderung zu speichern.

   
   

Weitere Informationen zu Schlüsseln für starke Namen und zum Signieren von Assemblys finden Sie in den folgenden Ressourcen: .NET Framework-Entwicklerhandbuch: Erstellen von Assemblys und .NET Framework-Entwicklerhandbuch – Gewusst wie: Signieren einer Assembly mit einem starken Namen.

Angeben von Optionen für die benutzerdefinierte Lösung

Damit die Beispiellösung in Ihrer Umgebung funktionsfähig ist, müssen Sie Servercode mit den folgenden Informationen bereitstellen:

• Speicherort der Vorlagen, die auf der Seite für elektronische Visitenkarten angezeigt werden sollen

• Format der Miniaturbilder für die einzelnen Visitenkarten; dieses Format ist die Erweiterung, die Sie beim Speichern der Visitenkartenvorschauen verwendet haben, z. B. .jpg

• URL der SharePoint-Website, auf der diese Lösung ausgeführt wird

Die Datei Web.config von SharePoint ermöglicht die bequeme Bereitstellung dieser Informationen für den Servercode. Die Datei Web.config befindet sich im Basisverzeichnis der SharePoint-Website. Gehen Sie wie weiter oben in diesem Thema unter So ermitteln Sie das Basisverzeichnis einer SharePoint-Website im Abschnitt Übersicht: Arbeiten mit der SharePoint-Beispiellösung beschrieben vor, um das Basisverzeichnis einer SharePoint-Website zu ermitteln.

Kopieren Sie die Parameter aus der Datei Web.config, die in der heruntergeladenen Beispiellösung enthalten war, in den Abschnitt appSettings Ihrer Datei Web.config für SharePoint. Ändern Sie den Wert für siteURL in die URL Ihrer lokalen SharePoint-Website. Aktualisieren Sie ggf. die Werte für die Einstellungen templatePath und templateFormat.

<configuration>

...

</appSettings>

<add key="templatePath" value="~/_layouts/Templates" />

<add key="templateFormat" value="jpg" />

<add key="siteURL" value="http://example" />

...

</appSettings>

...

</configuration>

Hinzufügen erforderlicher Verweise

Damit die Beispiellösung funktionsfähig ist, müssen Sie der Lösung bestimmte Verweise hinzufügen. Fügen Sie der Lösung in Visual Studio die folgenden Verweise hinzu, indem Sie mit der rechten Maustaste auf das Projekt EBCDeploymentExample klicken und dann auf Verweis hinzufügen klicken:

• System

• System.Configuration

• System.Drawing

• System.Web

• Microsoft.SharePoint

• Microsoft.Office.Server

Die Beispiellösung verwendet SharePoint-Benutzerprofile als Datenquelle für Mitarbeiterkontaktinformationen. Der folgende Abschnitt enthält ausführliche Informationen zur Verwendung von Benutzerprofilen in der Beispielanwendung. Das Arbeiten mit Benutzerprofilen ist bequemer, wenn Sie in den Code bestimmte Verweise aufnehmen. Fügen Sie der Datei EBCDeploymentExample.aspx.cs den folgenden Code hinzu:

using System;

...

using Microsoft.SharePoint;

using Microsoft.Office.Server.UserProfiles;

Abrufen von Kontaktinformationen durch Zugreifen auf SharePoint-Benutzerprofile

SharePoint-Benutzerprofile stellen eine einheitliche Anwendungsprogrammierschnittstelle (Application Programming Interface, API) für den Zugriff auf SharePoint-Benutzerdaten bereit, unabhängig von der ursprünglichen Datenquelle (z. B. Active Directory oder ein LDAP-Verzeichnis). In der Beispiellösung stellen Benutzerprofile die Mitarbeiterkontaktinformationen bereit, mit denen die Visitenkarte vervollständigt wird.

Gehen Sie folgendermaßen vor, um die Mitarbeiterkontaktinformationen abzurufen und eine Visitenkarte aufzufüllen:

1. Suchen des SharePoint-Benutzerprofils für den Mitarbeiter, der eine Visitenkarte zum Herunterladen ausgewählt hat

2. Erstellen von Eigenschaften für jedes Element (Name, Position usw.)

3. Extrahieren des Werts für jedes Element aus dem Benutzerprofil

Suchen Sie zunächst das SharePoint-Profil des Benutzers. Verwenden Sie dazu die PopulateCard()-Funktion in der Beispiellösung.

// Obtain the location of this SharePoint site.

String siteURL = ConfigurationManager.AppSettings["siteURL"];

// Create a Profile Manager for this site.

UserProfileManager profileManager = new UserProfileManager(Microsoft.Office.Server.ServerContext.GetContext(new SPSite(siteURL)));

// Find the identity of the user accessing this page.

string sAccount = this.User.Identity.Name;

// Get the SharePoint profile for the user with the given identity.

UserProfile user = profileManager.GetUserProfile(sAccount);

Erstellen Sie als Nächstes die Eigenschaften für jedes Element.

UserProfileValueCollection givenName = null;

UserProfileValueCollection lastName = null;

UserProfileValueCollection jobTitle = null;

UserProfileValueCollection email = null;

UserProfileValueCollection phone = null;

UserProfileValueCollection company = null;

Rufen Sie die Werte für die Eigenschaften aus dem Benutzerprofil ab. Eigenschaften, die standardmäßig nicht in Benutzerprofilen enthalten sind, können beim Synchronisieren von SharePoint mit der Benutzerdatenquelle zu den Benutzerprofilen hinzugefügt werden. Beispielsweise ist company keine Standardeigenschaft für Benutzerprofile. In diesem Beispielcode ist company dem company-Feld in dem Verzeichnis zugeordnet, das Mitarbeiterkontaktdaten für SharePoint bereitstellt.

givenName = user[PropertyConstants.FirstName];

lastName = user[PropertyConstants.LastName];

jobTitle = user[PropertyConstants.Title];

email = user[PropertyConstants.WorkEmail];

phone = user[PropertyConstants.WorkPhone];

company = user["company"];

Weitere Informationen zum Definieren zusätzlicher SharePoint-Benutzerprofileigenschaften finden unter Personalisierungsdienste in SharePoint-Produkten und -Technologien (in englischer Sprache).

Verwenden von Websitevorlagen für ein einheitliches Aussehen

Neue Seiten auf einer SharePoint-Website können problemlos so konfiguriert werden, dass sie dem Erscheinungsbild der Website entsprechen. Geben Sie eine Masterseitendatei an, und fügen Sie anschließend ASP:Content-Abschnitte für Header, Footer und alle anderen gemeinsamen Bereiche der Seiten auf Ihrer SharePoint-Website hinzu, damit sich die neue Seite nahtlos in den Rest der Website einfügt.

Damit eine Seite, die von SharePoint gehostet wird, auf eine kompilierte Assembly zugreifen kann (z. B. EBCDeploymentExample.aspx), muss die Seite auf den Namen, die Version und das öffentliche Schlüsseltoken für die Assembly verweisen. Geben Sie diese Werte mithilfe des Inherits-Parameters an, wie im folgenden Beispiel veranschaulicht.

Sowohl die Masterseitendatei als auch der Inherits-Parameter werden im <Page>-Tag ganz oben in EBCDeploymentExample.aspx festgelegt.

<%@ Page Language="C#" MasterPageFile="~/_layouts/simple.master" ValidateRequest="False" Inherits="EBCDeployment.Example, EBCDeploymentExample, Version=1.0.0.0, Culture=neutral, PublicKeyToken=0bac7bedd8e30aa1" %>

Die Inhaltsabschnitte geben an, welche SharePoint-Standardkomponenten einer SharePoint-Websitevorlage folgen. Der folgende Inhaltsabschnitt veranschaulicht, wie Sie der Websitevorlage folgen können.

<asp:Content ID="PageTitle" ContentPlaceHolderId="PlaceHolderPageTitle" runat="server">

<SharePoint:EncodedLiteral ID="EncodedLiteral1" runat="server" text="Electronic Business Cards" EncodeMethod='HtmlEncode'/>

</asp:Content>

Hosten der neuen Seite auf der SharePoint-Website

Zum Hosten der neuen Seite in SharePoint platzieren Sie die Seite im virtuellen SharePoint-Verzeichnis LAYOUTS. Kopieren Sie dazu die Datei EBCDeploymentExample.aspx in den folgenden Ordner:

1. <Systemlaufwerk>:\Programme\Gemeinsame Dateien\Microsoft Shared\Web Server Extensions\12\TEMPLATE\LAYOUTS

   Benutzer können nun an folgendem Speicherort auf die Seite zugreifen:

2. http://Beispiel/_layouts/EBCDeploymentExample.html.

   Dabei steht Beispiel für den Namen der SharePoint-Website.

Kopieren der Lösung in den globalen Assemblycache

Die letzten Schritte bei der Implementierung der SharePoint-Beispiellösung bestehen darin, die Assembly zu kopieren und sie in den globalen Assemblycache (GAC) zu kopieren, wobei EBCDeploymentExample für den Zugriff darauf konfiguriert ist. Kopieren Sie die kompilierte Assembly (EBCDeploymentExample.dll) aus <Projektordner>\bin\debug in den globalen Assemblycache. Dieser befindet sich unter <Systemlaufwerk>:\windows\assembly. Beim Kompilieren im Releasemodus befindet er sich im Ordner bin\release statt \bin\debug.

Zum Kopieren der Assembly in den neuen Ordner öffnen Sie beide Ordner in Windows Explorer. Ziehen Sie dann die DLL-Datei aus dem Ordner \debug in den Ordner des globalen Assemblycaches.

Hinweis:
Möglicherweise müssen Sie die Internetinformationsdienste (Internet Information Services, IIS) zurücksetzen, bevor die neue SharePoint-Seite auf die Assembly zugreifen kann und funktionsfähig ist. Zum Zurücksetzen von IIS öffnen Sie ein Windows-Befehlsfenster, und geben Sie iisreset ein.

Nun können Sie zu http://IhreSharePointURL/_layouts/EBCDeploymentExample.aspx navigieren, um die Beispiellösung anzuzeigen.

Öffnen einer aktuellen Website in Visual Studio

Zum Arbeiten mit der .NET-Beispiellösung aus dem Downloadpaket öffnen Sie eine lokale Website in Microsoft Visual Studio (VS) 5.0, und navigieren Sie zu dem Ordner, der die Beispiellösung enthält. Wenn Sie eine vorhandene Website in VS öffnen, erkennt das VS-Projekt die Beziehung zwischen den Dateien EBCDeploymentExample.aspx und EBCDeploymentExample.aspx.cs. Die Konfiguration der Website wird automatisch aus der Datei Web.config der Beispiellösung importiert.

So verwenden Sie eine vorhandene Website mit der Beispiellösung in Visual Studio

1. Klicken Sie in Visual Studio im Menü Datei auf Öffnen und dann auf Website.

2. Wechseln Sie zu dem Ordner, der die Beispiellösung aus dem Downloadpaket enthält.

3. Klicken Sie auf OK.

Angeben von Optionen für die benutzerdefinierte Lösung

Damit die Beispiellösung in Ihrer Umgebung funktionsfähig ist, müssen Sie Servercode mit den folgenden Informationen bereitstellen:

• Speicherort der Vorlagen, die auf der Seite für elektronische Visitenkarten angezeigt werden sollen

• Format der Miniaturbilder für die einzelnen Visitenkarten; dieses Format ist die Erweiterung, die Sie beim Speichern der Visitenkartenvorschauen verwendet haben, z. B. .jpg

• Ordnerpfad des Active Directory-Verzeichnisdiensts, von dem die Mitarbeiterdaten zur Personalisierung der Visitenkartenvorlagen bereitgestellt werden

• Authentifizierungsmethode, z. B. Windows-Authentifizierung.

• Anmeldeinformationen für den Identitätswechsel

Außerdem könnten Sie Assemblyverweise für den Visual Studio-Compiler bereitstellen. Verweise, die für die Beispiellösung erforderlich sind, werden in einem späteren Abschnitt in den Anweisungen unter "Hinzufügen erforderlicher Verweise" bereitgestellt.

In der Datei Web.config der Website können Sie diese Informationen bequem für den Servercode zur Verfügung stellen. Öffnen Sie die Datei Web.config in der Beispiellösung, um die Parameterwerte für Ihre Konfiguration festzulegen.

<configuration>

<appSettings>

<add key="templatePath" value="~/Templates"/>

<add key="templateFormat" value="jpg"/>

<add key="ADPath" value="LDAP://ServerName.exchange.yourdomain.com/DC=exchange, DC=yourdomain,DC=com "/>

</appSettings>

<system.web>

<authentication mode="Windows"/>

<identity impersonate="true" userName="username"password="password"/>

</system.web>

</configuration>

Es ist wichtig, für den ADPath-Parameter einen gültigen Active Directory-Verzeichnisdienst anzugeben. Die Parameter userName und password stellen den Benutzernamen und das Kennwort für das Dienstkonto der Website dar. Es ist sicherer, die Werte mit den Anmeldeinformationen zu verschlüsseln, als sie in Klartext zu belassen. Weitere Informationen zum Verschlüsseln von Anmeldeinformationen finden Sie unter Verwenden des ASP.NET-Dienstprogramms zum Verschlüsseln von Anmeldeinformationen und Verbindungszeichenfolgen mit dem Sitzungsstatus.

Hinzufügen erforderlicher Verweise

Sie müssen der Lösung bestimmte Verweise hinzufügen, damit die Beispiellösung funktionsfähig ist. Klicken Sie in Visual Studio mit der rechten Maustaste auf das Projekt EBCDeploymentExample, und klicken Sie auf Verweis hinzufügen, um der Lösung die folgenden Verweise hinzuzufügen.

• System

• System.Configuration

• System.DirectoryServices

• System.Web

Der System.DirectoryServices-Verweis ist für das Verbinden mit und Abfragen von Active Directory erforderlich.

Das Arbeiten mit Active Directory ist komfortabler, wenn Sie in den Code bestimmte Verweise aufnehmen. Fügen Sie in EBCDeploymentExample.aspx.cs den folgenden Verweis hinzu:

...

Using System.DirectoryServices;

Verbinden mit Active Directory

Zum Verbinden mit Active Directory erstellen Sie einen DirectoryEntry-Parameter mit der Active Directory-Pfadvariablen (ADPath):

DirectoryEntry de = new DirectoryEntry(ConfigurationManager.AppSettings["ADPath"]);

Abfragen von Active Directory nach Mitarbeiterkontaktinformationen

Verwenden Sie für Active Directory-Abfragen nach Mitarbeiterkontaktinformationen die DirectorySearcher-Funktion. Erstellen Sie die Funktion mithilfe des im vorherigen Abschnitt erstellten DirectoryEntry-Parameters.

DirectorySearcher ds = new DirectorySearcher(de);

Bestimmen Sie als Nächstes die Identität des Websitebesuchers. Entfernen Sie die Domäne von der Identität des Benutzers, und stellen Sie sicher, dass nur Daten für den Benutzer mit dem richtigen Alias abgerufen werden. In diesem Beispiel wird davon ausgegangen, dass das E-Mail-Adressformat in Ihrer Organisation alias@ihredomäne.com lautet.

string longAlias = this.User.Identity.Name;

int start = longAlias.IndexOf("\\"); // Parse away the domain name.

int end = longAlias.Length; // Get the length of the alias.

string alias = longAlias.Substring(start + 1, (end - (start + 1)));

ds.Filter = "(mailnickname=" + alias + ")";

Geben Sie als Nächstes die Eigenschaften des Outlook-Kontakts (vCard) an, der abgerufen wird, damit sie später aktualisiert werden können.

ds.PropertiesToLoad.Add("givenName"); // Get the given name.

ds.PropertiesToLoad.Add("sn"); // Get the surname.

ds.PropertiesToLoad.Add("title"); // Get the job title.

ds.PropertiesToLoad.Add("mail"); // Get the email address.

ds.PropertiesToLoad.Add("telephoneNumber"); // Get the phone number.

ds.PropertiesToLoad.Add("company"); // Get the company name.

Durchsuchen Sie das Verzeichnis nach dem Benutzer mit dem angegebenen Alias, und speichern Sie die Ergebnisse in einer SearchResultCollection-Auflistung.

SearchResultCollection data = ds.FindAll();

Zugreifen auf Kontaktinformationen in Active Directory-Abfrageergebnissen

Nachdem Sie die Kontaktinformationen aus Active Directory abgerufen haben, verwenden Sie diese Informationen zum Personalisieren der Mitarbeitervisitenkarte.

Bevor Sie auf Kontaktinformationen in Active Directory-Abfrageergebnissen zugreifen, erstellen Sie Eigenschaften für die Kontaktinformationen.

PropertyValueCollection givenName = null;

PropertyValueCollection lastName = null;

PropertyValueCollection jobTitle = null;

PropertyValueCollection email = null;

PropertyValueCollection phone = null;

PropertyValueCollection company = null;

Suchen Sie dann die Werte für die Eigenschaften im Resultset.

// In case invalid data was returned, try...

try

{

// Get the properties needed for the EBC.

DirectoryEntry resultEntry = data[0].GetDirectoryEntry();

givenName = resultEntry.Properties["givenName"];

lastName = resultEntry.Properties["sn"];

jobTitle = resultEntry.Properties["title"];

email = resultEntry.Properties["mail"];

phone = resultEntry.Properties["telephoneNumber"];

company = resultEntry.Properties["company"];

}

catch (Exception)

{

// Create a writer for error output.

StreamWriter sw = new StreamWriter(Response.OutputStream);

sw.WriteLine("Error updating template!");

sw.Close();

}

Wenn der Mitarbeiter die Visitenkarte herunterlädt, wird sie mit den Kontaktinformationen des Mitarbeiters aufgefüllt.