Bildbibliotheken dienen [...]]]> In SharePoint gibt es schon seit mehreren Versionen die Bildbibliothek. In SharePoint 2010 dazugekommen ist die Objektbibliothek, die sich u.a. auch für Bilder eignet. Häufig wird noch aus Gewohnheit (oder wegen der griffigeren Bezeichnung) die Bildbibliothek verwendet, dabei hat die Objektbibliothek einige interessante Funktionalitäten. Hier im Artikel sind einige Infos dazu zusammengefasst.

Bildbibliotheken (Image Libraries)

Bildbibliotheken dienen als Ablage für Bitmap- bzw. Rastergrafiken. Sie bieten folgende Funktionalitäten bzw. Eigenschaften:

• Es werden folgende Formate unterstützt: BMP, GIF, ICO, JPEG, PNG und TIFF
• Es stehen drei Ansichtsformate zur Verfügung:
  - Details (Listenansicht)
  - Miniaturansicht (mit Bildvorschau)
  - Filmstreifen (mit größerer Bildvorschau des selektierten Bildes)
• Eine Bildschirmpräsentation (Diashow) kann über das Aktionen-Menü gestartet werden
• Für das Hochladen mehrerer Bilder auf einmal wird der Microsoft Picture Manager verwendet. Damit kann ein Anwender nicht einfach den Computer/das Netzwerk nach Bildern durchsuchen sondern muss sich erst eine Bildverknüpfung anlegen. Dafür bietet der Picture Manager grundlegende Werkzeuge zur Bildbearbeitung (Größe ändern, Zurechtschneiden…).
• Bilder können aus der Bibliothek heraus mit dem Picture Manager bearbeitet werden
• Ausgewählte Bilder können heruntergeladen und ggf. in ein anderes Dateiformat konvertiert werden (volle Größe, Vorschau, Miniaturansicht, benutzerdefinierte Größe)
• Beim Hochladen werden manche Metadaten automatisch übernommen (Bilderstellungsdatum, Autor…)
• In Suchergebnissen werden Bilder in Bildbibliotheken als Miniaturansicht angezeigt
• Bildbibliotheken unterstützen keine Datenblattansicht, d.h. die Mehrfachbearbeitung von Metadaten ist nicht möglich
• Es wird keine Vorschau mit weiteren Eigenschaften/Funktionen angezeigt beim Berühren einer Miniaturansicht mit der Maus
• Die Bildbibliothek wird nicht mit der aktuelle Benutzeroberfläche (Menüband) angezeigt

Hinweis: Wenn Dateien in anderen Formaten hochgeladen werden, wird u.a. keine Vorschau angezeigt. Dies gilt ebenfalls für Grafiken im Vektorvormat (PSD, EPS…) wie für PDF-Dateien.

Objektbibliothek (Asset Libraries)

In Medienbibliotheken können ebenfalls Bilder sowie zusätzlich Audio- und Videodateien abgespeichert werden. Hier die Funktionalitäten und Eigenschaften:

• Es werden folgende Bildformate unterstützt: BMP, GIF, ICO, JPEG, PNG und TIFF

• Weiterhin werden diverse Video- (MPEG4, WMV) und Audioformate (MP3, WMA, WAV) unterstützt. Die vollständige Auflistung hier:
  http://msdn.microsoft.com/en-us/library/cc189080(VS.95).aspx

• Es stehen zwei Ansichtsformate zur Verfügung:
  - Miniaturansicht (Bilder werden direkt angezeigt, für Videos und Audiodateien werden entsprechende Standardgrafiken angezeigt, die über die Eigenschaften angepasst werden können)
  - Details (Listenansicht)

• Das Hochladen mehrerer Dateien gleichzeitig funktioniert wie bei Dokumentenbibliotheken per Drag & Drop

• Beim Hochladen werden manche Metadaten automatisch übernommen, falls erweiterte Bilddaten ebenfalls übernommen werden sollen (Kamera, GPS-Daten…), können zusätzliche Spalten eingerichtet werden wie hier beschrieben: http://blogs.msdn.com/b/michaelp/archive/2011/05/13/automatic-metadata-extraction-of-digital-assets-in-sharepoint-2010.aspx

• Die Datenblattansicht wird unterstützt, d.h. Mehrfachbearbeitung von Metadaten ist möglich

• In der Miniaturansicht wird beim Berühren mit der Maus eine Vorschau der Datei angezeigt, von dort aus können weitere Aktionen gestartet werden (Video abspielen…)

• Die Medienbibliothek unterstützt die grafische Benutzeroberfläche (Menüband)

• Bilder in Objektbibliotheken werden in Suchergebnissen nicht als Miniaturansicht angezeigt, hier ein möglicher Workaround, der jedoch in der Zentraladministration von SharePoint eingerichtet werden muss:
  http://www.sharepointblog.com/2010/11/image-content-type-thumbnails-in-2010.html

Hier muss eine Einstellung in der Zentraladministration von SharePoint 2010 erfolgen, und zwar unter Anwendungsverwaltung – Dienstanwendungen verwalten. Selektieren Sie dort den [...]]]> Wer in einer Liste oder Bibliothek eine Spalte vom Typ "Verwaltete Metadaten" hinzufügen möchte und dort die Option "Ausdruckssatz anpassen" wählt, erhält möglicherweise die Fehlermeldung "Der Standardterminologiespeicher für diese Website kann nicht identifiziert werden":

Hier muss eine Einstellung in der Zentraladministration von SharePoint 2010 erfolgen, und zwar unter Anwendungsverwaltung – Dienstanwendungen verwalten. Selektieren Sie dort den gewünschten Managed Metadata Service, d.h. die dazugehörige Verbindung…

… und wählen dann im Menüband die Eigenschaften. Aktivieren Sie nun im Fenster die Option "Diese Dienstanwendung ist der Standardspeicherort für spaltenspezifische Ausdruckssätze.

Int32.Parse(e.Result.Elements().First().Attribute("ItemCount").Value)

Dabei ist e ein Object vom Typ GetListItemsCompletedEventArgs

Um zum Beispiel Null-Pointer Exceptions zu vermeiden, kann man vor dem ersten Lesen eines Items folgende Zeile voranstellen:

if (Int32.Parse(e.Result.Elements().First().Attribute("ItemCount").Value) == [...]]]> In diesem Beispiel möchte ich zeigen, wie man die Anzahl der gelesenen Items ermitteln kann, die aus einer SharePoint Liste via Web Services ausgelesen wurden.

Der Ausdruck sieht so aus.

Int32.Parse(e.Result.Elements().First().Attribute("ItemCount").Value)

Dabei ist e ein Object vom Typ GetListItemsCompletedEventArgs

Um zum Beispiel Null-Pointer Exceptions zu vermeiden, kann man vor dem ersten Lesen eines Items folgende Zeile voranstellen:

if (Int32.Parse(e.Result.Elements().First().Attribute("ItemCount").Value) == 0) return;

Voraussetzung:

einbinden der Bibliothek

using System.Linq;

In dieser PDF-Datei finden Sie alle Funktionalitäten und Webparts nach SharePoint-Version und –Bereich!

Für Fragen kontaktieren Sie uns – wir freuen uns auf Sie.

Diese werden auf Attribute gemappt. Wenn ein Attribut fehlt, weil [...]]]> Dieser Blog beschreibt, wie man mit einer Silverlight-Anwendung ein BPOS-ListItem updaten kann, das  eventuell leere Felder hat. Das Grundproblem besteht darin, dass man zuerst das Item laden muss, bevor es aktualisiert werden kann. Aus verständlichen Performance-Gründen sendet der Web Service aber nur Felder mit Inhalt.

Diese werden auf Attribute gemappt. Wenn ein Attribut fehlt, weil es im Item keinen Inhalt hat, dann laufen wir auf einen Fehler wenn wir auf das Attribut zugreifen um es in unsere Eingabemaske zu schreiben.

Zwei Lösungsansätze – Attribute hinzufügen oder vor jedem Zugriff testen

Attribute hinzufügen

In der beschriebenen BPOS-Lösung wurde eine interaktive Eingabemaske erstellt, die sowohl zum Anlegen als auch zum Aktualisieren eines Items verwendet wird.

Die zugrundeliegende Tabelle sieht in diesem Beispiel so aus:

Dabei wird das zu aktualisierende Item über den Namen gesucht, der in einem AutoComplete-Feld eingeben wird.

Ich habe dabei folgende Abfrage entwickelt, die eine Helpermethode zum erzeugen der Query verwendet.Die Enumeration ClubListen dient dazu, die verschiedenen asynchronen Requests zu identifizieren.

XElement query = XDocument.Parse(this.makeCamelID(this.AutoNamen.Text)).Element("Query");

this.flagListe = ClubListen.MITGLIED_EINFUEGEN;
proxy.GetListItemsAsync(ListenGUID.Mitglieder, null, query, null, null, null, null);

Die Methode wird beim Klick auf den Button Einfügen ausgelöst.

Die registrierte Callback-Methode sieht dann so aus:

void proxy_GetListItemsCompleted(object sender, GetListItemsCompletedEventArgs e)
        {
          ….. // Code ausgelassen  

       if (flagListe == ClubListen.MITGLIED_EINFUEGEN)
            {
                this.populateMaske(e);

            }

      …… // Code ausgelassen

 

        }

Ich rufe die Helpermethode populateMaske(e) auf, der als Parameter das Ergebnis des asynchronen Request übergeben wird. Und in dieser Methode wird dann das eingangs beschriebene Problem gelöst.

Die Methode ist relativ lang. Deshalb wird sie hier in kleinen Modulen beschrieben.

In einem ersten Schritt sorge ich dafür, dass fehlende Attribute erzeugt und mit einem Standardwert belegt werden. Dazu brauche ich einen String, der alle Attribute, die ich erwarten muss, enthält. Dieser String mappt in gewisser Weise die  Eingabemaske.

String suchString = "ows_Title;ows_FirstName;ows_WorkAddress;ows_WorkZip;ows_WorkCity;ows_HomePhone;";
suchString += "ows_Email;ows_Geburtstag;ows_Abteilung;ows_Posten;ows_Mitglied_seit;ows_ID";

Als nächste erzeuge ich ein XElement, welches das für die Maske relevante Element aus dem XML des asynchronen Requests extrahiert. Dazu muss man natürlich den Aufbau des Response kennen. Dieser wird aber noch an anderer Stelle in einem Blogbeitrag beschrieben werden.

XElement element = e.Result.Elements().First().Elements().First();

In diesem Element finde ich aber nur die Attribute der Felder des Items, die nicht leer sind.

Deshalb müssen wir nun schauen, welche Attribute fehlen.

IEnumerable<XAttribute> attribute = element.Attributes();
String[] myAttribute = new String[attribute.Count()];

            int i = 0;
            foreach (XAttribute attribut in attribute)
            {
                myAttribute[i] = attribut.Name.ToString();
                i++;
            }

            foreach (String s in suchString.Split(‘;’))
            {
                if (!myAttribute.Contains(s))
                {
                    XAttribute x = new XAttribute(s, "");
                    element.Add(x);
                }
            }

Als erstes erzeugen ich  eine iterierbare Attribut-Collection. Deren Anzahl dient zur dynamischen Erzeugen eines String-Arrays, in das ich den Namen der Attribute schreiben.

  int i = 0;
            foreach (XAttribute attribut in attribute)
            {
                myAttribute[i] = attribut.Name.ToString();
                i++;
            }

Jetzt weis ich, welche Attribute, sprich Felder, übertragen wurden.

Im nächsten Schritt lege ich alle Attribute an, die nicht übertragen wurden, weil die Felder im SharePoint-Item leer waren.

foreach (String s in suchString.Split(‘;’))
           {
               if (!myAttribute.Contains(s))
               {
                   XAttribute x = new XAttribute(s, "");
                   element.Add(x);
               }
           }

Finde ich das Attribut, genauer seinen Namen nicht, weil es nicht im String enthalten ist, dann erzeuge ich das Attribut und füge es dem XElement zu.

Jetzt kann ich alle meine Maskenfelder füllen. Sollten zukünftig weitere Felder hinzukommen, muss ich lediglich den Suchstring erweitern.

Vor jedem Zugriff Testen, ob das Attribute vorhanden ist

Bei diesem Ansatz habe ich ein Array mit allen möglichen Attributen erstellt, die ich in die Eingabemaske schreiben möchten. Ein Ausschnitt des Arrays sieht dann so aus:

            this.mAttribute[1] = "ows_FirstName";
            this.mAttribute[2] = "ows_Title";
            this.mAttribute[3] = "ows_Strasse";
            this.mAttribute[4] = "ows_WorkZip";
            this.mAttribute[5] = "ows_WorkCity";

Beim Befüllen der Maske überprüfe ich vor jedem Zugriff, ob es das Attribut gibt. Wenn ja, schreibe ich seinen Inhalt, Value, in das entsprechende Eingabefeld.

           if (myAttribute.Contains(mAttribute[1])) this.txtName.Text = element.Attribute(mAttribute[1]).Value;
           if (myAttribute.Contains(mAttribute[2])) this.txtNachname.Text = element.Attribute(mAttribute[2]).Value;
           if (myAttribute.Contains(mAttribute[3])) this.txtStrasse.Text = element.Attribute(mAttribute[3]).Value;
           if (myAttribute.Contains(mAttribute[4])) this.txtPLZ.Text = element.Attribute(mAttribute[4]).Value;
           if (myAttribute.Contains(mAttribute[5])) this.txtOrt.Text = element.Attribute(mAttribute[5]).Value;

Bei entsprechendem Aufbau der Eingabemaske kann mit wenig Aufwand die Eingabemaske um weiteren Feldern erweitert werden. Dazu muss dann lediglich das Array erweitert werden.

Ich selektieren über einen  XML.Linq Ausdruck alle [...]]]> Dieser Beitrag beschreibt, wie man eine Silverlight AutoComplete Box mit dem Inhalt einer BPOS-Liste füllen kann. In diesem Blog beschreibe ich nur diese Funktion und gehe davon aus, dass die Liste asynchron über den Web Service Lists.asmx ausgelesen wurde. Das Ergebnis steht dann in e.Result (eine XML-Auflistung von Datensätzen).

Ich selektieren über einen  XML.Linq Ausdruck alle Elemente des ersten Elements unterhalb des Root-Elements. Hier gibt es das Attribut “ows_FullName”, dessen Value als String in eine typisierte Liste geschrieben wird.

var dieListe = (from x in e.Result.Elements().First().Elements()
                           select x.Attribute(“ows_FullName”).Value);
this.AutoFamilie.ItemsSource = dieListe;

In unserer Silverlight-Anwendung habe ich eine AutoComplete Box definiert.

Der Box wird als ItemSource-Eigenschaft die Liste dieListe zugewiesen. Fertig ist ein typisches Ajax-Element. Für eigene Anwendung muss man lediglich den Namen des x.Attribute anpassen.

Die beschriebene Logik funktioniert mit jeder Liste, die das Interface IEnumerable  implementiert.

Ich gehe von folgendem Request aus:

%URI%?Mitgliedsnummer=4&x=y&Item=test

Der Wert der Mitgliedsnummer soll in eine Textbox übernommen werden. Dies geschieht sinnvoller Weise, indem im Konstruktor für das Event Loaded ein Event-Handler registriert wird.

Loaded += new [...]]]> Dieser Beitrag beschreibt die Lösung der folgenden Aufgabenstellung, die sich immer wieder ergibt.

In einer Silverlight-Anwendung soll ein Parameter aus dem HTML-Request übernommen werden.

Ich gehe von folgendem Request aus:

%URI%?Mitgliedsnummer=4&x=y&Item=test

Der Wert der Mitgliedsnummer soll in eine Textbox übernommen werden. Dies geschieht sinnvoller Weise, indem im Konstruktor für das Event Loaded ein Event-Handler registriert wird.

Loaded += new RoutedEventHandler(MainPage_Loaded);

Die Implementierung wird im folgenden Listing gezeigt. Wichtig ist, dass man über Silverlight auf das Objektmodell des Browsers zugreifen kann.

void MainPage_Loaded(object sender, RoutedEventArgs e)
        {

            bool pFlag = false;

            String nummer = “”;

            foreach (String myKey in  HtmlPage.Document.QueryString.Keys) {

                   if (myKey == “Mitgliedsnummer”) {

                       pFlag = HtmlPage.Document.QueryString.TryGetValue(myKey,out nummer);

                      break;

                   }

            }

            if (pFlag) {

                this.txtMitgliedsnummer.Text = nummer;

            }

        }

An der Lösung sind drei Objekte beteiligt:

• Die Verwendung des HTMLPage Objektes aus dem Namespace System.Windows.Browser.
• Hier finden ich das Document Objekt und dieses hat wiederum ein QueryString Objekt. Damit kann ich den HTML-Request darstellen.

Auf der Basis dieses Objektmodells ist die Umsetzung relativ einfach.

1. Mit Hilfe von foreach werden Keys des QueryString-Objektes durchlaufen (ich weis nicht, ob noch weitere Parameter übergeben werden)
2. Wenn ich den Key finden, dann lesen ich über TryGetValue(string key, out string) den zum Key gehörenden Wert aus. Die Funktion liefert war oder falsch.
3. Danach schreiben ich, wenn es denn einen Übergabeparameter Mitgliedsnummer gegeben hat, diesen Wert in die TextBox txtMitgliednummer.

Die Funktion kann auch noch kürzer geschrieben werden:

String nummer = “”;
            foreach (String myKey in HtmlPage.Document.QueryString.Keys)
            {
                if (myKey == “Mitgliedsnummer”)
                {
                    if (HtmlPage.Document.QueryString.TryGetValue(myKey, out nummer))
                        this.txtMitgliedsnummer.Text = nummer;
                        break;
                }
            }