Por un lado es necesario un archivo en un servidor que contenga la información. Ese archivo es un Json con esta estructura:{ "Nombre del atajo1": { "nombre": "Nombre del atajo1", "descripcion": "Qué hace el atajo", "novedades": "Qué se ha añadido a en la última versión", "etiquetas": "#aqui #las #etiquetas", "autor": "http:\/\/t.me\/usuarioDeTelegram", "version": "1.0", "url": "http:\/\/shrtcts.es\/l\/\/descarga" }, "Nombre del atajo2": { "nombre": "Nombre del atajo2", "descripcion": "Qué hace el atajo", "novedades": "Qué se ha añadido a en la última versión", "etiquetas": "#aqui #las #etiquetas", "autor": "http:\/\/t.me\/usuarioDeTelegram", "version": "1.0", "url": "http:\/\/shrtcts.es\/l\/\/descarga" }, ...

Para cada atajo del canal hay una entrada en este archivo json que está almacenado en la dirección http://shrcts.es/versiones.json Observa que el archivo es un diccionario que contiene diccionarios para cada atajo. Es un diccionario de diccionarios.

Al principio del actualizador hay un diccionario para configurar el nombre y la version del atajo actual, la que el desarrollador manda al canal para ser publicada o actualizada. Imaginemos que has hecho un shortcut que se llama «Publicar en mi blog», hace un tiempo enviaste la primera versión, pero lo hemos actualizado con mejoras y has enviado la versión 1.2. En este primer diccionario aparecerán, por tanto, los siguientes datos que son los de la primera versión:

A continuación se carga el archivo donde están todas las versiones de los atajos para hacer la comprobación y saber si se tiene la ultima versión para ello se usa la acción URL y Obtener contenido de la URL. Lo que descargará el json en el atajo que se debe convertir a un diccionario con la acción Obtener diccionario de la entrada.

De todos los datos de los atajos que hay en el diccionario te interesa solo aquellos que pertenezcan al del atajo concreto que estás actualizando, para ello con Obtener valor del diccionario con la clave nombre del diccionario que se creó al comienzo del actualizador se obtendrá solo el diccionario con los datos de atajo. Como hay un diccionario por cada atajo necesitaras volver a convertir el json que devuelve en un diccionario. Y ahora ya sí, tienes el diccionario con todos los datos de ese atajo. Se guarda en una variable porque se van a solicitar varios datos de ese diccionario, así que lo necesitarás varias veces.

Lo primero que se hae es comprobar si la versión que se está usando actualmente es igual que la que hay almacenada en el servidor, así que se obtiene la el valor de la clave version con una acción Obtener valor del diccionario. Si coinciden las versiones no se hace nada, por lo que la ejecución del atajo termina sola.

En caso de que la versión difiera se muestra un aviso con las novedades que se han introducido y el botón cancelar activo por si el usuario no quiere actualizar en ese momento. En caso de que pulse «ok» se le llevará a la URL de la nueva versión obteniendo el valor de la clave «url» directamente al recuperar la variable:

Recuerda que si tienes cualqueir duda sobre esta entrada puedes preguntar en el grupo de telegram  Shortcuts en Español.

Y que tienes a tu disposición el libro Descubriendo Shortcuts para iOS en iBooks Store.

Campos disponibles:

• text=[texto] • title=[titulo] • url=[url] • list=[lista] • q=[terminoDeBusqueda] • index=[indice]

URL Schemes:

copied://clipboard
Abrir Copied y muestra el portapapeles.

copied://list/[nombreLista]
Abrir Copied y muestra la lista con el nombre que especificado.

copied://search?q=[terminoDeBusqueda]
Hacer una búsqueda en Copied usando las palabras que se incluyan en el término de búsqueda.

copied://x-callback-url/save?title=[Titulo]&text=[Texto]&url=[url]&list=[lista]&x-success=shortcuts://
Guardar un elemento en el historial de Copied y volver a Atajos.

copied://x-callback-url/copy?index=[indice]&list=[lista]&x-success=shortcuts://
🔹 Recuperar el elemento X que se haya puesto en [indice] devolviéndolo a Atajos para hacer algo con él.

Mira este atajo de ejemplo
Más información aquí

—————
◼️ Repositorio de atajos
◻️ ¡Tenemos grupo en Telegram!

Campos disponibles:

• in=[paste|latest|recent] • count=[numero] • out=[copy|save|save_copy] • watermark=[single|repeat] • border=[inside|outside|all] • mockup=[color_modelo] • clean_status=[yes] • delete_source=[yes]

URL Schemes:

picsew://x-callback-url/scroll?in=[paste|latest|recent]&count=[numero]&out=[copy|save|save_copy]&watermark=[single|repeat]&border=[inside|outside|all]&mockup=[color_modelo]&clean_status=[yes]&delete_source=[yes]
🔹 Usa las imágenes EN SERIE, una debajo de otra pero sin que se note la unión. Se le envían mediante in= paste las buscará en el portapapeles, con latest usará las últimas N imágenes especificadas en count y con recent se auto detectarán las últimas capturas. Con el parámetro out se le da salida a las imágenes procesadas, puede ser copiar, guardar o guardar y copiar. Si tienes definido una marca de agua en la aplicación puedes especificar cómo añadirlo con el parámetro «watermark» con el valor single para añadir la marca en la posición normal de la foto, o repeat para añadir una marca a cada foto. Con el parámetro border se puede añadir un borde a la imagen por dentro, con la opción inside, por fuera de la imagen, con la opción outside o all para ambas. El grosor del borde se especifica añadiendo _XX en la opción seleccionada de 0 a 100, por ejemplo «border=outside_60». Con el valor mockup se puede añadir a la captura de pantalla un marco con el iPhone, iPad o Apple Watch que se desee para ello se especifica mediante color[modelo] por ejemplo white_iphonex o black_ipad. Cuando se especifica «clean_status=[yes]» se elimina la barra de estado de la captura. Con «delete_source=[yes]» se borran las fotografías originales.

picsew://x-callback-url/vert?in=[paste|latest|recent]&count=[numero]&out=[copy|save|save_copy]&watermark=[single|repeat]&border=[inside|outside|all]&mockup=[color_modelo]&clean_status=[yes]&delete_source=[yes]
🔹 Usa las imágenes y las une en VERTICAL, una debajo de otra. Se le envían mediante in= paste las buscará en el portapapeles, con latest usará las últimas N imágenes especificadas en count y con recent se auto detectarán las últimas capturas. Con el parámetro out se le da salida a las imágenes procesadas, puede ser copiar, guardar o guardar y copiar. Si tienes definido una marca de agua en la aplicación puedes especificar cómo añadirlo con el parámetro «watermark» con el valor single para añadir la marca en la posición normal de la foto, o repeat para añadir una marca a cada foto. Con el parámetro border se puede añadir un borde a la imagen por dentro, con la opción inside, por fuera de la imagen, con la opción outside o all para ambas. El grosor del borde se especifica añadiendo _XX en la opción seleccionada de 0 a 100, por ejemplo «border=outside_60». Con el valor mockup se puede añadir a la captura de pantalla un marco con el iPhone, iPad o Apple Watch que se desee para ello se especifica mediante color[modelo] por ejemplo white_iphonex o black_ipad. Cuando se especifica «clean_status=[yes]» se elimina la barra de estado de la captura. Con «delete_source=[yes]» se borran las fotografías originales.

picsew://x-callback-url/hori??in=[paste|latest|recent]&count=[numero]&out=[copy|save|save_copy]&watermark=[single|repeat]&border=[inside|outside|all]&mockup=[color_modelo]&clean_status=[yes]&delete_source=[yes]
🔹 Usa las imágenes y las une en HORIZONTAL, una debajo al lado de la otra. Se le envían mediante in= paste las buscará en el portapapeles, con latest usará las últimas N imágenes especificadas en count y con recent se auto detectarán las últimas capturas. Con el parámetro out se le da salida a las imágenes procesadas, puede ser copiar, guardar o guardar y copiar. Si tienes definido una marca de agua en la aplicación puedes especificar cómo añadirlo con el parámetro «watermark» con el valor single para añadir la marca en la posición normal de la foto, o repeat para añadir una marca a cada foto. Con el parámetro border se puede añadir un borde a la imagen por dentro, con la opción inside, por fuera de la imagen, con la opción outside o all para ambas. El grosor del borde se especifica añadiendo _XX en la opción seleccionada de 0 a 100, por ejemplo «border=outside_60». Con el valor mockup se puede añadir a la captura de pantalla un marco con el iPhone, iPad o Apple Watch que se desee para ello se especifica mediante color[modelo] por ejemplo white_iphonex o black_ipad. Cuando se especifica «clean_status=[yes]» se elimina la barra de estado de la captura. Con «delete_source=[yes]» se borran las fotografías originales.

—————
◼️ Repositorio de atajos
◻️ ¡Tenemos grupo en Telegram!

Campos disponibles:

• text=[Mensaje] • to=[Telefono] • [UsuarioDeTelegram]

URL Schemes:

➡️ tg://msg?text=[Mensaje]&to=[telefono]
🔹 Envía un mensaje al número de teléfono especificado.

➡️ tg://resolve?domain=[UsuarioDeTelegram]
🔹 Abre un chat con el usuario de Telegram espeficiado sin necesidad de conocer su número, a través de su alias.

Si quieres saber cómo obtener el token de su api para usar el atajo para publicar en sigue estos pasos:

1. Ve a las preferencias de tu instancia en mi caso de mastodon.cloud: https://mastodon.cloud/settings/applications
2. Ahí pulsa en nueva aplicación y rellena los datos así:

Nombre de la aplicación: Shortcuts
Sitio web: ninguno
URI: déjalo como está

3. Ahora vuelve al menú de desarrollo y pulsa en la app que te aparecerá con el nombre Shortcuts y dentro te aparecerá un campo que se llama tu token de acceso ahí lo tienes.

Por cierto si quieres seguirme mi perfil es este.

Vamos a hacer un atajo que nos permita guardar en los registros de Salud de nuestro móvil nuestra temperatura corporal, para cuando estamos enfermos y queremos ir viendo como evolucionamos. Lo llamaremos Temperatura Corporal.

En primer lugar hay que pensar en cómo se va a usar este atajo. En este caso está claro que usaremos un termómetro tradicional, por lo que el dato tendremos que introducirlo a mano en el atajo, por tanto ¿qué vamos a necesitar?:

• Que nos pida el dato de temperatura.
• Que guarde ese dato para usarlo en la siguiente acción.
• Que lo guarde en los registros de salud.

Por ahora vamos a dejar de lado las variables mágicas ya que, si bien son útiles para atajos sencillos añaden complejidad en los mas dificiles y es mas educativo usar variables. Si no sabes de lo que estoy hablando, mejor, olvida este párrafo, te iré enseñando.

Es importante saber que las cajas de acción están formadas por tres partes: la entrada de datos, la acción propiamente dicha y la salida de datos. Esto es, a cada caja le entran una serie de datos, dentro de la caja se producirá la acción de la caja y saldrá ya modificado hacia la siguiente acción. Por ejemplo, tenemos el número 2, una caja que multipla por 6; la entrada es el 2, entra a la caja dónde tiene lugar la acción es decir el 2 se multipicla por 3, por lo que el resultado será un 6 en la salida. En el caso de encadenar varias cajas de acción la salida de una caja es la entrada de la siguiente.

PASO 1

Comenzamos un nuevo atajo con el botón crear atajo.

Tenemos el espacio de trabajo en blanco, así que pulsamos abajo, en buscar y empezamos a escribir solicitar entrada hasta que aparece abajo.

Arrastramos la caja de solicitar entrada al espacio de trabajo. Aparecen tres campos que rellenamos así:

Pregunta – ¿Qué temperatura tienes?

Respuesta por omisión – lo dejamos en blanco

Tipo de entrada – Número

PASO 2

Ahora vamos a guardar el dato que hemos obtenido al solicitar la entrada en una variable. Las variables son como taquillas con nombre donde podemos guardar información para recuperarla más adelante.

Variable – Temp

Elegimos la acción guardar variabley al soltarla justo debajo de la acción solicitar entradaaparecerá una línea vertical que las une. Esto nos indica que los datos que salen de la acción de arriba pasan a la acción de abajo.

PASO 3

Se elige ahora la acción Registrar muestra médica y lo rellenaremos de la siguiente manera:

Tipo – Temperatura corporal

Valor – Pinchamos en variables encima del teclado y seleccionamos temp que es el nombre que le dimos a la variable.

Fecha – *Lo dejamos en blanco*

El resultado debería ser como el de la siguiente captura:

¿Y para qué puede servirme a mi eso, que suena a programación, si no soy desarrollador? Pues para un montón de cosas, imagínate que todas las mañanas al salir a la calle pones una lista de música ya sea en Spotify o Apple Music, y además quieres mandar un mensaje a alguien diciendo «buenos dias» (algo cada vez mas común, jeje). TIenes dos opciones, o lo vas haciendo por ti mismo todas las mañanas o creas un atajo que lo haga por ti. O, por ejemplo, que cuando vas a visitar a un amigo le mande un mensaje con un solo clic avisandolo de que sales desde donde estes y la hora aproximada a la que llegarás. Unir varios pdf en uno solo,… las posibilidades son infinitas.

¿Como se usan estos «atajos»? Hay dos tipos de atajos fundamentales:

• Los independientes que al hacer clic ya te iran pidiendo datos si es que los necesitan, hasta devolverte el resultado:
  • Por un lado puedes abrir la app de atajos y hacer clic sobre uno de ellos, si es independiente, se ejecutará, te pedirá algun dato si lo necesita y al final del todo te dará el resultado.
  • Esto mismo lo puedes hacer añadiendo dicho atajo a al widget.
  • Grabando una frase que cuando siri la oiga ejecute este atajo.
• Las extensiones que requieren que les mandes datos desde otra aplicación para hacer algo con ellos (cambiar el tamaño de una imagen, por ejemplo).
  • Los que son tipo extensión solo pueden ejecutarse a través del menú compartir de cualquier aplicación, seleccionando la app atajos.

Me encanta como suena, pero ¿sabré hacerlo yo solo? Por supuesto, además voy a ir escribiendo pequeñas guías sobre como usar la aplicación, así que vamos a empezar por el principio, el nombre, en español: atajos, en inglés shortcuts, que leido es: sorcats.

La interfaz de shortcuts

Al abrir la aplicación nos encontrareos con estas dos pestañas:

En la izquierda están todos los atajos que vayamos creando, en tu caso puede que esté vacío. En la derecha está la galería, donde apple va colgando aquellos atajos que pueden ser interesantes, y que para principiantes como tu son un buen comienzo para darle uso a la app y para abrirlos y empezar a estudiar cómo están hechos. Solo tienes que añadirlos a tu biblioteca y a jugar.

Nosotros, en este artículo vamos a empezar a crear uno desde cero, y como no puede ser de otra manera con un ¡Hola Mundo! del que aquí teneis su historia.

Pues bien pulsamos sobre el boton «Crear atajo» y llegamos a esta pantalla:

Ahi tenemos la parte superior con la barra de título, justo debajo está la barra de herramientas donde se puede Deshacer o Rehacer, ejecutar el atajo con el boton play, compartirlo o entrar en sus opciones.

Debajo está la zona más importante, la zona de trabajo, donde iremos soltando en orden de ejecución las cajas de acción (ya lo veremos más adelante)

Y abajo del todo la barra de buscar que esconde todo el menú de acciones que se pueden usar para crear nuestros atajos.

Primer paso: buscar las cajas de acción y arrastrarlas a la zona de trabajo

El primer paso será buscar las cajas de acción que eramos usar, os recomiendo navegar por los menus que hay para ir viendo qué se puede hacer, aunque no lo entendáis. Tambien os diré que aparecerán más o menos en función de las aplicaciones que tengáis en el movil, ya que éstas añaden acciones en atajos.

Buscaremos la caja de texto en el buscador y cuando aparezca abajo la arrastraremos a la zona de trabajo.

Dentro de la caja de texto podemos escribir cualquier texto (y mas cosas que ya explicaremos) por ahora escribiremos «¡Hola mundo!»

Ahora si, pulsaremos play y veremos como se ejecuta y nos devuelve un ¡Hola mundo!

¡Hemos hecho nuestro primer programa y nuestro primer atajo!

En siguientes entradas iremos profundizando en el uso de la aplicación.

Desde hace años, 2015 o así, encontré la aplicación workflow, que de alguna manera permitía cierta automatización de tareas para iOS. Esto es, aquellas cosas que haces mucho y son siempre iguales quizá se podían automatizar. Los límites los ponían las reglas del sistema operativo. 

Por aquel momento no era mucho lo que se podía hacer, pero la programación visual y las ganas de llevar aquello al maximo hicieron que me interesara mucho por la app. 

Algún tiempo después, cuando el GUM Granada (Grupo de Usuarios de Mac de Granada) fue retomado, Jose Ruiz creó el grupo en telegram de Workflow en Españolque más tarde pasaría a llamarse Shortcuts en Español. Ahí estuvimos un año unos 30 o 40 locos haciendo lo que podíamos e ilusionados con que la compra por parte de apple de Workflow traería cosas muy interesantes a esta aplicación entorno a la que creamos esta comunidad. 

Llegó el 17 de Septiembre y la ilusión se apoderaba de todos, pero no imaginábamos lo que realmente iba a pasar: aquel pequeño grupo empezó a llenarse, y metidos en esa vorágine y casi sin darme cuenta creamos un canal repositorio de atajos y hasta un canal para organizarnos los admins, porque necesitamos ayuda y encontramos gente buenísima para ayudar.

En este momento el grupo tiene 1436 miembros y el canal 2772 lectores y 83 atajos originales, asi que no creo que me equivoque si digo que somos la comunidad mas grande en castellano sobre Shortcuts.

En adelante aprovecharé mi blog para ir explicando algunos atajos que he creado con la intención de que podais aprender su uso y sacarle el máximo provecho.

Muchas gracias a Jose por iniciarlo todo y prender la llama, a Frank por sus conocimientos, a Pedro por echarle mas leña al fuego en el momento adecuado con la creación del canal, a Irene por ser incansable e interiorista de chats y a Fran Llamas por subirse al carro a echar una mano sin pensarselo.