Wiki-Quellcode von Salesforce-Plugin

Verstecke letzte Bearbeiter

version	line-number	content
1.10	1	[[Plugin-Download>>url:https://customer.formcycle.eu/index.php/apps/files/?dir=/FORMCYCLE%20-%20Plugins%20Customer/fc-plugin-bundle-salesforce&fileid=24242\|\|target="_blank"]] (erfordert Anmeldung)
1.4	2
	3	{{content/}}
	4
	5	Über das kostenpflichtige Salesforce-Plugin ist es möglich, Daten aus {{formcycle/}} an ein Salesforce-Objekt zu übermitteln. Das Plugin nutzt dafür die vom Salesforce-System bereitgestellte [[SOAP>>https://de.wikipedia.org/wiki/SOAP\|\|rel="noopener noreferrer" target="_blank" title="Simple Object Access Protocol"]]-Webservice Schnittstelle.
	6
	7	== Installation ==
	8
	9	Das Plugin kann als Mandant-Plugin oder System-Plugin installiert werden. Eine Anleitung zur Installation von Plugins finden Sie [[hier>>doc:Formcycle.UserInterface.Client.Plugins.WebHome]].
	10
	11	== Konfiguration des Plugins ==
	12
1.6	13	{{figure image="1_Plugin_Konfiguration.png"}}
	14	Die Konfigurationsoberfläche des Plugins. Hier werden Einstellungen zur Verbindung mit dem Salesforce-Server getroffen.
1.4	15	{{/figure}}
	16
	17	Nach der Installation des Plugins stehen die in der Abbildung dargestellten Konfigurationsparameter zur Verfügung. Folgende Einstellungsmöglichkeiten gibt es dabei:
	18
1.6	19	; auth.endpoint.url
1.7	20	: {{smallcaps}}URL{{/smallcaps}}, unter der der Authentifizierungsendpunkt erreicht werden kann.
1.6	21	; service.endpoint.url
1.7	22	: {{smallcaps}}URL{{/smallcaps}}, unter der der Serviceendpunkt erreicht werden kann.
1.6	23	; salesforce.login
1.8	24	: Benutzername für die Authentifizierung (Optionaler Parameter)
1.6	25	; salesforce.pwd
1.8	26	: Passwort für die Authentifizierung (Optionaler Parameter)
1.6	27	; salesforce.token
1.9	28	: Zugriffstoken für die Authentifizierung (Optionaler Parameter)
1.6	29
1.11	30	== Aktions-Plugin: //Salesforce: Create Object// ==
	31
	32	{{figure image="2_Aktion_Oberfläche.png" width="400"}}
1.18	33	Die Einstellungen für die Verarbeitungsaktion //Salesforce: Create Object//.
1.11	34	{{/figure}}
	35
1.18	36	Nach Installation des Salesforce-Plugins gibt es in der [[Status- und Aktionsverarbeitung>>doc:Formcycle.UserInterface.MyForms.WorkflowProcessing.WebHome]] eine neue Aktion namens //Salesforce: Create Object//, mit der eine neue Instanz eines Salesforce Objekts erstellt werden kann. Neben den Standardeinstellungen der Aktion für Name und Bemerkungen gibt es die folgenden Parameter:
1.11	37
	38	=== Details für die Plugin-Verarbeitung ===
	39
	40	==== Salesforce Einstellungen ====
	41
	42	; Salesforce Objekt
	43	: Über eine Dropdown-Auswahl muss in diesem Feld der Typ des zu erstellenden Salesforce-Objekts ausgewählt werden.
	44
1.18	45	Nachdem ein Objekt ausgewählt wurde, können in der Tabelle //Objekt-Felder// die Werte festegelegt werden, welche in die neue Objekt-Instanz geschreiben werden sollen. Jede Tabellenzeile enhält dabei die folgenden Spalten:
1.11	46
1.18	47	; {{ficon name="play-circle-outline1"/}}-Schaltfläche
	48	: Durch anklicken dieser Schaltfläche können Detailinformationen für das jeweilige Salesforce-Feld geöffnet und wieder geschlossen werden.
	49	; Technischer Name
	50	: Der technische Name des Salesforce-Feldes, wie er im Salesforce-Objekt definiert ist.
	51	; Wert
	52	: Der Wert, welcher in der zu erstellenden neuen Objekt-Instanz für das Salesforce-Feldes verwendet werden soll. Hier können auch [[Platzhalter>>doc:Formcycle.UserInterface.Variables]] verwendet werden. Dafür befindet sich ein
	53	; {{ficon name="trash-alt"/}}-Schaltfläche
1.19	54	: Löscht die Zeile, wodurch kein Wert für das entsprechende Salesforce-Feld übertragen wird.
1.18	55
1.12	56	==== Allgemeine Rückgabeparameter ====
	57
	58
	59
1.11	60	=== Rückgabeparameter der Aktion ===
	61
1.12	62	{{figure image="plugin_result.png"}}
	63	Konfiguration der Rückgabewerte
	64	{{/figure}}
	65
1.19	66	In diesem Bereich werden die vom Salesforce-Plugin als Ergebnis der Erstellung der neuen Objekt-Instanz zurückgelieferten Parameter aufgeführt. Für die einzelnen Parameter kann ein Alias vergeben werden. In weiteren Aktionen kann auf den entsprechenden Rückgabeparameter per Platzhalter-Syntax zugegriffen werden. Der Platzhalter wird dabei nach dem folgenden Muster gebildet:
1.12	67
1.19	68	{{code language="none"}}
	69	[%$<Aktions-Name>.RESULT[0].<Name oder vergebener Alias der Rückgabeparameters>%]
1.12	70	{{/code}}
	71
1.11	72	; ResultCode
1.12	73	: Enthält einen Zahlenwert, welchen den Abarbeitungs- bzw. Fehlerstatus des Plugins wiedergibt.
	74	; ResultMessage
	75	: Enthält eine Klartextmeldung, welche den zurückgelieferten //ResultCode// näher erläutert.
	76	; ResultDocumentID
	77	: Enthält die vom d.3 System zurückgelieferte Dokument-ID, wenn das Dokument erfolgreich im d.3 System abgelegt werden konnte, sonst den Wert -1.
	78
	79	{{info}}
	80	Über den [[image:icon_copy.png]] Button kann der aus dem Namen oder Alias erzeugte Platzhalter einfach in die Zwischenablage kopiert
	81	und an anderer Stelle, z.B.: im Text einer E-Mail-Aktion, eingefügt werden.
	82	{{/info}}
	83
	84	Der ResultCode enthält nummerischer Zahlenwerte, welche dazu verwendet werden können, den Erfolg der Aktion zu bestimmen. Folgende Ergebnisnummern sind möglich:
	85
1.16	86	{{table dataTypeNum="0" preSort="0-asc"}}
1.19	87	\|=Status / Fehlercode\|=Bedeutung
1.15	88	\|0\|Das Plugin wurde fehlerfrei ausgeführt.
	89	\|10\|Die Salesforce-Authentifizierung ist fehlgeschlagen, überprüfen Sie bitte ihre Nutzer-Credentials.
	90	\|30\|Es konnte keine Verbindung zum Salesforce-Service aufgebaut werden.
	91	\|31\|Aufruf einer Webservice-Methode lieferte Fehler
1.17	92	\|40\|In {{formcycle/}} ist ein nicht näher spezifizierter Fehler aufgetreten.
1.14	93	{{/table}}
1.11	94
	95
	96
	97
1.17	98	##clear="h1"
1.11	99

Wiki-Quellcode von Salesforce-Plugin

Navigation