Notifications FAQ

How notification works in Twproject?

There are three entities: events, subscriptions and messages.

Topic actions like task creation, status or dates changes etc. raises events when happens. Events are queued. By default every minute, event queue is scanned and matched with the subscription set.

If an event match with a subscription a message is generated and queued. Messages dispatcher periodically send messages on their channel (email, sticky, digest ect.).

Subscription are created while assigning resources to tasks. https://twproject.com/support/using-twproject/projects-and-tasks/notifications-subscriptions/

Which are the available channels to get notified?

Available channels are:

  • email: you will receive an email every time an event that you are subscribed to is generated .
  • digest: every week you will receive an email summing up all the events generated during the week that.
  • Sticky notes: when an event occurred a sticky note will appear on your Twproject screen.

Where can I see all my subscriptions?

All subscription are listed in your resource page. Click on your avatar at the top right of the page and then on “subscription” in the right menu.

Where I can change events listened by default?

Default notifications are set on roles, so when you are assigned to a task with a specific role, you will be subscribed by default to those event selected in the role. To edit these, login as administrator and go in admin page -> roles. Select the role per project you want to edit, at the bottom of the page you will find the table to customize default subscriptions.

Can I change my subscriptions for a specific project?

Of course, once you are assigned you can edit the assignment changing the subscriptions, just go in the editor and click on “customize your notifications”.

Localization FAQ

Which languages are available?

Twproject is actually available in English, German, French, Spanish, Italian,  Portuguese, Chinese, Japanese, Russian, Polish and Slovenian.

How do I change Twproject language?

Go “admin” –>  “Basic system configuration” –> “Language, dates, currency” here you can change the default Twproject language. This will be the language every user will see once logged. Every user then, if they need can change its own language by the option page.

Can a user see Twproject in his own language?

Yes, every user can set its preferred language.

How do I change the server timezone?

Go “admin” –>  “Basic system configuration” –> “Language, dates, currency”

Can I use Twproject with my currency?

Yes, go “admin” –>  “Basic system configuration” –> “Language, dates, currency”. Same currency is used across users.

If I change a label, what happen upgrading Twproject?

By default, your label changes are saved on the database, so that they will be preserved.

How to contribute in Twproject translation?

If you would like to start a translation for a new language contact us info@twproject.com.

Installation FAQ

How do I first login?

Open a browser an navigate to your server, or “localhost” if you installed Twproject on the same computer. The url usually looks like http://localhost, but sometime you need to add the port number something like http://localhost:8080. The installer tells you the port used.

  • For on-premises solution first login is “administrator” with empty password.
  • For on the cloud solution, first login is administrator with the password you received via e-mail.
  • Is a good idea to change the password as soon as possible.

32 or 64 bits?

Twproject is available for many different operating systems. Even if it is built on Java some components are specific for 32 or 64 bit versions. By the way a 64 bit installer cannot run on a 32 bit machine.

64 bit distribution should be preferred in case on “stressed” environments, specially on windows servers.

How do I install Twproject by hand?

A good starting point: https://twproject.com/support/twproject-advanced-usage/installation/handcustom-install/

How do I upgrade my Twproject instance?

Easy with the graphical installer. See below for details: https://twproject.com/support/twproject-advanced-usage/installation/upgrade-the-application/

Can I install Twproject on my Tomcat, instead of the provided one?

Yes, proceed in this way:

ensure that your Tomcat is updated, i.e. 6 and above, and using JDK 6/7

install anywhere using the graphical installer with access to the real database, until the last step of the installer, where you disable the “launch Tomcat” and “launch browser” checkboxes

the installer will:

create a config.properties with the JDBC connection parameters

create a lic.properties file with the license data supplied

now copy the resulting webapp, that is, the webapps/ROOT folder, from the provided Tomcat to your Tomcat

if you are not using the Twproject  web app as ROOT, configure your Tomcat adding the Twproject  web app

Launch Tomcat and browse to the web app root, the schema will be created and filled.

In 99% of the cases where this does not work it is due either to launching Tomcat not as root, or using a database user that doesn’t have schema creation rights.

Time Tracking FAQ

Can I insert work done weekly?

Yes, in Twproject there is a specific page for this that you find clicking on the “timesheets” button in the main menu.
https://twproject.com/support/using-twproject/work-time-tracking/weekly-timesheet/

Can I insert work done for someone else?

Yes, in the timesheets page (“timesheets” button in the main menu) there is a specific combo that let you select resources. By default it select yourself but you can anytime change it to insert worklog for someone else.

There is a way to start recording time spent?

Twproject supports time counters. This functionality lets you start recording time on a specific task just clicking on a button, something like a semaphore that you can turn on and off. Read here for more info:
https://twproject.com/support/using-twproject/work-time-tracking/weekly-timesheet/

Can I exclude some worked hours from project costs?

Yes,  In the cost page there is the possibility to filter worklog by its status. So for example you can have a report of your task cost just by worklog marked as “billed”. Consider that worklog status are customizable by the user.

Can I record work done for a specific issue?

Yes. If the issue is assigned to you, there will be a watch icon in the issue line. if you click on it  a yellow box will appear at the top of the page where you can record your time spent, the date and a description. The same yellow box will appear every time you mark on of your issue as closed.

Can I insert my work done directly on my dashboard?

There is specific widget for doing this called “WORKLOGDAY” that you can add to your page while customizing. How to do that is written here:
https://twproject.com/support/twproject-advanced-usage/customizations/dashboard-customization/

Is there a way to check if I forget to insert work done for some days?

Yes, just go to your timesheets page and click on -> “check worklog” -> “check days missing worklog”. You will be able to specify a range of dates for checking.

Can I insert worklog on non active task?

Yes, by default your timesheets page will show you just your active tasks in the week you are looking to have the page as clean as possible. However, that page you will also have a combo where you can find non-active task, simply choose on of them to have it added to the list.

Documents FAQ

Can I upload files on a project?

Of course, as many you want. Just drag files (one or more at once) on the document box in the project editor. If you upload the same file more than once, versions will be created. Uploaded documents will be full-text indexed.

Which users can see those files?

Only the ones that have “document read” permission on that project. Usually project managers and worker, but you can change default permissions. https://twproject.com/support/using-twproject/security/roles/

Can I search uploaded file’s content full text?

Well, depends on the file you uploaded. Pdf, word, excel, PowerPoint, open office, txt, html are all indexed.
Images are not Smile

Can I link a project to a folder on my file system?

Twproject uses the concept of “file storage” to address this matter. You can have remote file systems, samba, subversion, ftp or amazon s3 “storages” and everyone can be linked to a project. Links can point both to a subfolder, a document or the repository root. Some basic actions like upload, create folder, delete, rename can be done using Twproject interfaces. File storages are accessible with the mobile interface too.
https://twproject.com/support/using-twproject/documents/file-storages/

How permissions work on file storages?

Actually it is quite complex, but summarizing everything is delegated to the permissions the user have on the task linked to that repository. Hi level permissions are necessary to create new repositories, then Twproject security does the dirty job.
https://twproject.com/support/using-twproject/security/roles/

Can Twproject connect to Amazon AWS S3?

Yes. https://twproject.com/support/using-twproject/documents/file-storages/

Can Twproject connect to a subversion repository?

Yes. Moreover it can import SVN logs for generating worklog.

https://twproject.com/support/using-twproject/documents/file-storages/

Can Twproject connect to Alfresco document management?

Yes, Alfresco and most of recent DMS expose repositories using Samba or NFS. Remote file system type can be used directly. https://twproject.com/support/using-twproject/documents/file-storages/

Can Twproject connect to SharePoint?

Yes, see above.

Does Twproject manage versions?

Yes. If you upload a file with the same name (on the same task) a version will be created automatically. From the document page of task or resource you will have full access to older version too. https://twproject.com/support/using-twproject/documents/document-repository/

Can I have my documents on a db instead of the file system?

Yes. By default Twproject use a folder for storing uploaded files. In some cases it could be useful to have that files on the Twproject database. Go to “admin” –> “Basic configuration” –> “File system” and set the “database” type. Existing documents will rest “untouched”.

Can I encrypt my files?

Yes. You can encrypt uploaded files using AES. Go to “admin” –> “Basic configuration” –> “File system” and set the “encrypted folder” type. Existing documents will rest “untouched”.

Customizations FAQ

Can I customize my home page / dashboard?

Yes. By default every supplied page (get things done, project manager,  supervisor etc.) is customizable. You can add/remove widget to get your page confortable.
https://twproject.com/support/using-twproject/dashboard-the-users-home-pages/

Can I add custom field on Twproject main entities?

Of course. Tasks, resources, issues, assignments, worklogs and costs can have up to 6 custom field. Custom fields are really flexible and you can have different types like strings, numbers, files, or any Twproject entity, but also external lookup.
https://twproject.com/support/twproject-advanced-usage/customizations/custom-fields/

Can I filter for custom fields values

Yes of course.
https://twproject.com/support/twproject-advanced-usage/customizations/custom-fields/

Can I write my own report?

Yes. Twproject uses Jasper Report for creating in minutes powerful reports.
https://twproject.com/support/twproject-advanced-usage/customizations/write-your-own-report/

Can I attach a customized form to a resource or a project?

Of course; this is a really flexible way to add structured information on task or resources.
https://twproject.com/support/twproject-advanced-usage/customizations/create-your-own-custom-form/

Can I have a wizard for creating a task from my data?

Yes. Wizards allows to add functionality to Twproject.
https://twproject.com/support/twproject-advanced-usage/customizations/create-your-own-custom-wizard/

Workflows FAQ

Why should I use a workflows instead of a project?

Because a defined process can implement a graph (eventually with loops) while a project is structured as a tree. If you think your process is well defined and it may requires decisions that could activate or not some steps consider using a process.

Actually in most cases task structure with dependencies is enough and by far easy to set-up. See here for details about workflows: https://twproject.com/support/using-twproject/projects-and-tasks/project-as-business-process/

Can I use a process instead of a project?

Yes. Once you have your process defined, you can decide to start a new process instead of project. See here for details about workflows: https://twproject.com/support/using-twproject/projects-and-tasks/project-as-business-process/

Where is the workflow management?

Go to “admin” –>  “Customization” –> “Business processes”

How can I write new processes?

Process are written in XML using JPDL language. A good starting point are the supplied examples. Have a look to jBoss documentation: http://docs.jboss.org/jbpm/v3/userguide/jpdl.html#d0e5138

Can you recommend a tool to edit the process xml’s?

When we started developing the processes part we’ve searched for a good tool to create processes and we find that the best one is the plugin for eclipse. Unfortunately you need to install the IDE to then start using the plugin.

Technical FAQ

How can I upgrade Twproject to latest version?

Go to “admin” –>  “Monitoring” –>  “Check for updates”. If you need to upgrade go to https://twproject.com/on-your-server/  and download your installer (be careful to 32 or 64 bit versions). Run it. That’s all.
https://twproject.com/support/twproject-advanced-usage/installation/ 

How do I verify / change Twproject memory settings?

On Windows: if you are using the windows service: open a command console (Start -> Run -> “cmd” in the run input), go to the Twproject folder, and into the bin folder. Say that your Twproject  service is displayed as “Teamwork-8080”, the system name will be teamwork8080. Type

tomcat6w //ES//teamwork8080

and an application will open and in the “Java” tab you can modify memory settings. Another method is go to Start -> Run, and run “regedt32.exe”. There should be an entry at HKEY_LOCAL_MACHINE -> SOFTWARE -> Apache Software Foundation -> Procrun 2.0 -> [Tomcat service name]. If you are launching using the tw.bat, edit the file, change the -Xms64m -Xmx128m settings to a higher range.

On Linux: open the teamworkLinux.sh script, and change the -Xms128m -Xmx384m settings to a higher range.

On OSX: if you are launching by script by hand, open the teamworkOsx.sh script, and change the -Xms128m -Xmx512m settings to a higher range. If you are launching Twproject  as service, change in [Twproject  root folder]/launchdScript.sh the line “export JAVA_OPTS=-Xmx512M $JAVA_OPTS” (if it is #export JAVA_OPTS=-Xmx512M $JAVA_OPTS, remove the #).

All cases: In all cases, you may also want to widen the PermGen space (the part of memory which cannot be garbage collected): e.g. -Xms512m -Xmx1024m -XX:PermSize=128M -XX:MaxPermSize=256M

Can I configure a Public Domain Name for my Twproject?

If you intend to access Twproject both from intranet and extranet, you should set a public name to your Twproject. Go to “admin” –>  “Basic system configuration” –> “http server” and set “server name” to the same name you set on your DNS.

How can I schedule batch jobs?

Twproject has its own scheduler that is used by default for monitoring events, dispatching messages, download e-mail and so on. If you need to schedule some additional jobs, there are several ready-to-use jobs you can use: org.jblooming.scheduler.ExecuteJavaMain, org.jblooming.scheduler.ExecuteOsBatch and org.jblooming.scheduler.ExecuteSQL could be a good starting point to develop you own or to use them as-is.

How can I authenticate my users using my LDAP/Active directory?

Twproject supports both standard, http, ldap or ldap with standard fallback. Go to “admin” –>  “Advanced configuration” –> “LDAP integration” .
https://twproject.com/support/twproject-advanced-usage/connections/ldap-active-directory/

Where are Twproject log files?

You can see/download Twproject logs directly from the web interface: Go to “admin” –>  “Monitoring” –>  “Logging”.

You will find Twproject log here [TWPROJECT INSTALLATION ROOT]/webapps/ROOT/WEB-INF/log

Can I get more information from log files?

Sometime,  in case of trouble, you may need to get more information about Twproject status and behavior. In this case go to “admin” –>  “Monitoring” –>  “Logging” and set log level to “info” or “debug”.

Other advanced debug options are available on “config.properties” file. Do not “play” with this parameters, if you have trouble, contact us, will be happy to help you.

When I upgrade Twproject to a new version, where can I find database schema changes?

Twproject check your database schema and eventually applies changes automatically. Every action is logged on [TWPROJECT INSTALLATION ROOT]/webapps/ROOT/WEB-INF/log/schemaHistory.log file

Pricing / Payments FAQ

Yearly license, non expiring license, or Twproject hosted?

The first distinction is between an installed (needing a license) or hosted service.

Go for installed if you are aiming at keep you data in house or deep integration with your other IT services, and / or if you have specific security policies for software in use.

Go hosted if you want to keep maintenance efforts at a minimum and if you want to start immediately. You could anytime move to an in house installation.

In case you are using the installed version, pick a yearly license to minimize initial investment; if you have a budget and don’t want to multiply purchasing order processes, get the non expiring one.

How are licenses counted?

Each user with enabled login counts for 1 user. No test for concurrent login is done, so concurrent login has no influence on license count. Users may be enabled and disabled any time; as soon as a user is disabled, she/he is no longer counted in the license count, but all data connected to that user is preserved.
In short, only those that really can work in Twproject are counted.

How much does Twproject cost?

If you want to use Twproject hosted by us on Amazon servers, see the Amazon hosting dedicated page

If you want to install Twproject on your servers, see license prices page.

Is support Included?

Free support is provided through our support site. Frequently asked question, user manual, videos are available for free. If you need you can always contact us submitting your questions, we will answer within few hours.

Do you offer remote setup service?

Many of our customers use remote setup to get a professional Twproject server setup and configuration. It is assumed that the database server is already installed. Setup is for the current version or upgrade to the current version; installing following upgrades is not included. In case of upgrade, it is assumed that the customer has complete backups.

Are there hidden / additional costs?

No additional costs! Twproject comes with free upgrade of the current version for all users, so there are no additional costs to pay.

How do I extend my license to more users, or for a longer period?

You can buy additional licenses anytime directly from your Twproject instance.  You can even renew or extend your period. Simply login as admin, go in the admin  page and click on Twproject shop button.

What if I don’t want to pay with PayPal?

If you don’t want to pay with PayPal, send a mail to info@twproject.com and we’ll send you the international money transfer data.

What about Refunds?

If you’re not satisfied, write us  within 30 days to get a full refund.

License agreement?

Here is the license agreement you will accept by using Twproject.

Milestones FAQ

How can I set a milestone?

In Twproject milestones are always related to a project or task. Both start or end date can be set as milestones. https://twproject.com/support/using-twproject/projects-and-tasks/

Are milestone approaching notified?

Yes, by default 3 days before the milestone. You can eventually change this value or even ignore the notification. https://twproject.com/support/using-twproject/projects-and-tasks/notifications-subscriptions/

Where can I see my milestone?

Milestones are visible in the summary bar at the end of “get things done” page. Moreover you can use “next milestone” pre-set filter on task list page.

Does a milestones create time constraints?

Yes. Once a milestone is set, every change on task tree structure that requires time shift on parents are blocked. This allows to delegate sub task to other resources without compromising the main project schedule.