How to call integration in interface

RE: How to call integration in interface

Mike Schmitt — Wed, 07 May 2025 11:59:27 GMT

[quote userid="91720" url="~/discussions/f/user-interface/39025/how-to-call-integration-in-interface/147862"]How can I pass it as rule input to integration[/quote]

The thing you're currently doing (with the paragraph field) should be sufficient for passing it into the integration. The problem is that you're not passing the data in formatted correctly, and you haven't really given us sufficient description yet of what the integration requires.

RE: How to call integration in interface

Konduru Chaitanya — Wed, 07 May 2025 09:53:11 GMT

You will have to perform it in a saveInto under a button

RE: How to call integration in interface

ZAINAB — Wed, 07 May 2025 08:30:46 GMT

I understand this but currently my emails are stored in local variable in the interface .How can I pass it as rule input to integration

RE: How to call integration in interface

Harsha Sharma — Wed, 07 May 2025 08:19:10 GMT

You should follow Appian trainings from Appian Academy to understand the basics like rule inputs , variables better. Before working on integrations, understanding how to handle or work with data in Appian is primary.

RE: How to call integration in interface

Konduru Chaitanya — Wed, 07 May 2025 08:17:07 GMT

At the right side you would see an option to configure rule inputs

docs.appian.com/.../Integration_Object.html

RE: How to call integration in interface

ZAINAB — Wed, 07 May 2025 08:06:53 GMT

Hi , i will be passing emails like this to the integration . How do I need to pass the interface result to integration in integration obj?

Getting the below error when trying to type mailaddress in paragraph field .can you please help

Could not display interface. Please check definition and inputs. Interface Definition: Expression evaluation error [evaluation ID = d891f:89f97] : An error occurred while executing a save: Expression evaluation error : An error occurred when creating local!integrationResult. a!save() and smart service functions cannot be used in a local variable unless "refreshAlways" is true for that local variable using the a!refreshVariable() function.

Getting the below error as well
Could not display interface. Please check definition and inputs. Interface Definition: Expression evaluation error [evaluation ID = 288a6:536a3] : An error occurred while executing a save: Expression evaluation error at function a!save [line 145]: Incorrect number of parameters for function; expected 2 parameters, but found 1 parameters.

RE: How to call integration in interface

Konduru Chaitanya — Wed, 07 May 2025 05:23:27 GMT

Hello ZAINAB ,

Could you please check the type of the Rule input that you have configured in the integrations. Does it match to take the inputs that you are passing.

RE: How to call integration in interface

Mike Schmitt — Tue, 06 May 2025 15:52:07 GMT

You still need to call the integration rule with parameterized naming.

this is how you had it before (correct):

this is what you're trying now (which will fail for any rule that doesn't have exactly 1 parameter, hence the error message you're getting)

The fact that we're wrapping the "emails" value in a JSON string that also has the property of "emails" doesn't mean you don't have to use the named parameter when calling the integration rule. Whether or not the integration is set up to use this or not, is up to its internal code (which you still haven't shared here, but would help a lot if possible).

RE: How to call integration in interface

ZAINAB — Tue, 06 May 2025 15:48:23 GMT

Modified the code as below and getting the error as

Could not display interface. Please check definition and inputs. Interface Definition: Expression evaluation error [evaluation ID = 307dc:00441] : An error occurred while executing a save: Expression evaluation error at function rule!ASR_bulkgetemployees [line 147]: Rule 'asr_bulkgetemployees' has 2 parameters, but instead passed 1 parameters.

code

local!formattedEmailString: a!toJson(
{
emails: joinarray(local!individualEmails, ",")
}
),

a!save(
local!integrationResult,
rule!ASR_bulkgetemployees(local!formattedEmailString),
),

RE: How to call integration in interface

Mike Schmitt — Tue, 06 May 2025 15:37:40 GMT

Please try it with this definition of local!formattedEmailString instead. Here we're preparing your concatted list of email addresses, but then putting it in a dictionary at the "emails" property, and wrapping that up into a JSON string, which it looks like the integration expects (guessing based on your screenshot).

local!formattedEmailString: a!toJson(
  {
    emails: joinarray(local!individualEmails, ",")
  }
),

RE: How to call integration in interface

ZAINAB — Tue, 06 May 2025 15:36:49 GMT

integration is expecting list of emails "test1@test.com ,test2@test.com" . when i pass in the mail addresses it return the employee ID of those mails that's it

RE: How to call integration in interface

Mike Schmitt — Tue, 06 May 2025 15:31:01 GMT

[quote userid="91720" url="~/discussions/f/user-interface/39025/how-to-call-integration-in-interface/147839"]is this correct way to pass the body of the integration?[/quote]

From your screenshot of the integration it looks like it's expecting a JSON object with the property "Emails" followed by the concatenated list of emails. You're just passing in the email list itself. You might wanna verify exaclty what the integration is expecting to consume. You haven't shown what the actual code of the integration is doing so it's, still, hard for me to guess.

RE: How to call integration in interface

ZAINAB — Tue, 06 May 2025 15:27:38 GMT

It is not making any difference .There is some issue calling the integration from the rule .

is this correct way to pass the body of the integration?
a!save(
local!integrationResult,
rule!ASR_bulkgetemployees(Emails:local!formattedEmailString),
),

with this code i get warning as invalid parameter.

a!save(
local!integrationResult,
rule!ASR_bulkgetemployees({"Emails":local!formattedEmailString}),
),

with this code it says Missing keyword syntax

RE: How to call integration in interface

Mike Schmitt — Tue, 06 May 2025 15:13:38 GMT

In case this makes any difference to your integration, these values are separated by a comma but not a space. The values you're created in local!formattedString are separated by a comman AND a space. This could easily make a difference if the integration is not expecting to clean extra spaces between emails.

RE: How to call integration in interface

ZAINAB — Tue, 06 May 2025 15:07:57 GMT

Could not display interface. Please check definition and inputs. Interface Definition: Expression evaluation error [evaluation ID = ab535:440c6] : An error occurred while executing a save: Expression evaluation error : An error occurred when creating local!integrationResult. a!save() and smart service functions cannot be used in a local variable unless "refreshAlways" is true for that local variable using the a!refreshVariable() function.

getting this error sometime

RE: How to call integration in interface

ZAINAB — Tue, 06 May 2025 14:59:35 GMT

RE: How to call integration in interface

Mike Schmitt — Tue, 06 May 2025 14:55:30 GMT

[quote userid="91720" url="~/discussions/f/user-interface/39025/how-to-call-integration-in-interface/147833"] in the " "[/quote]

does this mean the integration expects a slightly different value from what the local variable holds? can you post some screenshots of the interface's current exact value and the value you're entering in the integration that's working?

RE: How to call integration in interface

ZAINAB — Tue, 06 May 2025 14:54:02 GMT

copied the value and pasted the value in the " " in the integration it is working

RE: How to call integration in interface

Mike Schmitt — Tue, 06 May 2025 14:49:33 GMT

And if you copy out the exact same value and run it in the integration rule by itself, it works?

RE: How to call integration in interface

ZAINAB — Tue, 06 May 2025 14:48:40 GMT

Yes,i'm getting the mails by comma seperated which is expected

RE: How to call integration in interface

Mike Schmitt — Tue, 06 May 2025 14:21:51 GMT

Did you look at the value of local!formattedEmailString before trying the integration, to see if it contains the value you expect? I notice that the only time it's changed is upon form load, so it should already hold its correct value presumably before you interact with the paragraph field.

RE: How to call integration in interface

ZAINAB — Tue, 06 May 2025 14:12:52 GMT

a!localVariables(
  local!data:ri!ASR_Requests,
  local!rawEmails: ri!ASR_Requests.emailAddresses,
  
  local!integrationResult,
  local!isintegrationSuccess,

  local!individualEmails: reject(
    a!isNullOrEmpty(_),
    a!forEach(
      items: split(local!rawEmails, char(10)),
      expression: trim(fv!item)
    )
  ),

  local!invalidEmails: reject(
    a!isNullOrEmpty(_),
    a!forEach(
      items: local!individualEmails,
      expression: if(
        regexmatch(
          pattern: "^[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,}$",
          searchString: fv!item,
          regexFlags: "si"
        ),
        null,
        fv!item
      )
    )
  ),

  local!formattedEmailString: joinarray(local!individualEmails, ", "),

  local!validationMessage: if(
    a!isNotNullOrEmpty(local!invalidEmails),
    "Emails must be valid and each on a new line.",
    {}
  ),
  a!formLayout(
    label: "Test Request",
    contents: {
      a!sectionLayout(
        contents: {
          a!columnsLayout(
            columns: {
              a!columnLayout(
                contents: {
                  a!boxLayout(
                    label: "",
                    labelSize: "SMALL",
                    contents: {
                      a!columnsLayout(
                        columns: {
                          a!columnLayout(
                            contents: {
                              a!textField(
                                label: "Title:",
                                labelPosition: "JUSTIFIED",
                                value: local!data.requestTitle,
                                saveInto: {
                                  a!save(local!data.requestTitle, save!value),
                                  a!save(
                                    ri!ASR_Requests.requestTitle,
                                    save!value
                                  )
                                },
                                refreshAfter: "KEYPRESS",
                                characterLimit: 100,
                                required: true,
                                requiredMessage: "Title is Required"
                              ),

                              a!dateField(
                                label: "Start Date",
                                labelPosition: "JUSTIFIED",
                                value: local!data.startDate,
                                saveInto: {
                                  a!save(local!data.startDate, save!value),
                                  a!save(ri!ASR_Requests.startDate, save!value)
                                },
                                required: true,
                                requiredMessage: "Start Date is Required",
                                validations: rule!ASR_startDateValidation(ri!ASR_Requests.startDate)
                              ),

                              a!dateField(
                                label: "End Date",
                                labelPosition: "JUSTIFIED",
                                value: ri!ASR_Requests.endDate,
                                saveInto: {
                                  a!save(local!data.endDate, save!value),
                                  a!save(ri!ASR_Requests.endDate, save!value)
                                },
                                required: true,
                                requiredMessage: "End Date is Required",
                                validations: rule!ASR_endDateValidation(
                                  ri!ASR_Requests.startDate,
                                  ri!ASR_Requests.endDate
                                )
                              )

                            }
                          ),
                          a!columnLayout(
                            contents: {
                              a!textField(
                                label: "Requested By:",
                                labelPosition: "JUSTIFIED",
                                value: rule!GBL_displayUserFirstLast(loggedInUser()),
                                saveInto: ri!ASR_Requests.requestorName,
                                readOnly: true()
                              ),
                              a!textField(
                                label: "Requestor Email:",
                                labelPosition: "JUSTIFIED",
                                value: loggedInUser(),
                                saveInto: ri!ASR_Requests.requestorEmail,
                                readOnly: true(),
                                validations: {}
                              ),
                              a!dateTimeField(
                                label: "Requested On:",
                                labelPosition: "JUSTIFIED",
                                value: now(),
                                saveInto:  ri!ASR_Requests.createdOn, 
                                readOnly: true(),
                                validations: {}
                              )
                            }
                          )
                        }
                      ),
                      a!paragraphField(
                        label: "Email Addresses",
                        labelPosition: "JUSTIFIED",
                        placeholder: "Email Addresses should be one per line (can be pasted from Excel)",
                        value: local!data.emailAddresses,
                        saveInto: {  
                          a!save(
                            local!integrationResult,
                            rule!ASR_bulkgetemployees(Emails: local!formattedEmailString)
                          ),
                          a!save(local!data.emailAddresses, save!value),
                          a!save( ri!ASR_Requests.emailAddresses, save!value)
                        },
                        refreshAfter: "KEYPRESS",
                        height: "TALL",
                        required: true,
                        requiredMessage: "Email Address is Required",
                        validations:if(
                          (a!isNotNullOrEmpty(local!invalidEmails)),
                          "Emails must be in a valid format, and each email must be on a new line. ",
                          {}
                        )
                      )

                    },
                    style: "#134f5c",
                    marginBelow: "STANDARD"
                  )
                }
              )
            }
          )
        }
      )
    },
    buttons: a!buttonLayout(
      primaryButtons: {
        a!buttonWidget_23r3(
          label: "Submit",
          style: "PRIMARY",
          submit: true,
          validate: true(),
          saveInto: {
            a!save(
              ri!ASR_Requests.requestorName,
              rule!GBL_displayUserFirstLast(loggedInUser())
            ),
            a!save(
              ri!ASR_Requests.requestorEmail,
              loggedInUser()
            ),
            a!save(ri!ASR_Requests.createdOn, now()),
            a!save(
              ri!ASR_Requests.requestStatus,
              cons!ASR_AUDIT_STATUS_TYPES[1]
            ),
            a!save(
              ri!ASR_Requests.requestType,
              cons!ASR_REQUEST_TYPE
            ),
            a!save(ri!ASR_Requests.isActive, true())

          },
          loadingIndicator: true()
        )
      },
      secondaryButtons: {
        a!buttonWidget_23r3(
          label: "Cancel",
          style: "NORMAL",
          submit: true,
          validate: false,
          value: true,
          saveInto: ri!cancel
        )
      }
    )
  )
)

Here is my interface code where i want to check the emailaddress validation first and then pass those mails to the integration without clicking on submit .can you please help

RE: How to call integration in interface

Mike Schmitt — Tue, 06 May 2025 14:06:45 GMT

[quote userid="91720" url="~/discussions/f/user-interface/39025/how-to-call-integration-in-interface/147817"]rule!ASR_bulkgetemployees(Emails: local!formattedEmailString)[/quote]

You haven't shown us what the configuration is for "local!formattedEmailString" so we would have no way of knowing what its value is or what error you're getting.

Have you verified its value is correct before the field's "save" operation takes place? What is its configuration?

RE: How to call integration in interface

ZAINAB — Tue, 06 May 2025 14:01:11 GMT

a!paragraphField(
label: "Email Addresses",
labelPosition: "JUSTIFIED",
placeholder: "Email Addresses should be one per line (can be pasted from Excel)",
value: local!data.emailAddresses,
saveInto: {
a!save(
local!integrationResult,
rule!ASR_bulkgetemployees(Emails: local!formattedEmailString)
),
a!save(local!data.emailAddresses, save!value),
a!save( ri!ASR_Requests.emailAddresses, save!value)
},

Getting warning for integration call ..it says invalid parameter .Can someone please help .

RE: How to call integration in interface

Mike Schmitt — Tue, 29 Apr 2025 22:06:17 GMT

[quote userid="91720" url="~/discussions/f/user-interface/39025/how-to-call-integration-in-interface/147625"]How can I pass emailaddresses as "test@test.com test2@test.com ....." to the integration [/quote]

why not just concat them together with joinArray and a separator of " "?