名字及其读音
日本表单先要求填写姓:先姓后名,或者用一个氏名字段写成山田 直樹。大多数表单还会要求以注音假名填写名字的读音,因为同一个汉字可能有不止一种读法:
- フリガナ 或 カナ 要求片假名:ヤマダ ナオキ。
- ふりがな 或 ひらがな 要求平假名:やまだ なおき。
- セイ 和 メイ 分别是姓和名的读音,填在两个框里。
- 半角カナ 要求半角片假名:ヤマダ ナオキ。
在应用的 New address 中,或为智能体和测试使用 country: "JP",创建国家为日本的测试账号。它的人设会从日本名字列表中取名,每个读音字段都会按要求的假名和宽度填入该名字的读音。应用会在名字旁边显示读音,方便复制。
检查应用是否:
- 在所有显示名字的地方(包括邮件)都把姓放在前面
- 在列出人员的地方按读音而不是汉字排序和搜索
- 接受较长的读音,比如ササキ ショウタ,也接受较短的读音,比如アヤ
全角和半角
日文文本有两种宽度。全角字母和数字,比如220,是日语键盘默认输入的字符。半角字符就是常见的 220。字段通常会说明需要哪种:全角、半角数字或半角英数字。
Proxy Mail QA 会按字段的要求填写名字、读音以及推测出的信息,比如邮编和建筑名:郵便番号(全角)字段会填入220-0011。在你自己的测试中,也要试试字段不要求的那种宽度:
- 在邮编或电话字段中输入全角数字。 很多表单会在字段失去焦点时转换它们。检查应用是否保存半角形式,或者说明它需要什么格式。
- 姓和名之间使用全角空格。 检查山田 直樹是否和山田 直樹保存得一样,否则应用会把他们当作两个不同的人。
- フリガナ字段中的半角片假名。 要么接受并转换,要么提示该字段需要全角片假名。
特殊姓名 列表提供全角字母、半角片假名,以及姓名之间的全角空格,可直接粘贴使用。
根据邮编填写地址
大多数日本表单会在输入 郵便番号 时自动填写 都道府県 和 市区町村,常用 yubinbango 或 ajaxzip3 等库。测试账号的地址与邮编一致:220-0011 对应 神奈川県 横浜市西区 高島,数据来自 Japan Post,番地和建筑名是编造的,所以不会寄到真实的门牌。
对于智能体和测试,请在地址的其他部分之前先输入邮编,然后填写 番地 和 建物名。form_values 会在日本邮编字段旁提示这一点。
也要测试查询无法运行的情况:库不认识的邮编、网络很慢,以及先填地址后填邮编的用户。
LINE 登录
LINE 在日本使用广泛,很多应用提供 LINEでログイン。LINE Login 使用 OpenID Connect:请求 openid profile email 可获得包含用户 LINE 资料的 ID token(LINE Login 文档)。
发布前测试。 新的 LINE Login channel 初始为 Developing 状态,此时只有拥有该 channel Admin 或 Tester 角色的人才能用它登录(角色)。在 channel 的 Roles 标签页通过邮件邀请测试人员。每个人都要用 LINE 账号登录 LINE Developers Console,所以测试时请使用团队自己控制的 LINE 账号,不要用客户的。每个环境的回调 URL 都必须在 channel 的 LINE Login 标签页注册,应用发送的 redirect_uri 必须与其中之一匹配。如果控制台不接受你的本地地址,请使用 HTTPS 隧道。
邮箱地址。 LINE 只向已申请邮箱权限的 channel 提供邮箱地址(Basic settings、OpenID Connect、Apply,并附上向用户说明为何收集邮箱的页面截图),且请求中必须包含 email scope。而且并非每个 LINE 账号都登记了邮箱地址。因此,LINE 登录后需要邮箱的应用应主动询问并验证。这一步可以用 Proxy Mail QA 测试:
- 用测试 LINE 账号登录。
- 应用要求填写邮箱地址时,填入 Proxy Mail QA 地址。
- 在页面中用 Chrome 填写邮件里的验证码或打开链接,智能体则用
wait_for_code。 - 检查账号现在有了这个地址,并且再次用 LINE 登录时找到的是同一个账号,而不是新建第二个。
另外测试:
- 在 LINE 授权页点取消。 应用应回到登录页并显示清楚的提示,而不是错误页。
- 添加好友选项。 使用
bot_prompt时,LINE 会在授权页(normal)或其后的页面(aggressive)提示添加你的 LINE Official Account 为好友(添加好友选项)。分别在添加和不添加的情况下各登录一次:两种情况下应用都应正常工作。 - 登录后的资料。 LINE 显示名是昵称,不是法定姓名。如果应用需要 姓、名 及其 フリガナ,应在 LINE 登录后询问,测试账号的日本人设会填写这些内容。
日语邮件
日语验证邮件和重置邮件的读取方式和其他邮件一样:认证コード 或 確認コード 后的验证码、链接,以及有效期(10分以内)。检查主题和发件人名称在日本邮件应用中显示正常,并且邮件不只是一张图片。