After creating integrations, you can choose which repos and projects to import, which to exclude, and whether to enable auto-import.
Note: When you first set up an integration, we recommend specifically importing your most critical repos, and waiting to turn on auto-import. This will speed up initial processing of data. Turn on auto-import to gather additional data once initial processing is complete. If you experience regular integration processing delays, consider turning off auto-import.
Importing repos and projects
All integrations require repos and projects to be imported for Flow to show data in reports.
- To import specific repos, go to the Repos page, then to the Available tab. Learn more about managing repositories.
- To import specific ticket projects, go to the integration’s details page for your ticket-based integration. In the Tickets tab, click the Import toggle next to all projects you want to import.
To import repos and projects programmatically, use the auto-import feature. To edit or enable an integration’s auto-import settings:
- Go to the integration’s details page.
-
In the Repos tab, if you have one, click the toggle next to Auto-import all groups.
- If you want to auto-import all repos and projects from specific groups, but not all groups, click the toggle in the Auto-import column of the table in the Repos tab.
In the Tickets tab, if you have one, click the toggle next to Auto-import all projects.
The auto-import feature is available for any integration. However, repo exclusion rules are only available for Git-based integrations. You cannot set up exclusion rules for ticket projects, but can set up auto-import following similar steps as in this article.
Note: Toggling off auto-import for a repo group prevents future repos from that group from importing. It does not delete previously imported repos.
Creating repo exclusion rules
Repo exclusion rules allow you to exclude specific repos or groups of repos from being auto-imported into your account.
By adding repo exclusion rules, you will:
- See more of the data you want in Flow.
- Spend less time manually managing repos.
To edit your existing repo exclusion rules or create new ones, click the Repo exclusion tab of the integration's details page.
Create rules to exclude:
- Repos by name
- Repos by regular expression
- Repos by date
- Archived repos
- Open-source repos
Creating a repo exclusion rule for an integration does not apply to that integration’s previously-imported repos. For example, if you toggle on Exclude open-source repos, Flow will exclude all future open-source repos it discovers, but repos imported prior to creating this rule will still be included. To exclude a previously imported repo, you must manually remove the repo from the repos list.
Exclude repos by name
Exclude any imported or available repo by name. If the repo you wish to exclude is already imported, it will be deleted.
To exclude a repo by name:
- Click Add more to locate repos by name.
- Type in the name of the repo you would like to exclude. If the repo is already imported, it will be labeled as imported.
- Once you have selected the repo you would like to exclude, you will be prompted to confirm your action. Click Yes.
Once you've confirmed your choice, the repo will no longer be imported when the auto-import feature is turned on for this integration.
Exclude repos by regular expression
To exclude one or multiple repos by regular expression:
- Click Add Rule.
- Enter the regular expression you want to use to exclude repos.
- Choose to match the regular expression rule on repo name or group name.
- Optionally apply the regular expression rule to a specific group within your integration.
- Click Save. You will be prompted to confirm your action.
- Click Yes.
Any repo that matches this regular expression will not be imported when the auto-import feature is turned on for this integration.
Exclude repos by date
To exclude repos by date:
- Click Add Date.
- Select a specific date from the calendar to exclude repos older or younger than the date.
- Optionally apply the date exclusion rule to a specific group within your integration.
- Click Save.
- Click Yes if you would like to proceed.
Exclude archived repos
Toggle on Exclude archived repos to exclude all archived repos of the selected integration from importing.
Note: This exclusion rule is only available for GitHub and GitLab integrations.
Exclude open-source repos
Toggle on Exclude open-source repos to exclude all open-source repos of the selected integration from importing.