https://github.com/chapter-three/teamwork-log
Take a CSV file and log its data as time entries in TeamWork.
https://github.com/chapter-three/teamwork-log
Last synced: about 2 months ago
JSON representation
Take a CSV file and log its data as time entries in TeamWork.
- Host: GitHub
- URL: https://github.com/chapter-three/teamwork-log
- Owner: chapter-three
- Created: 2015-05-19T15:11:33.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2021-11-14T00:27:37.000Z (over 3 years ago)
- Last Synced: 2025-01-18T06:27:33.075Z (3 months ago)
- Language: AppleScript
- Size: 83 KB
- Stars: 1
- Watchers: 35
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# teamwork-log
Take a CSV file and log its data as time entries in TeamWork.
# Installation
- Checkout this repository: `git clone [email protected]:chapter-three/teamwork-log.git && cd teamwork-log`
- Install dependencies: `npm install`
# Configuration
### Create the config file
- Duplicate `example.log.config.json` and rename to `log.config.json`
- Edit `log.config.json`
### Add company/user info
- Add your company id into the `company` field, which is the subdomain of your Teamwork URL
- If your Teamwork url is `http://acme.teamworkpm.net/` then your company id is `acme`
- In order to get an API key of *Teamwork*, go to your *Teamwork* account and hit your user picture. **Select Edit my details**. [@see trackduck](http://help.trackduck.com/2014/11/teamwork-integration-setup/)
- Enter this value into the `key` field
- To get your Teamwork user id, hover over your user photo/picture
- Look at your browser status bar
- The numeric value in the URL is your user id
- Enter this value into the `personId` field
### Map CSV fields
- Alter the capitalized values `Date`, `Notes`, etc to the names of the columns in your CSV file
### Map projects
- A project mapping consists of the project's name from your time keeping application (TKA hereafter), and the id of the associated project in Teamwork
- Get the project id by navigating to the project in Teamwork
- The project id is the numerical value in the URL
### Map project tasks (optional)
- You can map a task from your TKA to a task in Teamwork
- Follow the example syntax in `example.log.config.json`
- The Teamwork task id can be found similar to how you find a project's id
# Usage
- Export a CSV file from your TKA
- In your terminal, `$ log --file path/to/your/csvfile.csv`
# Troubleshooting
- If you get an error like `log: too many arguments`, then try running as `$ ./log --file ...` instead