Table Excerpt

name	plugininfo

Plugin info

MaintenanceDepartment	Dev CUF
LicType	Płatna
SalesName	Plus SAP Data Source
ArtifactId	sap-datasources
TypWtyczki	Wtyczka
PluginId	com.suncode.plugin-sap-datasources
ShortDescription	Źródło danych służące do wymiany informacji między systemem PlusWorkflow a systemem SAP.

Image Added

Parametr pozwala na dodanie dodatkowych nagłówków do żądania. Parametr można wykorzystać np. do wymuszenia odpowiedzi z API w formacie JSON. W takim wypadku należy dodać wiersz w opisywanym parametrze i w polu "Nagłówek" podać wartość "Accept", natomiast w polu "Wartość" podać "application/json".

Image Removed
Poprawnie skonfigurowane API na żądanie z powyższym nagłówkiem powinno zwrócić dane w formacie JSON lub odpowiedzieć błędem w przypadku, gdy na to żądanie nie można odpowiedzieć w formacie JSON.Ścieżka (podobna do XPath) służąca do wyodrębnienia danych z wynikowego JSON-a. Dokumentacja korzystania z JsonPath - https://github.com/json-path/JsonPath

Image Removed

Polish

Info
Instrukcja tworzenia źródeł danych w systemie - http://192.168.1.52:8081/confluence/pages/viewpage.action?pageId=13272439

Wtyczka zawiera implementację źródeł danych operujących na RESTful API.

Za pomocą opisywanych źródeł danych można odczytywać i przekazywać dane pomiędzy systemem PlusWorkflow a zewnętrznym API z wykorzystaniem metod protokołu HTTP (GET, POST itd.).

Info
Istnieje również możliwość komunikacji z wewnętrznym API systemu. W takim przypadku w adresie URL należy użyć domeny "localhost"

Opis konfiguracji:

Nazwa parametru

Opis parametru

Wymagalność

Autoryzacja

Schemat autoryzacji żądania. Jeśli żądany endpoint nie wymaga autoryzacji pole należy zostawić puste. Opis definiowania szablonów autoryzacji znajduje się TUTAJ.

Opcjonalny

Dodatkowe nagłówki

Opcjonalny

Metoda HTTP

Lista metod protokołu HTTP. Dostępne metody: GET, HEAD, POST, PUT, DELETE, PATCH. Należy wybrać wymaganą metodę żądania zgodnie z dokumentacją API.

Wymagany

URL

Adres URL endpointu, do którego wysłane zostanie żądanie. W przypadku wywołania akcję z API tego samego systemu PlusWorkflow, w którym skonfigurowane jest źródło adres URL musi zawierać domenę "localhost".

Wymagany

Content-Type

Parametr pozwala na zdefiniowanie formatu danych przekazywanych w ciele żądania. Parametr jest stosowany tylko, gdy wśród parametrów wejściowych znajdują się parametry typu "Parametr Body". W pozostałych przypadkach wartość tego parametru nie ma znaczenia.

Wymagany

Parametry wejściowe

Id parametrów wejściowych

Nazwy parametrów wejściowych

Typy parametrów wejściowych

Określa id parametrów wejściowych.

W przypadku parametru typu "Paramter URL" należy podstawić zdefiniowane id do adresu URL żądania w formacie {id} np. http://localhost/{parametr}
W przypadku parametru typu "Parametr Body" zdefiniowane id zostanie użyte jako klucz przekazywanych danych w ciele żądania
https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types#multipartform-data

Określa wyświetlaną nazwę parametrów wejściowych

Parametr URL - parametr zostanie przekazany w adresie URL

Parametr Body - parametr zostanie przekazany ciele żądania

Warning
Parametrów typu "Parametr Body" nie należy dodawać do żądań typu "GET"!

Opcjonalny

Parametry wyjściowe

Id parametrów wyjściowych

Nazwy parametrów wyjściowych

JsonPath

Określa id parametrów wyjściowych używane w mappingu

Określa wyświetlaną nazwę parametrów wyjściowych

Opcjonalny

Zarządzanie źródłami danych

Panel

title	Opis

Źródło danych służące do wymiany informacji między systemem PlusWorkflow a systemem SAP.

Panel

title	Wymagana konfiguracja

Przed wgraniem na serwer należy wgrać pliki z katalogu do:

Windows: sapjco3.dll windows/system32

Linux: libsapjco3.so server/lib (Też do tomcata)

Tomcat: sapjco3.jar server/lib

Potem restart serwera i wgranie wtyczki

Pliki:

View file

name	libsapjco3.so
height	250

View file

name	sapjco3.dll
height	250

View file

name	sapjco3.jar
height	250

Panel

title	Parametry

Image Added

Parametr	Opis	Wartość Domyślna	Typ	Uwagi
Autoryzacja	Zapisany szablon autoryzacji		Lista wyboru	Lista przygotowanych wcześniej konfiguracji połączeń do SAP. Więcej informacji znajduję się w [SAPDS] Szablony autoryzacji
Funkcja	Nazwa wywoływanej funkcji BAPI		Tekst	Obok parametru jest przycisk dzięki któremu można sprawdzić czy dana funkcja istnieje w danym połączeniu SAP
Czas pamięci podręcznej [sekundy]	Czas przechowywania wyników w pamięci serwera dla tych samych paramentów wywoływania. Czas liczony w sekundach	30	Liczba	Im większy czas tym rzadziej będzie odpytywać serwer SAP. Przydatne podczas stosowania paginacji w DC lub dla danych z SAPA które rzadko się zmieniają.
Logowanie parametrów	Wyświetla w logach dodatkowe parametry z którymi została wywołana funkcji. Oraz wyświetla wyniki tej funkcji		Logiczny
Id parametrów wejściowych	Unikalny identyfikator parametru		Tekst	Nie można stosować znaku . (kropki) Można uzupełniać parametry importu oraz tabele powiązane z funkcją.
Nazwa parametrów wejściowych:	Nazwa wyświetlana parametru wejściowego		Tekst	W przypadku gdy parametry wyjściowe zostaną pobrane z obiektu nagłówkowego (exportParameters) oraz którejś z tabeli funkcji (tableParameters) to wynik zostanie połączony wg następującej reguły: Jeżeli odpowiedź części nagłówkowej będzie reprezentowany jednym wierszem, to wartości tego wiersza zostaną zdublowane tyle razy ile wierszy posiada odpowiedź części tabelarycznej. Image Added Jeżeli odpowiedź części tabelarycznej będzie reprezentowany jednym wierszem, to wartości tego wiersza zostaną zdublowane tyle razy ile wierszy posiada odpowiedź części nagłówkowej. Image Added Jeżeli odpowiedź części tabelarycznej oraz części nagłówkowej posiadają odpowiedź dłuższa niż 1 wiersz, to wynik zostanie przedstawiony w następującej formie: Image Added
Nazwa parametru BAPI	Nazwa parametru wejściowego funkcji z BAPI.		Tekst	Gdy parametr jest w strukturze lub w tablicy należy podać z kropką nazwę struktury/parametru a potem parametr docelowy np DOCUMENT_HEADER.NR_DOK (Podczas wywoływania źródła danych parametry tablicowe podaję się jako tekst rozdzielony znakiem średnika)
Id parametrów wyjściowych	Unikalny identyfikator parametru		Tekst	Nie można stosować znaku . (kropki)
Nazwy parametrów wyjściowych	Nazwa wyświetlana parametru wyjściowego		Tekst
xPath	Ścieżka typu 'XPath' do node'a, którego wartość ma zostać odczytana. XPath tutorial		Tekst	Przykładowo aby odczytać wartość tablicową należy podać "//TABELA_NAZWA//PARAM"

Panel

title	Przykładowa konfiguracja

Przykłady konfiguracji:

Konfiguracja źródła	Przykładowa dokumentacja	Zrzut ekranu
mpk.json	Image Added	Image Added
kontrahenci.json	Image Added	Image Added
pz.json	Image Added	Image Added
kodpodatku.json	Image Added	Image Added

The parameter allows adding additional headers to the request. The parameter can be used, for example, to force a response from the API in JSON format. In this case, add a row in the described parameter and enter "Accept" in the "Header" field, and "application/json" in the "Value" field.

Image Removed
A properly configured API should return data in JSON format on request with the above header or reply with an error in case this request cannot be answered in JSON format.A path (similar to XPath) used to extract data from the resulting JSON. Documentation for using JsonPath - https://github.com/json-path/JsonPath

Image Removed

English

Info
Instructions for creating data sources in the system - http://192.168.1.52:8081/confluence/pages/viewpage.action?pageId=13272439

The plugin contains the implementation of datasources operating on the RESTful API.

Described data sources allow for read and transfer data

Panel

title	Description

Data source for information exchange between the PlusWorkflow system and

an external API using the HTTP protocol methods (GET, POST, etc.).

Info
It is also possible to communicate with the PWFL system's internal API. In this case, use "localhost" in the URL

Image Removed

Configuration description:

Name of the parameter

Description

Optionality

Authorization

Request authorization scheme. If the requested endpoint does not require authorization, leave the field blank. Description of defining authorization templates is HERE.

Optional

Additional headers

Optional

HTTP method

List of HTTP protocol methods. Available methods: GET, HEAD, POST, PUT, DELETE, PATCH. Choose the required request method according to the API documentation.

Required

URL

Endpoint URL to which the request will be sent. If you call an action from the API of the same PlusWorkflow system in which the datasource is configured, the URL must contain the domain "localhost".

Required

Content-Type

The parameter allows defining the format of the data transferred in the body of the request. The parameter is used only if the "Parameters Body" type parameters are among the input parameters. In other cases the value of this parameter does not matter.

Required

Input parameters

Input parameters id

Input parameters names

Input parameters types

Specifies the id of the input parameters.

In the case of a "URL param" parameter, you must substitute the defined id in the URL of the request in the {id} format, e.g.. http://localhost/{parametr}
In the case of a "Body param" parameter, the defined id will be used as the key of the transmitted data in the body of the request
https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types#multipartform-data

Specifies the display name of the input parameters

URL param - the parameter will be passed in the URL

Body param - the parameter will be passed in the request body

Warning
Parameters of type "Body param" should not be added to requests of type "GET"!

Optional

Output parameters

Output parameters id

Output parameters names

JsonPath

Specifies the id of the output parameters used in mapping

Specifies the display name of the output parameters

Optional

the SAP system.

Panel

title	Configuration required

Before uploading to the server, upload the files from the directory to:

Windows: sapcjo3.dll windows/system32

Linux: libsapjco3.so server/lib

Tomcat: sapjco3.jar server/lib

Then restart the server and upload the plug

Files:

View file

name	sapjco3.jar
height	250

View file

name	sapjco3.dll
height	250

View file

name	libsapjco3.so
height	250

Panel

title	Parameters

Image Added

Parameter	Description	Default value	Type	Comments
Authorization	Authorization template saved		Selection list	List of previously prepared configuration of connections to SAP. For more information, see [SAPDS] Szablony autoryzacji
Function	The name of the BAPI function being called		Text	Next to the parameter, there is a button that allows you to check whether a given function exists in a given SAP connection
Cache time [Seconds]	The time the results are stored in the server's memory for the same calling parameters. Time is counted in seconds	30	Number	The longer the time, the less frequently it will poll the SAP server. Useful when using pagination in DC or for SAPA data that rarely changes.
Parameter logging	It displays in the logs additional parameters with which the function was called. And it displays the results of this function		Logical
Input parameters id	Unique identifier for the parameter		Text	The mark cannot be used. (dots)
Input parameters name	Display name of the input parameter		Text
BAPI parameter name	The name of the input parameter of the function from the BAPI.		Text	When the parameter is in the structure or in the array, the name of the structure / parameter should be given with a dot and then the target parameter, e.g. DOCUMENT_HEADER.NR_DOK (When calling the data source, the array parameters are given as text separated by a semicolon)
Output parameters id	Unique identifier for the parameter		Text	The mark cannot be used. (dots)
Output parameters name	Display name of the output parameter		Text
xPath	'XPath' type path to the node whose value is to be read. XPath tutorial		Text	For example, to read an array value, enter "// TABLE NAME // PARAM"

Panel

title	Sample configuration

Configuration examples::

Source configuration	Sample documentation	Screenshot
mpk.json	Image Added	Image Added
kontrahenci.json	Image Added	Image Added
pz.json	Image Added	Image Added
kodpodatku.json	Image Added	Image Added

Versions Compared

Old Version 2

New Version Current

Key

Image Added

Wtyczka zawiera implementację źródeł danych operujących na RESTful API.

The plugin contains the implementation of datasources operating on the RESTful API.

Configuration description:

Page History

Versions Compared

Old Version 2

New Version Current

Key

Image Added

Wtyczka zawiera implementację źródeł danych operujących na RESTful API.

The plugin contains the implementation of datasources operating on the RESTful API.

Configuration description: