Szczegółowe opisy działań nasłuchiwacza ESM
Szczegółowe opisy działań nasłuchiwacza ESM
AlwaysFailDataCardAction
- Zapobiega zapisaniu karty danych.
Klasa
com.efecte.datamodel.entity.action.implementations.AlwaysFailDataCardAction
Elementy konfiguracji
| Nazwa | Wymagany | Opis |
|---|---|---|
| Komunikat o błędzie | NIE | Opcjonalny komunikat o błędzie wyświetlany użytkownikowi w plikach dziennika. Wartością może być tekst prezentacyjny do celów lokalizacyjnych. Wartością domyślną jest błąd walidacji (text_validator_error). |
ChangeDataCardValuesAction
- Ustawia wartość atrybutu.
- Czyści wartość atrybutu.
Klasa
com.efecte.datamodel.entity.action.implementations.ChangeDataCardValuesAction
Elementy konfiguracji
| Nazwa | Wymagany | Opis |
|---|---|---|
| Kod | Tak | Kod atrybutu. |
| Wartość | Tak | Nowa wartość atrybutu. Ponieważ wartość jest podana jako tekst, ograniczy to możliwe typy danych, np. odwołania nie działają. Pusta wartość (<value></value>) oznacza opróżnienie wartości atrybutu. |
CopyDataCardValuesAction
- Kopiuje wartość z karty danych źródłowych do wartości innego atrybutu lub do wartości atrybutu na karcie danych docelowych.
- Można również kopiować wartości za odniesieniami.
- Jeśli skopiowany atrybut jest wielowartościowy, istniejące wartości zostaną ZASTĄPIONE.
- Multiwartości działają tylko na karcie danych hosta, a nie za odniesieniami.
- W przypadku kopiowania wartości do atrybutu docelowego o wielu wartościach kopiowana jest tylko pierwsza wartość, jeśli atrybut docelowy ma typ danych referencyjnych, a atrybut źródłowy nie.
Klasa
com.efecte.datamodel.entity.action.implementations.CopyDataCardValuesAction
Elementy konfiguracji
| Nazwa | Wymagany | Opis |
|---|---|---|
| Kod | Tak | Kod atrybutu, który ma zostać zmieniony. |
| Wartość | Tak | Kod atrybutu karty danych źródłowych, z którego kopiowana jest wartość. Lub, w przypadku kopiowania z referencji: $source_data_card_reference_attribute_code:referred_data_card_attribute_code$ |
CopySourceReferenceAction
- Tworzy odniesienie z kart danych docelowych do kart danych źródłowych.
Klasa
com.efecte.datamodel.entity.action.implementations.CopySourceReferenceAction
Elementy konfiguracji
| Nazwa | Wymagany | Opis |
|---|---|---|
| Kod | Tak | Kod atrybutu referencyjnego na karcie danych docelowych. Ten atrybut będzie odwoływał się do karty danych źródłowych. |
Utwórz akcję karty danych
- Tworzy nową kartę danych na podstawie skonfigurowanego szablonu i w skonfigurowanym folderze.
- Opcjonalnie dodaje odniesienia pomiędzy twórcą, a utworzonymi kartami danych.
- Opcjonalnie ustawia wartości atrybutów na utworzonej karcie.
- Jako przypadek szczególny można dodać czas rozpoczęcia edycji w interfejsie użytkownika ESM (patrz „:EDITING_START_TIME:” poniżej).
Klasa
com.efecte.datamodel.entity.action.implementations.CreateDataCardAction
Elementy konfiguracji
| Nazwa | Wymagany | Opis |
|---|---|---|
| Szablon | Tak | Kod szablonu, na którym będzie oparta nowa karta danych. |
| Falcówka | Tak | Kod folderu, w którym zostanie zapisana utworzona karta danych. :SOURCE: użyje folderu twórcy. |
| Odniesienie ze źródła | NIE | Kod atrybutu dla atrybutu odniesienia lub odniesienia wstecznego na karcie danych twórcy, który będzie odwoływał się do nowo utworzonej karty danych. |
| kod_atrybutu_w_utworzonym | NIE | Wartość specyficzna dla typu danych , która ma zostać ustawiona dla wskazanego atrybutu. Należy pamiętać, że wartość ta podlega makrom specyficznym dla typu danych, takim jak makra daty. |
| kod_atrybutu_w_utworzonym | NIE | :EDITING_START_TIME: umieści czas rozpoczęcia edycji w atrybucie daty lub ciągu znaków utworzonej karty danych. Należy pamiętać, że czas rozpoczęcia edycji jest dostępny tylko wtedy, gdy edycja, która wyzwoliła tę akcję, została przeprowadzona za pośrednictwem widoku edycji GUI; dlatego ten element konfiguracji powinien być używany razem z warunkiem źródłowym GuiEdit. |
| kod_atrybutu_w_utworzonym | NIE | :SOURCE: utworzy odwołanie do twórcy w atrybucie odwołania lub skopiuje nazwę twórcy do atrybutu ciągu. |
| kod_atrybutu_w_utworzonym | NIE | $refence_path_to_creator_attribute$ kopiuje wartość wskazanego atrybutu twórcy do wskazanego atrybutu obiektu utworzonego. |
EntityDataCardAction
- Przenosi kartę danych do kosza lub przywraca ją z kosza.
- Trwale usuwa kartę danych.
- Ukrywa lub wyświetla kartę danych.
Notatka:
Na przykład, obiekt DatacardHiddenState-handler może kolidować z obiektem nasłuchującym zawierającym tę akcję. Jeśli szablon zawiera obiekt DatacardHiddenState-handler, implementacja obiektu nasłuchującego musi to uwzględnić. Sprawdź kolejność wykonywania obiektów nasłuchujących i obiektów nasłuchujących.
Klasa
com.efecte.datamodel.entity.action.implementations.EntityDataCardAction
Elementy konfiguracji
| Nazwa | Wymagany | Opis |
|---|---|---|
| Akcja jednostki | Tak | Akcja: „kosz”, „przywróć”, „usuń trwale”, „ukryj”, „ustaw widoczne”. |
AkcjaWyrażenia
- Wykona zdefiniowany skrypt Pythona na docelowych kartach danych.
Notatka:
Nazwa akcji jest nieco myląca, ponieważ uruchamia ona skrypty, a nie wyrażenia (w rozumieniu stosowanym w kontekście walidatora i obsługi wyrażeń).
Klasa
com.efecte.datamodel.entity.action.implementations.ExpressionAction
Elementy konfiguracji
| Nazwa | Wymagany | Opis |
|---|---|---|
| Kod | Tak | Kod atrybutu docelowej karty danych. Wynik wyrażenia zostanie ustawiony na ten atrybut. |
| Wyrażenie | Tak | Skrypt Pythona, który ma zostać wykonany. |
FolderDataCardAction
- Przenosi kartę danych do określonego folderu.
Klasa
com.efecte.datamodel.entity.action.implementations.FolderDataCardAction
Elementy konfiguracji
| Nazwa | Wymagany | Opis |
|---|---|---|
| Falcówka | NIE | Kod folderu, do którego przenoszona jest karta danych lub „: SOURCE: ”, jeśli karta danych jest przenoszona do tego samego folderu, w którym znajdują się dane źródłowe. |
| Atrybut folderu | NIE | Kod atrybutu, którego wartość jest kodem folderu, do którego przenoszona jest karta danych. Jeśli folder jest skonfigurowany, zostanie on użyty zamiast tego. |
| Folder zapasowy | NIE | Kod folderu, do którego przenoszona jest karta danych, jeśli nie jest dostępny żaden folder skonfigurowany za pomocą atrybutu folder lub Folder . |
Zapisz akcję karty danych
- Tworzy odniesienie z kart danych docelowych do kart danych źródłowych.
- Dzięki temu możliwe jest obliczenie nowych wartości atrybutów zawierających procedurę obsługi (ExpressionHandler lub podobną).
Klasa
com.efecte.datamodel.entity.action.SaveDataCardAction
Elementy konfiguracji
| Nazwa | Wymagany | Opis |
|---|---|---|
| - | - | - |
SaveDataCardXmlToFileAction
- Zapisuje kartę danych w formie XML do określonego pliku i folderu.
- Ta akcja działa tylko na zapisanej karcie danych źródłowych.
- Jeżeli plik istnieje, zostanie nadpisany (plik zostanie usunięty przed zapisaniem nowego pliku).
- Akcja najpierw próbuje zapisać XML do pliku tymczasowego, a następnie zmienia nazwę pliku tymczasowego na określony plik.
- Ma to na celu uniemożliwienie odczytania pliku wynikowego przed jego całkowitym zapisaniem.
Klasa
com.efecte.datamodel.entity.action.SaveDataCardXmlToFileAction
Elementy konfiguracji
| Nazwa | Wymagany | Opis |
|---|---|---|
| Plik docelowy | Tak | Nazwa pliku (ścieżka), w którym zapisany jest plik XML. Może zawierać następujące makra: $now$, $TIMESTAMP$ i $ENTITY_ID$. Są one rozwijane odpowiednio do bieżącej daty (w formacie rrrr-MM-dd), bieżącego znacznika czasu (czas, który upłynął od epoki w milisekundach) oraz identyfikatora karty danych w bazie danych. |
Wyślij kartę danych Xml do usługi internetowej
- Wysyła kartę danych w formie XML do skonfigurowanej usługi sieciowej SOAP.
- Należy pamiętać, że ta akcja działa tylko na karcie danych źródłowych, która została zapisana.
Uwierzytelnianie podstawowe prewencyjne
Funkcja ta zwiększa efektywność procesów uwierzytelniania poprzez proaktywne wysyłanie danych uwierzytelniających i redukcję liczby cykli uwierzytelniania.
Jak włączyć:
- Globalnie: Ustaw ustawienie platformy datacard.listeners.preemptive.authentication=true
- Na odbiornik: w konfiguracji akcji dodaj „preemptiveAuthentication=true” do elementu „connectionParameters”
Uwaga: jeśli opcja jest włączona globalnie, można ją wyłączyć dla konkretnych akcji, ustawiając opcję „preemptiveAuthentication=false” w elemencie konfiguracji „connectionParameters” akcji.
Klasa
com.efecte.datamodel.entity.action.implementations.webservice.SendDataCardXmlToWebService
Elementy konfiguracji
| Nazwa | Wymagany | Opis |
|---|---|---|
| adres punktu końcowego | Tak | Adres punktu końcowego, który definiuje lokalizację usługi sieciowej. Przykład: http://localhost:8080/axis2/services/EfecteNotifyService. Użytkownika i hasło można umieścić bezpośrednio w adresie URL, jeśli po stronie usługi sieciowej używane jest uwierzytelnianie HTTP BASIC. W takim przypadku adres URL wyglądałby następująco: http://user:password@localhost:8080/axis2/services/EfecteNotifyService |
| zestaw_jednostek_docelowa_przestrzeń_nazw | Tak | Docelowa przestrzeń nazw dla elementu entityset. Przykład: http://integration.efecte.com/notify/request |
| nazwa_operacji | Tak | Operacja: obecnie jedyną wartością może być „Powiadom”. |
| Wymagaj zmienionych danych | Tak | „Prawda” lub „Fałsz”. Jeśli wartość to prawda, wiadomość jest wysyłana tylko wtedy, gdy coś się zmieni. Jeśli wartość to fałsz, wiadomość jest wysyłana zawsze po zapisaniu karty danych. Warunki źródłowe nadal mogą być używane do definiowania momentu wykonania tej akcji. Na przykład wiadomość jest wysyłana tylko wtedy, gdy zmieni się wartość określonego atrybutu. |
| nazwa użytkownika | NIE | Nazwa użytkownika do uwierzytelniania podstawowego HTTP. W przeciwnym razie uwierzytelnianie podstawowe nie będzie używane. |
| hasło | NIE | Hasło do uwierzytelniania podstawowego HTTP. W przypadku jego braku uwierzytelnianie podstawowe nie będzie używane. |
| użyj kodowaniaChunkedTransferEncoding | NIE | „Prawda” lub „Fałsz”. Domyślnie „Prawda”. Jeśli fałsz, kodowanie transferu fragmentarycznego nie jest używane. |
| parametry połączenia | Definiuje opcje konfiguracji połączenia. <element_konfiguracji> <name>connectionParameters</name> <value>acceptSelfSignedCertificates=false,allowAllHostnamesInCertificate=true,connectionRequestTimeout=60,connectTimeout=60,socketTimeout=60</value> </element_konfiguracji> Jeśli wyprzedzające uwierzytelnianie podstawowe nie jest ustawione na „true” w ustawieniu platformy „datacard.listeners.preemptive.authentication” i chcesz je włączyć dla tego odbiornika, dodaj to w „connectionParameters”: preemptiveAuthentication=true |
Wyślij kartę danych Xml do akcji HTTP
- Wysyła kartę danych jako wiadomość XML do usługi zewnętrznej.
- Wysłaną wiadomość można przekształcić do dowolnego żądanego formatu za pomocą transformacji XSLT.
- Wiadomości są wysyłane do kolejki, która zajmuje się ponownym wysłaniem wiadomości, jeśli wysyłanie się nie powiedzie.
Uwierzytelnianie podstawowe prewencyjne
Funkcja ta zwiększa efektywność procesów uwierzytelniania poprzez proaktywne wysyłanie danych uwierzytelniających i redukcję liczby cykli uwierzytelniania.
Jak włączyć:
- Globalnie: Ustaw ustawienie platformy datacard.listeners.preemptive.authentication=true
- Na odbiornik: w konfiguracji akcji dodaj „preemptiveAuthentication=true” do elementu „connectionParameters”
Uwaga: jeśli opcja jest włączona globalnie, można ją wyłączyć dla konkretnych akcji, ustawiając opcję „preemptiveAuthentication=false” w elemencie konfiguracji „connectionParameters” akcji.
Klasa
com.efecte.datamodel.entity.action.implementations.http.SendDataCardXmlToHttpAction
Elementy konfiguracji
| Nazwa | Wymagany | Opis |
|---|---|---|
| adresURL punktu końcowego | Adres URL, pod którym strona trzecia świadczy usługę. Port i kontekst usługi powinny być zawarte w tym adresie URL. | |
| Metoda punktu końcowego | Definiuje, jaka metoda zostanie użyta do nawiązania kontaktu ze stroną trzecią (wysłanie/usunięcie). | |
| Usługa punktu końcowego | Usługa, która będzie wykorzystywana, jest świadczona przez stronę trzecią, tj. ESSAnnouncement, Other(=ESM). | |
| nazwa użytkownika | Nazwa użytkownika zdefiniowana w uwierzytelnianiu BASIC przez osobę trzecią. | |
| hasło | Hasło zdefiniowane w uwierzytelnianiu BASIC przez osobę trzecią. | |
| Wzorzec daty i godziny | Definiuje wzorzec formatu daty i godziny, który będzie używany w pliku xml jako dane do wysłania. Przykład: <configuration_item> <name>datetimePattern</name> <value>yyyy-MM-dd'T'HH:mm:ssXXX</value> </configuration_item> |
|
| OczekiwanyKodOdpowiedziMessage |
Kombinacja oczekiwanego kodu odpowiedzi i komunikatu. Przykład 1 : Zarówno 200, jak i 404 są akceptowane jako kod odpowiedzi. W przypadku kodu 200 komunikat odpowiedzi powinien być pusty lub zerowy. W przypadku kodu 404 komunikat odpowiedzi powinien zawierać tekst „Nie można usunąć nieistniejącego ogłoszenia”. |
|
| Plik transformacji xsl | Definiuje miejsce, w którym można zdefiniować plik xsl w systemie plików. <element_konfiguracji> <name>xslTransformFile</name> <value>/home/likewise-open/server777/ESSAnnouncement1.xsl</value> </element_konfiguracji> |
|
| xsl |
Definiuje kod jako osadzony xsl: <xsl:transform version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns="http://www.efecte.com/integration/update/xsd/1.0" > ]]> |
|
| xslParameters | Definiuje wiele parametrów wejściowych do transformacji za pomocą XSL. Przykład 1: <element_konfiguracji> <name>xslParameters</name> <value>ess_tenant=klient</value> </element_konfiguracji> Przykład 2: <element_konfiguracji> <name>xslParameters</name> <value>ess_tenant=klient, xxx=yyy</value> </element_konfiguracji> |
|
| Plik schematu xsd | Definiuje odpowiedni plik xsd w celu sprawdzenia zawartości xml, która zostanie wysłana. <element_konfiguracji> <name>xsdSchemaFile</name> <value>/home/likewise-open/server777/update.xsd</value> </element_konfiguracji> |
|
| parametry połączenia | Definiuje opcje konfiguracji połączenia. <element_konfiguracji> <name>connectionParameters</name> <value>acceptSelfSignedCertificates=false,allowAllHostnamesInCertificate=true,connectionRequestTimeout=60,connectTimeout=60,socketTimeout=60</value> </element_konfiguracji> Jeśli wyprzedzające uwierzytelnianie podstawowe nie jest ustawione na „true” w ustawieniu platformy „datacard.listeners.preemptive.authentication” i chcesz je włączyć dla tego odbiornika, dodaj to w „connectionParameters”: preemptiveAuthentication=true |
|
| kodowanie wyjściowe | Definiuje kodowanie dla wyjściowego pliku XML. <element_konfiguracji> <name>kodowanie_wyjścia</name> <value>UTF-8</value> </element_konfiguracji> |
Wyślij akcję poczty
- Wysyła pocztę.
- UWAGI:
- Usunięcie karty danych również wyzwala nasłuchiwanie, należy więc uważać na warunki źródłowe.
- Ta czynność nie uniemożliwia przechowywania danych na karcie, nawet jeśli z jakiegoś powodu nie można wysłać wiadomości e-mail (błędna konfiguracja, awaria serwera poczty itp.).
- Jeśli programy nasłuchujące są skonfigurowane do uruchamiania przez użytkownika innego niż root, upewnij się, że skonfigurowany użytkownik ma dostęp do wymaganych atrybutów.
- Ustawienia serwera poczty są definiowane w Ustawieniach platformy. Nie można ich nadpisać w konfiguracji programu nasłuchującego.
- Przynajmniej jeden z elementów konfiguracji Do, DW lub UDW musi mieć wartość.
Klasa
com.efecte.datamodel.entity.action.implementations.SendMailAction
Elementy konfiguracji
| Nazwa | Wymagany | Opis |
|---|---|---|
| Z | Tak | Adres(y) nadawcy. Mogą zawierać odniesienia do atrybutów w formacie $attribute_code$ lub $code_of_reference:attribute_code$. Oddzielaj adresy przecinkiem lub średnikiem. |
| Do | NIE | Adres(y) odbiorcy. Może zawierać odniesienia do atrybutów w formacie $attribute_code$ lub $code_of_reference:attribute_code$. Oddzielaj adresy przecinkiem lub średnikiem. |
| DW | NIE | Kopia adresu(ów) odbiorcy. Może zawierać odniesienia do atrybutów w formacie $attribute_code$ lub $code_of_reference:attribute_code$. Oddzielaj adresy przecinkiem lub średnikiem. |
| UDW | NIE | Adres(y) odbiorcy w ukrytej kopii. Może zawierać odniesienia do atrybutów w formacie $attribute_code$ lub $code_of_reference:attribute_code$. Oddzielaj adresy przecinkiem lub średnikiem. |
| Temat | NIE | Temat wiadomości. Może zawierać odniesienia do atrybutów w formacie $attribute_code$ lub $code_of_reference:attribute_code$. Wartości wielowartościowe są rozdzielone przecinkiem. |
| Wiadomość | NIE | Tekst wiadomości. Tekst może zawierać podziały wiersza. Można użyć <![CDATA[]]>, jeśli potrzebne są znaki specjalne. Może zawierać odniesienia do atrybutów w formacie $attribute_code$ lub $code_of_reference:attribute_code$. Wartości wielowartościowe są rozdzielone przecinkiem. |
| Typ zawartości | NIE | Typ MIME wiadomości. Na przykład text/html. Domyślnie text/html. Możliwe wartości to text/plain i text/html. |
| Wyślij raz | NIE | Unikalny identyfikator. Jeśli opcja „Wyślij raz” jest ustawiona, obiekt nasłuchujący wyśle pocztę tylko raz dla danej karty danych. W przypadku zastąpienia obiektu AutoMailSender obiektem nasłuchującym, należy użyć identyfikatora atrybutu klasy obiektu AutoMailSender jako wartości. Tworząc nową akcję SendMailAction bez wcześniejszej konfiguracji obiektu AutoMailSender, należy użyć dowolnego unikalnego identyfikatora. Należy jednak upewnić się, że żaden inny obiekt nasłuchujący nie będzie używał tego samego identyfikatora (chyba że chcesz, aby dwa lub więcej obiektów nasłuchujących używało tego samego identyfikatora). |
| Załączniki | NIE | Nazwy plików w katalogu o nazwie „uploads/sendmailaction”. Pliki muszą zostać ręcznie dodane do serwera, ponieważ w programie Efecte nie ma graficznego interfejsu użytkownika. Odniesienia do atrybutów w formacie $attribute_code$ lub $code_of_reference:attribute_code$. Atrybuty muszą być typu odniesienia zewnętrznego. Oddziel pliki średnikami. |
WyślijAkcjęWysyłaniaZmienionegoŹródłaJMSMessage
- Akcja wyśle komunikat JMS do kolejki po zapisaniu karty danych. Treścią komunikatu jest cała karta danych w formacie Efecte XML.
Klasa
com.efecte.datamodel.entity.action.implementations.SendSourceChangedJMSMessageAction
Elementy konfiguracji
| Nazwa | Wymagany | Opis |
|---|---|---|
| Adres URL | Tak | Adres URL, pod który wysyłana jest wiadomość. |
| Temat | Tak | Podmiot kolejki. |
| Użytkownik | NIE | Konto użytkownika. |
| Hasło | NIE | Hasło do konta użytkownika. |
| Wymagaj zmienionych danych | Tak | „Prawda” lub „Fałsz”. Jeśli wartość to prawda, wiadomość jest wysyłana tylko wtedy, gdy coś się zmieni. Jeśli wartość to fałsz, wiadomość jest wysyłana zawsze po zapisaniu karty danych. Warunki źródłowe nadal mogą być używane do definiowania momentu wykonania tej akcji. Na przykład wiadomość jest wysyłana tylko wtedy, gdy zmieni się wartość określonego atrybutu. |
| Kodowanie XML | NIE | Opcjonalne kodowanie XML. |
TargetedSccmUpdateAction
- Wyzwala ukierunkowaną aktualizację SCCM .
- Należy go dołączyć do szablonu administrowanego oprogramowania i uruchomić, gdy system autonomiczny (AS) stanie się „Monitorowany” (zwykle jest to część konfiguracji bazowej).
- Akcja wyszukuje wszystkie komputery, na których prawdopodobnie jest zainstalowane to oprogramowanie (na podstawie pola „Całe zainstalowane oprogramowanie”). Następnie pobiera identyfikatory zasobów SCCM tych komputerów, kolejkuje je do aktualizacji i na koniec instruuje SccmIntegrationTask, aby wykonał docelowe uruchomienie, używając tylko identyfikatorów z kolejki.
Notatka:
Samo uruchomienie zadania odbywa się w tle, więc nie występuje znaczące opóźnienie podczas zapisywania oryginalnej karty danych. Uruchomienie zadania rozpoczyna się po kilku minutach, więc jeśli kilka kart AS zostanie objętych monitorowaniem w krótkim czasie, wszystkie identyfikatory zasobów zostaną zgrupowane i zaktualizowane w tym samym uruchomieniu zadania SccmIntegrationTask.
Elementy konfiguracji
| Nazwa | Wymagany | Opis |
|---|---|---|
| - | - | - |
TransformDataCardAction
- Akcja przekształca aktualnie edytowaną kartę danych w inną kartę danych. Używa reguł i folderu docelowego zdefiniowanych w transformacjach.
- Jeden łańcuch akcji może zawierać kilka akcji TransformDataCard. Obsługiwane jest również tworzenie kilku nowych kart w łańcuchu akcji.
Uwaga: Tytuł
Należy upewnić się, że warunki źródłowe powodują, że transformacja ma miejsce tylko w pożądanych sytuacjach, na przykład gdy atrybut otrzymuje wartość po raz pierwszy. W przeciwnym razie nowe karty danych mogą zostać utworzone za każdym razem, gdy karta danych hosta zostanie przeniesiona, skopiowana do innego folderu lub usunięta.
Elementy konfiguracji
| Nazwa | Wymagany | Opis |
|---|---|---|
| Szablon docelowy | Tak | Kod szablonu docelowego. |