FAQ

Frequently asked questions about custom integration apps.

If this page doesn’t answer your question, please contact us in the support chat.

How to create Single-Select and Multi-Select fields via Integration API?

Here are the prompts.

Single-select:

type: 'text',
subType: 'single-select'

Multi-select:

type: 'array[text]',
subType: 'multi-select',

Sample:

{
  state: {
    name: `State`,
    type: `text`,
    subType: `workflow`,
    options: [
      {
        name: `New`,
        default: true,
      },
      {name: `In Work`},
      {
        name: `Closed`,
        final: true,
      },
    ],
  },
}

Note, that if you want to update the values of the Multi-select, you need to treat that as a collection and use this guide - addToEntityCollectionField

await fibery.entity.addToEntityCollectionField({
  'type': 'Cricket/Player',
  'field': 'comments/comments',
  'entity': {'fibery/id': PARENT_ENTITY_ID},
  'items': [
    {'fibery/id': COMMENT_ID}
  ]
});

Workflow:

type: 'text',
subType: 'workflow'

Optionally you can pass a list of options. If the options property is missing, Fibery will try to identify options based on your data dynamically.

Options format:

[
  {
    name: 'Open',
    color: '#123414', // OPTIONAL
    default: true/false, // Workflow should have record with default flag
    final: true/false // workflow final step
  }
]

It’s also possible to pass multi-select with type text but in this case, options should be comma-separated (e.g. dev,high prio,r22)

Troubleshooting

I’m trying to connect to my PostgresQL database and get “Server is not available… Caused by: SSL/TLS required” error

You can use ?ssl=true to fix the issue. Find the example reference in this community thread.

I have error “Version is required”

Please, check you config.app.json file

The config must contain the following keys:

[
  `name`,
  `version`,
  `authentication`,
  `sources`,
  `description`,
]