Wie zu Datenbank hinzufügen-script in DNN benutzerdefinierte Modul-Entwicklung-Paket?

Willkommen in der Entwicklung für Portal, wo Sie die offizielle website bietet null Dokumentation und alles gelernt, vom Experimentieren, blogs, Foren und Websites versuchen, Sie zu verkaufen etwas.

Ich vorschlagen, gehen in Ihre DNN-root-Ordner und öffnen Sie die /Install/Module/UsersOnline_05.01.00_Install.Ressourcen-Datei. Es ist nur ein zip-Archiv umbenannt .Ressourcen. Innerhalb dieses Archiv ist der verpackte "Benutzer Online" - Modul und das ist das Beispiel, das ich bin gehen zu Fuß durch.

Wenn Sie bereits Ihre .DNN xml-Paket erstellt für das Modul, das Sie hinzufügen müssen, um eine neue <component> Eintrag zu lassen, DNN wissen für die Ausführung Ihrer SQL-Skripts während der installation:

...snip...
<components>
    <component type="Script">
      <scripts>
        <basePath>DesktopModules\UsersOnline</basePath>
        <script type="Install">
          <path>Providers\DataProviders\SqlDataProvider</path>
          <name>04.09.04.SqlDataProvider</name>
          <version>04.09.04</version>
        </script>
        <script type="Install">
          <path>Providers\DataProviders\SqlDataProvider</path>
          <name>05.01.00.SqlDataProvider</name>
          <version>05.01.00</version>
        </script>
        <script type="UnInstall">
          <path>Providers\DataProviders\SqlDataProvider</path>
          <name>Uninstall.SqlDataProvider</name>
          <version>05.01.00</version>
        </script>
      </scripts>
</component>
...snip...

Während der Modul-installation, DNN ausführen des Skripts eingetragen, die hier in der Reihenfolge Ihrer Versionsnummer. Wenn das aktuelle Modul installiert wird, nie installiert wurde, dann würde es in dieser Reihenfolge Durchlaufen:

1. 04.09.04
2. 05.01.00

Wenn das Modul wurde bereits installiert und wird aktualisiert (aus 04.09.04), es würde überspringen Sie die Vorherige Versionen " - Skripte (vorausgesetzt, Sie haben bereits ausgeführt wurden) und führen Sie einfach die neuere 05.01.00 Skript mitbringen sollte alles up to date. Es ist Ihre Verantwortung, zu erstellen Sie Ihre SQL-Skripten zur Unterstützung der integrierten upgrade-Mechanismus.

Gibt es auch eine "UnInstall" - Skript, welches ausgeführt wird, wenn der Benutzer die un-installiert das Modul. So können Sie bereinigen, nachdem Ihr Modul.

Jede SQL-Skript enthält die T-SQL-Befehle, die erforderlich sind, um Ihr Modul, schema, Standard-Daten, gespeicherte Prozeduren, etc. Hier ist ein Ausschnitt der OnlineUsers Moduls Skript:

/************************************************************/
/*****              SqlDataProvider                     *****/
/*****                                                  *****/
/*****                                                  *****/
/***** Note: To manually execute this script you must   *****/
/*****       perform a search and replace operation     *****/
/*****       for {databaseOwner} and {objectQualifier}  *****/
/*****                                                  *****/
/************************************************************/

if exists (select * from dbo.sysobjects where id = object_id(N'{databaseOwner}[{objectQualifier}DNNUOL_GetOnlineUsers]') and OBJECTPROPERTY(id, N'IsProcedure') = 1)
    DROP PROCEDURE {databaseOwner}{objectQualifier}DNNUOL_GetOnlineUsers
GO

CREATE PROCEDURE {databaseOwner}{objectQualifier}DNNUOL_GetOnlineUsers
@PortalID int,
@IncludeHosts bit
AS
IF @IncludeHosts = 0
BEGIN
SELECT 
    UO.UserID,
    U.UserName,
    U.DisplayName,
    U.FirstName, 
    U.LastName, 
    U.FirstName + ' ' + U.LastName AS FullName
FROM
    {databaseOwner}{objectQualifier}UsersOnline UO INNER JOIN {databaseOwner}{objectQualifier}Users U ON UO.UserID = U.UserID INNER JOIN {databaseOwner}{objectQualifier}UserPortals UP ON U.UserID = UP.UserID
WHERE
    UO.PortalID = @PortalID AND UO.UserID = U.UserID AND UP.Authorised = 1 AND U.IsSuperUser = 0 -- Inner Join takes care of SU = 0, but for sanity.
END
ELSE
BEGIN
SELECT DISTINCT
    UO.UserID,
    U.UserName,
    U.DisplayName,
    U.FirstName, 
    U.LastName, 
    U.FirstName + ' ' + U.LastName AS FullName
FROM
    {databaseOwner}{objectQualifier}UsersOnline UO INNER JOIN {databaseOwner}{objectQualifier}Users U ON UO.UserID = U.UserID, {databaseOwner}{objectQualifier}UserPortals UP
WHERE
    UO.PortalID = @PortalID AND UO.UserID = U.UserID AND UP.Authorised = 1
END
GO

/************************************************************/
/*****              SqlDataProvider                     *****/
/************************************************************/

Hinweis: die Verwendung von {databaseOwner} und {objectQualifier} vor jeder Tabelle oder Prozedur in der Datenbank erstellt werden. Diese sind Platzhalter und werden ersetzt, die zur Laufzeit mit den Einstellungen von der installation der web.config-Datei. Grundsätzlich können Sie davon ausgehen, diese werden ersetzt mit "dbo"." aber wenn Sie verkaufen Ihr Modul oder Bereitstellung an Dritte, für die installation müssen Sie die Unterstützung für benutzerdefinierte Eigentümer und Qualifizierer.

Hier sind einige zusätzliche Ressourcen:

• Erstellen von DotNetNuke SqlDataProvider Dateien Mit SSMS
• Erstellen von DotNetNuke® Umfrage-Modul (für DNN 4.0, aber immer noch hilfreich)