Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add Example Configuration files #25

Closed
alexekuo opened this issue Sep 13, 2015 · 6 comments
Closed

Add Example Configuration files #25

alexekuo opened this issue Sep 13, 2015 · 6 comments

Comments

@alexekuo
Copy link

Add config examples that start at bare minimum along with full featured examples

@kria
Copy link
Owner

kria commented Sep 16, 2015

I guess it's not the most user-friendly piece of software, but there are some examples in the config and wiki. Anything in particular you want explained more thoroughly?

@kria kria closed this as completed Feb 22, 2016
@humamaki
Copy link

Hello Kria,
On the event rules can you clarify which fields are required and which fields are optional. I'm not sure if leaving some of the fields empty will cause issues or not.

Thank you.

@kria
Copy link
Owner

kria commented Feb 23, 2016

Since the latest version (1.15.0), all arguments except notifyare optional. So this is a valid rule that will let everything through:

<rule notify="true" />

For instance, a missing teamProject or teamProject="" means that notifications will be relayed for all projects.

Some filter only apply to specific events so if you have set gitBranch="develop", that doesn't affect whether or not a WorkItemChangednotification is relayed. Take a look here to see which filters affect which events.

@kria kria reopened this Feb 23, 2016
@humamaki
Copy link

Thank you very much for your quick response. I really appreciate your help.
What about this :

<userMap id="slackusers">
        <add tfsUser="MYDOMAIN\kria" mappedUser="UXXXXXXXX" />
</userMap>

Is this the login to TFS?

Thank you again.

@kria
Copy link
Owner

kria commented Feb 23, 2016

This is a list of one or many users that is totally optional. tfsUser is the account that people use to login to TFS..

userMap a way to connect Windows users to their corresponding external user. The point of doing that is that if you want to send a direct message to someone or generate a highlighted notification on the external system, you need to know their username or id on that system. The usermap is connected to a bot using the userMapId argument.

This mechanism is used by the DirectMessageNotifier to send direct messages to Slack and by the mapped*User parameters.

In this screenshot, it's used to generate a notification and sound in Slack (see the yellow highlight):

image

@humamaki
Copy link

Thank you very much. It is working now and I really appreciate your help.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

3 participants