Wiki-Quellcode von Sharepoint plugin

Zeige letzte Bearbeiter
1 {{content/}}
2
3 {{error}}
4 Das SharePoint-Plugin FormCycle.wsp kann nur noch bis SharePoint Version 2013 eingesetzt werden. In den folgenden Versionen ist die Schnittstelle nicht mehr vorhanden und das Plugin wird daher nicht mehr weiter entwickelt.
5 {{/error}}
6
7 == Plugin zu SharePoint hinzufügen ==
8
9 === Schritt 1: Plugin herunterladen ===
10
11 1. Laden Sie das Plugin von der [[Customer-Cloud>>https://customer.formcycle.eu]] herunter.
12
13 === Schritt 2: Plugin für {{formcycle/}} installieren ===
14
15 {{figure clear="h2" group="step2" image="sharepoint.png"}}
16 Installation des Plugin für die SharePoint-Integration in {{formcycle/}}
17 {{/figure}}
18
19 Melden Sie sich als //superadmin// bei {{formcycle case="dat"/}} an und installieren sie das Plugin wie folgt.
20
21 1. Gehen Sie auf //Systemeinstellungen// -> //Systemplugins//
22 1. Klicken Sie auf die Schaltfläche //Neu//, um das Plugin einzufügen.
23 1. Klicken Sie auf //Durchsuchen// und laden Sie die Datei {{code language="none"}}plugin-sharepoint.jar{{/code}} hoch.
24 1. Konfigurieren Sie den Parameter {{code language="none"}}fc.sharepoint.plugin.clients{{/code}}. Mandantennamen werden durch Kommas {{code language="none"}},{{/code}} getrennt. Sie können den Platzhalter {{code language="none"}}*{{/code}} verwenden, um alle Formulare in SharePoint verfügbar zu machen.
25 1. Speichern Sie die Einstellungen durch Klick auf //Speichern//.
26 1. Seit Version 2.0.0 des Plugins gibt es auch den Parameter {{code language="none"}}fc.sharepoint.plugin.client.required{{/code}}. Wird der Wert auf {{code language="none"}}true{{/code}} gesetzt, muss das SharePoint-Plugin zwingend einen oder mehrere Mandantennamen übermitteln, sonst werden keine Formulare zurückgegeben.
27
28 === Schritt 3: Plugin auf SharePoint-Server übertragen ===
29
30 Laden Sie den Web-Service-Provider hoch in SharePoint hoch.
31
32 Kopieren Sie dazu die Datei {{code language="none"}}FormCycle.wsp{{/code}} auf den Sharepoint-Server. Sie können den Webservice-Provider [[bei uns herunterladen>>https://customer.formcycle.eu]].
33
34 === Schritt 4: Plugin in SharePoint installieren ===
35
36 {{figure clear="h2" group="step4" image="step4.png"}}
37 Verwaltungsshell in SharePoint öffnen. Sie müssen als Administrator über erweiterte Rechte verfügen.
38 {{/figure}}
39
40 {{figure clear="h2" group="step4" image="step5.png"}}
41 Kommandozeilenbefehl, wenn das Plugin neu installiert wird.
42 {{/figure}}
43
44 {{figure clear="h2" group="step4" image="step6.png"}}
45 Der Service //SharePoint Administration// muss aktiv sein. Die kann in der SharePoint-Administration überprüft werden.
46 {{/figure}}
47
48 {{figure clear="h2" group="step4" image="step7.png"}}
49 Abschließender Kommandozeilenbefehl, um die Installation des Plugins abzuschließen.
50 {{/figure}}
51
52 1. Öffnen Sie einen //SharePoint-Verwaltungsshell// als Administrator mit erweiterten Rechten.
53 1. Falls Sie die Datei neu installieren, führen Sie den Befehl {{code language="none"}}Add-SPSolution C:\Users\Administrator\Desktop\FormCycle.wsp{{/code}} aus. Falls Sie ein Update eines bestehenden {{code language="none"}}FormCycle.wsp{{/code}} durchführen, führen Sie den Befehl {{code language="none"}}run Update-SPSolution -Identity FormCycle.wsp -LiteralPath "C:\Users\Administrator\Desktop\FormCycle.wsp" -GacDeployment{{/code}} aus.
54 1. Vergewissern Sie sich, dass der Service //SharePoint Administration// ausgeführt wird.
55 1. Führen Sie den Befehl {{code language="none"}}Install-SPSolution -identity "FormCycle.wsp" -GACDeployment -AllWebApplications{{/code}} aus.
56
57 === Schritt 4: URL auf {{fcserver/}} konfigurieren ===
58
59 Setzen Sie den Parameter {{code language="none"}}xima.formcycle.server.url{{/code}} für die URL zu {{formcycle/}} unter //PropertyBag//. Es gibt zwei verschiedene Vorgehensweisen zum setzen der URL- und Client- Parameter.
60
61 {{figure clear="h2" group="step4" image="step8.png"}}
62 Die {{code language="none"}}xima.formcycle.server.url{{/code}} muss entsprechend gesetzt sein, damit SharePoint mit {{formcycle/}} kommunizieren kann.
63 {{/figure}}
64
65 {{figure clear="h2" group="step4" image="sharepoint_33.png"/}}
66
67 ==== Vorgehen bei der Verwendung von SPWeb ====
68
69 1. Setzen Sie die URL der Seitensammlung.
70 {{code language="none"}}$web = Get-SPWeb http://sharepoint-server{{/code}}
71 1. Setzen Sie die URL zum Server von {{formcycle case="dat"/}}.
72 {{code language="none"}}$web.AllProperties["xima.formcycle.server.url"]="http://formcycle-server/formcycle"{{/code}}
73 1. Seit Version 2.0.0 des Plugins können Sie auch den Namen des Mandaten einstellen, der in SharePoint genutzt werden soll.
74 {{code language="none"}}$web.AllProperties["xima.formcycle.server.client"]="meinMandantName"{{/code}}
75 1. Aktualisieren Sie die Einstellungen.
76 {{code language="none"}}$web.Update(){{/code}}
77
78 ==== Vorgehen bei der Verwendung von SPSite ====
79
80 1. Setzen Sie die URL der Seitensammlung.
81 {{code language="none"}}$site = Get-SPSite http://sharepoint-server/siteCollection{{/code}}
82 1. Auslesen der Site-ID {{code language="none"}}$site.ID{{/code}}. Dabei handelt es sich um einen eindeutigen Schlüssel der auf der Farm vorhandenen SPSites. Bitte kopieren Sie sich den Schlüssel, er wird in den nächsten Schritten benötigt.
83 1. Setzen Sie die URL zum Server von {{formcycle case="dat"/}}. **Ersetzen Sie die rot markierte Stelle mit der zuvor kopierten ID.**
84 {{box}}$site.RootWeb.Properties["xima.formcycle.server.url_(% style="color: rgb(255, 0, 0);" %)IdDerSPSite(%%)"]="http:~/~/formcycle-server/formcycle"{{/box}}
85 Beispiel: {{code language="none"}}$site.RootWeb.Properties["xima.formcycle.server.url_a755f7e7-4beb-47de-b41c-6648b2d3fb7a"]="http://formcycle-server/formcycle/"{{/code}}
86 1. Seit Version 2.0.0 des Plugins können Sie auch den Namen des Mandaten einstellen, der in SharePoint genutzt werden soll. Es werden dann nur die Formulare dieses Mandanten verwendet. Ersetzen Sie dazu die rot markierte Stelle mit der zuvor kopierten ID.
87 {{box}}$site.RootWeb.Properties["xima.formcycle.server.client_(% style="color: rgb(255, 0, 0);" %)IdDerSPSite(%%)"]="meinMandantName"{{/box}}
88 Beispiel:{{code language="none"}}$site.RootWeb.Properties["xima.formcycle.server.client_a755f7e7-4beb-47de-b41c-6648b2d3fb7a"]="demoMandant"{{/code}}
89 1. Aktualisieren Sie zuletzt die Einstellungen.
90 {{code language="none"}}$site.RootWeb.Properties.Update(){{/code}}
91
92 == Nutzung des Plugins ==
93
94 === Webpart für Plugin einrichten ===
95
96 {{figure clear="h2" group="webpart" image="step9.png"}}
97 Schritt1: Den Webpart zum Webpart-Katalog hinzufügen.
98 {{/figure}}
99
100 {{figure clear="h2" group="webpart" image="step10.png"}}
101 Schritt 2: Webparts in den Webseiteneinstellungen auswählen.
102 {{/figure}}
103
104 {{figure clear="h2" group="webpart" image="step11.png"}}
105 Schritt 3: Neues Dokument anlegen.
106 {{/figure}}
107
108 {{figure clear="h2" group="webpart" image="step12.png"}}
109 Schritt 4: Webpart von {{formcycle/}} hinzufügen.
110 {{/figure}}
111
112 {{figure clear="h2" group="webpart" image="step13.png"}}
113 Schritt 5: Webpart-Einstellungen öffnen
114 {{/figure}}
115
116 {{figure clear="h2" group="webpart" image="step14.png"}}
117 Schritt 6: Gruppe für den Webpart setzen.
118 {{/figure}}
119
120 1. Klicken Sie auf //Webseiteneinstellungen// und fügen Sie den Webpart von {{formcycle/}} zu Ihrem Webpart-Katalog hinzu.
121 1. Gehen Sie auf //Web-Designer-Kataloge// {{rarrow/}} //Webparts//.
122 1. Klicken Sie auf //Dateien// -> //Neues Dokument//.
123 1. Wählen Sie {{code language="none"}}FormCycle.FormCycleWebPart.FormCycleWebPart{{/code}} aus und klicken Sie auf //Katalog auffüllen//.
124 1. Öffnen Sie die //Webpart-//Details.
125 1. Setzen Sie die Gruppe für den //Webpart//, z.B. //Formulare//.
126
127 === Erstellen eines SharePoint-Dokument mit integrierten Formular ===
128
129 {{figure clear="h2" group="erstellen" image="step15.png"}}
130 Einfügen eines Webparts in einem Dokument.
131 {{/figure}}
132
133 {{figure clear="h2" group="spInstr" image="step16.png"}}
134 Hinzufügen des Webparts für {{formcycle/}} zu einem Dokument.
135 {{/figure}}
136
137 1. Auf der Seite, wo Sie {{formcycle/}} integrieren möchten, klicken Sie auf //Bearbeiten// -> //Einfügen// -> //Webpart//.
138 1. Wählen Sie die Gruppe aus, die Sie im vorletzten Schritt vergeben haben, und klicken Sie auf //Hinzufügen//.
139
140 Das Plugin steht nun in SharePoint zu Verfügung und ermöglicht das Einbindung von Formularen.
141
142 === Formularwerte in SharePoint-Liste übertragen ===
143
144 Übertragene Formularwerte können auch in einer SharePoint-Liste übertragen werden, wenn dies nötig ist.
145
146 Siehe hierzu den Abschnitt zum [[Übertragen von Formularwerten>>doc:CopyToSharePointList]].

Navigation

Copyright 2000-2025