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
5.2	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 eine [[image:icon_placeholder.png]] Schaltfläche rechts neben dem Eingabefeld.
1.18	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	{{figure image="plugin_result.png"}}
	59	Konfiguration der Rückgabewerte
	60	{{/figure}}
	61
1.19	62	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	63
1.19	64	{{code language="none"}}
	65	[%$<Aktions-Name>.RESULT[0].<Name oder vergebener Alias der Rückgabeparameters>%]
1.12	66	{{/code}}
	67
1.11	68	; ResultCode
1.12	69	: Enthält einen Zahlenwert, welchen den Abarbeitungs- bzw. Fehlerstatus des Plugins wiedergibt.
	70	; ResultMessage
	71	: Enthält eine Klartextmeldung, welche den zurückgelieferten //ResultCode// näher erläutert.
	72	; ResultDocumentID
	73	: 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.
	74
5.2	75	Über die [[image:icon_placeholder.png]] Schaltfläche neben jedem Eingabefeld kann die Platzhalterauswahl geöffnet werden.
1.12	76
	77	Der ResultCode enthält nummerischer Zahlenwerte, welche dazu verwendet werden können, den Erfolg der Aktion zu bestimmen. Folgende Ergebnisnummern sind möglich:
	78
1.16	79	{{table dataTypeNum="0" preSort="0-asc"}}
1.19	80	\|=Status / Fehlercode\|=Bedeutung
1.15	81	\|0\|Das Plugin wurde fehlerfrei ausgeführt.
	82	\|10\|Die Salesforce-Authentifizierung ist fehlgeschlagen, überprüfen Sie bitte ihre Nutzer-Credentials.
	83	\|30\|Es konnte keine Verbindung zum Salesforce-Service aufgebaut werden.
	84	\|31\|Aufruf einer Webservice-Methode lieferte Fehler
1.17	85	\|40\|In {{formcycle/}} ist ein nicht näher spezifizierter Fehler aufgetreten.
1.14	86	{{/table}}
1.11	87
	88
	89
	90
1.17	91	##clear="h1"
1.11	92

Wiki-Quellcode von Salesforce-Plugin

Navigation