Insert PR body.

Author: KostyaSha

docs/Configuration.adoc

@@ -1,9 +1,13 @@
+:imagesdir: images
 == GitHub integration plugin
 
-=== Pull Requests Trigger
-==== Triggering
+=== Triggers common configuration:
 - Configure https://wiki.jenkins-ci.org/display/JENKINS/GitHub+Plugin[github-plugin] according to it's documentation.
 - Set `GitHub project property` with link to your GitHub repository in Job settings.
+image::github-project-property.png[]
+
+=== Pull Requests Trigger
+==== Triggering
 - Configure https://wiki.jenkins-ci.org/display/JENKINS/Git+Plugin[git-plugin]: add any repo name i.e. 'origin-pull' and set refspec to
 `+refs/pull/${GITHUB_PR_NUMBER}/merge:refs/remotes/origin-pull/pull/${GITHUB_PR_NUMBER}/merge` if you want run
 build for merged state or '/head' for building exact PR commits, or `$GITHUB_PR_COND_REF` if you want 'head' state
@@ -29,6 +33,7 @@ like `Build #${BUILD_NUMBER} started`
 - `GITHUB_PR_TARGET_BRANCH` - `master`
 - `GITHUB_PR_SOURCE_BRANCH` - `KostyaSha-patch-9`
 - `GITHUB_PR_AUTHOR_EMAIL` - `KostyaSha@users.noreply.github.com`
+- `GITHUB_PR_BODY` -
 - `GITHUB_PR_SHORT_DESC` -
 - `GITHUB_PR_TITLE` - `Update README.md`
 - `GITHUB_PR_URL` - `https://github.com/KostyaSha/test-repo/pull/21`
@@ -44,8 +49,6 @@ like `Build #${BUILD_NUMBER} started`
 === Branch Trigger
 
 ==== Triggering
-- Configure https://wiki.jenkins-ci.org/display/JENKINS/GitHub+Plugin[github-plugin] according to it's documentation.
-- Set `GitHub project property` with link to your GH repository in Job settings.
 - Configure Git SCM with variables refspec: `refs/heads/${GITHUB_BRANCH_NAME}:refs/remotes/origin/${GITHUB_BRANCH_NAME}`
 url `${GITHUB_REPO_GIT_URL}`, branchspec `${GITHUB_BRANCH_NAME}`.
 

docs/images/github-project-property.png

@@ -30,6 +30,7 @@ public class GitHubPRCause extends GitHubCause<GitHubPRCause> {
     private String targetBranch;
     private String sourceBranch;
     private String prAuthorEmail;
+    private String body;
 
     private String sourceRepoOwner;
     private String triggerSenderName = "";
@@ -65,6 +66,7 @@ public GitHubPRCause(GitHubPRPullRequest pr,
                 pr.getUserEmail(), pr.getTitle(), pr.getHtmlUrl(), pr.getSourceRepoOwner(),
                 pr.getLabels(),
                 triggerSender, skip, reason, "", "", pr.getState());
+        this.body = pr.getBody();
     }
 
     //FIXME (sizes) ParameterNumber: More than 7 parameters (found 15).
@@ -229,6 +231,15 @@ public GitHubPRCause withCommentBodyMatch(String commentBodyMatch) {
         return this;
     }
 
+    public String getBody() {
+        return body;
+    }
+
+    public GitHubPRCause withBody(String body) {
+        this.body = body;
+        return this;
+    }
+
     @Override
     public String getShortDescription() {
         return "GitHub PR #<a href=\"" + getHtmlUrl() + "\">" + number + "</a>, " + getReason();

github-pullrequest-plugin/src/main/java/org/jenkinsci/plugins/github/pullrequest/GitHubPRCause.java

@@ -36,6 +36,7 @@ public class GitHubPRPullRequest {
     // https://github.com/kohsuke/github-api/issues/178
     private final Date issueUpdatedAt;
     private String title;
+    private String body;
     private Date prUpdatedAt;
     private String headSha;
     private String headRef;
@@ -105,6 +106,7 @@ public GitHubPRPullRequest(GHPullRequest pr) throws IOException {
 
         sourceRepoOwner = remoteRepo.getOwnerName();
         state = pr.getState().toString();
+        body = pr.getBody();
     }
 
     public int getNumber() {
@@ -135,6 +137,10 @@ public String getTitle() {
         return title;
     }
 
+    public String getBody() {
+        return body;
+    }
+
     @Nonnull
     public Set<String> getLabels() {
         return isNull(labels) ? Collections.<String>emptySet() : labels;

github-pullrequest-plugin/src/main/java/org/jenkinsci/plugins/github/pullrequest/GitHubPRPullRequest.java

@@ -18,6 +18,7 @@ public enum GitHubPREnv {
     TARGET_BRANCH,
     SOURCE_BRANCH,
     AUTHOR_EMAIL,
+    BODY,
     SHORT_DESC,
     TITLE,
     URL,

github-pullrequest-plugin/src/main/java/org/jenkinsci/plugins/github/pullrequest/data/GitHubPREnv.java

@@ -50,6 +50,7 @@
 import static org.jenkinsci.plugins.github.pullrequest.data.GitHubPREnv.COMMIT_AUTHOR_EMAIL;
 import static org.jenkinsci.plugins.github.pullrequest.data.GitHubPREnv.COMMIT_AUTHOR_NAME;
 import static org.jenkinsci.plugins.github.pullrequest.data.GitHubPREnv.COND_REF;
+import static org.jenkinsci.plugins.github.pullrequest.data.GitHubPREnv.BODY;
 import static org.jenkinsci.plugins.github.pullrequest.data.GitHubPREnv.HEAD_SHA;
 import static org.jenkinsci.plugins.github.pullrequest.data.GitHubPREnv.NUMBER;
 import static org.jenkinsci.plugins.github.pullrequest.data.GitHubPREnv.SHORT_DESC;
@@ -277,6 +278,7 @@ public QueueTaskFuture<?> startJob(GitHubPRCause cause, Cause additionalCause) {
                 TARGET_BRANCH.param(cause.getTargetBranch()),
                 SOURCE_BRANCH.param(cause.getSourceBranch()),
                 AUTHOR_EMAIL.param(cause.getPRAuthorEmail()),
+                BODY.param(cause.getBody()),
                 SHORT_DESC.param(cause.getShortDescription()),
                 TITLE.param(cause.getTitle()),
                 URL.param(cause.getHtmlUrl().toString()),