Role references on Record Fluent APIs?

[eemeli-koli]

I recently tried to convert role definitions on my menu module records with references to my Role object. Direct references to the object cause the resulting application files have their references as [Object object]. If trying to reference names from the Roles as "role.name" in the Record roles array, this results in the following build error:

[now-sdk] ERROR: Cannot convert a Symbol value to a string
TypeError: Cannot convert a Symbol value to a string
    at Array.join (<anonymous>)
    at Array.toString (<anonymous>)
    at String (<anonymous>)
    at ArrayShape.toString (/Users/user/.nvm/versions/node/v24.8.0/lib/node_modules/@servicenow/sdk/node_modules/@servicenow/sdk-build-core/dist/plugins/shape.js:228:33)
    at Object.field (/Users/user/.nvm/versions/node/v24.8.0/lib/node_modules/@servicenow/sdk/node_modules/@servicenow/sdk-build-core/dist/xml.js:45:25)
    at /Users/user/.nvm/versions/node/v24.8.0/lib/node_modules/@servicenow/sdk/node_modules/@servicenow/sdk-build-plugins/dist/record-plugin.js:46:57
    at Array.forEach (<anonymous>)
    at Plugin.toFile (/Users/user/.nvm/versions/node/v24.8.0/lib/node_modules/@servicenow/sdk/node_modules/@servicenow/sdk-build-plugins/dist/record-plugin.js:46:22)
    at Plugin.recordToFile (/Users/user/.nvm/versions/node/v24.8.0/lib/node_modules/@servicenow/sdk/node_modules/@servicenow/sdk-build-core/dist/plugins/plugin.js:392:55)
    at Plugin.recordsToFiles (/Users/user/.nvm/versions/node/v24.8.0/lib/node_modules/@servicenow/sdk/node_modules/@servicenow/sdk-build-core/dist/plugins/plugin.js:418:43)
[now-sdk] ERROR: Build failed due to errors

I went around this defining my roles names separate as constants which can then be referenced in my Role definitions and any Record roles arrays when needed. What is intended way to reference roles on Record Fluent APIs?

[venkat-kaluva]

Thank you for reporting this issue. I was able to reproduce it and we’re working on a fix.

In the meantime, while it's not an ideal workaround, you can set the roles directly since the roles field is of type UserRoles and not a reference type:

roles: ['x_example.role1', 'x_example.role2']

Please let us know if you have any further questions.

[eemeli-koli]

Thanks for the update, I figured out a workaround by assigning the role names as constants which are used both in the Role API and in the roles arrays on Records API.