{issue_id} mark to put it into the result URL.
+ *
+ * @return Bug Tracking System Issue URL pattern
+ */
+ String urlPattern() default "";
+}
diff --git a/src/main/java/com/epam/reportportal/annotations/Issue.java b/src/main/java/com/epam/reportportal/annotations/Issue.java
new file mode 100644
index 00000000..d59b0fa5
--- /dev/null
+++ b/src/main/java/com/epam/reportportal/annotations/Issue.java
@@ -0,0 +1,60 @@
+/*
+ * Copyright 2024 EPAM Systems
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.epam.reportportal.annotations;
+
+import java.lang.annotation.*;
+
+/**
+ * This annotation supposed to automatically link failed test items a specific Issue on ReportPortal.
+ */
+@Documented
+@Inherited
+@Retention(RetentionPolicy.RUNTIME)
+@Target(ElementType.METHOD)
+@Repeatable(Issues.class)
+public @interface Issue {
+ /**
+ * Type (Locator), Short Name (Abbreviation) or Long Name (Defect name) (specified by priority) of an Issue on ReportPortal for
+ * the current project. If there is no such issue found in Project Setting the value will be used "as is" and sent as
+ * Issue Type (Locator).
+ *
+ * @return Type (Locator), Short Name (Abbreviation) or Long Name (Defect name) of an Issue
+ */
+ String value();
+
+ /**
+ * Arbitrary text describing the issue.
+ *
+ * @return issue description
+ */
+ String comment() default "";
+
+ /**
+ * Links to External System where this issue is located.
+ *
+ * @return External Issue describing object
+ */
+ ExternalIssue[] external() default {};
+
+ /**
+ * For Parameterized and Dynamic tests select certain test for Issue applying using filters by certain criteria. Each additional filter
+ * applies to the set of tests using logical "AND".
+ *
+ * @return filter list
+ */
+ TestFilter[] filter() default {};
+}
diff --git a/src/main/java/com/epam/reportportal/annotations/Issues.java b/src/main/java/com/epam/reportportal/annotations/Issues.java
new file mode 100644
index 00000000..2086db4e
--- /dev/null
+++ b/src/main/java/com/epam/reportportal/annotations/Issues.java
@@ -0,0 +1,30 @@
+/*
+ * Copyright 2024 EPAM Systems
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.epam.reportportal.annotations;
+
+import java.lang.annotation.*;
+
+/**
+ * Gathering annotation for {@link Issue}
+ */
+@Documented
+@Inherited
+@Retention(RetentionPolicy.RUNTIME)
+@Target(ElementType.METHOD)
+public @interface Issues {
+ Issue[] value();
+}
diff --git a/src/main/java/com/epam/reportportal/annotations/ParameterKey.java b/src/main/java/com/epam/reportportal/annotations/ParameterKey.java
index 1c401989..856daafa 100644
--- a/src/main/java/com/epam/reportportal/annotations/ParameterKey.java
+++ b/src/main/java/com/epam/reportportal/annotations/ParameterKey.java
@@ -21,23 +21,16 @@
import java.lang.annotation.Target;
/**
- * Used in parametrized tests. ReportPortal waiting test parameters
- * in key - value style. Using the annotation for method parameter
+ * Used in parametrized tests. ReportPortal waiting test parameters in key - value style. Using the annotation for method parameter
* the specific key can be provided.
- *
- * @author Pavel Bortnik
- * @since ReportPortal Api v3.1.0
*/
-
@Retention(RetentionPolicy.RUNTIME)
@Target({ ElementType.PARAMETER })
public @interface ParameterKey {
-
/**
* Returns parameter key value
*
* @return key value
*/
String value() default "";
-
}
diff --git a/src/main/java/com/epam/reportportal/annotations/TemplateConfig.java b/src/main/java/com/epam/reportportal/annotations/TemplateConfig.java
index 45f096f2..dcaf1855 100644
--- a/src/main/java/com/epam/reportportal/annotations/TemplateConfig.java
+++ b/src/main/java/com/epam/reportportal/annotations/TemplateConfig.java
@@ -26,7 +26,7 @@
* Template configuration. Required for customizing representation of the parsed collections and arrays.
* {@link TemplateConfig#methodNameTemplate()} required to set the current method name template to be included in the result value to
* prevent situations when the method argument has the same name as a default {@link TemplateConfiguration#METHOD_NAME_TEMPLATE}
- *
+ *
* {@link TemplateConfig#selfNameTemplate()} required to set the current object name template to be included in the result value to
* prevent situations when the method argument has the same name as a default {@link TemplateConfiguration#SELF_NAME_TEMPLATE}
*/
diff --git a/src/main/java/com/epam/reportportal/annotations/TestFilter.java b/src/main/java/com/epam/reportportal/annotations/TestFilter.java
new file mode 100644
index 00000000..9ab33ed8
--- /dev/null
+++ b/src/main/java/com/epam/reportportal/annotations/TestFilter.java
@@ -0,0 +1,45 @@
+/*
+ * Copyright 2024 EPAM Systems
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.epam.reportportal.annotations;
+
+import java.lang.annotation.Documented;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * Link current Issue with a specific Parameterized or Dynamic test by applying filters.
+ */
+@Documented
+@Retention(RetentionPolicy.RUNTIME)
+@Target({})
+public @interface TestFilter {
+
+ /**
+ * Specify Test Name filters to select certain test for {@link Issue} applying, suitable for dynamic tests.
+ *
+ * @return Test Name filters
+ */
+ TestNameFilter[] name() default {};
+
+ /**
+ * Specify Test Parameter filters to select certain test for {@link Issue} applying, suitable for parameterized tests.
+ *
+ * @return Test Name filters
+ */
+ TestParamFilter[] param() default {};
+}
diff --git a/src/main/java/com/epam/reportportal/annotations/TestNameFilter.java b/src/main/java/com/epam/reportportal/annotations/TestNameFilter.java
new file mode 100644
index 00000000..379d056f
--- /dev/null
+++ b/src/main/java/com/epam/reportportal/annotations/TestNameFilter.java
@@ -0,0 +1,43 @@
+/*
+ * Copyright 2024 EPAM Systems
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.epam.reportportal.annotations;
+
+/**
+ * Filter Test Set by Test Name.
+ */
+public @interface TestNameFilter {
+ /**
+ * Select a test which name starts with specified String.
+ *
+ * @return required prefix
+ */
+ String startsWith() default "";
+
+ /**
+ * Select a test which name ends with specified String.
+ *
+ * @return required postfix
+ */
+ String endsWith() default "";
+
+ /**
+ * Select a test which name should contain specified String.
+ *
+ * @return required contents
+ */
+ String contains() default "";
+}
diff --git a/src/main/java/com/epam/reportportal/annotations/TestParamFilter.java b/src/main/java/com/epam/reportportal/annotations/TestParamFilter.java
new file mode 100644
index 00000000..977c4051
--- /dev/null
+++ b/src/main/java/com/epam/reportportal/annotations/TestParamFilter.java
@@ -0,0 +1,77 @@
+/*
+ * Copyright 2024 EPAM Systems
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.epam.reportportal.annotations;
+
+/**
+ * Filter Test Set by Parameter.
+ */
+public @interface TestParamFilter {
+ /**
+ * Parameter index to which this filter should be applied. If it's not specified then the filter try to match every parameter.
+ *
+ * @return parameter index
+ */
+ int paramIndex() default -1;
+
+ /**
+ * Select a test parameter which name starts with specified String. Designed to use with {@link ParameterKey} annotation, since there is
+ * no parameter names in Java runtime.
+ *
+ * @return required prefix
+ */
+ String nameStartsWith() default "";
+
+ /**
+ * Select a test parameter which name ends with specified String. Designed to use with {@link ParameterKey} annotation, since there is
+ * no parameter names in Java runtime.
+ *
+ * @return required prefix
+ */
+ String nameEndsWith() default "";
+
+ /**
+ * Select a test parameter which name should contain specified String. Designed to use with {@link ParameterKey} annotation, since there
+ * is no parameter names in Java runtime.
+ *
+ * @return required prefix
+ */
+ String nameContains() default "";
+
+ /**
+ * Select a test parameter which value starts with specified String. Non-string parameter values convert with {@link Object#toString()},
+ * method.
+ *
+ * @return required prefix
+ */
+ String valueStartsWith() default "";
+
+ /**
+ * Select a test parameter which value ends with specified String. Non-string parameter values convert with {@link Object#toString()},
+ * method.
+ *
+ * @return required prefix
+ */
+ String valueEndsWith() default "";
+
+ /**
+ * Select a test parameter which value should contain specified String. Non-string parameter values convert with
+ * {@link Object#toString()}, method.
+ *
+ * @return required prefix
+ */
+ String valueContains() default "";
+}
diff --git a/src/main/java/com/epam/reportportal/annotations/TmsLink.java b/src/main/java/com/epam/reportportal/annotations/TmsLink.java
new file mode 100644
index 00000000..f94d25b6
--- /dev/null
+++ b/src/main/java/com/epam/reportportal/annotations/TmsLink.java
@@ -0,0 +1,52 @@
+/*
+ * Copyright 2024 EPAM Systems
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.epam.reportportal.annotations;
+
+import java.lang.annotation.*;
+
+/**
+ * Add a link to a Test Case located in external Test Management System.
+ * This annotation appends a hypertext link to a Test Case into the Test Item description.
+ */
+@Documented
+@Inherited
+@Retention(RetentionPolicy.RUNTIME)
+@Target({ ElementType.METHOD, ElementType.TYPE })
+@Repeatable(TmsLinks.class)
+public @interface TmsLink {
+
+ /**
+ * TMS ticket ID.
+ *
+ * @return ID as string
+ */
+ String value();
+
+ /**
+ * Link text pattern, accepts 'tms_id' parameter.
+ *
+ * @return formatted link text
+ */
+ String linkTextPattern() default "TMS #{tms_id}";
+
+ /**
+ * Link URL pattern, accepts 'tms_id' parameter.
+ *
+ * @return link to a TMS ticket
+ */
+ String urlPattern() default "";
+}
diff --git a/src/main/java/com/epam/reportportal/annotations/TmsLinks.java b/src/main/java/com/epam/reportportal/annotations/TmsLinks.java
new file mode 100644
index 00000000..f762f96a
--- /dev/null
+++ b/src/main/java/com/epam/reportportal/annotations/TmsLinks.java
@@ -0,0 +1,30 @@
+/*
+ * Copyright 2024 EPAM Systems
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.epam.reportportal.annotations;
+
+import java.lang.annotation.*;
+
+/**
+ * Gathering annotation for {@link TmsLink}
+ */
+@Documented
+@Inherited
+@Retention(RetentionPolicy.RUNTIME)
+@Target({ ElementType.METHOD, ElementType.TYPE })
+public @interface TmsLinks {
+ TmsLink[] value();
+}
diff --git a/src/main/java/com/epam/reportportal/annotations/attribute/Attributes.java b/src/main/java/com/epam/reportportal/annotations/attribute/Attributes.java
index 80fe6ae5..5e509e38 100644
--- a/src/main/java/com/epam/reportportal/annotations/attribute/Attributes.java
+++ b/src/main/java/com/epam/reportportal/annotations/attribute/Attributes.java
@@ -28,7 +28,7 @@
* @see MultiValueAttribute
*/
@Retention(RetentionPolicy.RUNTIME)
-@Target({ElementType.METHOD, ElementType.TYPE})
+@Target({ ElementType.METHOD, ElementType.TYPE })
@Inherited
public @interface Attributes {
diff --git a/src/main/java/com/epam/reportportal/service/ReportPortalClient.java b/src/main/java/com/epam/reportportal/service/ReportPortalClient.java
index 90d8aa91..69c8d3bf 100644
--- a/src/main/java/com/epam/reportportal/service/ReportPortalClient.java
+++ b/src/main/java/com/epam/reportportal/service/ReportPortalClient.java
@@ -19,6 +19,7 @@
import com.epam.ta.reportportal.ws.model.item.ItemCreatedRS;
import com.epam.ta.reportportal.ws.model.launch.*;
import com.epam.ta.reportportal.ws.model.log.SaveLogRQ;
+import com.epam.ta.reportportal.ws.model.project.config.ProjectSettingsResource;
import io.reactivex.Maybe;
import okhttp3.MultipartBody;
import retrofit2.http.*;
@@ -60,4 +61,7 @@ public interface ReportPortalClient {
@GET("v1/{projectName}/item/uuid/{itemUuid}")
Maybe{issue_id} and
+ * {bts_project} placeholders to mark a place where to put Issue ID and Bug Tracking System Project name. The result URL
+ * should point on the Issue.
+ */
+ BTS_ISSUE_URL("rp.bts.issue.url", false),
+ /**
+ * Fail tests marked with {@link Issue} annotation if they passed. Default value: true. Designed to not miss the moment
+ * when the issue got fixed but test is still marked by annotation.
+ */
+ BTS_ISSUE_FAIL("rp.bts.issue.fail", false);
//formatter:on
private final String propertyName;
diff --git a/src/main/resources/META-INF/aop-ajc.xml b/src/main/resources/META-INF/aop-ajc.xml
index 4f45411f..9bfa23eb 100644
--- a/src/main/resources/META-INF/aop-ajc.xml
+++ b/src/main/resources/META-INF/aop-ajc.xml
@@ -1,4 +1,21 @@
+
+