1.Um ein SQL-Skriptobjekt zu bearbeiten, laden Benutzer die Liste der vorhandenen Elemente, indem sie die Ansicht SQL Scripts im Visual Designer-Modus von PackDesigner aufrufen.
2.Durch Klicken auf das Listenelement des zu ändernden Objekts werden dessen Details im Editor-Panel auf der rechten Seite des RayPack Anwendungsbildschirms angezeigt.
Die folgenden Eigenschaften des SQL-Skriptobjekts können bearbeitet werden:
Skriptname
Der Skriptname wird oberhalb der drei Ansichtsregisterkarten des Bearbeitungsbereichs angezeigt. Er wird durch Klicken auf den Namen selbst oder auf das Bearbeitungssymbol auf der rechten Seite editierbar. Ein direkter Werteditor-Dialog wird angezeigt, in dem der neue Namenswert eingegeben werden kann. Durch Drücken der Taste Enter oder Klicken auf das Symbol Speichern in der Benutzeroberfläche des direkten Werteditors wird der neue Name gespeichert.
Tab: GENERAL
Datenbank
Wählen Sie eines der SQL-Datenbankobjekte aus, die für das aktuelle Paketierungsprojekt erstellt wurden. Wenn die erforderliche Option noch nicht verfügbar ist, muss der Assistent zum Erstellen einer neuen SQL-Datenbank verwendet werden, um eine zum Projekt hinzuzufügen. Dieser Assistent ist über die Ansicht SQL Databases zugänglich.
Benutzer
RayPack ermöglicht das Ausführen von SQL-Skripten entweder über die Windows-Authentifizierung oder als bestimmter Benutzer. Wenn das Kontrollkästchen "Windows-Authentifizierung verwenden" aktiv ist, wird diese Option für das aktuelle SQL-Skript verwendet.
Um die Verwendung individueller Benutzeranmeldeinformationen zu aktivieren, muss das Kontrollkästchen deaktiviert werden. Sobald es inaktiv ist, werden die Steuerelemente für die Benutzerobjektverwaltung für die Benutzerauswahl aktiv.
Individuelle Benutzeranmeldeinformationen müssen in Form eines Benutzerobjekts angegeben werden. Um ein Benutzerobjekt auszuwählen oder zu erstellen, klicken Sie auf die Schaltfläche [...] auf der rechten Seite des Benutzereingabefelds. Der Dialog Benutzer auswählen wird angezeigt. Weitere Informationen zur Verwaltung von Benutzerdatenobjekten finden Sie im Abschnitt Allgemeine Dialoge.
|
Achtung: Benutzerobjekte werden wahrscheinlich an mehreren Stellen innerhalb von SQL-Datenbank-, Skript- und IIS-Verwaltungsstrukturen verwendet. Wenn auf dasselbe Benutzerelement von verschiedenen Stellen aus verwiesen wird, wirken sich Änderungen an den Eigenschaften dieses Benutzerelements tatsächlich auf alle zugehörigen Objekte aus. Bitte überprüfen Sie die Korrektheit von Benutzerprofiländerungen sorgfältig und stellen Sie sicher, dass alle zugehörigen Objekte mit dem geänderten Eigenschaftssatz weiterhin gültig und funktionsfähig sind. |
Komponente
Jedes SQL-Skriptobjekt muss einem Komponentenelement des Paketierungsprojekts zugeordnet sein. RayPack erstellt automatisch eine neue Komponente, wenn ein SQL-Datenbankelement erstellt wird. Es wird empfohlen, SQL-Skripte zur selben Komponente wie das übergeordnete SQL-Datenbankobjekt hinzuzufügen.
Um eine andere vorhandene Komponente als übergeordneten Container des SQL-Skriptelements auszuwählen, klicken Benutzer auf den nach unten zeigenden Pfeil auf der rechten Seite des Komponentenauswahlsteuerelements. Eine Liste der vorhandenen Komponenten wird angezeigt. Die neue Auswahl erfolgt durch Klicken auf eine der angegebenen Komponenten.
Um eine neue Komponente für das SQL-Skriptobjekt zu erstellen, klicken Benutzer auf die Schaltfläche [...] auf der rechten Seite des Komponentensteuerelements. Der allgemeine Dialog vom Typ Komponente auswählen wird angezeigt und ermöglicht das Erstellen und Auswählen von Komponenten.
Reihenfolge
Der ganzzahlige Wert wird schreibgeschützt angezeigt. Die Visual Designer-Benutzeroberfläche ermöglicht keine direkte Änderung des Reihenfolgewerts, jedoch indirekt über die Neuanordnungsoptionen des Kontextmenüs, das beim Rechtsklicken auf SQL-Skript-Listenelemente angezeigt wird. (Execute first und Execute earlier verringern den Reihenfolgewert, während Execute later und Execute last ihn erhöhen.)
|
Tipp: Jeder Wert, der nicht über dedizierte Visual Designer-Benutzeroberflächensteuerelemente bearbeitet werden kann, ist dennoch für Änderungen durch die in der TABLES-Ansicht des Erweiterten Modus bereitgestellten Tools verfügbar. Obwohl der erweiterte Modus erfahrenen Benutzern empfohlen wird, ist er für alle RayPack Benutzer frei zugänglich. |
Attribute
Die Attributspalte der Tabelle RPSqlScript stellt die folgenden Skriptausführungsoptionen bereit:
•Bei Installation ausführen
Das Skript wird ausgeführt, wenn das Paket installiert wird.
•Bei Deinstallation ausführen
Das Skript wird ausgeführt, wenn das Paket deinstalliert wird.
•Bei Fehler fortfahren
Wenn die Skriptausführung einen Fehler verursacht, wird die Paketlaufzeitausführung nicht abgebrochen, unabhängig davon, ob es sich um eine Installation, Reparatur oder Deinstallation handelt.
•Rollback bei Installation
Der Rollback-Mechanismus für dieses SQL-Skript wird ausgeführt, wenn das Paket installiert wird.
•Rollback bei Deinstallation
Der Rollback-Mechanismus für dieses SQL-Skript wird ausgeführt, wenn das Paket installiert wird.
Benutzer können jede Ausführungsoption aktivieren, indem sie das Kontrollkästchen links neben der Optionsbezeichnung auswählen.
|
Achtung: Wenn weder "Bei Installation ausführen" noch "Bei Deinstallation ausführen" ausgewählt sind, wird das Skript möglicherweise nie auf der Zieldatenbank während der Paketlaufzeit ausgeführt. |
Tab: SQL SCRIPT
Die Schnittstellenoptionen für die Registerkarte SQL SCRIPT hängen vom Skriptquellentyp ab, der während der Erstellung des SQL-Skriptobjekts definiert wurde. Wenn das angezeigte Skript geändert werden muss, müssen Benutzer auf die Schaltfläche "SQL-Skript bearbeiten..." oberhalb des Anzeigebereichs für den tatsächlichen Skriptinhalt klicken. Ein neues Dialogfenster wird geöffnet und ermöglicht die Bearbeitung entsprechend dem Quellentyp:
Binär
Benutzer können entweder
•eine andere Binärdatei als Quelle für die Skriptzeichenfolge auswählen
•den Inhalt der aktuell ausgewählten Binärdatei manuell bearbeiten, indem sie die im SQL-Skript-Textbereich angezeigte Zeichenfolge direkt bearbeiten
•den Inhalt der Binärdatei ersetzen, indem neuer Textinhalt aus einer externen *.sql Datei geladen wird
Eigenschaft
Benutzer können entweder
•eine andere Eigenschaft als Quelle für die Skriptzeichenfolge auswählen
•den Inhalt der aktuell ausgewählten Eigenschaft manuell bearbeiten, indem sie die im SQL-Skript-Textbereich angezeigte Zeichenfolge direkt bearbeiten
•den Eigenschaftsinhalt ersetzen, indem neuer Textinhalt aus einer externen *.sql Datei geladen wird
Text
Benutzer können entweder
•den Inhalt der Spalte Target des aktuell aktiven RPSqlScript Datenbanktabellen-Zeilenverweises manuell bearbeiten, indem sie die im SQL-Skript-Textbereich angezeigte Zeichenfolge direkt bearbeiten
•den Inhalt der Spalte Target desselben RPSqlScript Datenbanktabellen-Zeilenverweises ersetzen, indem neuer Textinhalt aus einer externen *.sql Datei geladen wird
Eckige Klammern deaktivieren '[', ']' und aktivieren '[', ']'
Eckige Klammern können entweder als Auslöser für spezielle SQL-Skript-Notationen, wie z. B. begrenzte Bezeichner, oder als einfache Textzeichen ohne besondere Funktionalität betrachtet werden. Um Packager bei der Erstellung sauberer und eindeutiger Quelldefinitionen zu unterstützen, wurde der Schalter für eckige Klammern zum SQL-Skript-Textbereich hinzugefügt.
Eckige Klammern deaktivieren führt zur expliziten Maskierung von eckigen Klammern, was bedeutet, dass jeder öffnenden und schließenden eckigen Klammer ein Maskierungsauslöser vorangestellt wird. Die maskierten Klammerzeichen gelten nicht mehr als Sondernotationen, sondern nur noch als einfache öffnende/schließende Klammerzeichen ohne zusätzliche Funktionalität.
Beispiel:
Der ursprüngliche Text "This is [sample] text" wird zu "This is [\[]sample[\]] text", sobald eckige Klammern deaktiviert werden.
Eckige Klammern aktivieren entfernt die Maskierung von bereits vorhandenen maskierten öffnenden/schließenden Klammerzeichen. Sie gelten wieder als Sonderzeichen (SQL-begrenzte Bezeichner).
Beispiel:
Der ursprüngliche Text "This is [sample] text with different [\[]square[\]] bracket usages." wird zu "This is [sample] text with different [square] bracket usages.", sobald eckige Klammern aktiviert werden.
Änderungen am SQL-Skriptinhalt werden durch Klicken auf die Schaltfläche OK am unteren Rand des Editors gespeichert. Die Schaltfläche OK ist nicht verfügbar, solange das SQL-Skript-Eingabefeld leer ist, da der Skriptinhalt eine Pflichtangabe ist. Durch Klicken auf Abbrechen werden alle nicht gespeicherten Änderungen verworfen und das Dialogfenster wird geschlossen.
|
Achtung: Das Speichern von Änderungen am SQL-Skriptinhalt, der aus einer Binärdatei oder Eigenschaft stammt, ändert tatsächlich den Inhalt dieses spezifischen Paketierungsprojektelements. Wenn andere Funktionen oder Optionen auf dieselbe Binärdatei oder dasselbe Objekt angewiesen sind, müssen sie ebenfalls mit dem geänderten Inhalt interagieren. |
Tab: REPLACEMENT
Wenn Suchen-und-Ersetzen-Aktivitäten für SQL-Skripte zur Ausführung zur Paketlaufzeit erforderlich sind, ist dies die Registerkarte für deren Verwaltung. Durch Klicken auf die Schaltfläche Hinzufügen wird eine neue Ersetzungsaufgabe mit Standardwerten generiert. Sie wird automatisch am Ende der aktuellen Ersetzungsaufgabensequenz hinzugefügt (d. h. an der untersten Position der Aufgabenelementliste).
Um den Eigenschaftswert einer Ersetzungsaufgabe zu ändern, müssen Benutzer auf den Zellwert des Listenelements doppelklicken, das sie ändern möchten. Der aktuelle Wert wird markiert und ist für die direkte Inline-Bearbeitung bereit:
Reihenfolge
Der Reihenfolgewert ist ein ganzzahliger Wert, der die Reihenfolge der Ersetzungsausführung angibt. Das Element mit dem niedrigsten Reihenfolgewert wird zuerst ausgeführt.
Suchen
Die Suchzeichenfolge muss als Klartext angegeben werden. Es gibt keine Unterstützung für die Verwendung von Platzhaltern oder auf regulären Ausdrücken basierenden Suchzeichenfolgen.
Bitte beachten Sie, dass der Standard-Suchalgorithmus Groß-/Kleinschreibung nicht berücksichtigt. Um dies zu ändern, muss der Attributwert 2 für den Ersetzungsauftrag festgelegt werden.
Ersetzen
Die Zeichenfolge, die anstelle des übereinstimmenden Schlüsselworts aus "Suchen" eingefügt wird.
Bitte beachten Sie, dass der Standard-Suchalgorithmus alle Übereinstimmungen ersetzt. Um die Ersetzung nach der ersten Übereinstimmung zu stoppen, muss der Attributwert 4 für den Ersetzungsauftrag festgelegt werden.
Attribute
Benutzer können entweder eine beliebige Kombination der verfügbaren Attributbitwertdarstellungen manuell eingeben oder den Attribut-Editor für diese Eigenschaft verwenden. Um den Attribut-Editor anzuzeigen, müssen Benutzer auf den aktuellen Wert der Attributspalte doppelklicken und die nach unten zeigende Pfeilschaltfläche verwenden. Kontrollkästchen werden sichtbar und ermöglichen die individuelle Aktivierung oder Deaktivierung jeder Attributoption:
1 = Nur ganzes Wort suchen
2 = Groß-/Kleinschreibung beachten
4 = Nur einmal ersetzen
Der Standard-Attributwert für eine Ersetzungsaufgabe ist 1, was bedeutet, dass die Suche Wort für Wort aufgelöst wird.
Um eine Ersetzungsaufgabe zu entfernen, müssen Benutzer sie aus der Liste der vorhandenen Ersetzungen auswählen und die Schaltfläche Entfernen unterhalb der Liste verwenden. Die Aufgabe wird sofort entfernt, ohne einen Bestätigungsdialog.