Hinzufügen von benutzerdefinierten Spalten zu einem in SharePoint gehosteten SharePoint-Add-In

  • Artikel

Dies ist der dritte in einer Reihe von Artikeln über die Grundlagen der Entwicklung von SharePoint gehosteten SharePoint-Add-Ins. Machen Sie sich zunächst mit SharePoint-Add-Ins und den vorherigen Artikeln dieser Reihe vertraut, die Sie unter Erste Schritte beim Erstellen von SharePoint gehosteten SharePoint-Add-Ins | Nächste Schritte finden können.

Hinweis

Wenn Sie unsere Artikelreihe zum Thema SharePoint-gehostete Add-Ins durchgearbeitet haben, haben Sie bereits eine Visual Studio-Lösung, die Sie für diesen Artikel verwenden können. Sie können auch das Repository von SharePoint_SP-hosted_Add-Ins_Tutorials herunterladen und die Datei „BeforeColumns.sln“ öffnen.

In diesem Artikel kehren wir zum Programmieren zurück, indem wir einige Websitespalten zum SharePoint-Add-In „Orientierung für Mitarbeiter“ hinzufügen.

Erstellen benutzerdefinierter Spaltentypen

  1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Projekt, und wählen Sie Neuen Ordner> hinzufügen aus. Nennen Sie den Ordner Websitespalten.

  2. Klicken Sie mit der rechten Maustaste auf den neuen Ordner, und wählen Sie Neues Element>hinzufügen aus. Das Dialogfeld Neues Element hinzufügen wird geöffnet, und der Office/SharePoint-Knoten wird angezeigt.

  3. Wählen Sie Websitespalte aus, geben Sie ihr den Namen Abteilung, und wählen Sie Hinzufügen aus.

  4. Bearbeiten Sie in der Datei „elements.xml“ für die neue Websitespalte das Element Feld so, dass es die im folgenden Beispiel gezeigten Attribute und Werte hat, mit der Ausnahme, dass Sie nicht den Wert der GUID für das Attribut ID ändern sollten, der von Visual Studio dafür generiert wurde. Seien Sie also vorsichtig, wenn Sie Kopieren und Einfügen verwenden.

    <Field ID="{generated GUID}"
      Name="Division"
      Title="Division"
      DisplayName="Division"
      Description="The division of the company where the employee works."
      Group="Employee Orientation"
      Type="Text"
      Required ="FALSE">
</Field>

  5. Fügen Sie eine weitere Websitespalte mit dem Namen OrientationStage im selben Ordner hinzu.

  6. Bearbeiten Sie in der Datei „elements.xml“ für die neue Websitespalte das Element Feld so, dass es die im folgenden Beispiel dargestellten Attribute und Werte aufweist, mit der Ausnahme, dass der Wert der GUID für das Attribut ID, den Visual Studio dafür generiert hat, nicht geändert werden sollte.

    <Field ID="{generated GUID}"
      Name="OrientationStage"
      Title="OrientationStage"
      DisplayName="Orientation Stage"
      Group="Employee Orientation"
      Description="The current orientation stage of the employee."
      Type="Choice"
      Required ="TRUE">
</Field>

  7. Weil es sich um ein Auswahlfeld handelt, müssen Sie die Auswahlmöglichkeiten und die Reihenfolge ihrer Anzeige in der Dropdownliste, wenn ein Benutzer eine Auswahl trifft, angeben. Da dies ein Pflichtfeld ist, müssen Sie einen Standardwert angeben. Fügen Sie das folgende untergeordnete Markup zum Feld-Element hinzu, und speichern Sie dann alle Dateien.

    <CHOICES>
    <CHOICE>Not Started</CHOICE>
    <CHOICE>Tour of building</CHOICE>
    <CHOICE>HR paperwork</CHOICE>
    <CHOICE>Corporate network access</CHOICE>
    <CHOICE>Completed</CHOICE>
</CHOICES>
<MAPPINGS>
      <MAPPING Value="1">Not Started</MAPPING>
      <MAPPING Value="2">Tour of building</MAPPING>
      <MAPPING Value="3">HR paperwork</MAPPING>
      <MAPPING Value="4">Corp network access</MAPPING>
      <MAPPING Value="5">Completed</MAPPING>
</MAPPINGS>
<Default>Not Started</Default>

Ausführen des Add-Ins und Testen der Spalten

  1. Verwenden Sie die F5-Taste, um Ihr Add-In bereitzustellen und auszuführen. Visual Studio führt eine temporäre Installation des Add-Ins auf Ihrer SharePoint-Testwebsite durch und führt das Add-In sofort aus.

  2. Wenn die Standardseite des Add-Ins geöffnet wird, wählen Sie den Link für Neue Mitarbeiter in Seattle aus, um die benutzerdefinierte Listeninstanz zu öffnen.

  3. Öffnen Sie die Seite Einstellungen der Liste, und fügen Sie die zwei Spalten mit den folgenden Schritten hinzu.

    1. Wählen Sie die Popupschaltfläche · · · direkt über der Liste aus, und wählen Sie dann Ansicht erstellen aus.

    2. Die Seite Ansichtstyp wird geöffnet, wobei oben die Breadcrumb-Struktur Einstellungen > Ansichtstyp angezeigt wird. Klicken Sie auf den Breadcrumb Einstellungen.

      Abbildung 1: Schritte zum Öffnen der Seite mit Listeneinstellungen

      Liste

    3. Öffnen Sie auf der Seite Einstellungen den Link Aus vorhandenen Websitespalten hinzufügen etwa in der Mitte der Seite links.

      Abbildung 2: Seite mit Listeneinstellungen

      Die Seite mit Listeninstanzeinstellungen, auf der der Link für „Spalten aus Websitespalten hinzufügen“ hervorgehoben ist.

    4. Wählen Sie auf der Seite Spalten aus Websitespalten hinzufügen in der Dropdownliste Websitespalten auswählen aus die Option Orientierung für Mitarbeiter aus.

      Abbildung 3: Seite "Spalten aus Websitespalten hinzufügen"

      Das Steuerelement für die SharePoint-Spaltenauswahl, wobei „Orientierung für Mitarbeiter“ in der Dropdownliste mit der Bezeichnung „Websitespalten auswählen“ ausgewählt ist.

    5. Fügen Sie die Spalten Abteilung und Orientierungsphase zum Feld Hinzuzufügende Spalten hinzu.

    6. Wählen Sie OK aus, um zur Seite Einstellungen zurückzukehren, und wählen Sie dann den Breadcrumb Neue Mitarbeiter in Seattle im oberen Bereich der Seite aus.

  4. Die neuen Spalten sind jetzt in der Liste enthalten. Fügen Sie der Liste ein neues Element hinzu. Im Bearbeitungsformular weist das Feld Ausrichtungsphase bereits den Standardwert Nicht gestartet auf. (Die vorhandenen Elemente sind in diesem Feld leer, da sie erstellt wurden, bevor das Feld in der Liste enthalten war.)

    Abbildung 4: Die Liste mit neuen Spalten

    Die Liste mit den neuen Spalten „Abteilung“ und „Orientierungsphase“.

  5. Schließen Sie zum Beenden der Debugsitzung das Browserfenster, oder beenden Sie das Debuggen in Visual Studio. Jedes Mal, wenn Sie F5 drücken, zieht Visual Studio die vorherige Version des Add-Ins zurück und installiert die neueste.

  6. Da Sie mit diesem Add-In und dieser Visual Studio-Lösung in anderen Artikeln arbeiten werden, hat es sich bewährt, das Add-In ein letztes Mal zurückzuziehen, wenn Sie Ihre Arbeit daran für eine Weile abgeschlossen haben. Klicken Sie mit der rechten Maustaste auf das Projekt im Projektmappen-Explorer, und wählen Sie Zurückziehen aus.

Nächste Schritte

Da Sie nicht wirklich möchten, dass Ihre Benutzer die benutzerdefinierten Spalten manuell zur Liste hinzufügen müssen, erstellen Sie im nächsten Artikel dieser Reihe einen benutzerdefinierten Inhaltstyp, der die benutzerdefinierten Spalten enthält und automatisch mit der Listenvorlage für neue Mitarbeiter verknüpft wird: Hinzufügen eines benutzerdefinierten Inhaltstyps zu einem von SharePoint gehosteten SharePoint-Add-In.