Artículo
Ricardo Paiva · Oct 28 Lectura de 2 min
Generadores de documentación estática

¡Hola comunidad!

En el pasado, la documentación técnica del código fuente y de los productos de software se generaba en archivos chm, pdf y generadores de documentación de los propios lenguajes de programación. Este enfoque antiguo tenía las siguientes limitaciones:

  1. Documentación obsoleta,
  2. Documentación no interactiva y difícil de consultar,
  3. Diseño poco amigable y que no se adhiere a HTML,
  4. Imposibilidad de personalizar el diseño de los documentos,
  5. Imposibilidad de tener documentación en HTML 5 online y offline.
  6. Falta de soporte a Markdown.

Hoy en día, existen varias soluciones de generación de documentación que producen Portales de Documentación Web muy atractivos, interactivos y con opciones estáticas y dinámicas, con soporte total para HTML 5 y más recientemente Markdown.

Consulta la tabla con las opciones de código abierto más populares:

00
0 0 29

¡Hola desarrolladores!

Muchos de vosotros publicáis vuestras bibliotecas de InterSystems ObjectScript en Open Exchange y Github.

Pero, ¿qué puedes hacer para facilitar a los desarrolladores el uso y la colaboración en tu proyecto?

En este artículo, quiero presentar una forma sencilla de poner en marcha y contribuir en cualquier proyecto ObjectScript con solo copiar un conjunto estándar de archivos en tu repositorio.

¡Vamos!

00
0 0 39
Artículo
Jose Tomas Salvador · Sep 6 Lectura de 2 min
InterSystems ObjectScript 101++

Desde hace ya algunos años he echado en falta poder ofrecer, a todos los que se interesan por ObjectScript, un tutorial más o menos completo de iniciación a ObjectScript. Algo que pueda ayudar más y facilitarles las cosas a esos nuevos desarrolladores que se acercan a nuestra tecnología... algo intermedio, a medio camino entre el típico "Hola Mundo", que no te permite ir mucho más allá, y el "Curso Avanzado de Programación", que te resulta imposible por carecer de tiempo o medios.

Si existiese algo que de verdad sirviera no sólo como introducción al ecosistema, sino cómo empujón y punto de partida para empezar a hacer cosas de verdad en ObjectScript y avanzar por ti mismo... ¿no sería estupendo?

70
0 2 156

El lenguaje ObjectScript de InterSystems IRIS tiene un motor de metadatos muy potente llamado XData. Esta característica permite crear definiciones de metadatos para tus clases, que serán utilizadas por el compilador o por los programas para ampliar las características estándar del lenguaje, basándose en las definiciones XData de su campo de acción.

Un ejemplo es IRIS Publisher, una aplicación de código abierto de la Comunidad, capaz de recopilar todas las definiciones de XData en formato HTML y/o Markdown, y que puede generar un Portal web con todos los documentos de la aplicación, recopilados a partir de estos elementos XData.

00
0 0 29
Artículo
Eduardo Anglada · Jul 22 Lectura de 2 min
Plugin IntelliJ IDEA para InterSystems

Os presento el soporte de InterSystems IRIS en IntelliJ IDEA. Este plugin añade soporte de Syntax Highlighting para ObjectScript, así como la auto importación y la compilación en el servidor después de guardar un archivo modificado. Utiliza LanguageServer escrito en Rust, donde se añadió la capacidad de importar y compilar código.

00
0 0 25

En Studio, podías abrir una clase directamente usando su nombre, sin tener que recorrer completamente el árbol de paquetes con un montón de clics hasta llegar a la clase deseada.

Con Ctrl + O o (File -> Open) podías escribir el nombre de la clase de forma sencilla, por ejemplo:

Pulsabas Enter y voilà!, la clase se abría.

¿Cómo se logra esto en VSCode?

10
0 0 41

Ahora que la extensión de ObjectScript para VS Code ha alcanzado la versión 1.0 y ha sido presentada en varias sesiones de la Cumbre Virtual 2020, parece un buen momento para ofrecer algunos consejos sobre cómo reportar problemas.

InterSystems ObjectScript para VS Code se basa en tres extensiones de VS Code que colaboran entre sí. Para facilitar la instalación y la administración hay una cuarta entidad, el paquete de extensiones de InterSystems ObjectScript. Es la mejor manera de empezar con un mínimo de clics y es práctico tenerlo incluso si ya habéis instalado las otras extensiones.

00
0 0 27
Artículo
Nancy Martínez · Abr 20 Lectura de 2 min
Docker - durabilidad ligera

Al trabajar desde casa durante estos "días de coronavirus", me faltan recursos.

  • no tengo ninguna máquina Linux disponible
  • espacio en disco limitado

Además, Docker Desktop (en Windows10) bloqueó de alguna manera los scripts de Durable %SYS como se describe aquí.
Investigando el caso, descubrí que se almacenaban muchos más datos de los que realmente necesitaba.
Así que diseñé mi durabilidad personalizada.

00
0 0 38
Artículo
YURI MARX GOMES · Dic 23, 2020 Lectura de 1 min
Cómo analizar el tiempo que dedicas a programar

¡Hola Comunidad!

Yo utilizo un excelente servicio para recoger el tiempo que dedico a programar. Es el WakaTime: https://wakatime.com/.

Este servicio se integra con la mayoría de los IDEs, incluyendo VSCode, y recoge el tiempo dedicado por proyecto, lenguaje, IDE... y estadísticas de código general. Mira mis últimos 7 días:

Esta información me ayuda a organizarme y equilibrar mis objetivos por proyecto.

00
0 0 62
Artículo
Mathew Lambert · Jul 24, 2020 Lectura de 2 min
Herramienta de compresión tar en ObjectScript

¡Hola desarrolladores!

Estoy seguro de que la mayoría de vosotros ya conoceis la posibilidad de usar GZIP en los productos de InterSystems. Pero el problema es que GZIP trabaja con un único archivo o flujo de datos, y no admite carpetas. Al trabajar con sistemas Unix, es posible solucionarlo con la herramienta de compresión tar, incluida en cada sistema Linux de forma predeterminada. Pero ¿qué hacer si debemos trabajar también en Windows, que no lo incluye?

Me alegra poder enseñaros el nuevo proyecto, isc-tar, que os ayudará a no preocuparos del sistema operativo y os permitirá gestionar los archivos tar en cualquier sitio.

00
0 0 47
Artículo
Mathew Lambert · Jul 15, 2020 Lectura de 4 min
Historia del proyecto isc-tar

¡Hola desarrolladores!

Aquí podéis ver el anuncio del proyecto isc-tar de @Dmitriy Maslennikov. En ocasiones, la historia de porque se ha llegado a un resultado es igual o más interesante que el resultado: cómo se construyó, cómo funciona y qué sucede en torno al proyecto. Esta es la historia:

  • Cómo desarrollar este proyecto
  • Cómo probarlo
  • Cómo lanzar nuevas versiones para publicar
  • Cómo automatizar todo lo anterior
  • Integración continua

Os hablaré de todo eso.

10
0 0 51

Esta vez quiero hablar de algo que no es específico de InterSystems IRIS, pero que creo que es importante si quieres trabajar con Docker y tu máquina de trabajo es un PC o portátil con Windows 10 Pro o Enterprise.

Como probablemente sabes la tecnología de contenedores viene básicamente del mundo Linux y, a día de hoy, es en los hosts que corren Linux donde pueden mostrar su máximo potencial. Los que usamos Windows vemos que tanto Microsoft como Docker han hecho grandes esfuerzos estos últimos años y nos permiten correr contenedores Linux en nuestro sistema Windows de una manera muy sencilla... pero no está soportado para entornos productivos y, aquí viene el gran problema, no es fiable si queremos mantener persistencia de datos fuera del contenedor, en el sistema host,...  debido principalmente a las importantes diferencias entre los sistema de archivos de Windows y Linux. Al final el propio Docker for Windows utiliza una pequeña máquina Linux virtual (MobiLinux) sobre la que realmente se levantan los contenedores.... lo hace de forma transparente para el usuario de windows... y de hecho funciona muy bien hasta que, como digo, quieren hacer que tus bases de datos sobrevivan más allá de la vida del contenedor...

En fin,... que me enrollo,... el caso es que muchas veces, para evitar problemas y simplificar, lo que se precisa es de un sistema Linux completo... y, si nuestra máquina es Windows, la única forma de tenerlo es vía una máquina virtual. Al menos hasta que salga WSL2 en Windows 10 en unos meses, pero eso es otra historia.

En este artículo te voy a contar, paso a paso, como instalar un entorno en el que puedas trabajar con contenedores Docker sobre un Ubuntu en tu servidor Windows. Vamós allá...

10
0 3 3,434

¡Hola Comunidad!

Creo que hoy en día todo el mundo guarda el código fuente de sus proyectos en repositorios como Github, GitLab, bitbucket, etc.

Lo mismo sucede con proyectos de InterSystems IRIS, se pueden ver algunos ejemplos en Open Exchange.

¿Qué hacemos cada vez que empezamos o continuamos nuestro trabajo con un repositorio en particular con la plataforma de datos de InterSystems?

10
0 0 164

Estaba buscando la forma mas simple de conectar desde el visual studio code a mi instancia local por el terminal sin tener que ir cambiando de ventana.

Soy consciente de que esto tambien se puede conseguir por telnet pero me parece complicar la cosa para conectarme a mi local.

La solución mas sencilla me ha parecido navegar a la carpeta /bin de la instalación (o añadirla al PATH), y ejecutar .\csession.exe NOMBREDEINSTANCIA.

20
0 0 153

¡Hola a tod@s!

En esta serie de artículos me gustaría presentar y discutir varios enfoques posibles para desarrollar software mediante las tecnologías de InterSystems y GitLab. Abordaré temas como:

00
0 0 113

¡Hola desarrolladores!

Programando a diario con IRIS y Docker, en el terminal VSCode llamo a los siguientes 3 comandos. Siempre de la misma forma para todos los proyectos:

docker-compose build   ; para compilar el contenedor

docker-compose up -d   ; para ejecutar IRIS en el contenedor

docker-compose exec iris iris session iris ; para abrir el terminal de IRIS

¿Hay alguna forma de acceso rápido por teclado que me escriba el resto?

00
0 1 134
Artículo
David Reche · Jul 16, 2019 Lectura de 2 min
Cómo verificar y arreglar la versión de Java en OSX


Atelier necesita como mínimo la versión de Java 1.8 para su ejecución. pero manejar diferentes versiones de Java puede ser algo enredada en OSX (Mac)

En este artículo trato de explicar cómo manejar diferentes versiones de Java en el Mac.

El siguiente comando nos puede ayudar a aclarar algunos problemas en nuestro entorno:

$ /usr/libexec/java_home -V
Matching Java Virtual Machines (3):
  1.8.0_60, x86_64:    "Java SE 8"    /Library/Java/JavaVirtualMachines/jdk1.8.0_60.jdk/Contents/Home
  1.6.0_65-b14-466.1, x86_64:    "Java SE 6"    /System/Library/Java/JavaVirtualMachines/1.6.0.jdk/Contents/Home
  1.6.0_65-b14-466.1, i386:    "Java SE 6"    /System/Library/Java/JavaVirtualMachines/1.6.0.jdk/Contents/Home​

00
0 0 1,240

Hola a todos,

Nuestro compañero en la Comunidad @Dmitry Maslennikov  liberó la última versión de la extensión VSCode para ObjectScript hace ya un tiempo, y es momento de hacer alguna revisión de lo que aporta esta versión.

¿Qué hay de nuevo en esta versión?

  • Se ha añadido una propiedad a export, "objectscript.export.addCategory" si se habilita utiliza el comportamiento previo, añade la carpeta categoría a la carpeta de exportación, se encuentra deshabilitada por defecto
  • Se ha añadido un menú de acciones en el Servidor, haciendo clic en la información del servidor desde la barra de estado. Abre el Portal de Gestión,  la referencia de clases de la documentación y alterna la conexión.
  • Sugerencias a nivel de clases: en ##class, Extends, As, CompileAfter, DependsOn, PropertyClass
  • Sugerencia al usar $SYSTEM con clases del paquete %SYSTEM
  • Importar y compilar carpeta o fichero desde el menú de contexto en el explorador de ficheros
  • Explorador del Servidor, ahora es posible abrir cualquier otro Namespace
  • Sugerencia en el uso de Macros

Para más detalles, pueden ver los siguientes ejemplos:

00
0 0 104
Artículo
Dmitry Maslennikov · Jun 17, 2019 Lectura de 2 min
GitHub ahora soporta ObjectScript

¡Hola a tod@s! Hoy traigo buenas noticias para la Comunidad:

Hace unos días, GitHub se actualizó con la última versión del proyecto linguist, que se utiliza para reconocer los tipos de código fuente en los repositorios. Ayuda a determinar qué lenguaje de programación se ha utilizado en cada archivo del repositorio. La sección de estadísticas del repositorio muestra los resultados del trabajo de este módulo.

 

Además, se puede buscar en todos los repositorios disponibles de GitHub para cualquier idioma elegido.

00
0 0 139