Jump to content

Wikifunciones: Introducción

From Wikifunctions
This page is a translated version of the page Wikifunctions:Introduction and the translation is 55% complete.

Las funciones son instrucciones de computadora que hacen cálculos sobre datos que proporcionas y responden a las preguntas que tienes sobre ellos. Por ejemplo, cuando le preguntas a un asistente de voz cuántas millas hay en un kilómetro, el asistente de voz llama a una función para calcularlo para ti.

Wikifunciones es un proyecto de código abierto que permite a cualquiera crear funciones y compartirlas para que otros las usen, remixen, prueben y aprendan de ellas.

Utiliza las siguientes guías para probar las características básicas de Wikifunciones. ¡Esperamos tus comentarios y contribuciones!.

Evaluar una Función

¡Puedes probar las funciones aportadas por la comunidad en Wikifunciones por ti mismo! Elige una de nuestra biblioteca de funciones, y dale valores de entrada para descubrir la salida.

Pasos:

  1. Encuentra una función en la Página principal.
  2. Navega a una página de función.
  3. Ingresa los valores de entrada.
  4. Ejecuta la función.

Resultados:

  1. ¿La salida fue lo que esperabas?
  2. ¿Tienes correcciones o comentarios para reportar?

Crear una Función

¡Puedes añadir tus propias funciones a Wikifunciones! Crea una nueva función para usar en tus propias implementaciones y permite que otros la usen también. Las nuevas funciones pueden escribirse en tu lenguaje preferido.

Pasos:

  1. Ve a la página de creación de función.
  2. Nombra tu función.
  3. Define las entradas de tu función:
    1. Agrega/elimina campos de entrada.
    2. Define el tipo de cada entrada.
    3. Nombra cada entrada.
  4. Define el tipo de salida de tu función.
  5. Opcionalmente, proporciona valores multilingües para cualquiera de estos campos:
    • Nombre de la función, alias de la función, etiquetas de entrada.
  6. Publica tu función.

Resultados:

  1. ¿La función fue guardada exitosamente?
  2. ¿Tienes correcciones o comentarios para reportar?

Editar una Función

Puedes contribuir a Wikifunciones editando su biblioteca de funciones. Añade o edita información multilingüe a las funciones, y amplía y modifica las definiciones de las funciones.

Pasos:

  1. Encuentra una función en la Página Principal.
  2. Navega a la página de función.
  3. Haz clic en Editar fuente para ver las opciones de edición para esta función.
  4. Opcionalmente, modifica los valores de:
    1. Nombre de la función,
    2. Alias de la función,
    3. Lista de entradas
      1. Agrega/elimina campos de entrada
      2. Modifica el tipo de entrada
      3. Modifica las etiquetas de entrada
    4. Tipo de salida.
  5. Opcionalmente, proporciona valores multilingües para cualquiera de estos campos:
    1. Nombre de la función
    2. Alias de la función
    3. Etiquetas de entrada.
  6. Publica tus cambios.

Resultados:

  1. ¿Tus cambios fueron guardados exitosamente?
  2. ¿Tienes correcciones o comentarios para reportar?

Create tests

You can create tests for your function implementations in Wikifunctions to ensure they are working properly.

Steps:

  1. Find a function on the Main Page or the function you created in the previous workflow.
  2. Navigate to the function page.
  3. Click the “+” link in the tests table.
  4. Click on "Select Función" under "Call".
    1. In the field under "Function", type in the name of the function you are testing and select the function when it shows up.
    2. Add values for the inputs in the respective fields.
  5. Click on "Select Función" under "Result Validation". In the field under "Function", type in the name of the function you want to use to check the result.
    • For a function whose output is String, this will be "String equality", for a function whose output is Boolean, this will be "Boolean equality".
    • Add the expected value in the given field (either "Second String" or "Second Boolean").
  6. Publish your updates.

Results:

  1. Was the test successfully saved?
  2. Do you have corrections or feedback to report?

Create an implementation

Functions are brought to life in implementations created to suit your needs. Run, remix, and combine functions via implementations in Wikifunctions. See the section below to learn how to connect your implementation to functions. We recommend creating and connecting a test before creating an implementation. A more comprehensive guide to creating implementations is available at Wikifunctions:How to create implementations.

Steps:

  1. Find a function on the Main Page.
  2. Navigate to the function page.
  3. Click the “+” link in the implementations table.
  4. You can create a new implementation in one of two ways:
    1. Code
      • Select the required programming language to write the function code.
      • Input your code.
    2. Composition:
      • Create a composition using existing functions.
  5. Publish your updates (after running a test by clicking the round arrow on the right of the box titled Pruebas).

Results:

  1. Was the implementation successfully saved?
  2. Do you have corrections or feedback to report?

Connect an Implementation or Test to a Function

Note: This feature is only available to Functioneers.

Connect tests and implementations to your function to see it come to life.

Steps:

  1. Find a function on the Main Page.
  2. Navigate to the function page.
  3. Select one or more tests, or one or more implementations.
  4. Click on the button “Connect”.

Results:

  1. Was the attach/detach state successfully changed?
  2. Do you have corrections or feedback to report?