org.finos.symphony.toolkit:teamcity-symphony-integration-server

A collection of Java projects for building Symphony bots and apps

License	Apache License, Version 2.0
Categories	TeamCity Build Tools Continuous Integration and Continuous Delivery
GroupId	org.finos.symphony.toolkit
ArtifactId	teamcity-symphony-integration-server
Last Version	6.20.1
Release Date	Mar 12, 2021
Type	jar
Description	A collection of Java projects for building Symphony bots and apps
Project Organization	Finos

Download teamcity-symphony-integration-server

Filename	Size
teamcity-symphony-integration-server-6.20.1.pom
teamcity-symphony-integration-server-6.20.1.jar	22 KB
teamcity-symphony-integration-server-6.20.1-sources.jar	13 KB
teamcity-symphony-integration-server-6.20.1-javadoc.jar	419 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/org.finos.symphony.toolkit/teamcity-symphony-integration-server/ -->
<dependency>
    <groupId>org.finos.symphony.toolkit</groupId>
    <artifactId>teamcity-symphony-integration-server</artifactId>
    <version>6.20.1</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/org.finos.symphony.toolkit/teamcity-symphony-integration-server/
implementation 'org.finos.symphony.toolkit:teamcity-symphony-integration-server:6.20.1'

Gradle Kotlin

// https://jarcasting.com/artifacts/org.finos.symphony.toolkit/teamcity-symphony-integration-server/
implementation ("org.finos.symphony.toolkit:teamcity-symphony-integration-server:6.20.1")

Apache Buildr

'org.finos.symphony.toolkit:teamcity-symphony-integration-server:jar:6.20.1'

Apache Ivy

<dependency org="org.finos.symphony.toolkit" name="teamcity-symphony-integration-server" rev="6.20.1">
  <artifact name="teamcity-symphony-integration-server" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='org.finos.symphony.toolkit', module='teamcity-symphony-integration-server', version='6.20.1')
)

Scala SBT

libraryDependencies += "org.finos.symphony.toolkit" % "teamcity-symphony-integration-server" % "6.20.1"

Leiningen

[org.finos.symphony.toolkit/teamcity-symphony-integration-server "6.20.1"]

Dependencies

compile (3)

Group / Artifact	Type	Version
org.apache.cxf : cxf-rt-rs-client	jar	3.3.4
org.finos.symphony.toolkit : entity-json	jar	6.20.1
org.finos.symphony.toolkit : symphony-api-spring-boot-starter	jar	6.20.1

provided (1)

Group / Artifact	Type	Version
org.jetbrains.teamcity » server-api	jar	2019.1

test (4)

Group / Artifact	Type	Version
org.jetbrains.teamcity » tests-support	jar	2019.1
org.mockito : mockito-core	jar
org.mockito : mockito-junit-jupiter	jar
org.junit.jupiter : junit-jupiter	jar

Project Modules

There are no modules declared in this project.

What This Is

This project is a set of libraries aimed at facilitating creating Bots and Apps for the Symphony Chat Platform using Java and Spring Boot.

This project contains the following:

• Symphony Java Client Bindings
• Symphony Java Client Identity
• Symphony API Spring-Boot Starter
• Symphony App Spring-Boot Starter
• Symphony JSON Support
• Symphony FIX Support
• A Symphony Maven Build Notifier
• A TeamCity Build Notifier
• Symphony Shared Stream
• Chat Workflow
• KoreAI Connector
• Tutorials for getting started
• Demo bots and apps

Read further to see what each of these includes.

Overview and Dependencies

Many of the components in this project rely on each other, as demonstrated in this dependency diagram. This also gives and overviw of the purpose of each component.

Symphony Java Client Bindings

This provides a JAX-RS standard, Type-Safe means of interacting with Symphony pods via REST apis.

bindings is a set of swagger-generated domain objects and interfaces that provide a Java API for interacting with Symphony's REST endpoints.

• Symphony REST Endpoint Documentation
• Symphony REST Endpoint Swagger Definitions

This is used in preference to Symphony's own API as the configuration can be left to spring boot, and you can use Spring's starters for JAX-RS to build your application.

View The README

Symphony Java Client Identity

symphony-java-client-identity provides a single abstraction of SymphonyIdentity, which encapsulates the data needed to authenticate with a symphony server. That is:

• Private Key
• Certificates
• Common Name
• Email Address

This is a highly convenient abstraction which works with Spring Boot's use of Jackson and YAML to describe Bot and App identities in Java.

View The README

Symphony API Spring Boot Starter

Provides Spring-Based configuration and auto-wiring for Symphony APIs. This is perfect if you are building a Symphony Bot using Spring Boot.

• View the README
• Read the Bot-Building Tutorial
• View Demo Bot Code

Symphony App Spring Boot Starter

If you are building a Symphony App, there are multiple concerns around app security, networking, describing your application and handling user authentication.

This provides you with an out-of-the-box way to get started and build an app with all of these concerns taken care of.

• View the README
• Read the App-Building Tutorial
• View Demo App Code

Entity JSON - Symphony JSON Support

This is a utility that helps you serialize/deserialize JSON in a format suitable for the JSON data payload of a Symphony Message, using Jackson.

• View the README
• Read the Tutorial

QuickFIX Support

This is a utility that helps you serialize/deserialize QuickFIX messages into JSON Format, as described here.

Although this is not reliant on Symphony code, it is adjacent tech and so might be useful for sending FIX payloads within Symphony.

• View the README

Maven Build Reporter

Provides a maven extension that allows you to report build results into a Symphony chat room.

• View the README

TeamCity Build Notifier

Allows you to report your TeamCity builds into Symphony chat rooms, using a bot.

• View the README

Symphony Shared Stream

The purpose of this module is to provide a drop-in stream consumer for Symphony that allows a cluster of bot replicas to coordinate work. That is, prevent the problem of two or more bots simultaneously consuming and processing the same Symphony message.

• View the README

Chat Workflow

This module provides a one-stop-shop for constructing work-flows in Java. It is intended that beyond configuration the developer will not have to understand any Symphony APIs to build work-flows and have them run in Symphony.

• View the README
• View the Tutorial
• Demo To-Do List Bot
• Demo Claim Bot
• RSS News Bot
• Poll Bot

Kore-AI Bridge

This is a Spring Boot App that acts as a middleman between a Symphony bot and a KoreAI bot, allowing you to expose your KoreAI bot as a bot on Symphony. Kore.AI is a low code/no code environment for building chat bots.

• View the README

License

This project is licensed under the Apache 2.0 License.

Running The Demo Bots

Releasing This Project (For Maintainers)

In order to do a release:

1. Changes.md

• Update this file to include details of the release.

2. On Releaser's machine:

mvn clean test -P symphony-ci
mvn versions:set -DnewVersion=<our breaking change no>.<symphony-api-version>.<our-release-no> -DartifactId=\*  -DgroupId=\*
mvn -DskipTests clean test source:jar javadoc:javadoc deploy -P symphony-release
mvn versions:set -DnewVersion=<our breaking change no>.<symphony-api-version>.<our-release-no+1>-SNAPSHOT -DartifactId=\*  -DgroupId=\*
# then push to git

3. On oss.sonatype.org

• Close the Staging Repository
• Release it.

4. Perform release on github with same number

The Fintech Open Source Foundation (www.finos.org)

FINOS’ mission is to promote open innovation in financial services. See our full list of repos from our nearly 100 projects & 11 programs at finos.github.io

Versions

Version
6.20.1 Mar 12, 2021
6.20.0 Feb 22, 2021
5.59.4 Jan 13, 2021
5.59.3 Jan 7, 2021
5.59.2 Jan 7, 2021
5.59.1 Nov 26, 2020