Technik:Abo-System

Voraussetzungen

Das xp_cmdshell-Feature für den SQL Server muss aktiviert werden, damit die Abonnements ausgeführt werden können (Weitere Informationen dazu finden Sie hier).

Sofern Sie Abos von SQL Server Reporting Services Berichten erstellen wollen, muss der Benutzer des von xp_cmdshell erzeugten Prozesses am Berichtsserver der Berichts-Generator- und Browser- oder der Inhaltsmanager-Rolle angehören.

Des Weiteren muss der SQL Server-Agent Dienst gestartet sein.

Der Benutzer, unter dem der SQL Server Agent ausgeführt wird benötigt die folgenden Rechte:

• Er muss die AboExecutor.exe ausführen können
• Bei Emailversand braucht der Benutzer die Rechte auf das angegebene Konto am SMTP, dass er Emails versenden darf

Für den Abo-Executor müssen die Konfigurationsdateien „ClientConfig.xml„ und „ClientSettings.dat“ (z.B. aus dem Clientverzeichnis kopieren) zur Verfügung gestellt werden.

In der AboExecutor.exe.config muss zumindest das PowerUser Passwort ergänzt werden.

Hinweis  Das Abo-System für Sql Server Reporting Services ist nur für Berichte geeignet, die mit der CoPlanner Reporting Services Integration auf reine CoPlanner-Daten zugreifen. Der Zugriff über Analysesichten auf Olap-Würfel wird aus technischen Gründen nicht unterstützt, da das Abo-System üblicherweise mit einem Serviceaccount ausgeführt wird und der Olap-Zugriff nur mit SSPI möglich ist.

Hinweis  Bei der Verwendung des Abo-Systems mit Berichten der Sql Server Reporting Services ist auf die Anmeldeinformationen für die Datenquelle zu achten. Die volle Funktionalität (Berechtigungen für die Benutzer) ist nur dann gegeben, wenn für die Anmeldeinformationen der Modus zur Eingabe der Anmeldeinformationen auffordern eingestellt ist. Bei Windows Authentifizierung wird das Abonnement immer im Kontext von xp_cmdshell ausgeführt.

AboExecutor.exe.config

In der Datei "AboExecutor.exe.config" im Verzeichnis "\server\AboExecutor" wird der E-Mail Versand konfiguriert. Folgende Einträge sind zu beachten:

<?xml version="1.0" encoding="utf-16" standalone="yes"?>
<configuration>
   <appSettings>
   <add key="abo" value="633964077278817699"/>
   <add key="user" value="PowerUser"/> 
   <add key="pass" value="UserPasswort"/> 
   <add key="maxAttachmentSizeInKB"value="1000"/>
   </appSettings>

   <system.net>
   <mailSettings>
      <smtp deliveryMethod="Network" from="aboexecutor@coplanner.com">
         <network
            host="psad001.graz.coplanner.com"
            port="25"
            defaultCredentials="true"
            />
      </smtp>
   </mailSettings>
 </system.net>
</configuration>

Das abo-Attribut kann vernachlässigt werden, da das durch den Job für das Abo entsprechend gesetzt wird.

Gültige Einträge für das user-Attribut sind der PowerUser, Partner oder Hersteller.

Bei dem pass-Attribut muss das entsprechende Passwort für den User eingetragen werden.

maxAttachmentSizeInKB: Die maximale Attachment-Größe bei E-Mail Versand in kB, wenn "0" oder nicht vorhanden, dann unlimitiert.

Das deliveryMethod-Attribut gibt die Übermittlungsmethode für E-Mails an. Zulässige Werte sind "network", "pickupDirectoryFromIis" und "specifiedPickupDirectory".

Das from-Attribut gibt die Absenderadresse für E-Mails an.

Das specifiedPickupDirectory-Attribut legt das Verzeichnis fest, in dem Anwendungen E-Mail-Nachrichten zur späteren Verarbeitung mit dem SMTP-Server speichern. Im Beispiel ist "c:\temp\pickup" als E-Mail-Pickup-Verzeichnis angegeben.

Das network-Attribut konfiguriert die Netzwerkoptionen für einen externen SMTP-Server.

Wichtig!  Sofern bei der Aufsetzung des Database-Mails ein User eingetragen und somit nicht das Häkchen "anonymous authentication" gesetzt wurde, muss in der AboManager-config der selbe Benutzer hinterlegt werden. Die zu verwendende Syntax kann diesem Link entnommen werden: network-settings

Architektur (Customizing)

Für jedes im CoPlanner-Client angelegte Abonnement wird vom CoPlanner Server ein Auftrag im SQL Server Agent erzeugt. Der Auftrag besteht aus einem einzigen T-SQL-Schritt, der die gespeicherte Prozeder dbo.ExecReportAbo mit der COPSYS_ID des Abonnements aufruft.

Der Auftrag wird laut Zeitplan ausgeführt, kann aber auch manuell im CoPlanner-Client angestoßen werden.

dbo.ExecReportAbo

Diese gespeicherte Prozedur wird aus dem SQL Server Agent-Auftrag aufgerufen. Diese – und nur diese – Prozedur darf bei Bedarf angepasst werden. Die Aufgaben von dbo.ExecReportAbo sind:

• Ermitteln des Pfades zum Abo-Executor

In einer Standardkonfiguration befindet sich der Abo-Executor AboExecutor.exe im Unterverzeichnis AboExecutor im CoPlanner Server-Verzeichnis.

• Ermitteln des Pfades zur Konfigurationsdatei „ClientConfig.xml“

In einer Standardkonfiguration befindet sich diese im Abo-Executor-Verzeichnis.

• Festlegen des Benutzernamens und Passworts für den CoPlanner-Benutzer, mit dem sich der Abo-Executor zum CoPlanner Server verbindet

In einer Standardkonfiguration wird der PowerUser mit einem leeren Passwort verwendet. Der Abo-Executor funktioniert nur mit den Benutzern PowerUser, Partner und Hersteller.

• Festlegen weiterer Parameter für den Abo-Executor

In einer Standardkonfiguration werden keine sonstigen Parameter übergeben.

Mit der ID des Abonnements und diesen Parametern wird die gespeicherte Prozedur dbo.ExecReportAboInternal aufgerufen.

Wichtig!  Diese Prozedur muss angepasst werden, wenn Applikations- und SQL-Server auf unterschiedlichen Servern laufen.

dbo.ExecReportAboInternal

Diese gespeicherte Prozedur darf nicht angepasst werden bzw. kann durch ein CopVersion überschrieben werden. Sie erstellt die Kommandozeile für den Abo-Executor, ruft diesen per xp_cmdshell auf und schreibt die Log-Tabellen.

Logging

Jede Abonnement-Ausführung (automatisch und manuell) wird in den Tabellen

• dbo.tb_ExecReportAboLog
• dbo.tb_ExecReportAboLogMsg

mit protokolliert. Die Tabellen enthalten für jedes Abonnement das Ergebnis der letzten Ausführung.

Spalte	Beschreibung
AboId	ID des Abonnements
AboName	Name des Abonnements
ExecTime	Zeitpunkt der Ausführung (bzw. wann wurde der Log-Datensatz erstellt)

Spalte	Beschreibung
AboId	ID des Abonnements
LineNr	Zeilennummer der Ausgabe
MsgTyp	Typ der Zeile MsgTyp Beschreibung Kein Typ Zeilen ohne Typ sind reine Informationszeilen. Auch Exceptions werden ohne Typ in die Log-Tabelle eingefügt, da sich diese Zeilen nicht leicht automatisch erkennen lassen. WRN Warnmeldungen, die vom Berichtsserver beim Rendern der Berichte ausgegeben werden. ERR Fehlermeldungen, die vom Berichtsserver beim Rendern der Berichte ausgegeben werden. VAR Das sind spezielle, vom Abo-Executor erstellt Zeilen, über die in weiteren Abfragen oder in Berichten Informationen abgerufen werden können.
MsgLine	Text der Zeile Die Spalte MsgLine hat in diesen Zeilen immer den Aufbau Variable:=Wert Derzeit ist nur die Variable AboName definiert, die den Namen des Abonnements liefert.