Resetting Metadata

If you make schema changes to a datastore or if TIBCO has released an update to a Connector with support for new entities or fields, you must reset the metadata for that datastore to see the changes in TIBCO Cloud™ Integration - Connect. When TIBCO Cloud™ Integration - Connect resets the metadata, it deletes and recreates the schema for the Connection's datastore.

API Limits

Resetting metadata consumes API calls for the datastore that you are accessing. If the datastore has a rate limited API, you could exceed those limits when you reset metadata, especially if you have multiple agents installed. In an environment with many agents, all agents attempt to reset their metadata simultaneously, generating multiple API calls through the Connector to the datastore. If the API rate limit is exceeded, an error is generated by the API and metadata is not successfully refreshed.

In this scenario, open the Windows Services screen and shut down all of your agent services except one. If you have a Connect cloud agent, shut down all of your Connect on-premise agents and leave the Connect cloud agent running. Reset metadata, and then gradually start your agent services one at a time to allow each agent to reset metadata independently.

Reset Metadata

You can reset metadata from the following:

• From the menu, select Connections, and then select Reset Metadata from the menu for the connection you want update.
• From the App Details page, select the Connections tab, and then select Reset Metadata from the menu for the connection you want update.
• From the flow designer, select Reset Metadata from the Gear menu for that connection.

Notes

• New metadata is retrieved immediately.
• Reset the metadata whenever changes have been made to a connection's schema, especially if the datastore may contain new or custom fields, or entities.
• This feature is not supported for the Text Connector. If you have changed the field names in the header row of your text file, see Resetting Metadata for Text Connections for instructions on resetting metadata.