快速入门：创建 TypeScript Durable Functions 应用

• 已安装 Visual Studio Code 扩展 Azure Functions。

• 已安装 Visual Studio Code 扩展 Azure Functions 1.10.4 或更高版本。

• 已安装 Azure Functions Core Tools 最新版本。

• 已安装 Azure Functions Core Tools 4.0.5382 或更高版本。

• 已安装 Node.js 版本 16.x+。

• 已安装 Node.js 版本 18.x+。

3. 根据提示提供以下信息：

   Prompt	操作	说明
   选择函数应用项目的语言	选择 TypeScript。	使用 TypeScript 创建本地 Node.js Functions 项目。
   选择 JavaScript 编程模型	选择“模型 V3”。	设置 v3 编程模型。
   选择版本	选择“Azure Functions v4”。	只有在尚未安装 Core Tools 的情况下，才会出现此选项。 在本例中，当你首次运行应用时，即已安装 Core Tools。
   为项目的第一个函数选择模板	选择“暂时跳过”。
   选择打开项目的方式	选择“在当前窗口中打开”。	在所选的文件夹中打开 Visual Studio Code。

3. 根据提示提供以下信息：

   Prompt	操作	说明
   选择函数应用项目的语言	选择 TypeScript。	使用 TypeScript 创建本地 Node.js Functions 项目。
   选择 JavaScript 编程模型	选择“模型 V4”。	设置 v4 编程模型。
   选择版本	选择“Azure Functions v4”。	只有在尚未安装 Core Tools 的情况下，才会出现此选项。 在本例中，当你首次运行应用时，即已安装 Core Tools。
   为项目的第一个函数选择模板	选择“暂时跳过”。
   选择打开项目的方式	选择“在当前窗口中打开”。	在所选的文件夹中打开 Visual Studio Code。

若要使用 v4 编程模型，你需要安装 durable-functions 库的 v3.x 预览版。

2. 通过运行函数应用的根目录中的 npm install durable-functions 来安装 durable-functions npm 包。

2. 通过运行函数应用的根目录中的 npm install durable-functions@preview 来安装 durable-functions npm 包预览版。

业务流程协调程序函数

你将使用一个模板在项目中创建 Durable Functions 代码。

1. 在命令面板中，输入内容，然后选择“Azure Functions: 创建函数”。

2. 根据提示提供以下信息：

   Prompt	操作	说明
   选择函数的模板	选择“Durable Functions 业务流程协调程序”。	创建 Durable Functions 业务流程
   选择持久存储类型	选择“Azure 存储(默认)”。	设置用于 Durable Functions 应用的存储后端。
   提供函数名称	输入“HelloOrchestrator”。	函数的名称。

你已添加了一个业务流程协调程序来协调活动函数。 打开 HelloOrchestrator/index.ts 查看业务流程协调程序函数。 每次调用 context.df.callActivity 都会调用名为 Hello 的活动函数。

接下来，请添加引用的 Hello 活动函数。

活动函数

1. 在命令面板中，输入内容，然后选择“Azure Functions: 创建函数”。

2. 根据提示提供以下信息：

   Prompt	操作	说明
   选择函数的模板	选择“Durable Functions 活动”。	创建活动函数。
   提供函数名称	输入“Hello”。	你的活动函数的名称。

现已添加业务流程协调程序调用的 Hello 活动函数。 打开 Hello/index.ts，可以看到，该函数采用某个名称作为输入，并返回一句问候语。 活动函数是在工作流中执行“实际工作”（例如发出数据库调用或执行一些非确定性计算）的位置。

最后，添加一个启动业务流程的 HTTP 触发的函数。

客户端函数（HTTP 启动器）

1. 在命令面板中，输入并选择 Azure Functions: Create Function。

2. 根据提示提供以下信息：

   Prompt	操作	说明
   选择函数的模板	选择“Durable Functions HTTP 启动器”。	创建 HTTP 启动器函数。
   提供函数名称	选择“DurableFunctionsHttpStart”。	你的活动函数的名称。
   授权级别	选择“匿名”。	出于演示目的，该值允许在不使用身份验证的情况下调用函数。

现已添加一个启动业务流程的 HTTP 触发的函数。 打开 DurableFunctionsHttpStart/index.ts，可以看到，该函数使用 client.startNew 启动新的业务流程。 然后，它使用 client.createCheckStatusResponse 返回 HTTP 响应，其中包含可用于监视和管理新业务流程的 URL。

现已创建一个可在本地运行并部署到 Azure 的 Durable Functions 应用。

v4 编程模型的优点之一是可以灵活地写入函数。 在 v4 模型中，可以使用单个模板在项目中的一个文件中创建所有的三个函数。

1. 在命令面板中，输入内容，然后选择“Azure Functions: 创建函数”。

2. 根据提示提供以下信息：

   Prompt	操作	说明
   选择函数的模板	选择“Durable Functions 业务流程协调程序”。	创建一个包含 Durable Functions 应用业务流程、活动函数和持久客户端启动器函数的文件。
   选择持久存储类型	选择“Azure 存储(默认)”。	设置用于你的 Durable Functions 的存储后端。
   提供函数名称	输入“Hello”。	持久函数的名称。

打开 src/functions/hello.ts 查看创建的函数。

现已创建一个名为 helloOrchestrator 的业务流程协调程序来协调活动函数。 每次调用 context.df.callActivity 都会调用名为 hello 的活动函数。

此外已添加业务流程协调程序调用的 hello 活动函数。 在同个文件中可以看到，该函数采用某个名称作为输入，并返回一句问候语。 活动函数是在工作流中执行“实际工作”（例如发出数据库调用或执行一些非确定性计算）的位置。

最后，你添加了一个启动业务流程的 HTTP 触发的函数。 在同一文件中，可以看到该函数使用 client.startNew 启动新的业务流程。 然后，它使用 client.createCheckStatusResponse 返回 HTTP 响应，其中包含可用于监视和管理新业务流程的 URL。

现已创建一个可在本地运行并部署到 Azure 的 Durable Functions 应用。

1. 若要测试函数，请在 Hello 活动函数代码中（在 Hello/index.ts 中）设置断点。 按 F5 或者在命令面板中选择“调试: 开始调试”启动函数应用项目。 Core Tools 的输出会显示在终端面板中。

   注意

   有关调试的详细信息，请参阅 Durable Functions 诊断。

1. 若要测试函数，请在 hello 活动函数代码中（在 src/functions/hello.ts 中）设置断点。 按 F5 或者在命令面板中选择“调试: 开始调试”启动函数应用项目。 Core Tools 的输出会显示在终端面板中。

   注意

   有关调试的详细信息，请参阅 Durable Functions 诊断。

5. 使用浏览器或 HTTP 测试工具向 URL 终结点发送 HTTP POST 请求。

   将最后一个段替换为业务流程协调程序函数的名称 (HelloOrchestrator)。 URL 应类似于 http://localhost:7071/api/orchestrators/HelloOrchestrator。

   响应是 HTTP 函数的初始结果。 它让你知道持久业务流程已成功启动。 它尚未显示业务流程的最终结果。 响应中包括了几个有用的 URL。 现在，查询业务流程的状态。

5. 使用浏览器或 HTTP 测试工具向 URL 终结点发送 HTTP POST 请求。

   将最后一个段替换为业务流程协调程序函数的名称 (HelloOrchestrator)。 URL 应类似于 http://localhost:7071/api/orchestrators/HelloOrchestrator。

   响应是 HTTP 函数的初始结果。 它让你知道持久业务流程已成功启动。 它尚未显示业务流程的最终结果。 响应中包括了几个有用的 URL。 现在，查询业务流程的状态。

6. 复制 statusQueryGetUri 的 URL 值，将其粘贴到浏览器的地址栏中，然后执行请求。 还可以继续使用 HTTP 测试工具发出 GET 请求。

   请求将查询业务流程实例的状态。 应该会看到实例已完成，并且它包含持久函数的输出或结果。 它如以下示例所示：

   {
       "name": "HelloOrchestrator",
       "instanceId": "9a528a9e926f4b46b7d3deaa134b7e8a",
       "runtimeStatus": "Completed",
       "input": null,
       "customStatus": null,
       "output": [
           "Hello Tokyo!",
           "Hello Seattle!",
           "Hello London!"
       ],
       "createdTime": "2020-03-18T21:54:49Z",
       "lastUpdatedTime": "2020-03-18T21:54:54Z"
   }
   

6. 复制 statusQueryGetUri 的 URL 值，将其粘贴到浏览器的地址栏中，然后执行请求。 还可以继续使用 HTTP 测试工具发出 GET 请求。

   请求将查询业务流程实例的状态。 应该会看到实例已完成，并且它包含 Durable Functions 应用的输出或结果。 它如以下示例所示：

   {
       "name": "helloOrchestrator",
       "instanceId": "6ba3f77933b1461ea1a3828c013c9d56",
       "runtimeStatus": "Completed",
       "input": "",
       "customStatus": null,
       "output": [
           "Hello, Tokyo",
           "Hello, Seattle",
           "Hello, Cairo"
       ],
       "createdTime": "2023-02-13T23:02:21Z",
       "lastUpdatedTime": "2023-02-13T23:02:25Z"
   }
   

1. 从输出面板复制 HTTP 触发器的 URL。 调用 HTTP 触发的函数的 URL 应采用此格式：

   https://<functionappname>.azurewebsites.net/api/orchestrators/HelloOrchestrator

1. 从输出面板复制 HTTP 触发器的 URL。 调用 HTTP 触发的函数的 URL 应采用此格式：

   https://<functionappname>.azurewebsites.net/api/orchestrators/helloOrchestrator