Hi, I'm Ask INFA!
What would you like to know?
ASK INFAPreview
Please to access Ask INFA.

IICS API Version V2 Connector Guide

IICS API Version V2 Connector Guide

Configuring the Get Connection and List Connections services

Configuring the Get Connection and List Connections services

You can use the Get Connection service in a process to retrieve the connection details by providing the connection ID. You can use the List Connections service in a process to retrieve all the connections in the organization.
To use the Get Connection or List Connections service in a process, perform the following steps:
  1. Create an IICS API Version V2 connection to connect to Informatica Cloud.
  2. On the
    Explore
    page, navigate to the process for which you want to use the Get Connection or List Connections service.
  3. Add a Service step to configure the Login service to log in to Informatica Cloud.
    To configure the Login service, perform the following steps:
    1. Click the
      Service
      tab and select
      Service Type
      as
      Connection
      .
    2. In the
      Connection
      field, select the IICS API Version V2 connection.
    3. In the
      Action
      field, select
      Authentication
      Login
      .
  4. Add a Service step to configure the Get Connection or List Connections service.
    To configure the Get Connection or List Connections service, perform the following steps:
    1. Click the
      Service
      tab and select
      Service Type
      as
      Connection
      .
    2. In the
      Connection
      field, select the IICS API Version V2 connection.
    3. In the
      Action
      field, select
      Connection
      Get Connection
      or
      Connection
      List Connections
      as required.
    4. Click the
      Input Fields
      tab, and then select the values as
      ICS Server URL
      for the
      ICS Server URL
      field and
      ICS Session ID
      for the
      ICS Session ID
      field.
    Additionally, for the Get Connection service, enter the connection ID in the
    Connection ID
    field for which you want to retrieve the details as shown in the following image:
    This image shows the Connection ID field for which you want to retrieve the connection details.
    You can get the connection ID by invoking a process that contains a List Connections service.
  5. In the Start step, create an output field for the get connection or list of connections as shown in the following image:
    This image shows the output field for the get connection.
    To create an output field, perform the following steps:
    1. Click the
      Start
      step.
    2. Click the
      Output Fields
      tab.
    3. Click the
      Add
      icon.
    4. Enter the output field name.
    5. In the
      Type
      column, select
      More types
      .
      The
      Edit Type
      dialog box appears.
    6. From the
      Category
      list, select
      Connection defined Types
      .
    7. From the
      Connection
      list, select the IICS API Version V2 connection.
    8. Select the connection output type from the
      Types
      section.
      You can check the connection object ID in the
      Output Fields
      section of the
      Service
      tab.
    9. Select
      Allow a list of objects of this type
      for a list of connections.
    10. Click
      OK
      .
      Based on the selected object, the field is set to the object type or a list of object types.
  6. Add an Assignment step and add the output field you created in step 5 with the type
    Formula
    , and select
    Connection
    or
    Connections
    from the
    Fields
    tab in the
    Expression Editor
    as required as shown in the following image:
    This image shows the output field configured in the Assignment step for Get Connection.
  7. Click
    Save
    and
    Publish
    .
  8. Copy the REST Service URL from the
    Properties Details
    page, open a browser and paste the service URL.
    The service returns connection details or a list of connection details as a response.

0 COMMENTS

We’d like to hear from you!
Ravichethan N S - February 09, 2024

There are 2 questions here

1. After we select Login service, inputs fields are disabled which leads to no inputs while running the service

2. for the Get Connection service, enter the connection ID in the Connection ID - not which connection Id is referred here. (is it the Id value under UserInfo in json output of login Rest API or other value)

Informatica Documentation Team - February 16, 2024

Hi Ravichethan,

Please find the response below:
1. The input values will be taken from the app connection. You can’t override the input values in the Login service step. This behavior is as designed. You can proceed with step 4. 
2. We're glad to let you know that we addressed your feedback on this page.
You can use the connection ID that you get by invoking a process that contains the List Connections service.
Thanks,
Informatica Documentation team


Ravichethan N S - February 16, 2024

I have tried the suggestion but unable to procced with the Login service, I keep getting the same error mentioned below. I did not find any KB article as well so posting it again here. My process is valid and I have followed all the steps given in documentation.

{"error":{"code":500,"detail":{"reason":"{\"error\":{\"code\":null,\"message\":\"API request does not contain a valid INFA-SESSION-ID. Please verify your request.\",\"requestId\":\"8dhJchKZxcJltRZCLn5hyy\",\"details\":null}}","code":"HTTP_401"},"message":"{\"error\":{\"code\":null,\"message\":\"API request does not contain a valid INFA-SESSION-ID. Please verify your request.\",\"requestId\":\"8dhJchKZxcJltRZCLn5hyy\",\"details\":null}}"}}

Informatica Documentation Team - February 16, 2024

Hi Ravichethan,

We’re working to address your comments and will get back to you.

Thanks,

Informatica Documentation team


Ravichethan N S - February 16, 2024

I would suggest to look into Informatica KB to understand the difference with the login URL provided in connection is different from using in Postman.

Informatica Documentation Team - February 16, 2024

Hi Ravichethan,

We’re working to address your comments and will get back to you.

Thanks,

Informatica Documentation team