===== Benutzung und Einsatz des SQL-Dump-Konverters =====
==== 1. Erstellen einer Strukturdatei mittels phpMyAdmin ====
  - Starten Sie phpMyAdmin und öffnen Sie die benötigte Datenbank.
  - Klicken Sie oben in der Menüleiste auf **Exportieren**. Es erscheint dann ein Bildschirm ähnlich dem folgenden.
  - Wählen Sie **alle** benötigten Tabellen Ihres Addons aus.
  - Machen Sie alle weiteren Einstellungen sinngemäß der Vorlage.
  - Starten sie den Download durch Klick auf den **OK**-Button ganz unten.
  - Speichern Sie die empfangene *.sql Datei auf Ihrem Rechner ab.
{{ :dev:all:exportstructwith-phpmyadmin.gif?nolink |}}
==== 2. Konvertieren der *.sql Datei ====
Normalerweise geht es jetzt an's Eingemachte. Aus dem Dump mit viel Handarbeit sehr viele Zeilen schöne PHP-SQL Statements basteln, die dann einzeln zum Server gesendet werden.\\
Das ist uns zu umständlich, deshalb machen wir das 'etwas' einfacher:

  - Erst einmal wird der Konverter gestartet, indem dieser Link [[http://isteasy.de/otools/ConvertDump/?b=a20zw3|SQL-Dump-Konverter]] angeklickt wird.
  - Nachdem der Konverter gestartet ist, mit **Durchsuchen** die soeben erzeugte Dump-Datei auswählen.
  - Eventuell noch den Präfix der Tabellen an den in der Ursprungs-Datenbank benutzten anpassen.
  - Falls keine weiteren Sonderwünsche bestehen: **Konvertierung starten** anklicken.
  - nach wenigen Augenblicken wird die konvertierte Datei bereits zum Download angeboten.
  - Die neu erzeugte Datei auf dem Rechner speichern, fertig.
//(Zu Beruhigung der um den Datenschutz Besorgten: Es wird weder die Quell- noch die Zieldatei auf dem Server gespeichert.)//

{{ :dev:all:sqldumpconverter.gif?nolink |}}

==== 3. Einbinden der Strukturdatei (nur ab 2.8.4) ====
Nichts einfacher als das.\\
Dazu muss einfach nur die install-struct.sql in das Hauptverzeichnis des Addons (dort wo auch die install.php zu finden ist) kopiert werden. Der nachfolgende Code zeigt die Einbindung in die Dateien //install.php//, //uninstall.php// und //upgrade.php// eines Addons.

<code php install-upgrade.php>
<?php
// Must include code to stop this file being accessed directly
/* -------------------------------------------------------- */
    if (!defined('SYSTEM_RUN')) { die('Cannot access this file directly'); }
/* -------------------------------------------------------- */
// --- process import file to create addons tables ----------
    $sSqlStructFile = __DIR__.'/install-struct.sql';
    if (is_readable($sSqlStructFile)) {
        $oImporter = new SqlImport(WbDatabase::getInstance(), $sSqlStructFile);
        if ($oImporter->doImport(__FILE__)) {
// --- finish process import file ---------------------------------
// --- begin all other individual stuff ---------------------------

    /*
     * do all other stuff
     */

// --- end of all other individual stuff --------------------------
        } else {
            $aError[] = $oImporter->getError();    
        } //endif
        unset($oImporter);
    } else {
        $aError[] = 'missing or not readable file \"'.basename(__DIR__).'/install-struct.sql\"';
    } //endif
/* **** END INSTALL / UNINSTALL / UPGRADE *********************************** */
</code>
<code php uninstall.php>
<?php
// Must include code to stop this file being accessed directly
/* -------------------------------------------------------- */
    if (!defined('SYSTEM_RUN')) { die('Cannot access this file directly'); }
/* -------------------------------------------------------- */
// --- begin all other individual stuff ---------------------------

    /*
     * do all other stuff
     */

// --- end of all other individual stuff --------------------------
// --- process import file to delete addons tables ----------
    $sSqlStructFile = __DIR__.'/install-struct.sql';
    if (is_readable($sSqlStructFile)) {
        $oImporter = new SqlImport(WbDatabase::getInstance(), $sSqlStructFile);
        if (!$oImporter->doImport(__FILE__)) {
            $aError[] = $oImporter->getError();
        }
        unset($oImporter);
    } else {
        $aError[] = 'missing or not readable file \"'.basename(__DIR__).'/install-struct.sql\"';
    } //endif
// --- finish process import file ---------------------------------
/* **** END INSTALL / UNINSTALL / UPGRADE *********************************** */
</code>

Ich würde dazu gerne noch mehr schreiben, aber DAS war es bereits. Mehr gibt es nicht zu tun.

PS: das obige Codebeispiel kann durch simples anklicken des Labels auch heruntergeladen werden....\\
 --- //[[manuela@isteam.de|Manuela v.d.Decken]]  08.09.2014//
----