FI Finnish
SE Swedish
FR French
PL Polish
DE German
US English (US)

Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Please fill out the contact form below and we will reply as soon as possible.

Swedish
FI Finnish
SE Swedish
FR French
PL Polish
DE German
US English (US)
  • Log in
  • Home
  • Plattform
  • ESM
  • ESM-administratörsmanual
  • Systemkonfiguration och underhåll

Schemaläggbara uppgifter

Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Please fill out the contact form below and we will reply as soon as possible.

  • Tjänstehantering
    Matrix42 Professional Lösning Matrix42 Core lösning Hantering av företagstjänster Matrix42 Intelligens
  • Identitetsstyrning och administration ( IGA )
    IGA översikt IGA lösningsbibliotek
  • Plattform
    ESM ESS2 ESS Efecte Chat för tjänstehantering Efecte-integrationer Tillägg
  • Versionsinformation för M42 Core & Pro , IGA , konversations-AI
    2025.3 2025.2 2025.1 2024.2 2024.1 2023.4 2023.3 2023.2 2023.1 2022.4 2022.3 Publiceringsinformation och policyer
  • Annat material
    Villkor och uid Tillgänglighetspolicyer
  • Tjänster
+ More
    • Tjänstehantering

    • Identitetsstyrning och administration ( IGA )

    • Plattform

    • Versionsinformation för M42 Core & Pro , IGA , konversations-AI

    • Annat material

    • Tjänster

Schemaläggbara uppgifter

De Schemaläggningstjänsten ger dig möjlighet att skapa schemalagda uppgifter som automatiskt utför en åtgärd vid den angivna tiden i enlighet med de angivna villkoren. Med schemalagda uppgifter kan du utföra automatiskt utlösta åtgärder som att skicka e-post, generera textfiler och ändra datakortsinformation. Du kan definiera uppgiftstypen och när den ska köras med redigeraren för schemalagda uppgifter .

När du öppnar vyn Schemaläggbara uppgifter listar tabellen Redigera schemaläggbara uppgifter de uppgifter som konfigurerats, om några. Schemalagda uppgifter har en grön ikon. Uppgifter som aldrig har körts har en röd ikon.

I vyn Schemaläggbara uppgifter kan du ta bort inaktiva uppgifter genom att klicka på papperskorgen. Om du vill redigera en befintlig uppgift klickar du på dess namn. Du kan också skapa nya uppgifter genom att klicka på knappen Lägg till en ny uppgift .

Skapande av schemalagda uppgifter

För att komma åt redigeraren för schemalagda uppgifter, öppna avsnittet Schemalagda uppgifter i administrationsgränssnittet och klicka på Schemalagda uppgifter. Klicka på Lägg till en ny uppgift uppe till vänster i vyn Redigera schemalagda uppgifter . Välj typ av uppgift. Redigeraren för schemalagda uppgifter öppnas i arbetsområdet.

Alla schemaläggbara uppgifter måste ha följande information specificerad:

  • Beskrivning – Ange en beskrivning för uppgiften, som visas i vyn Redigera schemalagda uppgifter. Du kan ange användningen av uppgiften och differentiera uppgifter baserat på samma uppgiftstyp.
  • Användare – Välj den användare vars behörigheter uppgiften körs med.
    Schemaläggning – Aktivera uppgiften genom att aktivera schemaläggning. Om du avaktiverar schemaläggningen sparar ESM uppgiften men kör den inte.
  • Kör – Definiera när uppgiften ska köras.
    • Varje dag: Välj var x minut eller timme som uppgiften körs. Med Starta från kan du bestämma starttiden och även schemalägga olika uppgifter som ska köras vid olika tidpunkter så att de inte överlappar varandra eller åtminstone mestadels körs vid olika tidpunkter om du vill.
    • Varje vecka: Välj vilka veckodagar uppgiften ska köras på. Tiden (@hh:mm) låter dig bestämma starttiden och även schemalägga olika uppgifter att köras vid olika tidpunkter så att de inte överlappar varandra eller åtminstone mestadels körs vid olika tidpunkter om du vill.
    • Varje månad: Välj vilken dag i månaden uppgiften ska köras. Tiden (@hh:mm) låter dig bestämma starttiden och även schemalägga att olika uppgifter körs vid olika tidpunkter så att de inte överlappar varandra eller åtminstone oftast körs vid olika tidpunkter om du vill.
    • Varje kvartal: Välj vilka månader i kvartalet (1, 2, 3) och vilken dag i den månaden som uppgiften körs. Tiden (@hh:mm) låter dig bestämma starttiden och även schemalägga olika uppgifter att köras vid olika tidpunkter så att de inte överlappar varandra eller åtminstone mestadels körs vid olika tidpunkter om du vill.
  • Uppgiftsspecifika egenskaper krävs också.

De uppgiftsspecifika uppgiftsegenskaperna visas i arbetsområdet under schemaläggningen. Varje uppgift har en annan uppsättning uppgiftsegenskaper.

Definiera de uppgiftsspecifika egenskaperna baserat på den valda uppgiftstypen. Obligatoriska egenskaper visas omedelbart när vyn öppnas. Valfria egenskaper kan läggas till med knappen Lägg till egenskap. I praktiken består varje egenskap av ett namn-värde-par som förfinar eller ändrar uppgiftens beteende. Vissa egenskaper har ett användargränssnitt som hjälper dig att välja värdet från en rullgardinsmeny eller genom att klicka på en alternativknapp.

Frågetecknet öppnar hjälptexten för egenskapen. Du tar bort en egenskap genom att klicka på borttagningsikonen (x) till höger om egenskapen.

Manuellt tillagda egenskapsnamn och värden är skiftlägeskänsliga och måste vara exakta. Inställningsnamnen måste till exempel anges exakt som anges i hjälptexten.

Uppgiftstyperna beskrivs nedan.

CSVImportTask (CSV-koppling)

CSV-anslutning för import av data från externa system. CSV-filen kan hämtas från en lokal disk eller från en SFTP-server. Filen måste vara kompatibel med RFC 4180-standarden. Stöder SFTP med autentisering med offentliga nycklar och lösenordsautentisering. Filen som ska importeras måste ha .csv som filnamnstillägg.

Schemalagd uppgift för ChatIntegration

Använd dessa uppgifter i kombination med Efecte Multi-Room Chat som drivs av Giosg Live-plattformen. Alla chattkonversationsposter kan hämtas från Giosg Live-plattformen till Efecte Service Management för rapporterings- och revisionsändamål. Denna schemalagda uppgift i Efecte Service Management tar hand om att begära och lagra data. Välj tidsintervallet för att hämta informationen till en gång per dag, helst tidigt på morgonen, till exempel 04.00 till 06.00. Det tar lite tid att importera informationen från föregående arbetsdag, och därför kommer det att påverka den övergripande lösningens prestanda negativt om du kör den oftare.

Notera:

Mallen chat_session måste finnas för att den här schemalagda uppgiften ska fungera.

DatumkontrollUppgift

Med uppgiften DateCheckerTask kan du få schemalagda e-postrapporter eller filer gällande datakort vars datumfält matchar de angivna kriterierna. För att uppgiften ska fungera som avsett behöver den egenskaperna som beskrivs i obligatoriska egenskaper nedan. Valfria egenskaper beskrivs i tabellen över valfria egenskaper.

Obligatoriska DateCheckerTask-egenskaper:

Obligatoriska DateCheckerTask-egenskaper

Namn

Värde

Beskrivning

kontrollerad.attribut.kod

[attributkod]

Attributkod för det/de attribut vars värde ESM kontrollerar för utlösning av uppgiften. Attributets datatyp måste vara date eller date and time .

Om du anger mer än en kod, separera koderna med kommatecken.

kontrollerad.mall.kod

[mallkod]

Mallkoden för den/de mallar vars värde ESM kontrollerar för utlösning av uppgiften.

Om du anger mer än en kod, separera koderna med kommatecken.

trigger.datum

[nu+5d]

Ett nutidsmakro för att utlösa åtgärden.

Makrots syntax är följande: nu ±<n>d , där

  • ± representerar antingen + eller –
  • <n> representerar  ett heltal
  • d representerar  dag

mail.ämne

[Ämnestext]

Ett ämne för mejlet.

mail.recipient

[E-postadress]

Mottagarens e-postadress som ESM ska använda i meddelandets Till- fält.

Om du anger mer än en adress, separera adresserna med kommatecken.

e-post från

[E-postadress]

Avsändarens e-postadress som ESM ska använda i fältet Från i meddelandet.

mail.header

[Bäste herr]

Rubrik för meddelandets brödtext.

mail.footer

[Med vänliga hälsningar,]

Sidfot för meddelandets brödtext.

e-postrapport

[$entity_name$ på $template$ har ändrats.]

Ett rapportmeddelande där du kan använda följande attributplatshållare:

  • $mall$
  • $attributnamn$
  • $värde$
  • $entitetsnamn$

I rapporten ersätts platshållare med de faktiska attributvärdena:

"Datakortet $entity_name$ från $template$ har ändrats. Det nya värdet för $attribute_name$ är $value$"

"Datakort Volkswagen Passat 1.6 Första raden på mallen Bil har ändrats. Den nya ägaren är JOHN SMITH ."

Valfria DateCheckerTask-egenskaper:

Valfria DateCheckerTask-egenskaper

Namn

Värde

Beskrivning

rapportmetod

fil eller e-post eller onlyStore

En metod för att leverera en rapport. Standardmetoden är mail . Om den är inställd på onlyStore lagras de funna datakorten för att utlösa lyssnare och attributhanterare som är kopplade till mallen.

trigger.date.strict

[sant / falskt]

Om den är satt till true hittas endast kort från utlösningsdatumet. Annars hittas även kort med ett trigger.date- värde som är daterat före utlösningsdatumet.

inkluderade datakort

[alla / synliga / dolda]

Definierar vilka datakort som ingår, med avseende på deras dolda status. Standardvärdet är "synligt".

fil.sökväg

[c:\temp]

Om du använder filmetoden kräver ESM en sökväg till katalogen på datadisken där filen ska sparas.

”uploads” är standardmappen. Om den katalog som refereras till inte finns misslyckas åtgärden och loggen visar ett fel.

filnamn

[rapport.txt]

Om du använder filmetoden kräver ESM ett namn för en fil.

”report.txt” är standardnamnet.

Händelseuppgift

För att hantera körningen av datakortshändelser, som till exempel händelserna E-post och Spara, kan du aktivera eller inaktivera händelsekörning via den här uppgiftens konfigurationsinställningar. EventTask kräver en användare (vars behörigheter används för att köra uppgiften) och schemaläggningsregler.

Från och med ESM 2023.3, om det uppstår fel vid sökning efter händelsemålet (som avgör vilka händelser EventTask kommer att köra), vanligtvis på grund av konfigurationsproblem, kommer dessa fel inte att hindra uppgiften från att hitta och köra händelser som är korrekt konfigurerade. I sådana scenarier kommer händelsen att markeras som "delvis lyckades" och ett meddelande visas i EventTask-användargränssnittet:

För att utföra meddelandesändningen i meddelandekön. Om det finns några meddelanden i kön utlöser den här uppgiften sändningen av meddelandena. Mer information finns i avsnittet om meddelandekön.

MeddelandeKöUppgift

För att utföra meddelandesändningen i meddelandekön. Om det finns några meddelanden i kön utlöser den här uppgiften sändningen av meddelandena. Mer information finns i avsnittet om meddelandekön.

Licensövervakningsuppgift

En uppgift för hantering av programvarutillgångar för att spåra ett företags kostnadsfria och använda programvarulicenser.
Den skickar en e-postrapport om överträdelser av programvarulicenser, dvs. installerad programvara utan licens och programvara med fler installationer än vad licensen tillåter. Nödvändiga egenskaper beskrivs i tabellen nedan.

Nödvändig licensÖvervakningsuppgiftsegenskaper

Namn

Värde

Beskrivning

inga.licenser.rubrik

[Text]

Rubrik för programvara utan licenser.

för.många.installationer.rubrik

[Text]

Rubrik för programvara som installerats fler gånger än antalet licenser.

mail.ämne

[Ämnestext]

Ämnet för meddelandet.

e-postavsändare

[E-postadress]

Avsändarens e-postadress.

e-postmottagare

[E-postadress]

Postmottagarens adress.

Tekniska detaljer

LicenseMonitoringTask genererar en rapport över alla övervakade programvaruinstallationer som inte har en licenspool. Ett datakort för övervakad programvaruinstallation har ingen licenspool om datakortets attribut LicenseManagementLicenseReference inte refererar till en licenspool. Rapporten anger också vilken dator som har den här programvaran installerad.

Den genererade rapporten informerar också om vilka av licenspoolerna som har för många installationer. Detta görs genom att hitta de licenspooler som har fler övervakade programvaruinstallationer som refererar till dem än värdet för attributet LicenseManagementLicenseAmount.

E-postuppgift

MailTask är avsett för att skapa datakort från e-postmeddelanden. Den läser e-post från en inkorg, som måste vara baserad på ett e-postkonto (delade brevlådor stöds inte), importerar e-postmeddelandet till ESM, bifogar e-postmeddelandet och bilagorna till ett datakort och tar sedan bort meddelandet från brevlådan.

Följande tabeller beskriver egenskaperna för MailTask.

Obligatoriska MailTask-egenskaper

Namn

Värde

Beskrivning

grupp.id

[grupp-ID]

ID:t för mappen där datakortet som genereras från e-postmeddelandet skapas.

mall.kod

[mallkod]

Mallkod för den mall som ESM ska basera datakortet som genereras från e-postmeddelandet på.

svarsmeddelande

[Meddelandetext]

Svarsmeddelandet som ESM levererar till avsändaren.

Valfria MailTask-egenskaper

Namn

Värde

Beskrivning

mall.kod.fall.back

[mallkod]

Mallkod för en reservmall. ESM baserar datakortet på reservmallen om spårningsnumret inte hittas i den primära mallen.

svar.inaktiverad

några

Om egenskapen har något värde kommer ESM inte att skicka ett svar automatiskt på det ursprungliga e-postmeddelandet.

svar.avsändare

[e-postadress]

Avsändaradressen som ESM använder i fältet Från i svarsmeddelandet. Om denna adress inte är inställd används e-postmottagarens adress.

attribut.kod.kropp

[attributkod]

Attributkod för attributet som hämtar ett värde från e-postmeddelandets brödtextfält .

attribut.kod.från

[attributkod]

Attributkod för attributet som hämtar ett värde från e-postmeddelandets Från- fält. Värdet kan vara en kommaseparerad lista för flera värden.

attribut.kod.ämne

[attributkod]

Attributkod för attributet som hämtar ett värde från e-postmeddelandets ämnesfält .

attribut.kod.mottagare

[attributkod]

Attributkod för attributet som hämtar ett värde från e-postmeddelandets fält för både Till och Kopia .

attribut.kod.till

[attributkod]

Attributkod för attributet som hämtar ett värde från e-postmeddelandets Till- fält.

attribut.kod.cc

[attributkod]

Attributkod för attributet som hämtar ett värde från e-postmeddelandets kopiafält .

attribut.kod.tidsstämpel

[attributkod]

Attributkod för attributet som får ett värde som motsvarar e-postmeddelandets mottagningstid.

grupp.karta.attribut.kod

[attributkod]

Används för att fatta ett avsändarbaserat beslut om mappen där datakorten som genereras från e-posten skapas. Här anger du koden för attributet i mallen som beskriver e-postavsändaren – t.ex. klientmallen . Du måste också ha ett referensfält som attribute.code.from -värdet. Mapparna bland vilka valet görs måste ha mapToGroupAttributeValue- metadata definierade och ett värde som matchar attributfältets värden.

attribut.kod.e-post.spårning

[attributkod]

Attributkod för attributet vars värde fungerar som ett ID för e-postspårning.

attribut.kod.meddelande.som.länk

[attributkod]

Kod för attributet som e-postmeddelandena är länkade till. Detta attribut kräver hanteraren EntityStateMail för att hantera meddelandena och den externa referensdatatypen .

attribut.kod.bilaga.som.länk

[attributkod]

Kod för attributet som eventuella e-postbilagor är länkade till. Attributets datatyp måste vara en extern referens .

mail.store.host

[server-IP eller nätverksnamn]

Värdnamn för e-postservern från vilken e-posten läses. Åsidosätter värdet i framework.properties .

mail.store.port

[portnummer]

E-postserverns port. Åsidosätter värdet i framework.properties .

mail.store.user

[användarnamn]

Användare som används för att autentisera e-postserveranslutningen. Åsidosätter värdet i framework.properties .

mail.store.lösenord

[lösenord]

Lösenord som används för att autentisera e-postserveranslutningen. Åsidosätter värdet i framework.properties .

mail.transport.host

[värdnamn]

Värdnamn för e-postreläservern. Åsidosätter värdet i framework.properties .

mail.transport.port

[portnummer]

Portnummer för e-postreläservern. Åsidosätter värdet i framework.properties .

mail.transport.user

[användarnamn]

Användare som används för att autentisera anslutningen till e-postreläservern. Åsidosätter värdet i framework.properties .

mail.transport.lösenord

[lösenord]

Lösenord som används för att autentisera anslutningen till e-postreläservern. Åsidosätter värdet i framework.properties .

e-postmapp.namn

[mappnamn]

Namn på den postlådemapp som e-postmeddelandet läses från. Åsidosätter värdet i framework.properties .

valfri attributkod

[attributkod]

Här kan valfritt fast attributfältvärde anges, och det placeras sedan i datakortet som genereras från e-postmeddelandet.

uppdatering:attributkod:nuvarande värde

Nytt värde

Genom att konfigurera en egenskap vars namn är som "update:YYY:ZZZ" och YYY matchar attributkoden och ZZZ matchar attributets aktuella värde, kommer attributets värde att ersättas av egenskapsvärdet.

Till exempel kan egenskapsnyckeln vara "update:status:On hold" och värdet kan vara "Pågår". Det betyder att när ett nytt e-postmeddelande bifogas ett datakort vars nuvarande status är "On hold" kommer det att uppdateras till "Pågår".

Om egenskapsnyckeln slutar med $EMPTY$ kommer värdet att anges om det aktuella värdet är tomt. Om egenskapsnyckeln slutar med $ALWAYS$ kommer värdet alltid att uppdateras.

Endast följande datatyper stöds: sträng, statisk sträng och text. Värdet anges innan hanterare eller lyssnare utlöses.

autoUpdateMapping:tagg

[attributkod]

Genom att konfigurera den här egenskapen kan värden från specialformaterad e-post anges som attributvärde.

Till exempel "autoUpdateMapping:issue" med värdet "description": Attributet med koden 'description' i ESM kommer att uppdateras med hjälp av värdet från e-postmeddelandet. E-postadressen söks efter taggen '[issue]:'.

Allt som följer efter taggen på samma rad betraktas som värde.

Om e-postmeddelandet innehåller flera rader för  samma tagg (t.ex. [problem]:), används endast det senaste värdet.

Befintligt värde på datakortet ersätts alltid.

OBS! Taggens exakta format beror på konfigurationen.

OBS! Datatyper som stöds är: Sträng, Text, Datum, Datum och tid, Referens, Bakåtreferens, Extern referens, Tal och Decimaltal.
Med statiska attribut stöds endast String och Number.

Observera att den här funktionen endast stöder enskilda värden, t.ex. kan den inte mappa flera värden till ett flervärdesattribut.

Den här inställningen kan ha flera konfigurationer för olika taggar.

static.autoUpdateMapping:tag.value

[attributkod].[statiskt värde]

Den här inställningen kan användas när flera olika värden från ett externt system behöver mappas till ett enda statiskt värde i ESM.

Till exempel "static.autoUpdateMapping:newStatus.:new,untouched" med värdet "status.New": Det statiska attributet med koden 'status' i ESM kommer att uppdateras till värdet 'New' om värdet på taggen i e-postmeddelandet är 'new' eller 'untouched'. E-postmeddelandet söks efter taggen '[newStatus]:'.
Allt som följer efter taggen på samma rad betraktas som värde.

OBS! Taggens exakta format beror på konfigurationen.

Med hierarkiska statiska värden, använd konventionen 'föräldravärde/undervärde'

autoUpdateStartTag

taggstartsträng

Format för starttagg som används för att markera specialvärden i e-post.

Till exempel '$NAME$'. Strängen 'NAME' används som platshållare för taggnamn. Standardvärdet är '[NAME]:'.

Om inställningen för autoUpdateEndTag inte är definierad betraktas allt som följer på starttaggen på samma rad som värde.

Denna inställning är ett enda värde.

OBS! Taggar söks endast från e-postmeddelandets brödtext. Ämnesraden är inte inkluderad.

autoUpdateEndTag

taggstartsträng

Format för sluttagg som används för att markera specialvärden i e-postmeddelanden.

Till exempel '$/NAME$'. Strängen 'NAME' används som platshållare för taggnamn. Inget standardvärde. Om den här inställningen är definierad kommer allt mellan starttaggen och motsvarande sluttagg att betraktas som värde.
Till exempel om starttaggen är '$NAME$' och sluttaggen är '$/NAME$', en rad '$comment$communication ska hanteras via telefon.$/comment$' i e-postmeddelandet
tillsammans med inställningen 'autoUpdateMapping:comment=description'
kommer att göra att attributet med kodbeskrivningen får värdet 'kommunikation ska hanteras via telefon'.

Denna inställning är ett enda värde.

OBS! Taggar söks endast från e-postmeddelandets brödtext. Ämnesraden är inte inkluderad.

Exempel på AutoUpdateMapping

Det här avsnittet innehåller några konfigurationsexempel för inställningar för automatisk uppdatering.

Exempel 1: I det här exemplet finns först konfigurationen, sedan den importerade e-posten, och längst ner finns en skärmdump av det skapade datakortet:

Exempel 2:

Exempel 3:

Exempel4:

Exempel 5:

RapportExporteraUppgift

ReportExportTask kan användas för att exportera en vald rapport till en fil i önskat format. Detaljerade rapporter med tabellutdata stöds såväl som grafiska rapporter.

Notera:

ReportExportTask stöder nu endast rapporter i Efecte ITSM version 6-format. Vyer som skapats och sparats i det aktuella arbetsytegränssnittet stöds ännu inte.

Utdatafilformatet för detaljerade rapporter med tabellutdata kan konfigureras med en XSLT-fil. Som standard är CSV- och HTML-export inbyggd, men flera andra filformat är också möjliga. Andra lägen (minimal, referrer, fullständig) för detaljerade rapporter stöds inte.

Grafiska rapporter genererar en fil som innehåller en PNG-bild.

Notera:

Vid lokala installationer, se till att användarkontot som kör Tomcat-processen har skrivbehörighet till mappen som definieras i target.file.name.

Obligatoriska egenskaper för ReportExportTask

Namn

Värde

Beskrivning

rapport.id

[rapport-ID]

ID:t för rapporten som transformeras och exporteras av den här uppgiften. (ID:t är bookmarkID-parametern i en länk-URL.) För flera rapporter måste du konfigurera flera uppgifter.

mål.fil.dir

[text]

Sökväg till målkatalogen för den transformerade filen. Vid lokala installationer, se till att användarkontot som kör Tomcat-processen har skrivbehörighet till mappen som definieras i target.file.name.

mål.fil.namn

[text]

Namn på målfilen. Kan innehålla ett $now$ datummakro som kommer att ersättas med dagens datum. Datumformatet är åååå-mm-dd.

Om en fil med samma namn redan finns på målplatsen skrivs den över.

Valfria egenskaper för ReportExportTask

Namn

Värde

Beskrivning

mål.fil.kodning

[text]

Kodningen för målfilen. Standardvärdet är UTF-8.

transform.fil

[text, filnamn]

XSLT-filen som används för att omvandla rapportresultatets XML-fil till det slutliga formatet.

För att exportera filen i CSV-format, ange helt enkelt CSV i det här fältet.

För att exportera filen i HTML-tabellformat, ange HTML i det här fältet

För att exportera filen i något annat format än det som konfigurerats i en XSLT-fil, ange en sökväg till XSLT-filen. Om fältet lämnas tomt exporteras resultatet i XML-format som det är.

xslt.[parameter]

[xslt-parametervärde]

Alla parametrar som har prefixet xslt. skickas till XSLT-transformationen utan prefixet (t.ex. en xslt.some.parameter skickas till XSLT med namnet some.parameter ). För mer information, se avsnittet Tekniska detaljer nedan.

css.fil

[text, filnamn]

CSS-filen som läggs till i textrapporter. Det inbyggda värdet som stöds är STANDARD. Om fältet lämnas tomt läggs ingen fil till.

Värdet är rimligt när transform.file = HTML används .

header.include

[sant/falskt/namn]

Om värdet är satt till 'sant' kommer en rubrikrad att inkluderas i resultat-XML-filen. Rubrikraden innehåller koderna för de attribut som valdes i rapporten.

Om det är satt till 'namn' är rubrikerna attributnamn.

Standardvärdet är 'falskt'.

date.convert

sant, falskt

Om värdet är sant konverteras alla datumattribut enligt PlatformSettings date.output.pattern och datetime.output.pattern . 

Om den är satt till falskt kommer värdet att vara så som Java Virtual Machine returnerar dem.

Standardvärdet är falskt.

bild.bredd

[antal]

Om den konfigurerade rapporten producerar en grafisk rapport definierar detta bildens bredd i pixlar.

Standardvärdet är 640, maxvärdet är 1920.

bild.höjd

[antal]

Om den konfigurerade rapporten producerar en grafisk rapport definierar detta bildens bredd i pixlar.

Standardinställningen är 640, maxinställningen är 1080.

Tekniska detaljer:

XSLT-transformering kan användas för att exportera ESM-resultat i XML-format till valfritt textbaserat filformat – till exempel CSV, olika XML-filer eller HTML. XSLT-transformering stöder XSLT 1.0 och XPath 1.0.

Förutom vanliga egenskaper kan ReportExportTask även användas för att definiera parametrar för XSLT-transformering. När parametrarna skickas till XSLT-transformeringsfilen tas prefixet xslt. bort från parameternamnen (t.ex. blir xslt.some.parameter som some.parameter i XSLT-transformering). Vilka parametrar som stöds beror helt på vilken XSLT som används.

Data från flervärdesreferenser grupperas i ett enda XML-flervärdeselement eller i en enda kolumn i CSV-filen. Den ursprungliga referensen kan inte identifieras.

CSV-transformen som implementeras av ESM stöder följande parametrar:

CSV-transformpaparameter

Namn

Värde

Beskrivning

xslt.csv.separator.värde

[valfritt tecken]

Avgränsare mellan kolumner. Standardvärdet är ' , '.

xslt.csv.separator.multivalue

[valfritt tecken]

Avgränsare mellan flervärden. Standardvärdet är ' | '.

xslt.csv.quote.values

[sant/falskt]

Definierar om alla värden ska omges av dubbla citattecken. Standardvärdet är ' sant '.

TIPS! Formatet som används för CSV-filer beskrivs i detalj i RFC 4180, http://www.rfc-editor.org/rfc/rfc4180.txt

Notera:

Parametrarna för XSLT-transformationen kan också anges med ESM-plattformsinställningar för att få dem att påverka alla ReportExportTasks. Parametrar som anges i en ReportExportTask åsidosätter dock plattformsinställningsparametrarna. Formatet för XSLT-transformparametrar i plattformsinställningar är report.export.xslt.[parameter].

Om du till exempel vill definiera ett globalt separatorvärde för CSV-transformationen lägger du till en plattformsinställning med namnet result.export.xslt.csv.separator.value.

Diagram över XML-schemat för sökresultat som används i ReportExportTask:

RapporteraE-postuppgift

ReportMailTask kan användas för att generera ett e-postmeddelande som innehåller flera rapporter som skapats med den gamla Efecte Report Wizard (rekommenderas inte längre att användas). E-postserverkonfigurationer definieras av plattformsinställningar. Avsändare, mottagare, ämne och e-postinnehåll konfigureras av uppgiftsegenskaper.

  • ReportMailTask stöder endast rapporter i Efecte ITSM 6-format.
  • Detaljerade rapporter med tabellutdata stöds såväl som grafiska rapporter.
  • Utdatafilformatet för detaljerade rapporter med tabellutdata kan konfigureras med en XSLT-fil. Som standard är CSV- och HTML-export inbyggd, men flera andra filformat är också möjliga. Andra lägen (minimal, referrer, fullständig) för detaljerade rapporter stöds inte.
  • Grafiska rapporter producerar PNG-bilder.
  • Gruppera efter –rapporter stöds inte.
  • Följande egenskaper kan inte konfigureras för ReportMailTask: report.id, target.file.dir, target.file.name

Konfigurationen är mycket lik ReportExportTask. Följande tabeller innehåller endast ytterligare alternativ.

Obligatoriska egenskaper för ReportMailTask

Namn

Värde

Beskrivning

e-post från

[e-postadress]

Giltig e-postadress.

mail.recipient

[e-postadress[er]]

Giltig e-postadress för mottagare i till-fältet. Kan separeras med kommatecken eller semikolon. Mottagare i CC- eller BCC-fält stöds inte.

mail.ämne

[text]

Ämne för e-postmeddelandet.

Valfria egenskaper för ReportMailTask

Namn

Värde

Beskrivning

e-post.meddelande[.ORDINAL]

[text]

Valfritt meddelande före rapporter. Kan innehålla html-taggar som <br/> för radbrytningar.

En rad kan innehålla 450 tecken. Flera rader med unika ordningsnummer kan definieras.

mail.report.[ORDINAL].[ID]

[text]

Liknar ReportExportTask report.id .

Rapporten med det ID:t skickas med ett e-postmeddelande.  (ID är bookmarkID-parametern i en länk-URL.)

För flera rapporter i ett enda e-postmeddelande kan du konfigurera flera värden med unika ordningsnummer.

Värdet på egenskapen beror på värdet på egenskapen mail.attachment.disposition . Om det är inbäddat är värdet för denna egenskap en kort beskrivning som visas i e-postmeddelandet före rapporten. Om värdet för egenskapen mail.attachment.disposition är attachment , betyder denna egenskap filnamnet på en genererad bilaga. Var noga med filnamnstillägget. Det måste matcha inställningarna mail.attachment.text.content.type och transform.file . Vissa e-postklienter använder filnamnstillägg för att välja ett förhandsgransknings- eller hjälpprogram för att öppna bilagor. Vissa e-postklienter använder bilagors innehållstyp.

e-post.bilaga.disposition

[bilaga, inbäddad]

Pro definierar hur rapporter läggs till i e-postmeddelandet. Möjliga värden är bifogade filer (rapporter läggs till som bilagor) och inline (rapporter är en del av e-postmeddelandets brödtext).

Standardinställningen är inbäddad

e-post.bilaga.text.innehåll.typ

[text]

Om egenskapen mail.attachment.disposition är inställd på attachment definierar den här inställningen innehållstyp för textrapporter. Detta måste matcha inställningen transform.file . Vissa e-postklienter använder den här egenskapen för att välja förhandsgranskning eller hjälpprogram för att öppna bilagan. Vissa e-postklienter använder endast filnamnstillägg. Exempelvärden: text/plain , text/html (standard).

Notera:

Vanliga egenskaper för ReportExportTask och ReportMailTask inkluderar: target.file.encoding, transform.file, css.file, header.include, date.convert, image.width, image.height. Se detaljerad beskrivning på ReportExportTask.

DataCardsArchiverTask

DataCardsArchiverTask är avsett för att exportera datakort till filsystemet eller direkt till ett externt system med hjälp av https-förfrågansmetoden. Båda metoderna (fil och https-förfrågan) använder Efecte ESM:s standard XML-format, vilket kan behöva konverteras till målsystemets datamodellformat.

Endast Efecte-administratörer kan spara listvyer i arkivsektionen i arbetsytan. Listrapporter som sparas i arkivsektionen kan arkiveras med hjälp av den schemalagda uppgiften DataCardsArchiverTask.

Notera:

Den här uppgiften är utformad för att endast inkludera data från den aktuella mallen, och inte data som kommer via referenser.

Endast administratörer kan spara, visa eller ens se arkivfliken i sina vyer.

Arkiveringsuppgiften arkiverar inte bifogade filer eller e-postmeddelanden som är länkade till de arkiverade datakorten. Även om datakorten raderas kommer filerna (e-postmeddelanden och bifogade filer) från de raderade datakorten att finnas kvar i filsystemet såvida de inte raderas med en annan schemalagd uppgift: CleanRemovedFilesTask. Observera också att filarkiveringen eller https-förfrågningsmetoden varken skickar bifogade filer eller e-postmeddelanden till den definierade mappstrukturen eller till tredjepartssystemet.

Obligatoriska egenskaper för DataCardsArchiverTask

Namn

Värde

Beskrivning

Arkivtyp

[fil, http-förfrågan]

Om det ska exporteras till ett filsystem (värde: fil) eller skickas via https till ett externt system (värde: https-förfrågan).

Ta bort datakort

[Sant | Falskt]

Om datakort ska tas bort efter export till en fil eller om de ska behållas. Som standard tas inte datakort bort.

Arkivrapport

[rullgardinsmeny med rapporter under Arkivsektionen]

Arkivrapport vars datakort ska arkiveras. Denna rapport måste sparas i Arkiv - specialavsnitt om Arbetsyta.

Exportera alla attribut i datakort

[Sant | Falskt]

Om värdet är satt till 'Sant' skickas alla attribut för exporterade datakort till arkiveringsobjektet, även om en kolumn är vald i listvyn.

Om arkivtypen är 'fil' krävs följande DataCardsArchiverTask-egenskaper

Namn

Värde

Beskrivning

Filplats

[plats på servern där ESM har åtkomst]

Location där exporterade datakort ska exporteras till XML-filer när egenskapen 'Arkiv' är inställd på 'fil'. Esm ska också ha behörighet att spara filer på önskad plats.

Definiera här “/sökväg/till/mappen”

Om arkivtypen är 'https-förfrågan' krävs följande DataCardsArchiverTask-egenskaper.

Namn

Värde

Beskrivning

Extern systemadress

[extern system-URL]

T.ex. adress till en annan ESM. I ESM-fall, kontrollera alltid parametrar från namngiven konsult. Adressen måste börja med 'https://'

Externt systemanvändarnamn

[användarnamn]

Grundläggande autentiseringsanvändarnamn för ett externt system.

Lösenord för externt systemanvändare

[lösenord]

Användarlösenord för grundläggande autentisering för ett externt system

Parametrar för externa systemanslutningar

[parametrar för externa systemanslutningar]

Anslutningsparametrar. Timeout-enheten är den andra. Exempel presenteras nedan.

Förväntat svar från externt system

[200=.*, 201=.*]

Förväntade svarskoder från ett externt system separerade med kommatecken (standardvärde: "200=.*, 201=.*").

Extern systembatchstorlek

[batchstorlek]

Maximalt antal datakort som kan skickas inom en enskild begäran (standard: 10000).

Exempel vid anslutning till en annan ESM

  • Extern systemadress t.ex. https://environment.efectecloud.com/api/itsm/dataCardImport.ws?folderCode=alerts&createDataCards=true&updateDataCards=true&createEmptyReferences=true
  • Parametrar för externa systemanslutningar, t.ex.
    • accepteraSjälvsigneradeCertifikat=true, anslutningsbegäranTimeout=60, anslutningTimeout=60, socketTimeout=60

Arkivtyp: fil

När filen används av arkivtypen lagras den skapade ESM-entitets-XML-filen i serverns filsystem. Pro plats måste peka på den befintliga katalogen där ESM-behörigheten har åtkomst att skriva data. Ett filnamn genereras som [task_id]_[time_stamp]_[report_name].xml. Filer raderas inte.

Arkivtyp: https-förfrågan

När du använder en https-begäran skickas den genererade ESM-entitets-XML-filen till ett tredjepartssystem som en https-begäran. Kontrollera tabellen (Tabell: Obligatoriska DataCardArchiverTask-egenskaper, när arkivtypen är 'https-begäran') över de egenskaper som krävs när du använder arkiveringstypen https-begäran.

Metoden https-förfrågning använder MessageQueue. När DataCardArchiverTask har körts skickas XML-filen omedelbart till ett tredjepartssystem. Om överföringen av https-förfrågan misslyckas, t.ex. om ett tredjepartssystem inte svarar, lagras begäran i meddelandekön och körs igen nästa gång MessageQueueTask körs. För att https-förfrågan ska fungera korrekt ska Efecte-administratören konfigurera MessageQueueTask.

Filerna raderas när exporten är klar.

Förväntat svar från externt system

Egenskapen Förväntat svar för externt system definierar kombinationen av förväntade svarskoder och meddelanden från det externa systemet.

Förväntad svarskod: Koden anger den besvarade koden från det externa systemet oavsett om begäran accepteras eller avvisas. t.ex. 200, 404.

Förväntat svarsmeddelande: ESM kontrollerar svarsmeddelandet från mottagna svar. Kontrollen av meddelandeinnehåll hanteras av reguljära uttryck.

Formatet som används är:

code1=message1,code2=message2 (using comma as delimiter)

Exempel 1: 200=,404=Inget att arkivera

Både 200 och 404 accepteras som svarskod. För kod 200 ska svarsmeddelandet vara tomt eller null. För kod 404 ska texten "Ingenting ska arkiveras" inkluderas i svarsmeddelandet.

Exempel 2: 200=.+

Endast 200 accepteras som svarskod. Allt innehåll i svarsmeddelandet accepteras.

Skogsavverkning

DataCardsArchiverTask loggar sina aktiviteter på info- och debug-nivå till itsm.log. För att få ut mer detaljerad kommunikation mellan uppgiften och det externa systemet kan du även ställa in debug på loggnivå för paketet com.efecte.queue.

Rensa borttagna filerUppgift

CleanRemovedFilesTask är avsedd för att rensa orefererade/föräldralösa filer som e-postmeddelanden och bilagor från filsystemet. Om den här uppgiften inte körs kommer dessa resurser att finnas kvar i filsystemet och använda diskutrymme även efter att ett datakort som refererar till resurserna har tagits bort.

Denna schemaläggningsbara uppgift är aktiverad och körs dagligen som standard. Uppgiftsschemaläggningen kan antingen omschemaläggas eller inaktiveras av Efecte-administratören från Schemalagda uppgifter.

Observera: Den här funktionen tar inte bort överblivna filer som har funnits i systemet före uppdateringen till ESM version 2018.3.2.

Redigera och ta bort schemalagda uppgifter

Du kan visa och ändra alla skapade uppgifter i vyn Redigera schemalagda uppgifter. För att navigera till vyn, öppna fliken Allmänt i vyn Underhåll och klicka på Schemalagda uppgifter. I vyn klickar du på namnet på den uppgift du vill redigera.

Vyn Redigera schemalagda uppgifter öppnas i arbetsområdet, inklusive redigeraren för schemalagda uppgifter och vyn Uppgiftsegenskaper. Gör ändringen av den befintliga informationen och klicka på Spara för att spara den ändrade schemalagda uppgiften.

Du kan ta bort inaktiva uppgifter från vyn Redigera schemalagda uppgifter. Markera kryssrutorna Ta bort bredvid den/de uppgifter du vill ta bort och klicka på knappen Ta bort för att slutföra åtgärden.

Pro

Pro är automatiserade, schemaläggbara uppgifter avsedda för att importera användaridentitetsdata till Efecte Service Management Tool med hjälp av antingen Lightweight Directory Access Pro (LDAP)-gränssnittet för Active Directory , OpenLDAP , IBM LDAP , FreeIPA eller antingen Microsoft Graph API för Microsoft Azure AD . Efecte Provisioning Engine (EPE) inom vår IGA lösning, vilket accelererar provisioneringen av användare (även kallat uppfyllande inom området identitets- och styrningsadministration). EPE kommer att fungera som en verklig parallell bearbetningsmetod som möjliggör flera schemalagda och händelsebaserade ändringar av åtkomsträttigheter.

Obs! Sedan ESM 2023.3 finns provisioneringsuppgifterna på fliken IGA – inte längre på fliken Schemaläggbara uppgifter.

De importerade konfigurationerna lagras i EPE-Master-databasen ( Efecte Provisioning Engine - Master), inte i Efecte Service Management (ESM)-databasen. Mappning av identitetsattribut och mappning av åtkomsträttigheter lagras i ESM och påverkas av att mallar och mappar ändras i ESM.

För att ansluta Efecte Service Management-verktyget och Efecte Provisioning Engine måste flera inställningar konfigureras i plattformsinställningarna i administrationsgränssnittet.

Som standard hämtas egenskaperna som behövs för att ansluta till Efecte Provisioning Engine från consul. Det är därför du måste ställa in egenskapen consul.enabled till true. Då kan du se till att "provisioning.configuration.consul" också är aktiverat.

När Consul är aktiverat definieras alla nödvändiga konfigurationer för Efecte Provisioning Engine :

Pro uppgiftskonfiguration för Active Directory

Efecte Provisioning Engine använder Lightweight Directory Access Pro tocol (LDAP)-gränssnittet för Active Directory och OpenLDAP , IBM LDAP och Redhat LDAP (FreeIPA). Pro namnges enligt den aktuella katalogen. Annars är de nödvändiga konfigurationerna desamma.

Allmänna egenskaper Pro provisioneringsuppgifter

Namn

Värde

Beskrivning

Pro

[Schemabaserad provisionering, händelsebaserad provisionering, autentisering]

Pro kan kategoriseras efter behov. Andra egenskaper i provisioneringsuppgiften visas enligt den valda typen.

Mappningstyp

[Identitet och åtkomsträttigheter]

Lägg till avsnitten för båda mappningarna.

Namn

[Text]

Namn på etableringsuppgiften.

Web API användare

[Val av Web API användare]

Web API användare som ska användas för kommunikation mellan EPE och ESM

Lösenord för webb- API

[Text]

Lösenord för webb- API . Obligatoriskt fält att fylla i för att få provisioneringen att fungera.

Obligatoriska egenskaper Pro provisioneringsuppgift

Namn

Värde

Beskrivning

LDAP uniqueIdentifier -ID

[Text]

Varje importprocess har ett unikt process-ID, LDAP uniqueIdentifier Id , som används som en nyckel i provisioneringsmotorns master för att separera den processspecifika processen från andra importprocesser i provisioneringsmotorns master. Identifieraren behövs så att efterföljande ändringar eller borttagningar riktas mot rätt objekt.

LDAP-värd

[IP- eller värdnamn]

Målkatalogens IP-adress eller värdnamn.

LDAP-port

[Hamn]

Målkatalogporten definierar vilken port i Active Directory som Pro ska ansluta till.
Till exempel: 389 (vilket är standard-ldap-porten)

LDAP-användarnamn

[Användarnamn]@[Domän]

Användarnamn som används för LDAP-anslutning. I LDAP är användarnamnet vanligtvis användarens användarnamn eller DN.

LDAP-lösenord

[Text]

Lösenord som används för LDAP-anslutning. Lösenordet anges som vanlig text.

LDAP-autentiseringsmetod

[enkel, stark, ingen]

Autentiseringstyp som används för LDAP-anslutning. Följande autentiseringstyper stöds:

– enkelt

– stark

– ingen

LDAP-säkerhet Pro -tocol

[enkel, ssl]

Säkerhetsprotokoll som används för LDAP-anslutning. Följande säkerhetsprotokoll stöds:

– ssl : Pro kommer att upprätta en LDAP-anslutning till Active Directory

– enkelt : Pro kommer att upprätta en LDAP-anslutning till Active Directory

Obs! SSL måste vara aktiverat för att kunna tillhandahålla lösenord och ändra användargiltighet i AD .

LDAP-användarbas

[Text]

Definiera basen för användare. Exempel: CN=Användare,DC=adtest,DC=lokal

Obs! När konfigurationen för provisioneringsuppgiften har ställts in på "Läs OU-sökväg från datakortet" visar orkestreringsaktiviteterna en tilläggsegenskap (LDAP-grupp-/användarbas), där det är möjligt att definiera attributet från vilket attribut denna information kan läsas.

LDAP-användarfilter

[Text]

Definiera filtret för användare. Exempel: (objectClass=user)

Obs! När konfigurationen för provisioneringsuppgiften har ställts in på "Läs OU-sökväg från datakortet" visar orkestreringsaktiviteterna en tilläggsegenskap (LDAP-grupp-/användarbas), där det är möjligt att definiera attributet från vilket attribut denna information kan läsas.

LDAP-gruppbas

[Text]

Definiera basen för grupper. Exempel: CN=Grupp,DC=adtest,DC=lokal

Obs! När konfigurationen för provisioneringsuppgiften har ställts in på "Läs OU-sökväg från datakortet" visar orkestreringsaktiviteterna en tilläggsegenskap (LDAP-grupp-/användarbas), där det är möjligt att definiera attributet från vilket attribut denna information kan läsas.

LDAP-gruppfilter

[Text]

Definiera filtret för grupper. Exempel: (objectClass=group)

Obs! När konfigurationen för provisioneringsuppgiften har ställts in på "Läs OU-sökväg från datakortet" visar orkestreringsaktiviteterna en tilläggsegenskap (LDAP-grupp-/användarbas), där det är möjligt att definiera attributet från vilket attribut denna information kan läsas.

Valfria egenskaper Pro provisioneringsuppgifter

Namn

Värde

Beskrivning

LDAP ignorerad av användare

[Text]

Definition av <OU>-element som ska ignoreras vid sökning efter användare. Användaren ignoreras om den finns direkt i en av de definierade <OU> och även om den finns i ett underträd till en av de definierade <OU>. Exempel: OU=Sales,DC=adtest,DC=local

LDAP ignoreradesOusForGroups

[Text]

Definition av <OU>-element som ska ignoreras vid sökning efter grupper. Gruppen ignoreras om den finns direkt i en av de definierade <OU> och även om den finns i ett underträd till en av de definierade <OU>.

Exempel: OU=Ekonomi,DC=adtest,DC=lokal

Användarinställningar

Namn

Värde

Beskrivning

Lösenord för första inloggning

[Text] / [arbetsflöde / mall]

Det här alternativet är synligt när Pro är definierad som "Händelsebaserad provisionering". Lösenordet används när aktiviteten "Skapande av nya användare" tas i bruk. Det finns möjligheter att välja om administratörer vill definiera standardlösenordet som ska användas för första inloggningslösenordet för nya användare som skapas i det valda användarförrådet. Ett annat alternativ är att generera slumpmässigt lösenord i arbetsflödet/mallen.

Mappning av identitetsattribut
Som ett resultat av provisioneringsuppgiften tar Efecte Service Management Tool emot användaridentitetsdata från varje Active Directory . Denna information måste mappas till Efecte Service Management Tools datastrukturer.

Mappningarna av identitetsattribut i bilden ovan beskriver hur objekten och attributen mappas mellan Efecte Service Management Tool och mål Active Directory . Mappningen av identitetsattribut definierar Active Directory användarobjektattributen och de användarattribut som mappas. Den vänstra kolumnen i användargränssnittet (bilden ovan) anger de fält som Pro extraherar från Active Directory . Den högra kolumnen i användargränssnittet anger mappen/mallen/attributet i ESM som fältet extraherade från Active Directory vilket kommer att infogas/uppdateras. När det finns ett behov av att hämta AD attribut som har mer än ett värde, som 'memberOf', måste det också mappas till ett flervärdesattribut i ESM:s mall.

Obligatoriska egenskaper visas omedelbart när vyn öppnas. Valfria egenskaper kan läggas till med knappen Lägg till egenskap. I praktiken består varje egenskap av ett namn-värde-par som förfinar eller ändrar uppgiftens beteende. Vissa egenskaper har ett användargränssnitt som hjälper dig att välja värdet från en rullgardinsmeny eller genom att klicka på en alternativknapp.

En egenskap tas bort genom att klicka på raderingsikonen (x) till höger om egenskapen. Manuellt tillagda egenskapsnamn och värden är skiftlägeskänsliga och måste vara exakta. Inställningsnamnen måste till exempel anges exakt som anges i hjälptexten.

Notera:

Från och med EPE version 2021.1 tillåter vi att ange en lista över undantagna användarnamn vid export av data till ESM. Denna förbättring ger möjlighet att exkludera dedikerade användare från exporten till ESM.

Mappning av åtkomsträttigheter

Åtkomsträttigheter i Efecte Provisioning Engine uttrycks vanligtvis som LDAP-grupper, i AD vanligtvis som antingen en säkerhets- eller distributionsgrupp. Som ett resultat får Efecte Service Management Tool åtkomsträttigheter från varje Active Directory från provisioneringsuppgiften. Denna information måste mappas till Efecte Service Management Tools datastrukturer. Mappning av åtkomsträttigheter definierar specifika egenskaper för provisioneringsmotorns uppgiftstyp.

Egenskaperna "Målmallkod" och "Mappkod" visas omedelbart när vyn öppnas. Mappningar för åtminstone distinguishedName, objectGUID och datasourceid krävs också, och dessa tre fält visas automatiskt. Valfria egenskaper kan läggas till med knappen "Lägg till egenskap". I praktiken består varje egenskap av ett namn-värde-par som förfinar eller ändrar uppgiftens beteende. Vissa egenskaper har ett användargränssnitt som hjälper dig att välja värdet från en rullgardinsmeny eller genom att klicka på en alternativknapp. När det finns ett behov av att hämta AD attribut som har mer än ett värde, som "memberOf", måste det också mappas till ett flervärdesattribut i ESM:s mall.

Från och med EPE version 2021.1 tillåter vi att ange en lista över undantagna DN:er för grupper vid export av data till ESM. Denna förbättring ger möjlighet att undanta dedikerade grupper från exporten till ESM.

Efecte Provisioning Engine stöder flera olika LDAP-kataloger, vilket stöder LDAP-användargränssnittet. Konfigurationsvyn innehåller olika namn på egenskapsnamnen beroende på vald katalog. De nödvändiga identitets- eller åtkomsträttighetsmappningarna kan variera beroende på vald katalog.

Pro uppgiftskonfiguration för Azure AD

Konfigurationsvy för Azure AD provisioneringsuppgifter:

Allmänna egenskaper Pro provisioneringsuppgifter

Namn

Värde

Beskrivning

Pro

[Schemabaserad provisionering, händelsebaserad provisionering, autentisering]

Pro kan kategoriseras efter behov. Andra egenskaper i provisioneringsuppgiften visas enligt den valda typen.

Obs ! Vissa konfigurationer som är relaterade till den nya autentiseringskomponenten kan vara synliga i vissa delar av det administrativa användargränssnittet. Dessa ändringar påverkar inte befintliga kundmiljöer.

Mappningstyp

[Identitet och åtkomsträttigheter]

Lägg till avsnitten för båda mappningarna.

Namn

[Text]

Namn på etableringsuppgiften.

Web API användare

[Val av Web API användare]

Webb- API användare som ska användas för kommunikation mellan EPE och ESM.

Lösenord för webb- API

[Text]

Lösenord för webb- API . Obligatoriskt fält att fylla i för att få provisioneringen att fungera.

Egenskaper för visionsuppgifter Azure AD Pro

Namn

Värde

Beskrivning

Azure uniqueIdentifier -ID

[Text]

Varje importprocess har ett unikt process-ID, Azure uniqueIdentifier Id , som används som en nyckel i provisioneringsmotorns master för att separera den processspecifika processen från andra importprocesser i provisioneringsmotorns master. Identifieraren behövs för att efterföljande ändringar eller borttagningar ska riktas mot rätt objekt.

Applikations-ID (klient-ID)

[Sträng]

Anger program-ID:t för tjänstens huvudnamn.

Katalog-ID (hyresgäst)

[Sträng]

Anger ID för en hyresgäst.

https://login.microsoftonline.com/<tenant-id> och ersätt <tenant-id> med katalog-ID:t (hyresgäst-ID) för appregistreringen.

Inloggnings-URL

[Text]

Anger URL:en för din App Service-app.

Graph API URL

[Text]

Anger URL:en för din Graph App Service-app.

Azure AD parametrar för användare och grupper

Namn

Värde

Beskrivning

Importera användare-parametern

[Text]

Definiera filtret för användare.

Exempel på filtret:

$filter=börjarmed(givetnamn%2C)

Importera grupper-parametern

[Text]

Definiera filtret för grupper.

Exempel på filtret :

$filter=börjarmed(displaynamn%2C)

Efecte Provisioning Engine använder Microsoft Graph API för att ansluta till Microsoft Azure AD . Om det finns behov av att hämta bara en del av användarna från Azure AD kan det göras med hjälp av filter. Länk för att lära dig mer om API filter finns i Microsofts dokumentation: https://docs.microsoft.com/en-us/graph/api/overview?view=graph-rest-1.0

Anslutningssäkerhet

Namn

Värde

Beskrivning

Autentiseringsmetod

[Hemlighet / Certifikat]

En klienthemlighet (applikationshemlighet), antingen ett lösenord eller ett offentligt/privat nyckelpar (certifikat).

Hemligt nyckelvärde

[text]

Detta värde krävs när autentiseringsmetoden "Hemlighet" har valts. Använd klienthemligheten som du genererade i appregistreringen.

Alias för offentlig nyckel

[text]

Detta värde krävs när autentiseringsmetoden "Certifikat" har valts. Pro alias för den offentliga nyckeln till detta värde.

Alias för privat nyckel

[text]

Detta värde krävs när autentiseringsmetoden "Certifikat" har valts. Pro alias för privat nyckel till detta värde.

Lösenord för privat nyckel

[text]

Detta värde krävs när autentiseringsmetoden "Certifikat" har valts. Pro lösenordet för den privata nyckeln till detta värde.

Mappning av identitetsattribut för Azure AD

Som ett resultat av etableringsuppgiften tar Efecte Service Management Tool emot användaridentitetsdata från varje Azure Active Directory . Denna information måste mappas till Efecte Service Management Tools datastrukturer.

Identitetsattributmappningarna i bilden ovan beskriver hur objekten och attributen mappas mellan Efecte Service Management Tool och mål- Azure AD . Identitetsattributmappningen definierar Azure AD användar- eller gruppobjektattributen och de användar- eller rollattribut som mappas. Den vänstra kolumnen i användargränssnittet (bilden ovan) anger de fält som Pro extraherar från Azure AD . Den högra kolumnen i användargränssnittet anger mappen/mallen/attributet i ESM som fältet extraherade från Azure AD vilket kommer att infogas/uppdateras.

Obligatoriska egenskaper visas omedelbart när vyn öppnas. Valfria egenskaper kan läggas till med knappen Lägg till egenskap. I praktiken består varje egenskap av ett namn-värde-par som förfinar eller ändrar uppgiftens beteende. Vissa egenskaper har ett användargränssnitt som hjälper dig att välja värdet från en rullgardinsmeny eller genom att klicka på en alternativknapp.

En egenskap tas bort genom att klicka på raderingsikonen (x) till höger om egenskapen. Manuellt tillagda egenskapsnamn och värden är skiftlägeskänsliga och måste vara exakta. Inställningsnamnen måste till exempel anges exakt som anges i hjälptexten.

Notera:

Från och med EPE version 2021.1 tillåter vi att ange en lista över undantagna ID:n för användare vid export av data till ESM. Denna förbättring ger möjlighet att exkludera dedikerade användare från exporten till ESM.

Mappning av åtkomsträttigheter för Azure AD

Åtkomsträttigheter i Efecte Provisioning Engine uttrycks vanligtvis som Azure AD grupper, i Azure vanligtvis som antingen en säkerhets- eller Office 365 (O365)-grupp. Säkerhetsgrupper används för att styra användaråtkomst till resurser i appen och O365-grupper för att underlätta användarsamarbete med delade Microsoft-onlineresurser. Som ett resultat får Efecte Service Management Tool åtkomsträttigheter från varje Azure AD från provisioneringsuppgiften. Denna information måste mappas till Efecte Service Management Tools datastrukturer. Mappning av åtkomsträttigheter definierar specifika egenskaper för provisioneringsmotorns uppgiftstyp.

Egenskaperna "Målmallkod" och "Mappkod" visas omedelbart när vyn öppnas. Mappningar för åtminstone id och datasource-id krävs också, och dessa tre fält visas automatiskt. Valfria egenskaper kan läggas till med knappen "Lägg till egenskap". I praktiken består varje egenskap av ett namn-värde-par som förfinar eller ändrar uppgiftens beteende. Vissa egenskaper har ett användargränssnitt som hjälper dig att välja värdet från en rullgardinsmeny eller genom att klicka på en alternativknapp.

Notera:

Från och med EPE version 2021.1 tillåter vi att ange en lista över undantagna ID:n för grupper vid export av data till ESM. Denna förbättring ger möjlighet att exkludera dedikerade grupper från exporten till ESM.

Information om uppgiftsstatus Pro

Administratörer har insyn i extraktions- och laddningsstatus för alla användardatabaser som stöds. Vid behov kan administratörer också ladda ner användar- och gruppfiler för att granska mer information. Extraktionsstatus ger information om hur data hämtades från källan och laddningsstatus ger information om hur EPE kunde ladda data till ESM. Tabeller för extraktions-/laddningsstatus uppdateras inte i realtid. Vid behov kan användaren klicka på knappen "Uppdatera" i sidhuvudet. Den här sidan uppdateras också efter att du öppnar den igen.

Importera/exportera Pro

Från och med Efecte Pro version 2021.1 erbjuder vi möjligheten att importera/exportera provisioneringsuppgifter. Detta ger möjlighet att exportera befintliga provisioneringsuppgifter. Det är möjligt att välja vilka av de befintliga provisioneringsuppgifterna som ska exporteras.

Importera/Exportera-knapparna visas till vänster i vyn Schemalagda uppgifter.

När användaren klickar på knappen ”Exportera” får de se alla potentiella uppgifter, där de flexibelt kan välja lämpliga uppgifter.

När användaren klickar på knappen "Ok" exporteras provisioneringsuppgifterna till XML-filen. Den exporterade XML-filen kan sedan användas för att importera provisioneringsuppgifter till vald miljö. Om du vill importera dem till samma miljö rekommenderas det att ändra två egenskaper i XML-filen. För varje exporterad uppgift har du de två egenskaperna: "UniqueIdentifierId", "TaskName", och om du planerar att importera dem till en befintlig miljö rekommenderas det att ändra dem för att undvika fel under importen.

Was this article helpful?

Yes
No
Give feedback about this article

Related Articles

  • Importera data till ESM

Copyright 2026 – Matrix42 Professional.

Matrix42 homepage


Knowledge Base Software powered by Helpjuice

0
0
Expand