建立出RoomReservation的POCO

首先第一步是建立出POCO，因此在Model資料夾下面建立：RoomReservation

public class RoomReservation
{
	public DateTime StartDate { get; set; }
	public int NumberOfNightToStay { get; set; }
	public int NumberOfPepole { get; set; }
	public string BedSize { get; set; }

	public override string ToString()
	{
		return $"入住日期：{StartDate}{Environment.NewLine}" +
		$"入住幾晚：{NumberOfNightToStay}{Environment.NewLine}" +
		$"幾人：{NumberOfPepole}{Environment.NewLine}" +
		$"床型：{BedSize}{Environment.NewLine}";
	}
}

整合剛建立的POCO到CounterState

要把RoomReservation加入到Accessor，這邊偷懶用CounterState，因此在增加一個property進去：

public class CounterState
{
	...
	public RoomReservation RoomReservation { get; set; } = new RoomReservation();
}

再來建立出一個新的DialogSet

再來切換到EchoWithCounterBot.cs，首先是準備好DialogSet：

public class EchoWithCounterBot : IBot
{
	...
	private readonly DialogSet _dialogsWaterfall;

	public EchoWithCounterBot
		(EchoBotAccessors accessors, ILoggerFactory loggerFactory)
	{
		_dialogsWaterfall = new DialogSet(_accessors.DialogState);

		var waterfallSteps = new WaterfallStep[]
		{
			GetStartStayDateAsync,
			GetStayDayAsync,
			GetNumberOfOccupantAsync,
			GetBedSizeAsync,
			GetConfirmAsync,
			GetSummaryAsync,
		};

		_dialogsWaterfall.Add(new WaterfallDialog("formFlow", waterfallSteps));
		_dialogsWaterfall.Add(new DateTimePrompt("dateTime"));
		_dialogsWaterfall.Add(new NumberPrompt<int>("number"));
		_dialogsWaterfall.Add(new ChoicePrompt("choice"));
		_dialogsWaterfall.Add(new ConfirmPrompt("confirm"));
	}
	....
}

這邊定義了一個DialogSet，裡面第一個是一個Waterfalldialog，其中定義了好多個steps。

再來增加了一些prompt，在這些steps可以呼叫使用。

准備好了之後，接下來是定義每一個steps。

定義每一個step要做的事情

每一個steps都可以取得上一個steps結束的時候使用者輸入的内容。

因此，每一個steps，可以依照上一個steps的結果做出處理，然後觸發往下要執行的prompt或者waterfall結束。

接下來看看每一個step的定義：

private async Task<DialogTurnResult> GetStartStayDateAsync
	(WaterfallStepContext stepContext, CancellationToken cancellationToken)
{
	return await stepContext.PromptAsync("dateTime",
		new PromptOptions()
		{
			Prompt = MessageFactory.Text("請輸入入住日期"),
		},
		cancellationToken);
}

private async Task<DialogTurnResult> GetStayDayAsync
	(WaterfallStepContext stepContext, CancellationToken cancellationToken)
{
	(await GetCounterState(stepContext.Context))
		.RoomReservation.StartDate =
		DateTime.Parse(((List<DateTimeResolution>)stepContext.Result).First().Value);

	return await stepContext.PromptAsync("number", new PromptOptions()
	{
		 Prompt = MessageFactory.Text("請輸入要住幾天"),
	}, 
	cancellationToken);
}

private async Task<DialogTurnResult> GetNumberOfOccupantAsync
	(WaterfallStepContext stepContext, CancellationToken cancellationToken)
{
	(await GetCounterState(stepContext.Context))
		.RoomReservation.NumberOfNightToStay = (int)stepContext.Result - 1;

	return await stepContext.PromptAsync("number",
		new PromptOptions()
		{
			Prompt = MessageFactory.Text("幾人入住"),
		},
		cancellationToken);
}

private async Task<DialogTurnResult> GetBedSizeAsync
	(WaterfallStepContext stepContext, CancellationToken cancellationToken)
{
	(await GetCounterState(stepContext.Context))
		.RoomReservation.NumberOfPepole = (int)stepContext.Result;

	var choices = new List<Choice>()
	{
		new Choice("單人床"),
		new Choice("雙人床"),
	};

	return await stepContext.PromptAsync("choice",
		new PromptOptions()
		{
			Prompt = MessageFactory.Text("請選擇床型"),
			Choices = choices,
		},
		cancellationToken);
}
	
private async Task<DialogTurnResult> GetConfirmAsync
	(WaterfallStepContext stepContext, CancellationToken cancellationToken)
{
	var roomReservation = (await GetCounterState(stepContext.Context))
		.RoomReservation;

	roomReservation.BedSize = ((FoundChoice)stepContext.Result).Value;

	return await stepContext.PromptAsync("confirm", new PromptOptions()
	{
		Prompt = MessageFactory.Text($"請確認您的訂房條件：{Environment.NewLine}" +
		$"{roomReservation}")
	});
}

private async Task<DialogTurnResult> GetSummaryAsync
	(WaterfallStepContext stepContext, CancellationToken cancellationToken)
{
	if ((bool)stepContext.Result)
	{
		await stepContext.Context.SendActivityAsync
			($"訂單下定完成，訂單號：{DateTime.Now.Ticks}");
	}
	else
	{
		await stepContext.Context.SendActivityAsync("已經取消訂單");
	}

	return await stepContext.EndDialogAsync(cancellationToken: cancellationToken);
}

到這裡Dialog就准備好了。

修改bot邏輯呼叫DialogSet

在OnTurnAsync會加入以下方式來啓動waterflow dialog：

...
var dialogWaterfallContext = await _dialogsWaterfall.CreateContextAsync(turnContext, cancellationToken);
var waterfallResult = await dialogWaterfallContext.ContinueDialogAsync(cancellationToken);

if(turnContext.Activity.Text == "訂房")
{
	await dialogWaterfallContext.BeginDialogAsync("formFlow",
		null, cancellationToken);
}
else if(waterfallResult.Status != DialogTurnStatus.Empty)
{

}
...

測試

最後測試下來就會變成：