Skip to content

Commit caaeec4

Browse files
authored
Update Templates with new information (#3364) (#3378)
* Update Templates with new information (#3364) * Update Templates with new information Changes to procedures and UI Controller "Templates" doc implies "copy" icon is peer to launch and edit https://issues.redhat.com/browse/AAP-44632 * Update templates with new information Corrections Controller "Templates" doc implies "copy" icon is peer to launch and edit https://issues.redhat.com/browse/AAP-44632 * Update Templates with new information Corrections Controller "Templates" doc implies "copy" icon is peer to launch and edit https://issues.redhat.com/browse/AAP-44632 * Update Templates with new information Correction Controller "Templates" doc implies "copy" icon is peer to launch and edit https://issues.redhat.com/browse/AAP-44632
1 parent 2c1f0bd commit caaeec4

10 files changed

+44
-46
lines changed

downstream/assemblies/platform/assembly-ug-controller-job-templates.adoc

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -10,9 +10,9 @@ A job template is a definition and set of parameters for running an Ansible job.
1010
Job templates are useful to run the same job many times.
1111
They also encourage the reuse of Ansible Playbook content and collaboration between teams.
1212

13-
The *Templates* page shows both job templates and workflow job templates that are currently available.
14-
The default view is collapsed (Compact), showing the template name, template type, and the timestamp of the last job that ran using that template.
15-
You can click the arrow image:arrow.png[Arrow,15,15] icon next to each entry to expand and view more information.
13+
The *Automation Templates* page shows both job templates and workflow job templates that are currently available.
14+
The default view is to show each template as a card, showing the template name and template type.
15+
Select the template name to display more information about the tenmplate, including when it last ran.
1616
This list is sorted alphabetically by name, but you can sort by other criteria, or search by various fields and attributes of a template.
1717

1818
[NOTE]
@@ -22,7 +22,7 @@ Search functionality for Job templates is limited to alphanumeric characters onl
2222

2323
//image::ug-job-templates-home.png[Job templates home]
2424

25-
From this screen you can launch image:rightrocket.png[Rightrocket,15,15], edit image:leftpencil.png[Leftpencil,15,15], duplicate image:copy.png[Copy,15,15] and delete image:delete-button.png[Delete,15.15] a job template.
25+
From the template card you can launch image:rightrocket.png[Rightrocket,15,15], edit image:leftpencil.png[Leftpencil,15,15] a template, or, using the {MoreActionsIcon} icon, you can duplicate image:copy.png[Duplicate,15,15] or delete image:delete-button.png[Delete,15,15] a template.
2626

2727
Workflow templates have the workflow visualizer image:visualizer.png[Workflow visualizer,15,15] icon as a shortcut for accessing the workflow editor.
2828

downstream/assemblies/platform/assembly-ug-controller-workflow-job-templates.adoc

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -14,11 +14,12 @@ These resources include the following:
1414
* Project syncs
1515
* Inventory source syncs
1616

17-
The *Templates* page shows the workflow and job templates that are currently available.
18-
The default view is collapsed (Compact), showing the template name, template type, and the statuses of the jobs that have run by using that template.
19-
You can click the arrow next to each entry to expand and view more information.
17+
The *Automation Templates* page shows the workflow and job templates that are currently available.
18+
The default view is to show each template as a card, showing the template name and template type.
19+
Select the template name to display more information about the template, including when it last ran.
2020
This list is sorted alphabetically by name, but you can sort by other criteria, or search by various fields and attributes of a template.
21-
From this screen you can launch image:rightrocket.png[Launch,15,15], edit image:leftpencil.png[Edit,15,15], and duplicate image:copy.png[Copy,15,15] a workflow job template.
21+
22+
From the template card you can launch image:rightrocket.png[Rightrocket,15,15], edit image:leftpencil.png[Leftpencil,15,15] a template, or, using the {MoreActionsIcon} icon, you can duplicate image:copy.png[Duplicate,15,15] or delete image:delete-button.png[Delete,15,15]a template.
2223

2324
Only workflow templates have the workflow visualizer image:visualizer.png[Workflow visualizer,15,15] icon as a shortcut for accessing the workflow editor.
2425

2.31 KB
Loading

downstream/modules/platform/con-controller-view-completed-jobs.adoc

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,9 +5,10 @@
55
The *Jobs* tab provides the list of job templates that have run.
66
Click the expand icon next to each job to view the following details:
77

8-
* Status
9-
* ID and name
8+
* ID and name
9+
* Status
1010
* Type of job
11+
* Duration of run
1112
* Time started and completed
1213
* Who started the job and which template, inventory, project, and credential were used.
1314

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,16 @@
11
[id="controller-copy-a-job-template"]
22

3-
= Copying a job template
3+
= Duplicating a job template
44

5-
If you copy a job template, it does not copy any associated schedule, notifications, or permissions.
6-
Schedules and notifications must be recreated by the user or administrator creating the copy of the job template.
7-
The user copying the Job Template is granted administrator permission, but no permissions are assigned (copied) to the job template.
5+
If you duplicate a job template, it does not duplicate any associated schedule, notifications, or permissions.
6+
Schedules and notifications must be recreated by the user or administrator creating the duplicate of the job template.
7+
The user duplicating the Job Template is granted administrator permission, but no permissions are assigned (duplicated) to the job template.
88

99
.Procedure
1010

1111
. From the navigation panel, select {MenuAETemplates}.
12-
. Click image:options_menu.png[options menu,15,15] and the copy image:copy.png[Copy,15,15] icon associated with the template that you want to copy.
13-
* The new template with the name of the template from which you copied and a timestamp displays in the list of templates.
12+
. Click the {MoreActionIcon} icon associated with the template that you want to duplicate and select the image:copy.png[Duplicate Template,15,15] Duplicate Template icon.
13+
* The new template with the name of the template from which you duplicated and a timestamp displays in the list of templates.
1414
. Click to open the new template and click btn:[Edit template].
1515
. Replace the contents of the *Name* field with a new name, and give or change the entries in the other fields to complete this page.
1616
. Click btn:[Save job template].
Lines changed: 14 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -1,30 +1,25 @@
11
[id="controller-copy-workflow-job-template"]
22

3-
= Copying a workflow job template
3+
= Duplicating a workflow job template
44

5-
With {ControllerName} you can copy a workflow job template.
6-
When you copy a workflow job template, it does not copy any associated schedule, notifications, or permissions.
7-
Schedules and notifications must be recreated by the user or system administrator creating the copy of the workflow template.
8-
The user copying the workflow template is granted the administrator permission, but no permissions are assigned (copied) to the workflow template.
5+
With {ControllerName} you can duplicate a workflow job template.
6+
When you duplicate a workflow job template, it does not duplicate any associated schedule, notifications, or permissions.
7+
Schedules and notifications must be recreated by the user or system administrator creating the duplicate of the workflow template.
8+
The user duplicating the workflow template is granted the administrator permission, but no permissions are assigned (duplicated) to the workflow template.
99

1010
.Procedure
1111

12-
. Open the workflow job template that you want to copy by using one of these methods:
13-
** From the navigation panel, select {MenuAETemplates}.
14-
** In the workflow job template *Details* view, click image:options_menu.png[15,15] next to the desired template.
15-
*** Click the copy (image:copy.png[Copy icon,15,15]) icon.
16-
+
17-
The new template with the name of the template from which you copied and a timestamp displays in the list of templates.
18-
+
19-
//image::ug-wf-list-view-copy-example.png[Workflow template copy list view]
20-
+
21-
. Select the copied template and click btn:[Edit template].
22-
. Replace the contents of the *Name* field with a new name, and give or change the entries in the other fields to complete this template.
12+
. From the navigation panel, select {MenuAETemplates}.
13+
. Click the {MoreActionIcon) icon associated with the template that you want to duplicate and select the image:copy.png[Duplicate Template,15,15] Duplicate Template icon.
14+
* The new template with the name of the template from which you duplicated and a timestamp displays in the list of templates.
15+
. Click to open the new template and click btn:[Edit template].
16+
. Replace the contents of the *Name* field with a new name, and give or change the entries in the other fields to complete this page.
2317
. Click btn:[Save job template].
2418

19+
2520
[NOTE]
2621
====
27-
If a resource has a related resource that you do not have the right level of permission to, you cannot copy the resource. For example, in the case where a project uses a credential that a current user only has Read access.
28-
However, for a workflow job template, if any of its nodes use an unauthorized job template, inventory, or credential, the workflow template can still be copied.
29-
But in the copied workflow job template, the corresponding fields in the workflow template node are absent.
22+
If a resource has a related resource that you do not have the right level of permission to, you cannot duplicate the resource. For example, in the case where a project uses a credential that a current user only has Read access.
23+
However, for a workflow job template, if any of its nodes use an unauthorized job template, inventory, or credential, the workflow template can still be duplicated.
24+
But in the duplicated workflow job template, the corresponding fields in the workflow template node are absent.
3025
====

downstream/modules/platform/proc-controller-create-job-template.adoc

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55
.Procedure
66

77
. From the navigation panel, select {MenuAETemplates}.
8-
. On the *Templates* page, select *Create job template* from the *Create template* list.
8+
. On the *Automation Templates* page, select *Create job template* from the *Create template* list.
99
. Enter the appropriate details in the following fields:
1010
+
1111
[NOTE]
@@ -41,14 +41,15 @@ Specify the overriding branch to use in your job run.
4141
If left blank, the specified SCM branch (or commit hash or tag) from the project is used.
4242

4343
For more information, see xref:controller-job-branch-overriding[Job branch overriding]. | Yes
44-
| Execution Environment | Select the container image to be used to run this job.
45-
You must select a project before you can select an {ExecEnvShort}. | Yes.
46-
47-
Execution environment prompts show up as its own step in a later prompt window.
4844
| Playbook | Choose the playbook to be launched with this job template from the available playbooks.
4945
This field automatically populates with the names of the playbooks found in the project base path for the selected project.
5046
Alternatively, you can enter the name of the playbook if it is not listed, such as the name of a file (such as foo.yml) you want to use to run with that playbook.
5147
If you enter a filename that is not valid, the template displays an error, or causes the job to fail. | N/A
48+
| Execution Environment | Select the container image to be used to run this job.
49+
You must select a project before you can select an {ExecEnvShort}. | Yes.
50+
51+
Execution environment prompts show up as its own step in a later prompt window.
52+
5253
| Credentials | Select the image:examine.png[examine,15,15] icon to open a separate window.
5354

5455
Choose the credential from the available options to use with this job template.

downstream/modules/platform/proc-controller-create-workflow-template.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ This can lead to playbook failures if the limit is mandatory for the playbook th
1313
.Procedure
1414

1515
. From the navigation panel, select {MenuAETemplates}.
16-
. On the *Templates* list view, select *Create workflow job template* from the *Create template* list.
16+
. On the *Automation Templates* page, select *Create workflow job template* from the *Create template* list.
1717
+
1818
//image::ug-create-new-wf-template.png[Create workflow template]
1919
+

downstream/modules/platform/proc-controller-delete-job-template.adoc

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -6,9 +6,9 @@ Before deleting a job template, ensure that it is not used in a workflow job tem
66

77
.Procedure
88

9-
. Delete a job template by using one of these methods:
10-
* Select the checkbox next to one or more job templates. Click image:options_menu.png[options menu,15,15] and select btn:[Delete template].
11-
* Select the required job template, on the *Details* page click image:options_menu.png[options menu,15,15] and select btn:[Delete template].
9+
. Delete a job template using the following method:
10+
* Click the {MoreActionsIcon} icon and select the Delete Templateimage:delete-icon.png[Delete Template,15,15] icon.
11+
* Select the required job template, on the *Details* page click the {MoreActionsIcon} icon and select image:delete-button.png[Delete template,15,15] btn:[Delete template].
1212

1313
[NOTE]
1414
====

downstream/modules/platform/proc-controller-launch-job-template.adoc

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ Easier deployments drive consistency, by running your playbooks the same way eac
1111
.Procedure
1212

1313
* Launch a job template by using one of these methods:
14-
** From the navigation panel, select {MenuAETemplates} and click *Launch template* image:rightrocket.png[Rightrocket,15,15] next to the job template.
14+
** From the navigation panel, select {MenuAETemplates} and click *Launch template* image:rightrocket.png[Rightrocket,15,15] on the job template card.
1515
+
1616
//image::ug-job-template-launch.png[Job template launch]
1717
+
@@ -51,5 +51,5 @@ This endpoint accepts JSON and you can specify a list of unified job templates (
5151
The user must have the appropriate permission to launch all the jobs.
5252
If all jobs are not launched an error is returned indicating why the operation was not able to complete.
5353
Use the `OPTIONS` request to return relevant schema.
54-
For more information, see the link:https://docs.ansible.com/automation-controller/latest/html/controllerapi/api_ref.html#/Bulk[Bulk endpoint] of the Reference section of the Automation Controller API Guide.
54+
For more information, see the link:{LinkControllerAPIOverview}/api_ref.html#/Bulk[Bulk endpoint] of the Reference section of the {TitleControllerAPIOverview}.
5555
====

0 commit comments

Comments
 (0)