{"id":1119,"date":"2023-12-22T00:00:00","date_gmt":"2023-12-21T23:00:00","guid":{"rendered":"https:\/\/programaraciegas.net\/?p=1119"},"modified":"2023-12-11T06:35:42","modified_gmt":"2023-12-11T05:35:42","slug":"como-notificar-de-forma-apropiada-un-error-en-una-aplicacion-o-servicio","status":"publish","type":"post","link":"https:\/\/programaraciegas.net\/?p=1119","title":{"rendered":"C\u00f3mo notificar de forma apropiada un error en una aplicaci\u00f3n o servicio"},"content":{"rendered":"

A la hora de mejorar y mantener un producto software los desarrolladores utilizan el feedback proporcionado por los usuarios a trav\u00e9s de lo que se conoce como bug report<\/em> o feedback report<\/em>. Un bug report es un mensaje de un usuario al desarrollador indicando que hay un problema en una aplicaci\u00f3n.<\/p>\n

Este mensaje se puede enviar a trav\u00e9s de correo electr\u00f3nico, mediante una plataforma web de gesti\u00f3n de errores, a trav\u00e9s de chat o a trav\u00e9s del canal que el desarrollador haya proporcionado para la comunicaci\u00f3n con los usuarios.<\/p>\n

Un bug report efectivo<\/h2>\n

En muchas ocasiones los reportes de error enviados por los usuarios son totalmente in\u00fatiles y poco efectivos ya que se limitan a mensajes del tipo la app no funciona<\/em>. Es evidente que si se env\u00eda un reporte de error es porque el usuario ha encontrado que algo no funciona pero los desarrolladores, por ahora, no podemos leer el pensamiento de los usuarios por lo que es necesario dar m\u00e1s detalles sobre qu\u00e9 no funciona para encontrar respuesta a la pregunta de por qu\u00e9 no funciona y c\u00f3mo hace el usuario para que no funcione ya que los desarrolladores antes de publicar sus aplicaciones realizan multitud de pruebas de uso y puede que conocer c\u00f3mo utilizan su aplicaci\u00f3n otras personas les permita mejorar el uso de la misma.<\/p>\n

Adem\u00e1s, decir que la app no funciona es algo muy general. Una app peque\u00f1a tiene entre 4 y 15 pantallas por lo que es de agradecer un poco m\u00e1s de informaci\u00f3n.<\/p>\n

Qu\u00e9 incluir en un reporte de error<\/h2>\n

A la hora de enviar un reporte de error es muy recomendable incluir los siguientes apartados:<\/p>\n

Descripci\u00f3n breve del problema<\/h3>\n

En un par de p\u00e1rrafos describir qu\u00e9 error sucede. Se recomienda incluir el nombre de la aplicaci\u00f3n, en qu\u00e9 pantalla sucede y c\u00f3mo lleg\u00f3 a esa pantalla.<\/p>\n

Paso a paso<\/h3>\n

Incluir una lista de pasos desde que se abre la aplicaci\u00f3n hasta que se obtiene el error o el comportamiento no esperado.<\/p>\n

Tambi\u00e9n se debe incluir un paso indicando que se activa el lector de pantallas, el magnificador o cualquier otro producto de apoyo que se est\u00e9 utilizando ya que a veces los errores s\u00f3lo suceden con un producto de apoyo.<\/p>\n

Adem\u00e1s, si el producto de apoyo o la aplicaci\u00f3n tiene alguna personalizaci\u00f3n o ajuste especial que provoque el problema tambi\u00e9n es necesario indicarlo.<\/p>\n

Resultados esperados y resultados obtenidos<\/h3>\n

Este apartado sirve para indicar qu\u00e9 esperaba el usuario que sucediese y qu\u00e9 es lo que sucede realmente. A veces el problema no es de software sino de lenguaje empleado. El usuario entendi\u00f3 que deber\u00eda pasar una cosa pero el desarrollador no se explic\u00f3 bien en el manual o las instrucciones en la aplicaci\u00f3n. Este tipo de informes de error permiten solucionar este tipo de problemas de malentendidos o para comprender qu\u00e9 experiencia de uso tienen los usuarios ante ciertas situaciones provocadas por sus aplicaciones.<\/p>\n

Los resultados esperados y resultados obtenidos suelen ser un par de p\u00e1rrafos describiendo ambos elementos.<\/p>\n

Observaciones<\/h3>\n

Este apartado suele ser un texto beve donde el usuario puede aportar m\u00e1s informaci\u00f3n sobre, por ejemplo, si est\u00e1 utilizando el dispositivo con una configuraci\u00f3n determinada (por ejemplo un iPhone configurado en Espa\u00f1ol de USA con modo oscuro y con auriculares), el modelo de su dispositivo o si ten\u00eda alg\u00fan dispositivo m\u00e1s conectado.<\/p>\n

Adjuntos al reporte<\/h3>\n

Adjunto al reporte de errores es recomendable incluir un adjunto con un informe de comportamiento<\/a> o fichero de log que permita al desarrollador ver el comportamiento interno de la aplicaci\u00f3n cuando suced\u00eda el problema.<\/p>\n

Si el apartado de paso a paso es muy detallado no es necesario incluir ning\u00fan adjunto a menos que el problema lo tenga un usuario en concreto y pueda ser por una configuraci\u00f3n muy concreta o un fallo colateral en ese dispositivo concreto. Estos ficheros de log permiten encontrar esa informaci\u00f3n tan concreta que no es evidente ni para el usuario ni para el desarrollador.\u00a0<\/p>\n

En la mayor\u00eda de ocasiones se piden estos ficheros en una segunda comunicaci\u00f3n s\u00f3lo si el desarrollador no ha podido reproducir el problema reportado por el usuario y tras seguir el paso a paso indicado.<\/p>\n

Siempre con educaci\u00f3n<\/h2>\n

Es algo que puede parecer evidente cuando nos comunicamos con otra persona pero es algo que muchas veces se olvida. Si un usuario espera que otra persona atienda a su mensaje con buena disposici\u00f3n es necesario un trato cordial y sin caer en insultos o palabras despectivas hacia la persona que desarrolla el software, su inteligencia o su progenie.<\/p>\n

En varias ocasiones he desechado o ignorado reportes de error por estar mal estructurados, no aportar informaci\u00f3n suficiente o utilizar un lenguaje inapropiado. Y como yo conozco a muchos desarrolladores que hacen lo mismo ya que se considera que ese tipo de feddback no es beneficioso para el software.<\/p>\n

Buscando el entendimiento<\/h2>\n

A veces tambi\u00e9n hay un problema de comunicaci\u00f3n entre el usuario y el desarrollador por el lenguaje empleado. Puede que el usuario no sepa hablar franc\u00e9s y el desarrollador no sepa hablar japon\u00e9s. En estos casos siempre es recomendable utilizar un idioma neutral, siendo el m\u00e1s com\u00fan en el desarrollo de software utilizar ingl\u00e9s, y utilizando una herramienta de traducci\u00f3n incluir dentro del texto un aviso indicando que la persona habla en un idioma concreto y que este texto ha sido traducido al ingl\u00e9s gracias a una herramienta de traducci\u00f3n. Esto permite a ambas partes estar atentos a posibles malentendidos a causa de un error en la traducci\u00f3n.<\/p>\n","protected":false},"excerpt":{"rendered":"

A la hora de mejorar y mantener un producto software los desarrolladores utilizan el feedback proporcionado por los usuarios a trav\u00e9s de lo que se conoce como bug report o feedback report. Un bug report es un mensaje de un usuario al desarrollador indicando que hay un problema en una aplicaci\u00f3n. Este mensaje se puede … <\/p>\n

Continuar leyendo \u00abC\u00f3mo notificar de forma apropiada un error en una aplicaci\u00f3n o servicio\u00bb<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[7,8],"tags":[303,122],"class_list":["post-1119","post","type-post","status-publish","format-standard","hentry","category-herramientas-de-asistencia","category-metodologiafilosofia","tag-error","tag-notificaciones"],"jetpack_featured_media_url":"","_links":{"self":[{"href":"https:\/\/programaraciegas.net\/index.php?rest_route=\/wp\/v2\/posts\/1119","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/programaraciegas.net\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/programaraciegas.net\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/programaraciegas.net\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/programaraciegas.net\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=1119"}],"version-history":[{"count":0,"href":"https:\/\/programaraciegas.net\/index.php?rest_route=\/wp\/v2\/posts\/1119\/revisions"}],"wp:attachment":[{"href":"https:\/\/programaraciegas.net\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=1119"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/programaraciegas.net\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=1119"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/programaraciegas.net\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=1119"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}