Setting up ION group

In the ION group, specify these parameters:

Group Key Value
ION oauth.token.url <pu> + <ot>
ION rrs.client.id <ci>
ION rrs.client.secret <cs>
ION rrs.service.account.access.id <saak>
ION rrs.service.account.secret.key <sask>

Complete these steps to get the value for each parameter:

  1. From the application tray, select Infor ION API.
  2. On Authorized Apps, create a new Authorized App for Rhythm Recommendation Service:
    1. Click the Plus icon.
    2. On the Non-Infor Authorized App page, specify this information:
      Name
      Specify a name.
      Type
      Select Backend Service.
      Description
      Specify a description.

      Configure other settings, as needed.

  3. Click Save.
  4. On your newly created Authorized App page, click the Download Credentials option.
  5. On the Download Credentials window, select Create Service Account.
  6. Specify a service user who has the necessary permission to call Infor AI Platform endpoints.
    Note: The Service user must at least have RHYTHM-ServiceAccount or RHYTHM-RecommendationAdministrator and COLEMANAI-User roles.
  7. Click Download.
    Once downloaded, it will create credentials for the specific service user. This is an example of a generated .IONAPI credentials:
    {
    "ti":"M3DEVAPPDIS_TST",
    "cn":"TEST_ECOM2",
    "dt":"12",
    "ci":"M3DEVAPPDIS_TST~ZPB1GdBP5lryUOjupbnFTugV1b4AwEhnWrGZSMNeDH8",
    "cs":"gsfKXT0cDjqo_cdnMM7oIXg9HWjvbznG8OUd_f6_M27B3CDZ4qX6FO2fDC2mLvEYNp2_5fYfoQYoJM0z44So7w",
    "iu":"https://qac-ionapi.qac.awsdev.infor.com",
    "pu":"https://qac-sso.qac.awsdev.infor.com:443/M3DEVAPPDIS_TST/as/",
    "oa":"authorization.oauth2",
    "ot":"token.oauth2",
    "or":"revoke_token.oauth2",
    "ev":"M1528929412",
    "v":"1.0",
    "saak":"M3DEVAPPDIS_TST#NIU_qNUjbV2YsqOw9sZHUJjjEaW_zo1W6X6j0kfF-NfWWplKHKK_4M6BddfwtYciDZ-g9veGa-2H1nm-iJw2Lg",
    "sask":"zIt7EoIXe6ObuxT1EKZYSd4synXGT5fmLIBAxMYnQKhKhro1GRgBy4v82Rh1NbkLd2LLB7YUeeNCZQmp9vhCJQ"
    }
    
  8. Navigate to the environment's respective Rhythm Recommendations Services (RRS) swagger by replacing the qa in the URL with dev or qa. https://qa-api.rhyl.dev.inforcloudsuite.com/recommendations/swagger-ui.html#/.
    Note: You may contact an Infor representative for help on your environment’s RRS swagger URL.
  9. Click Authorize.
  10. Click Authorize on the Available Authorizations.
  11. The service user with RHYTHM-ServiceAccount or RHYTHM-RecommendationAdministrator role must log in in the login page.
    Note: You may contact an Infor representative to request for a service user if you do not have one yet.
  12. Under Recommendation Types, click POST / types.
  13. Click Try it out.
  14. Specify your tenant id in the x-rhy-run-as-tenant and paste these under the request body:
    {
      "code": "inforai-item-item-similarity",
      "entity": "item",
      "externalId": "string",
      "names": [
        {
          "locale": "en-US",
          "value": "Similar Products"
        }
      ],
      "source": "INFORAI"
    }
    
  15. Click Execute.
  16. Repeat Steps 13 and 14. Replace these values in the payload:
    • Replace code with inforai-user-user-similarity
    • Replace value with Recommended For You