Neu: Makro-Sammlung auf Redscope

Dieser Beitrag gibt einen Überblick über die neue Funktion einer Makro-Sammlung auf Redscope.org. Die Makro-Sammlung ist seit dem 12.6. für alle angemeldeten Nutzer von Redscope freigegeben.

Die Makro-Sammlung wird im linken Block-Menü in folgender Form angezeigt:

Home

Durch Anklicken der Überschrift dieses Blocks wird im Zentrum der Seite die Makro-Sammlung angezeigt.

Durch Anklicken der Makro-Pakete im Frame links oben werden darunter die einzelnen Makros und im rechten Teil des Fensters (sofern vorhanden) die Dokumentation zu dem Makro-Paket angezeigt.

Home

Durch Anklicken eines Makros im Frame links unten wird im rechten Teil des Fensters der Quellcode des Makros angezeigt.

Home

Durch Anklicken des Tabs 'Eigene Makros' gelangt man in die Funktion zur Verwaltung eigener Makros. Diese Funktion erlaubt u.a. das Bereitstellen (Upload) eigener Makros auf Redscope. Sie ist daher nur für Mitglieder freigeschaltet, deren Email-Adresse eine Authentifizierung von Mitgliedern erlaubt. (ich@gmx.de zählt z.B. nicht zu dieser Gruppe ;-)

Durch Eintragen einer ".sas"-Datei im Feld "Datei oder Archiv" und Drücken von "Deploy" wird die eingetragene Datei auf den Redscope-Server gestellt und in die Makro-Sammlung aufgenommen.

Home

Das neu eingestellte Makro kann nun unter dem Paketname "org.redscope.[Benutzername]" ([Benutzername] ist der Name des angemeldeten Redscope-Benutuzers) von allen Benutzern abgerufen werden.

Home

Durch Eintragen des genannten Paketnamens im Feld "Paket oder Makro" und Drücken von "Delete" werden alle Makros des eingetragenen Pakets aus der Makro-Sammlung wieder entfernt.

Home

Soviel für's Erste. - Will heißen: Wir wollen in allernächster Zeit eine weitere Funktion der Makro-Sammlung freischalten, die den Zugriff auf die Makro-Sammlung direkt aus SAS heraus erlaubt. Es wird dann möglich sein, in einem laufenden SAS-Programm auf Redscope zuzugreifen und sich Makros zu Ausführung auf den lokalen Rechner zu laden.

Über Feedback zur Makro-Sammlung freuen wir uns natürlich sehr. Wir haben zu diesem Zweck die Möglichkeit aktiviert, die Seite auf der die Makro-Sammlung angezeigt wird einfach mit einem Kommentar zu versehen.

Rahmenbedingungen Teilnahme MakroSammlung

Hallo zusammen,

mich würde interessieren, welche Rahmenbedingungen erfüllt sein sollten für die Teilnahme an der MakroSammlung (insbesondere die Form der separaten Dokumentation, Inline-Kommentare und Code-Style). Bei der Gelegenheit bräuchte ich auch noch einen Tipp, wie die externe Doku abgelegt sein soll.
Noch ein Riesen-Lob für die Idee sowie den Ausblick, nun Macros zentral aus einem SAS-Programm zu nutzen. Das Thema liegt schon lange auf meiner Wunschliste, allein schon bei mehreren versionierten Projekten, die auf unterschiedlichen Servern laufen, gibt es hier Schwierigkeiten. Bin sehr gespannt auf die weiteren Schritte!
Viele Grüße
Tobias Endt

SAS-Makro-Sammlung FAQs, die erste

Hallo Herr Endt,

... habe mir erlaubt, Ihre Fragen - auch die aus dem anschließenden Mail-Verkehr - zu einem kleinen FAQ zu kompilieren um sie der ganzen Community zugänglich zu machen.

Los geht's.


Was muss ich tun, damit ich den Reiter "Eigene Makros" sehen kann?

Das Veröffentlichen von Makros ist generell allen Mitgliedern möglich, deren E-Mail-Adresse eine sichere Identifikation der Person erlaubt. Kurz gesagt ist das immer dann der Fall, wenn es sich um eine Firmen-Email-Adresse handelt oder wenn die Mail-Domain eindeutig einer Person zuzuordnen ist.


Unter welchen lizenzrechtlichen Bestimmungen werden die Makros veröffentlicht?

Die Lizenz ist unsererseits nicht festgelegt. GPL oder LGPL freut uns natürlich, aber generell gilt: Die Lizenz sollte wie es in der Open Source Community guter Brauch ist, in jedem Programm in einem Kommentar am Beginn des Programms genannt sein.

Z.B. in dieser Form:

 /*
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of the GNU General Public License as
  * published by the Free Software Foundation; either version 2 of the
  * License, or (at your option) any later version.
  *
  * This program is distributed in the hope that it will be useful, but
  * WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  * General Public License for more details.
  *
  * The GNU General Public License is published by the Free Software
  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
  * USA at:
  *
  *    http://www.opensource.org/licenses/gpl-license.php
  */


Einige Makros benötigen einiges an (separater) Dokumentation, bei einigen würde ich auch gerne Beispiele für eine zugrundeliegende Datenstruktur o.ä. mitgeben.

Wie kann man SAS-Code, HTML-/PDF-Dokumentation, CSV-Datei so paketieren, dass es eine logische Einheit ergibt?

In der Beschreibung zur Sammlung ist ein Beispiel mit HTML-Doku abgebildet. Was ist beim Upload zu beachten?

Dokumentation mit hochzuladen ist denkbar einfach: Anstelle einer "*.sas"-Datei kann man eine Datei "index.html" hochladen. Diese Datei wird beim Anklicken des Benutzer-Packets (org.redscope.[Benutzer]) dann als Einstieg in die Dokumentation angezeigt.

In der "index.html" kann man Links (relative Links zur "index.html"!) verwenden um weitere Seiten / Dokumente anzuzeigen - z.B. auch PDFs. PDFs (und alle anderen Dateitypen) können ebenfalls mit der Upload-Funktion unter "Meine Makros" hochgeladen werden.

Bei umfangreicheren Makro-Bibliotheken gibt's (potentiell, s.u.) noch die Möglichkeit, ZIP-Archive anstelle einzelner Dateien hochzuladen. ZIP-Archive dienen dem veröffentlichen von Makro-Sammlungen unter einer anderen Domain als der Redscope-Benutzer-Domain (org.redscope.[Benutzer]). Um dieses Thema geht's in der nächsten Frage.


Kann ich auch Makros unter meiner eigenen Domain einstellen?

Das Servlet, das hinter der Makro-Samlung steht, kann das grundsätzlich. Allerdings ist die Autorisierungsfunktion noch nicht so an Redscope angebunden, dass der Upload von Makros in andere Packete als Benutzer-Pakete funktionieren würde. Ich schau mir mal an, mit welchem Aufwand das zu machen ist und melde mich dann an dieser Stelle wieder.