ESM-lyssnare implementerade åtgärder
ESM-lyssnare implementerade åtgärder
AlwaysFailDataCardAction
Klass: com.efecte.datamodel.entity.action.implementations.AlwaysFailDataCardAction
Utlösare: förspara
Beskrivning: Förhindrar att datakortet sparas.
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) (Eftersom TODO: lägg till byggnummer (UNDER IMPLEMENTATION)) |
Exempel
<action>
<name>Prevent saving of data card</name>
<class>com.efecte.datamodel.entity.action.implementations.AlwaysFailDataCardAction</class>
</action>Åtgärd för ändring av datakortvärden
Klass: com.efecte.datamodel.entity.action.implementations.ChangeDataCardValuesAction
Utlösare: före sparning eller efter sparning
Beskrivning: Anger ett attributs värde.
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 (uttryckt som <värde></värde>) innebär att attributets värde töms [sedan 4.2/4.1 4110; tidigare fungerade inte detta och orsakade fel med de flesta datatyper]. |
Exempel
<action>
<name>Set value to Closed</name>
<class>com.efecte.datamodel.entity.action.implementations.ChangeDataCardValuesAction</class>
<configuration_item>
<name>Code</name>
<value>jobstate</value>
</configuration_item>
<configuration_item>
<name>Value</name>
<value>Closed</value>
</configuration_item>
</action>Åtgärd för kopiering av datakortvärden
Klass: com.efecte.datamodel.entity.action.implementations.CopyDataCardValuesAction
Utlösare: före sparning eller efter sparning
Beskrivning: 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.
4.2 (>=4209) Om det kopierade attributet är flervärde kommer befintliga värden att ERSÄTTAS. Detta kan inte konfigureras. Flervärden fungerar bara på värddatakort, inte bakom referenser.
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$ |
Exempel
<action>
<name>Copy parent incident's status to child indicents</name>
<class>com.efecte.datamodel.entity.action.implementations.CopyDataCardValuesAction</class>
<configuration_item>
<name>Code</name>
<value>jobstate</value>
</configuration_item>
<configuration_item>
<name>Value</name>
<value>jobstate</value>
</configuration_item>
</action>KopieraKällreferensÅtgärd
Klass: com.efecte.datamodel.entity.action.implementations.CopySourceReferenceAction
Utlösare: spara efter
Beskrivning: Kopierar en referens till källdatakort till måldatakort. (Sedan: Effekt 4.1 4111).
| Namn | Nödvändig | Beskrivning |
|---|---|---|
| Koda | Ja | En kod för referensattributet i måldatakortet. Detta attribut får en referens till källdatakortet. |
Exempel
<action>
<name></name>
<class>com.efecte.datamodel.entity.action.implementations.CopySourceReferenceAction</class>
<configuration_item>
<name>Code</name>
<value></value>
</configuration_item>
</action>SkapaDataCard-åtgärd
Klass: com.efecte.datamodel.entity.action.implementations.CreateDataCardAction
Utlösare: spara efter
Beskrivning: Skapar ett nytt datakort baserat på en konfigurerad mall och i en konfigurerad mapp. Lägger valfritt till referenser mellan skaparen och de skapade datakorten, och anger eventuella attributvärden i det skapade kortet. Som ett specialfall kan man lägga till tiden då redigeringen i Efectes grafiska gränssnitt startades (se SC-604).
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. |
Exempel
<action>
<name>Create new editing report</name>
<class>com.efecte.datamodel.entity.action.implementations.CreateDataCardAction</class>
<configuration_item>
<name>Template</name>
<value>editing_report</value>
</configuration_item>
<configuration_item>
<name>Folder</name>
<value>editing_reports/value>
</configuration_item>
<configuration_item>
<name>Reference from source</name>
<value>ref_to_editing_reports</value>
</configuration_item>
<configuration_item>
<name>start_time</name>
<value>:EDITING_START_TIME:</value>
</configuration_item>
<configuration_item>
<name>end_time</name>
<value>now</value>
</configuration_item>
<configuration_item>
<name>incident_subject</name>
<value>$subject$</value>
</configuration_item>
<configuration_item>
<name>ref_to_incident</name>
<value>:SOURCE:</value>
</configuration_item>
</action>Enhetsdatakortåtgärd
Klass: com.efecte.datamodel.entity.action.implementations.EntityDataCardAction
Utlösare: förspara
Beskrivning: Flyttar ett datakort till papperskorgen, återställer det från papperskorgen, tar bort, döljer eller gör ett datakort synligt permanent. Observera att till exempel DatacardHiddenState-handlern kan hamna i konflikt med en lyssnare som innehåller denna åtgärd. Om mallen har en DatacardHiddenState-handler måste implementeringen av lyssnaren ta hänsyn till detta.
Notera:
Åtgärden "ta bort permanent" fungerar för närvarande inte med behörighet som inte är root --> BUG-003907
Konfigurationsobjekt
| Namn | Nödvändig | Beskrivning |
|---|---|---|
| Enhetsåtgärd | Ja | Åtgärd: "papperskorg", "återställ", "ta bort permanent", "dölj", "ställ in synlig" |
Exempel
<action>
<name>Move data card to trashcan</name>
<class>com.efecte.datamodel.entity.action.implementations.EntityDataCardAction</class>
<configuration_item>
<name>Entity action</name>
<value>trashcan</value>
</configuration_item>
</action>
<action>
<name>Restore data card from trashcan</name>
<class>com.efecte.datamodel.entity.action.implementations.EntityDataCardAction</class>
<configuration_item>
<name>Entity action</name>
<value>restore</value>
</configuration_item>
</action>
<action>
<name>Permanently delete data card</name>
<class>com.efecte.datamodel.entity.action.implementations.EntityDataCardAction</class>
<configuration_item>
<name>Entity action</name>
<value>delete permanently</value>
</configuration_item>
</action>
<action>
<name>Hide data card</name>
<class>com.efecte.datamodel.entity.action.implementations.EntityDataCardAction</class>
<configuration_item>
<name>Entity action</name>
<value>hide</value>
</configuration_item>
</action>
<action>
<name>Set data card visible</name>
<class>com.efecte.datamodel.entity.action.implementations.EntityDataCardAction</class>
<configuration_item>
<name>Entity action</name>
<value>set visible</value>
</configuration_item>
</action>Uttrycksåtgärd
Klass: com.efecte.datamodel.entity.action.implementations.Uttrycksåtgärd
Utlösare: före sparning eller efter sparning
Beskrivning: Kommer att köra ett definierat Python-skript på måldatakort. (Sedan: Efecte 4.1 4111).
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).
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
Klass: com.efecte.datamodel.entity.action.implementations.FolderDataCardAction
Utlösare: före sparning eller efter sparning
Beskrivning: Flyttar ett datakort till en specifik mapp.
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 . |
Om åtgärden inte har någon konfiguration flyttas datakortet till samma mapp där källdatakortet finns. Det rekommenderas dock att ange mappkonfigurationen. Källdatakortets mapp är standardinställningen eftersom den här åtgärden ersatte en annan åtgärd som flyttade måldatakort till källdatakortets mapp och ett uppdateringsskript, som skulle ha genererat den nödvändiga konfigurationen, skulle ha varit för mycket arbete.
- Eftersom >=4226. Fungerar med (testad) sträng, tal, decimal, datum, datum och tid, referens och statisk sträng och statiskt tal. Kan fungera med andra datatyper också. Inte testad med DropDownReference, men jag förstår inte varför det inte skulle fungera med den också.
Exempel
<action>
<name>Move data card to another folder</name>
<class>com.efecte.datamodel.entity.action.implementations.FolderDataCardAction</class>
<configuration_item>
<name>folder</name>
<value>folder_code</value>
</configuration_item>
</action>
<action>
<name>Move data card to another folder specified by an attribute</name>
<class>com.efecte.datamodel.entity.action.implementations.FolderDataCardAction</class>
<configuration_item>
<name>Folder attribute</name>
<value>attribute_code</value>
</configuration_item>
</action>SparaDataKortÅtgärd
Klass: com.efecte.datamodel.entity.action.SaveDataCardAction
Utlösare: spara efter
Beskrivning: Sparar datakortet. Detta möjliggör beräkning av nya värden för attribut som innehåller en hanterare (ExpressionHandler eller liknande).
Konfigurationsobjekt
| Namn | Nödvändig | Beskrivning |
|---|---|---|
| - | - | - |
Exempel
<action_chain>
<name>Saves datacards</name>
<action>
<name>Saving datacards</name>
<class>com.efecte.datamodel.entity.action.SaveDataCardAction</class>
</action>
</action_chain>SparaDataCardXmlTillFilÅtgärd
Sedan: 5,4 5400
Klass: com.efecte.datamodel.entity.action.SaveDataCardXmlToFileAction
Utlösare: spara efter
Beskrivning: Sparar datakortet i XML-format till en angiven fil och mapp. Observera att den här åtgärden endast fungerar på det sparade källdatakortet. Om filen finns kommer den att skrivas över (filen raderas innan den nya filen 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 för att förhindra att någon läser resultatfilen innan den är helt skriven.
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) och ID för datakortet i databasen. |
Exempel
<action>
<name>Save to file</name>
<class>com.efecte.datamodel.entity.action.implementations.SaveDataCardXmlToFileAction</class>
<configuration_item>
<name>Target file</name>
<value>C:/Temp/entity-$ENTITY_ID$-$TIMESTAMP$.xml</value>
</configuration_item>
</action>SkickaDataCardXmlTillWebbtjänst
Sedan: 4.2 4235
Klass: com.efecte.datamodel.entity.action.implementations.webservice.SendDataCardXmlToWebService
Utlösare: spara efter
Beskrivning: Skickar datakort i XML-format till konfigurerad SOAP-webbtjänst. Observera att den här åtgärden endast fungerar på det sparade källdatakort.
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. |
SkickaE-poståtgärd
Klass: com.efecte.datamodel.entity.action.implementations.SendMailAction
Utlösare: spara efter
Beskrivning: Skickar e-post.
Sedan: 5.1 version 5114
Anteckningar:
- 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.
- Skillnader mot AutoMailSenderHandler:
- Mappmetadata
automail_recipientochautomail_recipient_[attribute_code]stöds inte. De kan ersättas med FolderSourceConditions. - Taggarna
$name$,$template$och$from$stöds inte. - Inställningen do_not_check_for_change stöds inte. Eftersom den här åtgärden inte kontrollerar om värdena för datakortet ändras behövs inte inställningen. SourceConditions kan användas för att implementera förutsättningar för den här åtgärden.
- Mappmetadata
Konfigurationsobjekt
| Namn | Nödvändig | Beskrivning |
|---|---|---|
| Från | Ja | Avsändaradress(er). Kan innehålla referens(er) till attribut(er) 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) för 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. |
Exempel
<action>
<name>Send mail</name>
<class>com.efecte.datamodel.entity.action.implementations.SendMailAction</class>
<configuration_item>
<name>From</name>
<value>servicedesk@company.com</value>
</configuration_item>
<configuration_item>
<name>To</name>
<value>$customer:email$</value>
</configuration_item>
<configuration_item>
<name>Subject</name>
<value>Your request for support - $Identifier$ has been received</value>
</configuration_item>
<configuration_item>
<name>Message</name>
<value>Thank you for contacting Service.</value>
</configuration_item>
</action>SkickaKällaÄndradJMSMeddelandeåtgärd
Klass: com.efecte.datamodel.entity.action.implementations.SendSourceChangedJMSMessageAction
Utlösare: före sparning eller efter sparning
Beskrivning: Åtgärden skickar ett JMS-meddelande till kön när datakortet sparas. Meddelandets innehåll är hela datakortet i Efecte XML-format.
Konfigurationsobjekt
| Namn | Nödvändig | Beskrivning |
|---|---|---|
| URL | Ja | URL:en dit meddelandet skickas. |
| Ämne | Ja | Ämne för kön. |
| Användare | Nej, men behövs med Efecte Integration Suite | Användarkonto. |
| Lösenord | Nej, men behövs med Efecte Integration Suite | 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
Sedan: 5.1 51??
Klass: com.efecte.integration.database.inventory.RiktadSccmUpdateAction
Utlösare: spara efter
Beskrivning: Utlöser en riktad SCCM uppdatering. Denna bör bifogas mallen för administrerad programvara och bör utlösas när ett AS blir "Övervakat" (se exemplet nedan). Å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.
Observera att själva uppgiftskörningen sker i bakgrunden, så det blir 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.
OBS: Vi övervägde också att ge detta ett mer generiskt namn, t.ex. något relaterat till databasinventering, eller till och med "RunSchedulableTaskAction", men eftersom detta nu är kopplat till SCCM och bara utlöser en viss typ av SccmIntegrationTask-körning, heter det så här.
Konfigurationsobjekt
Inga konfigurationsobjekt behövs.
Exempel
<template code="LicenseManagementSoftware" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" >
<listener>
<name>postsave.4.When Administered software becomes Monitored, update installation information from SCCM</name>
<trigger>post save</trigger>
<source_conditions boolean="AND">
<source_condition>
<value>
<attribute>
<code>monitored_software_status</code>
<current_value>true</current_value>
</attribute>
<operator>=</operator>
<compared_value>Monitored</compared_value>
</value>
</source_condition>
<source_condition>
<value>
<attribute>
<code>monitored_software_status</code>
<current_value>false</current_value>
</attribute>
<operator>!=</operator>
<compared_value>Monitored</compared_value>
</value>
</source_condition>
</source_conditions>
<action_chain>
<name>Run targeted SCCM update</name>
<action>
<name>Run targeted SCCM update</name>
<class>com.efecte.integration.database.inventory.sccm.TargetedSccmUpdateAction</class>
</action>
</action_chain>
</listener>
</template>TransformDataCardAction
Sedan: 4.2 4210
Klass: com.efecte.datamodel.entity.action.implementations.TransformDataCardAction
Utlösare: spara efter
Beskrivning: Åtgärden omvandlar det redigerade datakortet till ett annat datakort. Använder regler och målmapp som definierats i transformeringarna. Regler kan för närvarande inte definieras i själva lyssnarens XML.
Notera:
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.
En ActionChain kan innehålla flera TransformDataCard-åtgärder. Att skapa flera nya kort i en ActionChain stöds också sedan 4.2 4210.
Konfigurationsobjekt
| Namn | Nödvändig | Beskrivning |
|---|---|---|
| Målmall | Ja | Kod för målmallen. |
Exempel
<action_chain>
<name>Transform datacard</name>
<action>
<name>Transform</name> <class>com.efecte.datamodel.entity.action.implementations.TransformDataCardAction</class>
<configuration_item>
<name>TargetTemplate</name>
<value>service_request</value>
</configuration_item>
</action>
</action_chain>