Connectors

GitHub Connector

Available for:

  • Ultimate and Enterprise editions
  • Team edition for an additional cost. Get in touch with Sales for licensing questions.

GitHub connector allows the downloading of source files and uploading of target files directly to/from the GitHub repository. The connector uses the GitHub API to implement the integration.

The connector allows access to all repositories associated with a GitHub account.

GitHub Connector Use Cases

There are a number of use cases for the connector:

  • Project Managers can add files directly to projects from an online repository 
  • Set up the Automation Widget allowing Submitters to add files to requests directly from the online repository.
  • Use Automated Project Creation (APC) to have Memsource automatically create new projects when a change in file size is detected in monitored files or a folder.
    • Selected files are imported the very first time APC runs. All files are imported when a folder is monitored
    • Use the Git connector if you need to monitor an entire subdirectory
    • This connector supports absolute path setting. Note that the target translation files can be stored only in the same branch as the source file.
  • Set up Continous Jobs to have Memsource monitor selected files for changes.
  • The Connector API can be used to automate steps otherwise performed manually through the UI. Webhooks can be used to have Memsource notify 3rd party systems about certain events (for example, a job status change). 

Use Git connector to connect to GitHub if:

  • Limiting Memsource access to a single repository is required.
  • Using an SSH key for authentication
  • Monitoring an entire subdirectory for a change in Automated Project Creation is required.
  • Detection of file changes based on Last modified date as opposed to just file size is required.

Connect to GitHub

GitHub Settings:

No changes are required.

Memsource Settings: 

  1. From the Setup page, scroll down to the Integrations section. Click on Connectors
    The Connectors page opens.
  2. Click New
    The Create Connector page opens.
  3. Provide a name for the connection and change the Type to GitHub
  4. Click Connect to GitHub.
    A popup window or a new tab will appear requesting authorization.
  5. Click the Authorize Memsource button.
    If successful, the window/tab will disappear and a small checkmark appears next to the Connect to GitHub button. 
  6. Click Save.
    The connector is added to the list on the Connectors page.

If a default project, branch, and folder is required when connecting to a GitHub account, open the connector configuration and click the Select Remote Folder button to set it.

Note: In some browsers, pop-ups must be enabled in the browser in order to connect.