Wiki source code of Sharepoint plugin

Show last authors
1 {{content/}}
2
3 == Adding the plugin to SharePoint ==
4
5 === Step 1: Upload the plugin ===
6
7 1. Download the plugin [[plugin-bundle-sharepoint.jar from our download page>>url:http://download.formcycle.de/download/fc/SharePoint/2.0.0/plugin-bundle-sharepoint.jar]].
8
9 === Step 2: Install the plugin for {{formcycle/}} ===
10
11 {{figure clear="h2" group="step2" image="step2.png"}}
12 Installing the {{formcycle/}} plugin for SharePoint integration.
13 {{/figure}}
14
15 Sign in to {{formcycle/}} with the //superadmin// account and install the plugin by following these steps:
16
17 1. Go to //System// -> //System plugins//.
18 1. Click on //new// to add a new the plugin.
19 1. Click on //browse// and upload the file {{code}}plugin-sharepoint.jar{{/code}}.
20 1. Select all clients to which the plugin should be available by changing the value for the plugin parameter {{code}}fc.sharepoint.plugin.clients{{/code}}. Client names are separated by commas {{code}},{{/code}}. You can use a star {{code}}*{{/code}} as wildcard to select all clients.
21 1. Save all settings by clicking on //save//.
22 1. Beginning at version 2.0.0 of the plugin, an additional plugin parameter has been added, {{code}}fc.sharepoint.plugin.client.required{{/code}}. When it is set to {{code}}true{{/code}}, the plugin will not return any forms or form data unless the SharePoint plugin specifies at least one client.
23
24 === Step 3: Upload the plugin to the SharePoint server ===
25
26 Upload the plugin (web service provider) to SharePoint.
27
28 Copy the file {{code}}FormCycle.wsp{{/code}} to the SharePoint-Server. You can download the web service provider [[from our download page>>url:http://download.formcycle.de/download/fc/SharePoint/2.0.0/FormCycle.wsp]].
29
30 === Step 4: Install the SharePoint plugin ===
31
32 {{figure clear="h2" group="step4" image="step4.png"}}
33 Open a shell management shell in SharePoint. You must be an administrator with the appropriate permissions.
34 {{/figure}}
35
36 {{figure clear="h2" group="step4" image="step5.png"}}
37 Command used when installing the plugin for the first time.
38 {{/figure}}
39
40 {{figure clear="h2" group="step4" image="step6.png"}}
41 The service //SharePoint administration// must be active. You can check this in the SharePoint administration interface.
42 {{/figure}}
43
44 {{figure clear="h2" group="step4" image="step7.png"}}
45 Final command to finish the installation.
46 {{/figure}}
47
48 1. Open a //SharePoint-Verwaltungsshell// as an administrator with extended permissions.
49 1. When you are installing the plugin for the first time, run the command {{code}}Add-SPSolution C:\Users\Administrator\Desktop\FormCycle.wsp{{/code}}. When installing an update of the plugin {{code}}FormCycle.wsp{{/code}}, run the command {{code}}run Update-SPSolution -Identity FormCycle.wsp -LiteralPath "C:\Users\Administrator\Desktop\FormCycle.wsp" -GacDeployment{{/code}}.
50 1. Check whether the service //SharePoint administration// is running.
51 1. Run the command {{code}}Install-SPSolution -identity "FormCycle.wsp" -GACDeployment -AllWebApplications{{/code}}.
52
53 === Step 5: Edit the URL to the {{fcserver/}} ===
54
55 Go to the //propertyBag// and modify the the parameter {{code}}xima.formcycle.server.url{{/code}} so that it points to the URL to the {{fcserver/}}. How to set this parameter depends on whether you are using SPWeb or SPSite.
56
57 {{figure clear="h2" group="step4" image="step8.png"}}
58 The parameter {{code}}xima.formcycle.server.url{{/code}} must be set correctly or no connection can be established between SharePoint and {{formcycle/}}.
59 {{/figure}}
60
61 {{figure clear="h2" group="step4" image="sharepoint_33.png"/}}
62
63 ==== For SPWeb ====
64
65 1. Set the URL of the site collection: {{code}}$web = Get-SPWeb http://sharepoint-server{{/code}}
66 1. Seth the URL to the {{fcserver/}}: {{code}}$web.AllProperties["xima.formcycle.server.url"]="http://formcycle-server/formcycle"{{/code}}
67 1. Beginning at version 2.0.0 of the plugin, you can set the name of client to be used in SharePoint: {{code}}$web.AllProperties["xima.formcycle.server.client"]="meinMandantName"{{/code}}
68 1. Update the settings: {{code}}$web.Update(){{/code}}
69
70 ==== For SPSite ====
71
72 1. Set the URL to the site collection: {{code}}$site = Get-SPSite http://sharepoint-server/siteCollection{{/code}}
73 1. Get the side ID: {{code}}$site.ID{{/code}}. Take note of this ID as you will need it shortly. This ID is a unique key of the available SPSites on the farm.
74 1. Set the URL to the {{fcserver/}}. Replace the part marked in red with the ID from the previous step.
75 {{box}}$site.RootWeb.Properties["xima.formcycle.server.url_(% style="color: rgb(255, 0, 0);" %)IdDerSPSite(%%)"]="http:~/~/formcycle-server/formcycle"{{/box}}
76 Example: {{code}}$site.RootWeb.Properties["xima.formcycle.server.url_a755f7e7-4beb-47de-b41c-6648b2d3fb7a"]="http://formcycle-server/formcycle/"{{/code}}
77 1. Beginning at version 2.0.0 of the plugin, you can set the name of the client to be used in SharePoint. Replace the part marked in red with the ID from step 2.
78 {{box}}$site.RootWeb.Properties["xima.formcycle.server.client_(% style="color: rgb(255, 0, 0);" %)IdDerSPSite(%%)"]="meinMandantName"{{/box}}
79 Example: {{code}}$site.RootWeb.Properties["xima.formcycle.server.client_a755f7e7-4beb-47de-b41c-6648b2d3fb7a"]="demoMandant"{{/code}}
80 1. Update the settings: {{code}}$site.RootWeb.Properties.Update(){{/code}}
81
82 == Using the plugin ==
83
84 === Setting up the web part for the plugin ===
85
86 {{figure clear="h2" group="webpart" image="step9.png"}}
87 Step 1: Adding the web part to the web part gallery.
88 {{/figure}}
89
90 {{figure clear="h2" group="webpart" image="step10.png"}}
91 Step 2: Select //web parts// in the web part settings.
92 {{/figure}}
93
94 {{figure clear="h2" group="webpart" image="step11.png"}}
95 Step 3: Create a new document.
96 {{/figure}}
97
98 {{figure clear="h2" group="webpart" image="step12.png"}}
99 Step 4: Add the {{formcycle/}} web part.
100 {{/figure}}
101
102 {{figure clear="h2" group="webpart" image="step13.png"}}
103 Step 5: Open the web part settings.
104 {{/figure}}
105
106 {{figure clear="h2" group="webpart" image="step14.png"}}
107 Step 6: Set a group for the web part.
108 {{/figure}}
109
110 1. Click on //web page settings// and add the {{formcycle/}} web part to your web part gallery.
111 1. Go to //web designer galleries// and click on //web parts//.
112 1. Click on //files// {{rarrow/}} //New document//.
113 1. Select {{code}}FormCycle.FormCycleWebPart.FormCycleWebPart{{/code}} and click on //Populate gallery//.
114 1. Open the web part details.
115 1. Set a group for the web part, eg. //forms//.
116
117 === Creating a SharePoint document with a form ===
118
119 {{figure clear="h2" group="erstellen" image="step15.png"}}
120 Adding a web part to a dcoument.
121 {{/figure}}
122
123 {{figure clear="h2" group="spInstr" image="step16.png"}}
124 Inserting the {{formcycle/}} web part to a document.
125 {{/figure}}
126
127 1. Go to the document to which you would like to add a {{formcycle/}} form, and click on //Edit// {{rarrow/}} //Insert// {{rarrow/}} //Web part//.
128 1. Select the group you set for the web part and click on //Add//.
129
130 The plugin has now been added to the document and allows for {{formcycle/}} forms to be integrated into SharePoint.
131
132 === Copying form data to a SharePoint list ===
133
134 Form data that has been submitted can be copied to a SharePoint list when necessary.
135
136 See the help pages on [[SharePoint lists>>doc:CopyToSharePointList]] for further instructions.

Navigation

Copyright 2000-2025