Skip to main content

assyst Integrations

This forum is for questions on integrations with IFS assyst.

  • 103 Topics
  • 262 Replies
103 Topics
askey-s
Sidekick (Customer)
askey-sSidekick (Customer)
asked in assyst Integrations
Adding Additional Affected Users to a existing event

I’m using ETM 1.10.0 and assyst 11.8.4Within the ETM I want to have additional affected users added to an event after it’s created.  (We’re using the Destination process to feed details in the ETM after the event is created.)The mapper resource is set the Event, and I use ‘Record to Update’ to search for the event.  However, although the ETM datamapper gets the correct additional users to add, the result is always ‘No update needed’.This is the only update required on the mapper.  Is there something else I need to select, or some way to force the update, please?

52
R
Sidekick (Customer)
R
Sidekick (Customer)
Richard EllingsenSidekick (Customer)
asked in assyst Integrations
Kafka consumer assystETM

The context for this inquiry is a close partner/supplier who uses Kafka as a message broker, and they have a desire to use it to send and recieve event information for events that should be mirrored in their ITSMs and our Assyst without also having to set up a Kafka REST Proxy unless absolutely necessary.AssystETM utilizes ActiveMQ as its message bus and can be set up to consume messages from other ActiveMQ message buses than the dedicated assyst one. However, a pull based message broker such as kafka does not seem to be mentioned in the wiki.I don’t have high hopes this is possible out of the box as of now, and it sounds ill-advised for us to try adding a Kafka client OSGi bundle to IPaaS ourselves😅. That being said, is this something that has been tested or done before, or is native support for using Kafka or another message broker something that is in the works or has been considered?Native support for Kafka sounds like something that could be a common use case, and therefore possi

52
R
Sidekick (Customer)
R
Sidekick (Customer)
Richard EllingsenSidekick (Customer)
asked in assyst Integrations
Deeplinking to events, actions or other resources using ETM datamappers

Hello,I have a question about the use of deep linking to Assyst resources when data mapping in ETM. I’d love some feedback on my current approach,  and whether there are other approaches I haven’t considered. TL;DRIs it possible in ETM to refer to the AssystREST URL that is specified in the IPaaS/ETM installation, as to create deep linking to the same Assyst environment ETM is attached to? Are there other ways to do deep linking in Assyst ETM? BackgroundOur IT users spend a lot of time trying to find the correct menu for a given resource and waiting through load times during manual lookups. Because of this, direct links to resources are almost always preferred to use speed up the process.When working on integrations in Assyst ETM, I thus often find it helpful to add deep links to Assyst resources (e.g., specific actions, events, items), which would normally only be added as plain text shortCode during manual processes, or simple integrations.These URLs can be added as clickable links i

346
R
Sidekick (Customer)
T
Sidekick (Customer)
TMurphyNS
asked in assyst Integrations
Event Type (incident table)

Hi all, I am trying to reference an incident (Event) in ETM via the Event Ref and Event Type field (I cannot use the Event ID) but ETM keeps throwing an error … The database and the wiki appear to show the int 4 as a valid value. The domain model refers to getEventTypeEnum. Can anyone tell me what is causing this error?Thanks!Trevor

361
R
Sidekick (Customer)
D
Do Gooder (Customer)
DuncanKDo Gooder (Customer)
asked in assyst Integrations
assyst Destination not passing through entity ID to ETM

Hello.We are just beginning to look at using assyst Destination along with ETM to configure some integrations. I have created an ETM channel with a destination source, but the ID of the entity is not being passed through when the entity is being created.  Destination: I know that the destination is working, because when I take the action, an import is coming through to ETM. However, ETM is saying that there are 0 records to import: I have also inspected the message that is coming through ActiveMQ, and the ID is indeed included as part of the message body.  Any help would be appreciated.  assyst Version: 24R2 SU4 Build: 13018 Date built: Jun 11, 2025 2:27:00 AM  ETM version 1.8.0 Thanks,  Duncan    

72
D
Do Gooder (Customer)
V
Sidekick (Customer)
VT_VKOLBSidekick (Customer)
asked in assyst Integrations
assystREST - getting custom field value

So I know I can get an array of the various custom fields with the following query parameter, but there is more benefit to be able to retrieve the value for a custom field by wither Short Code or custom field ID.  Is that even possible?   If so, what is the syntax to do so?returns all single select custom fields for specified event.“.../assystREST/v2/events/7430?fields=customFields.singleSelectValue”looking to return a specific custom field’s value either by ID or Short CodeThanks in advance for any help

31
R
Hero (Employee)
V
Sidekick (Customer)
VT_VKOLBSidekick (Customer)
asked in assyst Integrations
assystREST - searching for actions of an event

hello,I am need of searching for specific action types for a specific event and I cannot get the syntax right for specifying “action type”.   Any help on what is correct syntax and value for searching for actions of a certain action type, is greatly appreciated. Action Type for “ASSIGN” is of greatest interest I can query for all actions for a specific event without issue: but I cannot filter it down for specific “action types”: 

424
V
Sidekick (Customer)
D
Do Gooder (Customer)
DuncanKDo Gooder (Customer)
asked in assyst Integrations
Update intesc2 using ETM

Hello. We have a legacy escalation utility aLua script, which we use to take escalation actions on events when SLA escalations breach. Currently, the aLua script has two parts. The first runs an SQL query to identify which events need which escalation actions. This results in a CSV file being sent to ETM to add the action to the event. No issue with this part, it works well. The second part runs an SQL UPDATE statement to update the intesc1 (or intesc2, depending on escalation type) on the event’s incident data record. I am trying to integrate this second part into the ETM channel, but have not been able to find a field in ETM which will update this column in the database.  For reference, here is the code from the aLua utility: SQL_UPDATE_FIELD_1 =  [[SELECT      i.incident_id ESC_EVENT_ID,    'ESC1' ACTION_TFROM incident i     INNER JOIN inc_data id ON i.incident_id = id.incident_id WHERE    (i.status_enum  = 1) AND (i.inc_esc1 IS NOT NULL)     AND (id.intesc1 = 'n')    and exists (se

220
D
Do Gooder (Customer)
D
Do Gooder (Customer)
DuncanKDo Gooder (Customer)
asked in assyst Integrations
ETM - using customFieldsMap to determine if data in custom field comes from a Shared Field

Hello. I am looking for information on how to determine in ETM whether a custom field value brought back from an event is a Shared Field. I have an Event mapper where I am able to bring back the customFieldsMap. One of the fields I happen to know is a Shared Field, but I want to code my mapper to verify that the value is coming from a shared field, but I can’t see any attribute which would identify the field as a Shared Field. This is what I get for the field: "COST-CENTRE": {                "imageId": 0,                "customLookupValueId": 0,                "assystRESTType": "customField",                "assystRESTXMLType": "webCustomPropertyValueDto",                "objectAvailable": true,                "systemRecordFlag": false,                "decimalValue": 0,                "customFieldId": 79913,                "version": 1,                "entityInstanceId": 15400971,                "customFieldShortCode": "COST-CENTRE",                "singleSelectValue": {               

462
D
Do Gooder (Customer)
akudama
Do Gooder (Partner)
akudamaDo Gooder (Partner)
asked in assyst Integrations
ETM - Auto delete events with datamapper

Hi everyone!I'm kind of a newbie on ETM, even reading the documentation I think I need your help.For corporate policy we have to delete all events older than 24 months, no matter the type or the status of the event. Right now we are using the archive/delete function in Assyst where I run a query that I modify every time I need it.Reading the documentation I learnt that with a Datamapper you can perform a delete record so ideally I want to turn it into an automatic operation rather than doing it manually every time, but I'm not sure how I can tell the Datamapper to search only for the logged date older than 24 months (24 older from the actual date, ideally that date dynamically changes to do it automatically).Ideally I would like to run this every night with a CRON function but right now I don't know how manage it.Anyone could help me understand how to do it? If there are some examples or guidelines in the doc that I missed out feel free to point that outMany thanks in advance!

526
R
Sidekick (Customer)
R
Sidekick (Customer)
Richard EllingsenSidekick (Customer)
asked in assyst Integrations
Understanding typeaheadFilter in AssystREST and ETM

Hello everyone 😊I'm at my wits' end and could really use some help with something that feels like it should be obvious—but I just can’t get the hang of it.I’m currently working with assyst24R2 and IPaaS 1.8, and I’ve come across the typeaheadFilter query parameter in AssystREST. I’m trying to understand its intended use case and how (or if) it can be used when datamapping in ETM.My current use case is to return an array of all users whose shortCode starts with ZZ_, but I haven’t found a way to use [like] or [exclude] operators in datamapper fields, and i stumbled upon this query parameter in the search for this funcionality.There doesn’t seem to be any documentation on the wiki regarding the typeaheadFilter parameter—no examples, no reference, or examples of it behaviour, the only thing i could find was it’s mention as a query parameter in the RAML, but that did not help.😅 From what I’ve gathered, it is the REST version/equivalent to Type Ahead Search in the GUI, as mentioned in Look

222
R
Sidekick (Customer)
R
Sidekick (Customer)
Richard EllingsenSidekick (Customer)
asked in assyst Integrations
Assyst ETM - Always "Update Needed" if using onBehalfOfUser in datamapping

Hi everyone,I have a question regarding the use of onBehalfOfUser when datamapping and wonder if anyone else has experienced this issue, and if there are specific considerations or steps that need to be taken when using this?Whenever I try to use onBehalfOfUser in an Assyst Request datamapper, the resource returns as "Update Needed."I have logged a ticket on the IFS assystNet, but I’m wondering if anyone else has experienced this and what workarounds exist, if any.Thanks in advance!

283
B
Do Gooder
jyork
Sidekick (Customer)
jyorkSidekick (Customer)
asked in assyst Integrations
ETM example of creating an object if it doesn't exist

Does anyone have an example ETM datamapper that checks the existance of an object (could be an Item, Section, Department, Cost Center, etc.), and if it’s not found, to have it created?In the process of importing my Contact Users through ETM, we are providing the values for Section, Department, Building, Cost Center, Job Title, etc. The issue I am running in to is that there are sometimes values in the CSV that we are importing for something, we’ll use Section, that doesn’t exist in Assyst. What I am currently doing is exporting the list of existing Sections via the DMW, then comparing it to the distinct values in our CSV import, then manually adding any that are missing in Assyst. What I would rather do is create a datamapper that first goes through the import CSV, just looking at the Section column, and checking to see if it exists in Assyst yet. If so, skip, if not, create it. That way, I can get any missing Sections, Buildings, etc. added to Assyst BEFORE I do the user import, so th

351
R
Hero (Employee)
L
Do Gooder (Customer)
lloyd1306Do Gooder (Customer)
asked in assyst Integrations
ETM datamapper - date closure

Does anyone have any advice on how to use the ETM to return a list of events that were closed 2 years ago. I can get a list of events, I am struggling with the date of closure parameter. I am then going to push these events through another datamapper which will remove sensitive information. I have tried using the “daysFromEventClosure” drop down with no success. 

235
L
Do Gooder (Customer)
Yawansih
Do Gooder (Employee)
YawansihDo Gooder (Employee)
asked in assyst Integrations
Compatibility Check: CLIPS Report Design with assyst 11.8 and IFS 21R2 SU2

Dear IFS Community,I hope this message finds you well. I am currently working on integrating CLIPS report designs with assyst 11.8 and IFS Applications 21R2 SU2. Before proceeding, I wanted to verify if anyone has experience or insights regarding compatibility between these versions.Specifically, I’d like to know: Are there any known issues or limitations when using CLIPS report designs with this combination of versions? Are there recommended best practices or patches required for seamless integration? Has anyone successfully deployed this configuration, and if so, were any adjustments necessary? Any guidance, documentation references, or shared experiences would be greatly appreciated.Thank you in advance for your support!

171
C
Hero (Employee)
R
Sidekick (Customer)
Richard EllingsenSidekick (Customer)
asked in assyst Integrations
Examples of assyst Message Bus Request Mappers

Hello,I'm reaching out to see if anyone could share some examples of how to use the Assyst Message Bus Request when creating channels in ETM.I'm trying to expand my toolset when working with ETM and want to understand the possibilities and limitations of writing to, and then reading from, the same message bus queue.I've been referring to the Assyst wiki for guidance, but it lacks examples on how to fill out all the field types available during Assyst Message Bus Request datamapping. Specifically, I'm looking for guidance on:How to fill out the various options present in the Assyst Message Bus Request. When and how to use the different optional mapping fields. Any particular cautions or best practices to consider when adding to the message bus, especially if ETM is then set to separately consume that data.Any examples, tips, or resources you could share would be greatly appreciated!Thank you in advance for your help.

253
P
Hero (Employee)
Yawansih
Do Gooder (Employee)
YawansihDo Gooder (Employee)
asked in assyst Integrations
Seeking iPaaS Learning Resources for IFS Integrations

Hi IFS Community,I’m exploring iPaaS (Integration Platform as a Service) to integrate IFS Cloud/Applications with other systems (e.g., ERP, CRM).Could you share: 1. **Official IFS documentation** on iPaaS best practices? 2. **Tutorials/case studies** of IFS+iPaaS implementations. 4. **Training courses** (free/paid) to master IFS integrations. Thanks in advance!Abed Al-Rahman yawansih.

371
C
Hero (Employee)
S
Hero (Customer)
Steve MillerHero (Customer)
posted in assyst Integrations
Dynamic Jwt in assystETM

Good morning Community. Some BackgroundWe are currently using an external SMS service to communicate with our users (most notably within our Major Incident process) and looking to expand it into other processes. The solution that we use has an API interface and requires an encoded Jwt bearer token. This token must contain the iat (issued at time) claim and a secret to successfully authenticate (figure 1. with dummy data included below from jwt.io).figure 1.This is handled by a script on the integration server (Microsoft PowerShell using the JWT Module).$iis = "#######"$secret = "######"[int]$iat = (Get-Date -Date ((Get-Date).DateTime) -UFormat %s)$tokenBody = @{ "iss" = "$iis" "iat" = $iat}$myApiToken = ConvertTo-Json -InputObject $tokenBody $authToken = New-Jwt -Header '{"typ":"JWT", "alg":"HS256"}' -PayloadJson $myApiToken -Secret $secret$myApiHeader = @{ "Authorization" = "Bearer $authToken"}However, we have an interest in moving this to the assystETM platform now that we are on v

406
S
Hero (Customer)
D
Do Gooder (Customer)
DuncanKDo Gooder (Customer)
asked in assyst Integrations
Recommended configurations for new Notifier, Escalation Scheduler and Auto Close Scheduler

Hello, We are beginning the process of looking at upgrading our assyst version to 24R2SU2, and are investigating these three new programs: Notifier, Escalation Scheduler and Auto Close Scheduler. We have not been able to find much in the way of suggested configuration information on the wiki. The main question we have is when these programs are installed using the assyst installer, do they each need to be installed on all servers? “Notifier” if the only one of these that is checked off to be installed by default in the installer, so we must assume that for rule based notifications to work, it must be installed on all servers running the application? For Escalation Scheduler and Auto Close Scheduler to work, do they need to be installed on all servers or can they be installed only on our integration server(s) or on one server. Our setup is such that we have a number of web servers which are load balanced behind our URL, then a couple of servers which are primarily only used for back-end

571
A
Hero (Employee)
J
Do Gooder (Customer)
jbosleyDo Gooder (Customer)
asked in assyst Integrations
EPIP EHR Integration

Greetings, Avera Health has recently made the decision to switch to EPIC for its Electronic Health Record (EHR). We are interested in knowing if any other IFS assyst customers have any integrations with EPIC.Thank you,Jason

722
J
Do Gooder (Customer)
R
Do Gooder (Customer)
RoweKDo Gooder (Customer)
asked in assyst Integrations
lastSLAClockStop Object

I am working on an ETM channel I inherited from my predecessor. Within the code, he refers to the lastSLAClockStop of the existing record. As of the end of November, it doesn’t seem to exist in the payload. Is this a change that was made within IFS? 

335
P
Hero (Employee)
R
Sidekick (Customer)
Richard EllingsenSidekick (Customer)
asked in assyst Integrations
Purpose of Item source - Viability of alternative use case

Hello,I have a question regarding the use of Item Source and its intended use case.The Wiki currently presents this as a function to be used by ITOM/ITAM to allow for documenting the last audit. However, to actually use this seems unclear to me.Is the intended use solely to act as a registry of audits performed on the item?Such as :Source Reference Source System Last Audit Date Modified By Transaction ID 31234 SCOM 2024-12-31 ZZ_SCOM_IMPORT Transaction ID 41254 SCOM 2025-01-31 ZZ_SCOM_IMPORT  An alternative use case which I’m trying to verify the viability of is the use of “Item Source” as an alternative or extra ETM bonding. The reason for this is the ability to see the bonding from within the assyst application, and to use Last Audit Date as tracker for then the item was updated by an integration, and to be able to track this entirely seperate from the item modify date.The Along the lines of something like this:Source Reference (External id (used as

423
P
Hero (Employee)
askey-s
Sidekick (Customer)
askey-sSidekick (Customer)
asked in assyst Integrations
Closed Events, Stop Re-open After x Days

HiWe have times when staff re-open events days/weeks/months after they were resolved and closed.  It’s accepted that, sometimes, the re-open is valid should the resolution be found to not be correct.  However, it’s the time frame of the re-open that can be the issue.On the SmartMail generated closure email we state that the event can be re-opened within 3 weeks of the closure, and give the date before which it can be, but there’s nothing to actually stop this happening 22+ days after closure.I believe that there isn’t a way to remove the re-open action for events (unless I’ve just not seen it) so I’m looking at utilising the Action Processor to do the job and apply a closure action and, within the Action Processor manual in the wiki there is an example of a closure before applied after a number of days: {[[ Closure following at least 3 Chase up actions with more than 7 days difference ]], [[ ACT_TYPE_SC == "CHASE UP" and ACT_TYPE_COUNT >= 3 and EVENT_TYPE == "i" and DAYS_SINCE_1ST_A

684
P
Hero (Employee)
akudama
Do Gooder (Partner)
akudamaDo Gooder (Partner)
asked in assyst Integrations
AssystETM - variables as substitution keywords

Hi everyone, I am setting a datamapper in AssystETM to create an event based on the import of a mail.I set the datamapper and I can create the event without particular problems with the “standard” values of an event (affected user, mail, item, etc.).Now, I would like to also track the To and CC fields of the mail I’m importing; the final result I wish to achieve is to have all these fields and to be able to insert them in an action template that I can use, for example, with a mail to customer action.For that scope, i will need to create at least 3 substitution keywords to be used (one for the To filed, one for Cc and one that combines them).I was already able to create a variable in my datamapper to extract the required fields, but now I am struggling creating the keywords.I started creating a variable in my datamapper, but I can’t find any information regarding using datamapper variables as substitution keyword. Do you know if that is possible?I’d like to use variables if I am capable

807
P
Hero (Employee)
M
Do Gooder (Partner)
mombocDo Gooder (Partner)
asked in assyst Integrations
assyst ETM - disableExceptionOnMaxRecords

I’m using ETM1.7 and am trying to debug a data mapper that was created previously.  One of the Search criteria used on a Variable assyst search on an Event has “disableExpetionOnMaxRecords” set to ‘true’.I searched the wiki but am unable to find any info on this.Does anyone have any insight as to what this is used for? 

261
P
Hero (Employee)

Badges

  • 5th Reply
    LakshmiVhas earned the badge 5th Reply
  • 10th Reply
    VirajWhas earned the badge 10th Reply
  • 10th Topic
    Abdulhas earned the badge 10th Topic
  • 1st Reply
    BCRJWILSONhas earned the badge 1st Reply
  • 1st Reply
    FRFIBRhas earned the badge 1st Reply
Show all badges
Terms & ConditionsCookie settings