Abfragen des Active Directory mit dem Skripttask
Anwendungen für die Verarbeitung von Unternehmensdaten, wie z. B. Integration Services-Pakete, müssen Daten häufig unterschiedlich verarbeiten, je nach Stellung, Berufsbezeichnung und anderen Eigenschaften der Mitarbeiter, die im Active Directory gespeichert sind. Active Directory ist ein Microsoft Windows-Verzeichnisdienst, der einen zentralen Speicher für Metadaten nicht nur über Benutzer, sondern auch über andere Werte des Unternehmens, wie etwa über Computer und Drucker, bereitstellt. Der System.DirectoryServices-Namespace in Microsoft .NET Framework stellt Klassen für die Verwendung mit Active Directory bereit, sodass Sie den Datenverarbeitungsworkflow anhand der darin gespeicherten Informationen weiterleiten können.
.gif "Hinweis") Hinweis |
|---|
Wenn Sie einen Task erstellen möchten, den Sie einfacher in mehreren Paketen wiederverwenden können, empfiehlt es sich, den Code in diesem Skripttaskbeispiel als Ausgangspunkt für einen benutzerdefinierten Task zu verwenden. Weitere Informationen finden Sie unter Entwickeln eines benutzerdefinierten Tasks. |
Beschreibung
Im folgenden Beispiel werden Name, Titel und Telefonnummer eines Mitarbeiters anhand des Werts der email-Variable, die die E-Mail-Adresse des Mitarbeiters enthält, aus dem Active Directory abgerufen. Mithilfe von Rangfolgeneinschränkungen im Paket kann anhand der abgerufenen Informationen und der Berufsbezeichnung des Mitarbeiters beispielsweise bestimmt werden, ob eine E-Mail-Nachricht mit niedriger Priorität oder eine Seite mit hoher Priorität gesendet werden soll.
So konfigurieren Sie dieses Skripttaskbeispiel
Erstellen Sie die drei Zeichenfolgenvariablen email, name und title. Geben Sie eine gültige Unternehmens-E-Mail-Adresse als Wert der email-Variable ein.
Fügen Sie auf der Seite Skript im Skripttask-Editor die email-Variable der ReadOnlyVariables-Eigenschaft hinzu.
Fügen Sie die Variablen name und title zur ReadWriteVariables-Eigenschaft hinzu.
Fügen Sie im Skriptprojekt dem System.DirectoryServices-Namespace einen Verweis hinzu.
. Verwenden Sie im Code eine Imports-Anweisung, um den DirectoryServices-Namespace zu importieren.
| Hinweis |
|---|
Damit dieses Skript ausgeführt werden kann, muss im Netzwerk des Unternehmens Active Directory verwendet werden. Zudem müssen die in diesem Beispiel verwendeten Mitarbeiterinformationen im Unternehmen gespeichert werden. |
Code
Public Sub Main()
Dim directory As DirectoryServices.DirectorySearcher
Dim result As DirectoryServices.SearchResult
Dim email As String
email = Dts.Variables("email").Value.ToString
Try
directory = New _
DirectoryServices.DirectorySearcher("(mail=" & email & ")")
result = directory.FindOne
Dts.Variables("name").Value = _
result.Properties("displayname").ToString
Dts.Variables("title").Value = _
result.Properties("title").ToString
Dts.TaskResult = ScriptResults.Success
Catch ex As Exception
Dts.Events.FireError(0, _
"Script Task Example", _
ex.Message & ControlChars.CrLf & ex.StackTrace, _
String.Empty, 0)
Dts.TaskResult = ScriptResults.Failure
End Try
End Sub
public void Main()
{
//
DirectorySearcher directory;
SearchResult result;
string email;
email = (string)Dts.Variables["email"].Value;
try
{
directory = new DirectorySearcher("(mail=" + email + ")");
result = directory.FindOne();
Dts.Variables["name"].Value = result.Properties["displayname"].ToString();
Dts.Variables["title"].Value = result.Properties["title"].ToString();
Dts.TaskResult = (int)ScriptResults.Success;
}
catch (Exception ex)
{
Dts.Events.FireError(0, "Script Task Example", ex.Message + "\n" + ex.StackTrace, String.Empty, 0);
Dts.TaskResult = (int)ScriptResults.Failure;
}
}
Externe Ressourcen
- Technischer Artikel Processing Active Directory Information in SSIS (Verarbeiten von Active Directory-Informationen in SSIS) unter social.technet.microsoft.com
|
.gif "Integration Services (kleines Symbol)")
Bleiben Sie mit Integration Services auf dem neuesten Stand