[TA ] improve per-document error message when all documents fail per action (Azure#26902)

* fix bad Document error message when all actions fail

* update changelog

* update wording

Author: kristapratico

sdk/textanalytics/azure-ai-textanalytics/CHANGELOG.md

@@ -2,13 +2,8 @@
 
 ## 5.2.1 (Unreleased)
 
-### Features Added
-
-### Breaking Changes
-
 ### Bugs Fixed
-
-### Other Changes
+- Returns a more helpful message in the document error when all documents fail for an action in the `begin_analyze_actions` API.
 
 ## 5.2.0 (2022-09-08)
 

sdk/textanalytics/azure-ai-textanalytics/azure/ai/textanalytics/_response_handlers.py

@@ -409,8 +409,8 @@ def _get_doc_results(task, doc_id_order, returned_tasks_object):
     # if no results present, check for action errors
     if response_task_to_deserialize.results is None:
         return get_ordered_errors(returned_tasks_object, task_name, doc_id_order)
-    # if results obj present, but no document results (likely a canceled scenario)
-    if not response_task_to_deserialize.results.documents:
+    # if results obj present, but no document results or errors (likely a canceled scenario)
+    if not response_task_to_deserialize.results.documents and not response_task_to_deserialize.results.errors:
         return pad_result(returned_tasks_object, doc_id_order)
     return deserialization_callback(
         doc_id_order, response_task_to_deserialize.results, {}, lro=True

sdk/textanalytics/azure-ai-textanalytics/tests/test_analyze.py

@@ -540,6 +540,7 @@ def test_invalid_language_hint_method(self, client):
         for document_results in response:
             for doc in document_results:
                 assert doc.is_error
+                assert doc.error.code == "UnsupportedLanguageCode"
 
     @TextAnalyticsPreparer()
     @TextAnalyticsClientPreparer()