在项目板上移动分配的议题

简介

本教程演示如何使用 Alex-page/github-project-automation-plus 操作在议题被分配时将议题自动移到项目板上的特定列。 例如，在分配议题时，您可以将其移入项目板的 In Progress 列。

在教程中，您将先创建一个使用 alex-page/github-project-automation-plus 操作的工作流程文件。 然后，您将自定义工作流以适应您的需要。

创建工作流程

1. 选择要应用此项目管理工作流程的仓库。 您可以使用您有写入权限的现有仓库，或者创建一个新的仓库。 关于创建仓库的更多信息，请参阅“创建新仓库”。

2. 在仓库中，选择项目板。 您可以使用现有项目，也可以创建新项目。 有关创建项目的更多信息，请参阅“创建项目板”。

3. 在您的仓库中，创建一个名为 .github/workflows/YOUR_WORKFLOW.yml的文件，将 YOUR_WORKFLOW 替换为您选择的名称。 这是一个工作流程文件。 有关在 GitHub 上创建新文件的更多信息，请参阅“创建新文件”。

4. 将以下 YAML 内容复制到工作流程文件中。

   YAML

   # 此工作流使用未经 GitHub 认证的操作。
   # 它们由第三方提供，并受
   # 单独的服务条款、隐私政策和支持
   # 文档管理。
   
   name: Move assigned card
   on:
     issues:
       types:
         - assigned
   jobs:
     move-assigned-card:
       runs-on: ubuntu-latest
       steps:
         - uses: alex-page/github-project-automation-plus@5bcba1c1c091a222584d10913e5c060d32c44044
           with:
             project: Docs Work
             column: In Progress
             repo-token: ${{ secrets.PERSONAL_ACCESS_TOKEN }}

5. 自定义工工作流程文件中的参数：

   • 将 project 的值更改为您的项目板的名称。 如果您有多个具有相同名称的项目板， Alex-page/github-project-automation-placement-plus 将对所有具有指定名称的项目采取行动。
   • 将 column 的值更改为您想要在议题分配时将议题移入其中的列名称。
   • 更改 repo-token 的值：
     1. 使用 repo 范围创建个人访问令牌。 更多信息请参阅“创建个人访问令牌”。
     2. 将此个人访问令牌作为机密存储在仓库中。 有关存储机密的更多信息，请参阅“加密密码”。
     3. 在您的工作流程文件中，将 PERSONAL_ACCESS_TOKEN 替换为您的机密名称。

6. 将工作流程文件提交到仓库的默认分支。 更多信息请参阅“创建新文件”。

测试工作流程

每当分配仓库中的议题时，议题将移到指定的项目板列。 如果议题尚未在项目板上，则将添加到项目板中。

如果您的仓库是用户所有，则 Alex-page/github-project-automation-plus 操作将对仓库或用户帐户中具有指定项目名称和列的所有项目执行。 同样，如果您的仓库归组织所有，则该操作将对仓库或组织中具有指定项目名称和列的所有项目执行。

通过在仓库中分配议题来测试工作流程。

1. 在仓库中打开一个议题。 更多信息请参阅“创建议题”。
2. 分配议题。 更多信息请参阅“分配议题和拉取请求到其他 GitHub 用户”。
3. 要查看分配议题所触发的工作流程运行，请查看工作流程运行的历史记录。 更多信息请参阅“查看工作流程运行历史记录”。
4. 工作流程完成后，分配的议题应会添加到指定的项目板列中。

后续步骤

• 要详细了解您可以使用 alex-page/github-project-automation-plus 操作执行的其他事项，如删除或存档项目卡，请访问 alex-page/github-project-automation-plus 操作文档。