Giải pháp thăm quan


HỖ TRỢ
Đăng ký
Đăng nhập
Bắt đầu dùng thử miễn phí

Làm thế nào để viết các yêu cầu tuyệt vời

Làm thế nào để viết các yêu cầu tuyệt vời

Mục lục

Một trong những phần quan trọng nhất của bất kỳ dự án phát triển phần mềm nào là tạo ra các yêu cầu chi tiết, chính xác. Nếu không hiểu rõ những gì cần phải xây dựng, thì không thể tạo ra một sản phẩm cuối cùng chất lượng cao. Thật không may, viết ra những yêu cầu tốt thường nói dễ hơn làm. Lý do chính mà mọi người viết yêu cầu kém là họ không được đào tạo hoặc không có kinh nghiệm để viết yêu cầu tốt. Nếu bạn hoặc nhân viên của bạn gặp vấn đề với việc viết các yêu cầu tốt, bạn có thể được hưởng lợi từ hướng dẫn về cách viết các yêu cầu tốt. Bằng cách dành thời gian để tìm hiểu cách viết các yêu cầu tốt hơn, bạn có thể cải thiện chất lượng tổng thể của các dự án phát triển phần mềm của mình - và giúp bản thân đỡ phải đau đầu.

Đặc điểm kỹ thuật yêu cầu là gì?

Đặc tả yêu cầu là một quá trình trong đó các yêu cầu được xác định, lập thành văn bản và phân tích. Đó là một phần quan trọng của phát triển phần mềm vì nó đảm bảo rằng tất cả các bên liên quan đồng ý về chức năng của phần mềm trước khi bắt đầu phát triển. Bằng cách làm này, giảm khả năng hiểu nhầm và phải làm lại sau này.

Đặc tả yêu cầu, còn được gọi là tài liệu, là một quá trình ghi lại hoặc viết tất cả các yêu cầu của hệ thống và người dùng dưới dạng một tài liệu. Các yêu cầu này phải rõ ràng, đầy đủ, toàn diện và nhất quán.

Tại sao việc viết các yêu cầu tốt lại quan trọng?

Có rất nhiều lợi ích của việc có các thông số kỹ thuật yêu cầu tốt. Một số trong số họ được liệt kê dưới đây:

  • Giúp đảm bảo rằng tất cả các bên liên quan đều có hiểu biết chung về hệ thống sẽ được phát triển. Điều này tránh mọi hiểu lầm trong các giai đoạn phát triển sau này.
  • Đóng vai trò là điểm tham khảo cho tất cả các bên liên quan trong quá trình phát triển.
  • Giúp xác định bất kỳ khoảng trống nào trong các yêu cầu ở giai đoạn đầu.
  • Giảm chi phí tổng thể và thời gian phát triển vì nó tránh phải làm lại do những thay đổi trong yêu cầu.

Chúng ta đạt được những gì bằng cách viết ra những yêu cầu tuyệt vời?

Có rất nhiều điều yêu cầu tuyệt vời giúp đạt được. Một số trong số họ được liệt kê dưới đây:

  • Các yêu cầu lớn giúp đảm bảo rằng hệ thống đang được phát triển đáp ứng nhu cầu của người dùng.
  • Chúng là cơ sở để kiểm tra hệ thống để đảm bảo rằng nó hoạt động như mong đợi.
  • Chúng giúp giảm chi phí và thời gian phát triển tổng thể bằng cách tránh làm lại do những thay đổi trong yêu cầu.
  • Các yêu cầu lớn giúp cho quá trình phát triển trở nên hiệu quả và hiệu quả hơn.

Những thách thức khi viết yêu cầu

Có những thách thức khác nhau mà mọi người phải đối mặt khi viết các yêu cầu.

Thủ tục giấy tờ kém - Trong một số tổ chức, tài liệu về các quá trình không tồn tại hoặc không đạt tiêu chuẩn. Trong trường hợp này, việc thu thập các yêu cầu trở thành một quy trình gồm hai bước: đầu tiên thiết kế ngược lại quy trình hiện có, sau đó xác định các khu vực cần cải tiến và tối ưu hóa. Để xác nhận rằng các yêu cầu được bổ sung và chính xác, điều quan trọng là xác định các bên liên quan chính và các chuyên gia về chủ đề, tham gia trực tiếp với họ. Vẽ bản đồ quy trình kinh doanh và hình dung quy trình làm việc là hai cách tuyệt vời để làm điều đó. Điều này giúp loại bỏ các giả định không chính xác đồng thời cung cấp một bức tranh hoàn chỉnh. Vẽ bản đồ quy trình và hiển thị quy trình là hai cách tiếp cận hữu ích cho mục đích này.

Yêu cầu mâu thuẫn - Khi các bên liên quan có những ưu tiên khác nhau cho các mục tiêu kinh doanh của họ, điều này dẫn đến các yêu cầu mâu thuẫn với nhau. Trong những trường hợp như vậy, trách nhiệm của một nhà phân tích kinh doanh là ghi lại tất cả các yêu cầu một cách chi tiết, xác định những yêu cầu nào chống lại nhau và cho phép các bên liên quan có cơ hội quyết định điều gì cần ưu tiên.

Bạn không thể đưa ra quyết định mà không cần lắng nghe ý kiến ​​đóng góp của các bên liên quan và với tư cách là một nhà phân tích kinh doanh, bạn có thể có một số ý tưởng về những gì nên được ưu tiên. Điều quan trọng vẫn là lắng nghe quan điểm của các bên liên quan. Thiết lập một cuộc thăm dò có thể là một trong những phương pháp để có được sự rõ ràng về những gì quan trọng nhất đối với đa số các bên liên quan.

Không có sẵn thông tin đầu vào của người dùng - Một số lý do có thể góp phần làm cho người dùng cuối không có sẵn và mỗi lý do yêu cầu cách giải quyết riêng. Ví dụ: đôi khi người dùng cuối quá bận tâm với công việc hàng ngày của họ đến mức họ không muốn tham gia vào các hoạt động thu thập yêu cầu.

Trong những trường hợp như vậy, điều tốt nhất mà một nhà phân tích kinh doanh có thể làm là hạn chế số lượng và độ dài của các cam kết. Trước cuộc họp, nghiên cứu càng nhiều càng tốt sẽ giúp cuộc thảo luận có tổ chức và nhiều thông tin hơn. Nó gần giống như biến việc thu thập các yêu cầu thành các phiên xác thực yêu cầu. xác định nhóm trọng tâm và xác định người dùng cuối phù hợp nhất cho mỗi nhóm

Tập trung vào giao diện thay vì trải nghiệm - Nhiều bên liên quan và người dùng cuối có tầm nhìn rõ ràng về cách giải pháp mới sẽ xuất hiện, nhưng họ không biết nó sẽ đạt được những gì. Giao diện người dùng của bất kỳ hệ thống nào là rất quan trọng, nhưng nó không nên xác định hoặc can thiệp vào chức năng.

Các nhà phân tích kinh doanh nên luôn nhớ giữ riêng các yêu cầu về thiết kế và chức năng trong tài liệu của họ. Bằng cách sử dụng các công cụ tổng quát hơn như sơ đồ, câu chuyện người dùng hoặc các nguyên mẫu có độ phân giải thấp hơn là bản nháp thiết kế, họ có thể duy trì sự tập trung vào các khía cạnh chức năng của việc thu thập yêu cầu.

Đầu vào của các bên liên quan - Khi các bên liên quan hoặc người dùng cuối cố gắng nói cho các nhà thiết kế biết hệ thống nên hoạt động như thế nào thay vì hệ thống phải làm gì, điều đó có thể dẫn đến các thiết kế không tối ưu. Để bắt đầu điều này, hãy xác thực từng 'yêu cầu sai' bằng cách hỏi 'tại sao?' cho đến khi bạn đi đến vấn đề thực sự cần giải quyết.

Vấn đề truyền thông - Trong số các vấn đề có thể dẫn đến thông tin sai lệch giữa nhà phân tích kinh doanh và các bên khác là rào cản ngôn ngữ, giả định sai, từ vựng được giải thích không đầy đủ và sử dụng quá nhiều thuật ngữ kỹ thuật.

Cách tiếp cận lý tưởng để tránh vấn đề này là tương tác thường xuyên và phát triển các cuộc trò chuyện hai chiều. Ghi lại các nhu cầu mà bạn đã phát hiện và gửi chúng để được đồng nghiệp đánh giá và phê bình cho nhiều chuyên gia về chủ đề khác nhau, tạo bảng chú giải thuật ngữ và kiểm tra kỹ cơ sở.

Quy tắc cho một tập hợp các yêu cầu chính xác

Có một số quy tắc nhất định mà các yêu cầu phải tuân thủ để được gọi là "Đúng".

  • Hoàn thành - Tài liệu yêu cầu phải bao gồm đủ thông tin để nhóm phát triển và người kiểm tra của bạn hoàn thiện sản phẩm và đảm bảo rằng nó đáp ứng các yêu cầu của người dùng mà không có lỗi.
  • Tính nhất quán - Duy trì mức độ chi tiết nhất quán. Ví dụ: đối với các yêu cầu của người dùng, người dùng cuối phải là chủ thể của mọi câu. Tương tự, đối với các yêu cầu về hệ thống, hệ thống phải là chủ đề của mọi câu.
  • Khả năng sửa đổi - Các yêu cầu có thể thay đổi trong suốt vòng đời của dự án. Nhật ký yêu cầu phải được lưu trữ và có thể phân tích tác động của những thay đổi được thực hiện đối với các yêu cầu khác và các yếu tố của dự án.
  • Ưu tiên - Các yêu cầu phải được phân loại trên quan điểm tầm quan trọng. Không phải tất cả các đặc tính mong muốn cho một hệ thống đều quan trọng như nhau. Vì vậy, sẽ rất hữu ích nếu thiết lập một quy tắc để xác định các ưu tiên yêu cầu ở cấp độ tổ chức và điều chỉnh nó cho phù hợp với từng dự án. Và làm việc với người dùng để họ có thể ưu tiên các yêu cầu.

20 mẹo để viết yêu cầu tốt hơn

Mỗi tổ chức có một phương pháp làm việc khác nhau, do đó, một tập hợp các yêu cầu khác nhau. Do đó, quy trình quản lý yêu cầu cũng có thể khác nhau. Nhưng có một điều vẫn nhất quán là các nguyên tắc cơ bản của các yêu cầu viết. Dưới đây là 20 mẹo để viết yêu cầu tốt hơn.

  1. Cùng một lúc - Mỗi yêu cầu nên được coi như một trường hợp kiểm thử rời rạc. Không nên sử dụng các liên từ như và, hoặc, v.v. vì chúng có thể dẫn đến việc bỏ sót các yêu cầu. Điều này đặc biệt quan trọng vì các điều khoản như thế này có thể khiến các nhà phát triển phần mềm và người kiểm tra bỏ qua các yêu cầu. Chia các nhu cầu phức tạp thành các phần nhỏ hơn cho đến khi từng phần có thể được kiểm tra riêng biệt là một cách để ngăn điều này xảy ra.

  1. Nói “Cái gì” chứ không phải “Làm thế nào” - Trọng tâm nên tập trung vào những gì hệ thống sẽ làm, không phải là cách nó thực hiện. Ngoài ra, tránh đi quá sâu vào các chủ đề thiết kế như tên trường, đối tượng ngôn ngữ lập trình và đối tượng phần mềm. Nếu bạn thấy mình đang thảo luận về những chủ đề này trong Tài liệu Đặc tả Yêu cầu, hãy lùi lại một bước - điều này có thể có nghĩa là bạn đang trở nên quá cụ thể.

  1. Kiểm chứng - Một điều khác cần lưu ý khi tổ chức các yêu cầu là chúng phải luôn có thể kiểm tra được. Điều này có nghĩa là cần có khả năng xác minh hệ thống đáp ứng yêu cầu được đề cập. Điều này cũng liên kết đến điểm tiếp theo của chúng tôi - truy xuất nguồn gốc. Nếu một yêu cầu chứa đầy các thuật ngữ mơ hồ, thì việc phân tích và xác minh xem hệ thống có thực sự đáp ứng các tiêu chuẩn này về Hiệu suất hay không sẽ trở nên khó khăn hơn. Do đó, càng nhiều càng tốt, hãy nhắm đến sự rõ ràng và chính xác trong ngôn ngữ của bạn để việc thu thập Yêu cầu không phải là một quá trình mơ hồ.

  1. Truy xuất nguồn gốc - Truy xuất nguồn gốc trong quản lý dự án đề cập đến việc đảm bảo rằng các yêu cầu được liên kết với các thành phần khác trong dự án. Điều này cho phép người quản lý dự án, nhà phát triển và các bên liên quan theo dõi toàn bộ vòng đời của yêu cầu từ đầu đến cuối theo mọi hướng cũng như với các phần khác của hệ thống. Nếu bạn quản lý khả năng truy xuất nguồn gốc đúng cách, bạn có thể tránh mã không tương ứng với bất kỳ yêu cầu nào (mã 'đi lạc') và đảm bảo rằng mọi trường hợp thử nghiệm đều bao gồm ít nhất một yêu cầu. Bạn có thể truy xuất nguồn gốc các yêu cầu bằng cách gắn nhãn chúng với một số nhận dạng duy nhất và cung cấp thông tin về nguồn của chúng trong một kho lưu trữ trung tâm mà tất cả các thành viên trong nhóm đều có thể truy cập được.

  1. Khả thi - Đảm bảo rằng ngân sách và thời gian của dự án là khả thi, cùng với các nguồn lực sẵn có. Nếu những điều kiện này có thể hỗ trợ yêu cầu, thì bạn có thể tiếp tục với kế hoạch.

  1. Tính nhất quán - Duy trì mức độ chi tiết nhất quán. Ví dụ: đối với các yêu cầu của người dùng, người dùng cuối phải là chủ thể của mọi câu. Tương tự, đối với các yêu cầu về hệ thống, hệ thống phải là chủ đề của mọi câu.

  1. Trường hợp ngoại lệ - Một yêu cầu không được có điều khoản thoát. Ví dụ: “Hệ thống sẽ xác định số lần đăng nhập, ngoại trừ khi người dùng đã nhập sai tên người dùng rõ ràng”.

  1. Giọng nói hoạt động - Luôn viết với giọng chủ động, đảm bảo rằng một trong những diễn viên là chủ đề của mỗi câu.

  1. Nói không với mệnh đề "cho phép" - Cố gắng tránh xa các cụm từ dễ hiểu như nhưng, ngoại trừ và chỉ khi cần thiết.

  1. Không có chữ viết tắt - Mọi yêu cầu phải là một câu đầy đủ mà không có bất kỳ từ viết tắt hoặc biệt ngữ nào.

  1. Chủ ngữ & Vị ngữ - Đối với mọi yêu cầu, phải có chủ ngữ (người dùng / hệ thống) và vị ngữ (kết quả dự kiến, hành động hoặc điều kiện). 

  1. Clarity - Tránh sự mơ hồ do sử dụng các từ viết tắt như, vv, xấp xỉ. và những thứ tương tự.

  1. Sử dụng các Điều khoản Đúng - Các thuật ngữ không xác định như thân thiện với người dùng, đa năng và mạnh mẽ có thể gây khó khăn khi cố gắng xác định các trường hợp thử nghiệm. Những từ này thường mang những ý nghĩa khác nhau đối với những người khác nhau.

  1. Suy đoán có thể gây ra thiệt hại - Đừng đoán; không lập danh sách các tính năng nằm ngoài câu hỏi. Nói rằng bạn muốn một hệ thống xử lý tất cả các lỗi không mong muốn là điều hoàn toàn tưởng tượng vì không có hệ thống nào giống 100% những gì bạn mong muốn. Tránh các câu nói trùng lặp và mâu thuẫn.

  1. Tránh các tùy chọn - Không đưa ra ý tưởng hoặc lựa chọn. Bạn có thể phát hiện những điều này trong bất kỳ câu lệnh nào bao gồm các cụm từ có thể, có thể, có thể, hoặc nên.

  1. Thủ tục giấy tờ có tổ chức làm điều kỳ diệu - Giữ các yêu cầu được sắp xếp ở một nơi để cải thiện khả năng đọc tài liệu của bạn và tránh lãng phí thời gian tham khảo chéo nhiều nguồn.

  1. Nói chuyện với những gì chúng ta có - Không đề cập đến một yêu cầu chưa được xác định. Mục tiêu của bạn là làm cho tài liệu dễ đọc nhất có thể.

  1. Những gì nên được sử dụng và ở đâu? - “Sẽ” nên được sử dụng khi các yêu cầu được nêu rõ, “Ý chí” nên được sử dụng để thể hiện các tuyên bố về sự kiện; & “Nên” để thể hiện một mục tiêu cần đạt được.

  1. Chính xác - Đảm bảo rằng mỗi câu đều hoàn chỉnh và đúng ngữ pháp với chủ ngữ, động từ và vị ngữ thích hợp.

  1. Tập trung - Thiết lập sự tập trung bằng cách loại bỏ các cụm từ lan man, quá dài và các tham chiếu đến các bài báo lỗi thời.

Yêu cầu thăm quan Nền tảng ALM

Yêu cầu thăm quan Nền tảng ALM là một trong những nền tảng quản lý vòng đời ứng dụng đáng tin cậy nhất, chuyên quản lý các yêu cầu cho các tổ chức thuộc mọi quy mô trên toàn cầu. Các đối tác chính của Visure bao gồm các công ty quan trọng về kinh doanh và quan trọng về an toàn. Công ty tích hợp thông qua toàn bộ quy trình Quản lý vòng đời ứng dụng bao gồm quản lý rủi ro, theo dõi vấn đề và lỗi, quản lý truy xuất nguồn gốc, quản lý thay đổi và nhiều lĩnh vực khác như phân tích chất lượng, lập phiên bản yêu cầu và báo cáo mạnh mẽ.

Nếu bạn đang tìm kiếm một công cụ quản lý yêu cầu sẽ giúp bạn với cả yêu cầu chức năng và phi chức năng, hãy xem Yêu cầu về lượt truy cập. Với nền tảng này, bạn có thể dễ dàng tạo, quản lý và theo dõi tất cả các yêu cầu của dự án ở một nơi.

Kết luận

Để tạo ra một phần mềm tuyệt vời, điều quan trọng là phải có một bản đặc tả yêu cầu được viết tốt. Tài liệu này phác thảo các nhu cầu của khách hàng và hệ thống phải làm gì để đáp ứng kỳ vọng của họ. Tuy nhiên, viết các yêu cầu tốt có thể là một thách thức. Có nhiều tiêu chuẩn và hướng dẫn phải tuân theo, và có nhiều cách viết khác nhau tùy thuộc vào ngôn ngữ và công cụ bạn sử dụng. Yêu cầu thăm quan Nền tảng ALM cung cấp một khóa học dạy bạn cách viết thông số kỹ thuật yêu cầu hiệu quả bằng cách sử dụng các phương pháp hay nhất và tiêu chuẩn ngành. Khóa học bao gồm tất cả các thành phần thiết yếu của một tài liệu yêu cầu, từ cấu trúc đến định dạng, cũng như cách sử dụng các ngôn ngữ khác nhau cho các yêu cầu viết. Nó cũng nêu bật các đặc điểm của các yêu cầu lớn để bạn có thể tạo ra các tài liệu mà nhóm của bạn sẽ thích làm việc. Nếu bạn muốn tìm hiểu thêm về cách viết các yêu cầu hiệu quả, hãy thử Đặc điểm kỹ thuật yêu cầu khóa học theo Yêu cầu thăm quan Nền tảng ALM ngay hôm nay!

Đừng quên chia sẻ bài viết này!

Áo sơ mi

Triển khai các phương pháp hay nhất về AI để tối ưu hóa các yêu cầu về hệ thống điện tử hàng không

Tháng Chín 12th, 2024

11 giờ sáng giờ EST | 5 giờ chiều CEST | 8 giờ sáng theo giờ Thái Bình Dương

Fernando Valera

Fernando Valera

CTO, Giải pháp Visure

Reza Madjidi

Reza Madjidi

Giám đốc điều hành ConsuNova Inc.

Phương pháp tiếp cận tích hợp với Visure Solutions và ConsuNova Inc.

Tìm hiểu cách AI giúp tối ưu hóa các yêu cầu về hệ thống điện tử hàng không để cất cánh và hạ cánh an toàn