Integrations

Git (TMS)

Available for

  • Ultimate and Enterprise plans

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.

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.

    If the Include subfolders option is selected in APC:

    • If remote and subfolders are monitored, no files are imported the very first time APC runs. If source files are updated or new files are added to those folders, APC creates a project and imports the files.

    • If specific files in a remote folder are selected, the option is ignored and the specified files are imported on the first run.

    If the Include subfolders option is not selected in APC:

    • If a remote folder is monitored, all files from that folder are imported.

    • If specific files are monitored, only those files are imported.

  • Set up Continuous Jobs to have selected files monitored for changes.

Git Settings

No changes are required.

Phrase 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.

    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. Specified block fields UIDs will not be imported. Separate multiple UIDs by comma (e.g. UID1, UID2, UID3).

  8. Provide a Commit message if required.

  9. Click Test connection.

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

  10. 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.