Integrations

Git (TMS)

Content is machine translated from English by Phrase Language AI.

Available for

  • Team, Business and Enterprise plans

Get in touch with Sales for licensing questions.

Available for

  • Ultimate and Enterprise plans (Legacy)

Get in touch with Sales for licensing questions.

Git connector allows the downloading of source files and uploading of target files directly from/to the Git repository. Phrase clones the remote repository locally and uses git commands to communicate with the remote repo.

If the repository is hosted by GitHub or GitLab, use the dedicated connector instead of the generic Git 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. View changes submitted since the last commit by clicking the show link in the middle of the screen.

  • Set up the submitter portal allowing Submitters to add files to requests directly from the online repository. View changes submitted since the last commit by clicking the show link in the middle of the screen.

  • Use automated project creation to have new projects automatically created when a new commit is detected in monitored files, folder, or an entire subdirectory.

    • This connector supports absolute path setting. Target translation files can be stored in a different branch than the source files.

    • When APC is set to monitor subfolders, the target folder will have the same subfolder structure as the source folder.

    • All files from the monitored folder are imported the very first time APC runs. Newly added files are imported with the next triggered monitoring after their creation.

      • Exception GitLab: If the Include subfolders option is selected, APC does not import any files the first time it runs. If source files are updated or new files are added to those folders, APC creates a project and imports the files.

  • Set up continuous jobs to have selected files monitored for changes.

Git Settings

No changes are required.

Phrase TMS Settings

  1. From the Settings Setup_gear.png page, scroll down to the Integrations section.

  2. Click on Connectors.

    The Connectors page opens.

  3. Click New connector.

    The Create connector page opens.

  4. Provide a name for the connection and change the Type to Git .

  5. Enter the repository address into the Repository URI field.

    • The repository address is the connection string used to clone the repository (e.g. git@gitlab.com:joe.doe/my-repo.git)

    • In order for to access the repository, it has to be reachable from the Internet.

  6. Select an Authentication method.

    • For Password access enter the Username and Password or Personal Access Token, if basic authentication is not supported (e.g. GitHub).

      • If using password access, the Repository URI starts with https:// (e.g. https://github.com/joe.doe/my-repo.git).

      • The personal access token needs to have appropriate read/write rights.

    • For Private key access load the Private key and optionally enter the Private key passphrase.

      • If using a private key, the Repository URI starts with git@.

      • Only legacy PEM private key format is supported when using the private key for authentication. Use the -m PEM option when generating the private key.

  7. Provide a Commit message if required.

  8. Click Test connection.

    A checkmark will appear if the connection was successful. A red exclamation point will appear if it wasn't. Hover over the icon to see additional details.

  9. Click Save.

    The connector is added to the list on the Connectors page.

Was this article helpful?

Sorry about that! In what way was it not helpful?

The article didn’t address my problem.
I couldn’t understand the article.
The feature doesn’t do what I need.
Other reason.

Note that feedback is provided anonymously so we aren't able to reply to questions.
If you'd like to ask a question, submit a request to our Support team.
Thank you for your feedback.