Detaljerade beskrivningar av ESM-lyssnaråtgärder
Detaljerade beskrivningar av ESM-lyssnaråtgärder
AlwaysFailDataCardAction
- Förhindrar att datakortet sparas.
Klass
com.efecte.datamodel.entity.action.implementations.AlwaysFailDataCardAction
Konfigurationsobjekt
| Namn | Nödvändig | Beskrivning |
|---|---|---|
| Felmeddelande | Inga | Ett valfritt felmeddelande som visas för användaren / i loggfilerna. Värdet kan vara en presentationstext för lokaliseringsändamål. Standardvärdet är Valideringsfel (text_validator_error). |
ChangeDataCardValuesAction
- Anger ett attributs värde.
- Rensar ett attributs värde.
Klass
com.efecte.datamodel.entity.action.implementations.ChangeDataCardValuesAction
Konfigurationsobjekt
| Namn | Nödvändig | Beskrivning |
|---|---|---|
| Koda | Ja | Attributets kod. |
| Värde | Ja | Nytt värde för attributet. Eftersom värdet anges som text begränsar det antalet möjliga datatyper, t.ex. fungerar inte referenser. Tomt värde (<värde></värde>) innebär att attributets värde töms. |
Åtgärd för kopiering av datakortvärden
- Kopierar ett värde från källdatakortet till ett annat attributs värde eller till ett värde för ett attribut i måldatakortet.
- Kan även kopiera värden bakom referenser.
- Om det kopierade attributet är flervärde kommer befintliga värden att ERSÄTTAS.
- Flervärden fungerar bara på värddatakort, inte bakom referenser.
- Om värden kopieras till ett flervärdes-målattribut kopieras endast det första värdet om målattributet är av referensdatatypen och källattributet inte är det.
Klass
com.efecte.datamodel.entity.action.implementations.CopyDataCardValuesAction
Konfigurationsobjekt
| Namn | Nödvändig | Beskrivning |
|---|---|---|
| Koda | Ja | Koden för attributet som ska ändras. |
| Värde | Ja | Kod för källdatakortattributet där värdet kopieras från. Eller, om kopiering från en referens: $source_data_card_reference_attribute_code:referred_data_card_attribute_code$ |
KopieraKällreferensÅtgärd
- Skapar en referens från måldatakort till källdatakort.
Klass
com.efecte.datamodel.entity.action.implementations.CopySourceReferenceAction
Konfigurationsobjekt
| Namn | Nödvändig | Beskrivning |
|---|---|---|
| Koda | Ja | En kod för referensattributet i måldatakortet. Detta attribut får en referens till källdatakortet. |
SkapaDataCard-åtgärd
- Skapar ett nytt datakort, baserat på den konfigurerade mallen och i en konfigurerad mapp.
- Lägger valfritt till referenser mellan skaparen och de skapade datakorten.
- Anger valfritt attributvärden i det skapade kortet.
- Som ett specialfall kan man lägga till tiden då redigeringen i ESM-gränssnittet startades (se “:EDITING_START_TIME:” nedan).
Klass
com.efecte.datamodel.entity.action.implementations.CreateDataCardAction
Konfigurationsobjekt
| Namn | Nödvändig | Beskrivning |
|---|---|---|
| Mall | Ja | Mallkod för den mall som det nya datakortet ska baseras på. |
| Mapp | Ja | Mappkod för mappen där det skapade datakortet ska lagras. :SOURCE: kommer att använda skaparens mapp. |
| Referens från källan | Inga | Attributkod för referens- eller bakåtreferensattributet i skaparens datakort som hämtar en referens till det nyskapade datakortet. |
| attribut_kod_i_skapad | Inga | Datatypspecifikt värde som ska sättas till det angivna attributet. Observera att värdet är beroende av datatypspecifika makron, till exempel datummakron. |
| attribut_kod_i_skapad | Inga | :EDITING_START_TIME: placerar redigeringens starttid i ett datum- eller strängattribut för det skapade datakortet. Observera att redigeringens starttid endast är tillgänglig när redigeringen som utlöste denna åtgärd gjordes via GUI-redigeringsvyn; därför bör detta konfigurationsobjekt användas tillsammans med GuiEdit-källvillkoret. |
| attribut_kod_i_skapad | Inga | :SOURCE: skapar en referens till skaparen i ett referensattribut eller kopierar skaparens namn till ett strängattribut. |
| attribut_kod_i_skapad | Inga | $refence_path_to_creator_attribute$ kopierar värdet för det angivna attributet för skaparen till det angivna attributet för den skapade. |
Enhetsdatakortåtgärd
- Flyttar ett datakort till papperskorgen eller återställer det från papperskorgen.
- Tar bort ett datakort permanent.
- Döljer eller gör ett datakort synligt.
Notera:
Till exempel kan DatacardHiddenState-handlern komma i konflikt med en lyssnare som innehåller den här åtgärden. Om mallen har en DatacardHiddenState-handler måste implementeringen av lyssnaren ta hänsyn till detta. Kontrollera exekveringsordningen för lyssnare och hanterare.
Klass
com.efecte.datamodel.entity.action.implementations.EntityDataCardAction
Konfigurationsobjekt
| Namn | Nödvändig | Beskrivning |
|---|---|---|
| Enhetsåtgärd | Ja | Åtgärd: "papperskorg", "återställ", "ta bort permanent", "dölj", "sätt synlig". |
Uttrycksåtgärd
- Kommer att köra ett definierat Python-skript på måldatakort.
Notera:
Namnet på åtgärden är lite missvisande, eftersom den här åtgärden kör skript, inte uttryck (eftersom termerna används i samband med Validator- och Expression-hanterare).
Klass
com.efecte.datamodel.entity.action.implementations.Uttrycksåtgärd
Konfigurationsobjekt
| Namn | Nödvändig | Beskrivning |
|---|---|---|
| Koda | Ja | Kod för ett attribut för måldatakortet. Resultatet av uttrycket kommer att sättas till detta attribut. |
| Uttryck | Ja | Python-skriptet som ska köras. |
MappDataKortÅtgärd
- Flyttar ett datakort till en specifik mapp.
Klass
com.efecte.datamodel.entity.action.implementations.FolderDataCardAction
Konfigurationsobjekt
| Namn | Nödvändig | Beskrivning |
|---|---|---|
| Mapp | Inga | Koden för mappen dit datakortet flyttas, eller ": SOURCE: " om datakortet flyttas till samma mapp där källdata finns. |
| Mappattribut | Inga | Attributets kod som har ett värde som är en mappkod dit datakortet flyttas. Om mappen är konfigurerad kommer den att användas istället för denna. |
| Reservmapp | Inga | Koden för mappen dit datakortet flyttas om det inte finns någon tillgänglig mapp som konfigurerats med antingen mapp- eller mappattributet . |
SparaDataKortÅtgärd
- Skapar en referens från måldatakort till källdatakort.
- Detta möjliggör beräkning av nya värden för attribut som innehåller en hanterare (ExpressionHandler eller liknande).
Klass
com.efecte.datamodel.entity.action.SaveDataCardAction
Konfigurationsobjekt
| Namn | Nödvändig | Beskrivning |
|---|---|---|
| - | - | - |
SparaDataCardXmlTillFilÅtgärd
- Sparar datakortet i XML-format till en angiven fil och mapp.
- Den här åtgärden fungerar endast på det källdatakort som sparas.
- Om filen finns kommer den att skrivas över (filen raderas innan en ny fil skrivs).
- Åtgärden försöker först skriva XML-filen till en temporär fil och byter sedan namn på den temporära filen till den angivna filen.
- Detta är för att förhindra att någon läser resultatfilen innan den är helt skriven.
Klass
com.efecte.datamodel.entity.action.SaveDataCardXmlToFileAction
Konfigurationsobjekt
| Namn | Nödvändig | Beskrivning |
|---|---|---|
| Målfil | Ja | Namn på filen (sökvägen) där XML-filen sparas. Kan innehålla följande makron: $now$, $TIMESTAMP$ och $ENTITY_ID$. Dessa expanderas till aktuellt datum (i formatet åååå-MM-dd), aktuell tidsstämpel (tid som förflutit i millisekunder sedan epoken) respektive ID för datakortet i databasen. |
SkickaDataCardXmlTillWebbtjänst
- Skickar datakort i XML-format till konfigurerad SOAP-webbtjänst.
- Observera att den här åtgärden endast fungerar på det källdatakort som sparas.
Förebyggande grundläggande autentisering
Den här funktionen möjliggör effektivare autentiseringsprocesser genom att skicka autentiseringsuppgifter proaktivt, vilket minskar antalet returer som krävs för autentisering.
Så här aktiverar du:
- Globalt: Ställ in plattformsinställningen datacard.listeners.preemptive.authentication=true
- Per lyssnare: Lägg till "preemptiveAuthentication=true" i objektet "connectionParameters" i åtgärdskonfigurationen.
Obs: Om den är aktiverad globalt kan du inaktivera den för specifika åtgärder genom att ange "preemptiveAuthentication=false" i åtgärdens konfigurationsalternativ "connectionParameters".
Klass
com.efecte.datamodel.entity.action.implementations.webservice.SendDataCardXmlToWebService
Konfigurationsobjekt
| Namn | Nödvändig | Beskrivning |
|---|---|---|
| slutpunktsadress | Ja | Slutpunktsadress som definierar var webbtjänsten finns. Ett exempel: http://localhost:8080/axis2/services/EfecteNotifyService. Du kan lägga till användarnamn och lösenord direkt till URL:en om HTTP BASIC-autentisering används på webbtjänstsidan. Då skulle URL:en se ut så här: http://användare:password@localhost:8080/axis2/services/EfecteNotifyService |
| entitysetTargetNamespace | Ja | Målnamnrymd för entityset-elementet. Ett exempel: http://integration.efecte.com/notify/request |
| operationsnamn | Ja | Operation: för närvarande kan endast värdet vara ”Meddela”. |
| Kräv ändrade uppgifter | Ja | "Sant" eller "Falskt". Om sant skickas meddelandet endast när något har ändrats. Om falskt skickas meddelandet alltid när datakortet sparas. Källvillkor kan fortfarande användas för att definiera när denna åtgärd ska utföras. Till exempel skickas meddelandet endast när ett visst attributs värde har ändrats. |
| användarnamn | Inga | Användarnamn för http-basautentisering. Om inget anges används inte grundläggande autentisering. |
| lösenord | Inga | Lösenord för http-basautentisering. Om det inte anges används inte grundläggande autentisering. |
| useChunkedTransferEncoding | Inga | "Sant" eller "Falskt". Standardvärdet är "Sant". Om falskt används inte chunked överföringskodning. |
| anslutningsparametrar | Definierar alternativen för anslutningskonfiguration. <konfigurationsobjekt> <name>anslutningsparametrar</name> <value>acceptSelfSignedCertificates=false,allowAllHostnamesInCertificate=true,connectionRequestTimeout=60,connectTimeout=60,socketTimeout=60</value> </konfigurationsobjekt> Om den preemptiva grundläggande autentiseringen inte är inställd på "true" i plattformsinställningen "datacard.listeners.preemptive.authentication" och du vill aktivera den för denna lyssnare, lägg till detta under "connectionParameters": preemptiveAuthentication=sant |
Åtgärd för SkickaDataCardXmlTillHttp
- Skickar datakort som ett XML-meddelande till en extern tjänst.
- Det skickade meddelandet kan omvandlas till valfritt format med hjälp av en XSLT-transformation.
- Meddelandena skickas till en kö som sköter om att skicka meddelandet igen om sändningen misslyckas.
Förebyggande grundläggande autentisering
Den här funktionen möjliggör effektivare autentiseringsprocesser genom att skicka autentiseringsuppgifter proaktivt, vilket minskar antalet returer som krävs för autentisering.
Så här aktiverar du:
- Globalt: Ställ in plattformsinställningen datacard.listeners.preemptive.authentication=true
- Per lyssnare: Lägg till "preemptiveAuthentication=true" i objektet "connectionParameters" i åtgärdskonfigurationen.
Obs: Om den är globalt aktiverad kan du inaktivera den för specifika åtgärder genom att ange "preemptiveAuthentication=false" i åtgärdens konfigurationsalternativ "connectionParameters".
Klass
com.efecte.datamodel.entity.action.implementations.http.SendDataCardXmlToHttpAction
Konfigurationsobjekt
| Namn | Nödvändig | Beskrivning |
|---|---|---|
| slutpunkts-URL | URL:en där tredje part tillhandahåller tjänsten. Port och tjänstekontext ska kombineras i denna URL. | |
| slutpunktsmetod | Definierar vilken typ av metod som ska användas för att kontakta tredje part. (publicera/ta bort). | |
| slutpunktstjänst | Den tjänst som kommer att förbrukas från en tredje part, dvs. ESSAnnouncement, Other(=ESM). | |
| användarnamn | Användarnamn definierat i BASIC-autentiseringen från tredje part. | |
| lösenord | Lösenord definierat i BASIC-autentiseringen från tredje part. | |
| datum/tidMönster | Definierar det datum- och tidsformatmönster som ska användas i XML som nyttolast som ska skickas ut. Exempel: <configuration_item> <name>datetimePattern</name> <value>yyyy-MM-dd'T'HH:mm:ssXXX</value> </configuration_item> |
|
| förväntat svarskodmeddelande |
Kombinationen av förväntad svarskod och meddelande. Exempel 1 : Både 200 och 404 accepteras som svarskod. För kod 200 ska svarsmeddelandet vara tomt eller null. För kod 404 ska "Det går inte att ta bort ett icke-existerande meddelande" finnas i svarsmeddelandet. |
|
| xslTransformFile | Definierar platsen där vi kan definiera xsl-filen i filsystemet. <konfigurationsobjekt> <name>xslTransformFile</name> <value>/home/likewise-open/server777/ESSAnnouncement1.xsl</value> </konfigurationsobjekt> |
|
| xsl |
Definierar koden som inbäddad 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"> ]]> |
|
| xslParametrar | Definierar flera inparametrar för transformering med XSL. Exempel 1: <konfigurationsobjekt> <name>xslParametrar</name> <value>ess_tenant=kund</value> </konfigurationsobjekt> Exempel 2: <konfigurationsobjekt> <name>xslParametrar</name> <value>ess_tenant=kund, xxx=yyy</value> </konfigurationsobjekt> |
|
| xsdSchemaFil | Definierar motsvarande xsd-fil för att validera xml-innehållet som ska skickas ut. <konfigurationsobjekt> <name>xsdSchemaFile</name> <värde>/home/likewise-open/server777/update.xsd</värde> </konfigurationsobjekt> |
|
| anslutningsparametrar | Definierar alternativen för anslutningskonfiguration. <konfigurationsobjekt> <name>anslutningsparametrar</name> <value>acceptSelfSignedCertificates=false,allowAllHostnamesInCertificate=true,connectionRequestTimeout=60,connectTimeout=60,socketTimeout=60</value> </konfigurationsobjekt> Om den preemptiva grundläggande autentiseringen inte är inställd på "true" i plattformsinställningen "datacard.listeners.preemptive.authentication" och du vill aktivera den för denna lyssnare, lägg till detta under "connectionParameters": preemptiveAuthentication=sant |
|
| utkodning | Definierar kodningen för utdata-XML. <konfigurationsobjekt> <name>outputEncoding</name> UTF-8 </konfigurationsobjekt> |
SkickaE-poståtgärd
- Skickar post.
- ANMÄRKNINGAR:
- Radering av datakort utlöser också lyssnare, så var försiktig med källvillkor.
- Åtgärden förhindrar inte lagring av datakort även om e-post inte kan skickas av någon anledning (felkonfiguration, e-postserver nere osv.).
- Om lyssnare är konfigurerade att köras som icke-root-användare, se till att den konfigurerade användaren har åtkomst till nödvändiga attribut.
- Inställningar för e-postservern definieras i plattformsinställningarna. De kan inte skrivas över i lyssnarkonfigurationen.
- Minst ett av konfigurationsalternativen Till, Cc eller Bcc måste ha ett värde.
Klass
com.efecte.datamodel.entity.action.implementations.SendMailAction
Konfigurationsobjekt
| Namn | Nödvändig | Beskrivning |
|---|---|---|
| Från | Ja | Avsändaradress(er). Kan innehålla referens(er) till attribut i formatet $attribute_code$ eller $code_of_reference:attribute_code$. Separera flera adresser med kommatecken eller semikolon. |
| Till | Inga | Mottagaradress(er). Kan innehålla referens(er) till attribut i formatet $attributkod$ eller $referenskod:attributkod$. Separera flera adresser med kommatecken eller semikolon. |
| Kopia | Inga | Kopia av mottagaradress. Kan innehålla referenser till attribut i formatet $attributkod$ eller $referenskod:attributkod$. Separera flera adresser med kommatecken eller semikolon. |
| Bcc | Inga | Mottagaradress(er) i blindkopia. Kan innehålla referens(er) till attribut i formatet $attributkod$ eller $referenskod:attributkod$. Separera flera adresser med kommatecken eller semikolon. |
| Ämne | Inga | Meddelandets ämne. Kan innehålla referens(er) till attribut i formatet $attribute_code$ eller $code_of_reference:attribute_code$. Flervärden separeras med kommatecken. |
| Meddelande | Inga | Meddelandetext. Texten kan innehålla radbrytningar. <![CDATA[]]> kan användas om specialtecken behövs. Kan innehålla referens(er) till attribut i formatet $attributkod$ eller $referenskod:attributkod$. Flervärden separeras med kommatecken. |
| Innehållstyp | Inga | MIME-typ för meddelandet. Till exempel text/html. Standardinställningen är text/html. Möjliga värden är text/plain och text/html. |
| Skicka en gång | Inga | Unikt ID. Om Skicka en gång är inställt skickar lyssnaren bara e-post en gång per givet datakort. Om AutoMailSender ersätts med en lyssnare, använd AutoMailSenders attributs klassattribut-ID som värde. När du skapar en ny SendMailAction utan tidigare AutoMailSender-konfiguration, använd vilket unikt ID du vill. Se bara till att ingen annan lyssnare använder samma ID (såvida du inte specifikt vill att två eller fler lyssnare ska använda samma ID). |
| Bilagor | Inga | Filnamn på filer i katalogen "uploads/sendmailaction". Filerna måste läggas till manuellt på servern eftersom det inte finns något grafiskt gränssnitt i Efecte för det. Referens(er) till attribut(er) i formatet $attribute_code$ eller $code_of_reference:attribute_code$. Attribut(er) måste vara av typen Extern referens. Separera flera filer med semikolon. |
SkickaKällaÄndradJMSMeddelandeåtgärd
- Åtgärden skickar ett JMS-meddelande till kön när datakortet har sparats. Meddelandets innehåll är hela datakortet i Efecte XML-format.
Klass
com.efecte.datamodel.entity.action.implementations.SendSourceChangedJMSMessageAction
Konfigurationsobjekt
| Namn | Nödvändig | Beskrivning |
|---|---|---|
| URL | Ja | URL:en dit meddelandet skickas. |
| Ämne | Ja | Ämne för kön. |
| Användare | Inga | Användarkonto. |
| Lösenord | Inga | Lösenord för användarkonto. |
| Kräv ändrade uppgifter | Ja | "Sant" eller "Falskt". Om sant skickas meddelandet endast när något har ändrats. Om falskt skickas meddelandet alltid när datakortet sparas. Källvillkor kan fortfarande användas för att definiera när denna åtgärd ska utföras. Till exempel skickas meddelandet endast när ett visst attributs värde har ändrats. |
| Xml-kodning | Inga | Valfri kodning för XML. |
RiktadSccmUpdateAction
- Utlöser en riktad SCCM uppdatering.
- Detta bör bifogas den administrerade programmallen och bör utlösas när ett AS blir "övervakat" (vanligtvis en del av baslinjekonfigurationen).
- Åtgärden hittar alla datorer som verkar ha den programvaran installerad (baserat på fältet "All installerad programvara"). Den tar sedan SCCM -resurs-ID:n för dessa datorer, köar dem för uppdatering och instruerar slutligen SccmIntegrationTask att utföra en riktad körning med endast de köade ID:na.
Notera:
Själva uppgiftskörningen sker i bakgrunden, så det finns ingen betydande fördröjning när det ursprungliga datakortet sparas. Uppgiftskörningen startas efter några minuter, så om flera AS-kort blir övervakade inom en kort tidsperiod grupperas och uppdateras alla resurs-ID:n i samma SccmIntegrationTask-uppgiftskörning.
Konfigurationsobjekt
| Namn | Nödvändig | Beskrivning |
|---|---|---|
| - | - | - |
TransformDataCardAction
- Åtgärden omvandlar det aktuella redigerade datakortet till ett annat datakort. Använder regler och målmapp som definierats i transformeringarna.
- En ActionChain kan innehålla flera TransformDataCard-åtgärder. Det går också att skapa flera nya kort i en ActionChain.
Obs: Titel
Du måste säkerställa med källvillkor att transformationen endast sker i önskade situationer, till exempel när ett attribut får ett värde för första gången. Annars kan nya datakort skapas när värddatakortet flyttas, kopieras till en annan mapp eller tas bort.
Konfigurationsobjekt
| Namn | Nödvändig | Beskrivning |
|---|---|---|
| Målmall | Ja | Kod för målmallen. |