Memoria de Acceso Aleatorio

Haciendo consultas en Jama Connect desde cualquier parte en macOS

—

by

Juande Santander-Vela
in , ,

En cualquier gran proyecto es de la máxima importancia mantener los requerimientos de los usuarios, requerimientos técnicos, y requerimientos de los distintos subsistemas, y cómo se derivan de (y relacionan con) otros.

Para ello, se utilizan herramientas de gestión de requerimientos (Requirements Management). Tanto en el Square Kilometre Array Observatory (SKAO) como en el Joint ALMA Observatory (JAO), o incluso el Cherenkov Telescope Array Observatory (CTAO) utilizamos un software como servicio llamado Jama Connect.

Una de las herramientas básicas en estos sistemas es la necesidad de poder encontrar información, y sus relaciones. Y afortunadamente Jama Connect es una aplicación web en las que hay enlaces permanentes para prácticamente todos los elementos — al final es una base de datos configurable por el usuario para la tarea de gestión de requerimientos —, así que hay un enlace que se puede utilizar para esa búsqueda.

Pantallazo del workflow “Search in ALMA Jama” con una entrada adicional que sirve para prueba (ver paso 4 más abajo)

Si tu instalación de Jama Connect vive en https://myconnect.jamacloud.com/, entonces tu URL de búsqueda es https://myconnect.jamacloud.com/perspective.req#/search?term=search_term&scope=GLOBAL, con search_term representando una versión procesada del término de búsqueda en la que se reemplazan caracteres no imprimibles por códigos de tipo %20 para un espacio, por ejemplo.

Si tenemos un proyecto concreto en el que buscar con identificador de proyecto project_id, podemos utilizar https://myconnect.jamacloud.com/perspective.req#/search?term=search_term&scope=PROJECT&project=project_id para restringir la búsqueda a ese proyecto.

Podemos crear entonces nuestro servicio de Automator con los siguientes pasos:

  1. Crear un nuevo workflow de Automator del tipo Quick Action. Indicar que queremos que procese texto de cualquier aplicación.
  2. Añadir una acción Run shell script, escogiendo /usr/local/bin/python3 como el shell, y copiando el contenido del gist de GitHub jama_search.py (reproducido tras esta lista).
  3. Cambiar el valor de jama_search_base_url para que apunte a nuestra instalación de Jama.
  4. (Opcional) Podemos probar nuestro workflow añadiendo otra acción Run shell script, con el contenido único echo "mi término de búsqueda", de forma que quede antes de la acción del paso uno. Pulsando el botón de ejecutar el workflow, se abrirá una pestaña en la que se buscará en Jama el término incluido. Recordemos que ese paso tiene que eliminarse para el uso normal del workflow.
import sys # we use sys to get the input to the service
# from sys.stdin
from urllib.parse import quote # to convert high-ASCII and other
# into URL-compatible quoting
import webbrowser # To open the web browser
# establish the base instance URL
jama_search_base_url = "https://almaobservatory.jamacloud.com/perspective.req#/"
project_id="project_id code"
# get the text from the selection, split it in lines, URL quote it each one,
# and open the resulting search URL in a different tab
for line in sys.stdin:
text_input = quote(line.rstrip("\n")) # rstrip removes the ends of line
# URL for the Jama Search; you can use alternatively the PROJECT scope with a project_id
jama_search_url = jama_search_base_url + f"search?term={text_input}&scope=GLOBAL"
# jama_search_url = jama_search_base_url + f"search?term={text_input}&project={project_id}&scope=PROJECT"
# Output of the workflow done by a print
print(jama_search_url)
# Open the browser using Python's native browser support
# in a new tab (new=2) in the background (autoraise=False)
webbrowser.open(jama_search_url, new=2, autoraise=False)
view raw jama_search.py hosted with ❤ by GitHub

A partir de ese momento, nuestro menú Servicios incluirá una entrada que nos permitirá buscar una o más líneas de texto en nuestra instancia de Jama.

Comentarios

Una respuesta a «Haciendo consultas en Jama Connect desde cualquier parte en macOS»

  1. Conectando Memoria de Acceso Aleatorio al Fediverso — Parte II – Memoria de Acceso Aleatorio

    […] artículos se publican a todo tamaño, como muestra este pantallazo de Ivory para Mac mostrando una entrada sobre cómo usar Automator para buscar contenido dentro de Jama Connect publicada por ese […]

To respond on your own website, enter the URL of your response which should contain a link to this post’s permalink URL. Your response will then appear (possibly after moderation) on this page. Want to update or remove your response? Update or delete your post and re-enter your post’s URL again. (Find out more about Webmentions.)

Descubre más desde Memoria de Acceso Aleatorio

Suscríbete ahora para seguir leyendo y obtener acceso al archivo completo.

Seguir leyendo