function drupal_build_form

Hola John,

La función drupal_build_form retorna un arreglo renderizable el cual obtiene luego de construir o reconstruir el formulario que recibe en el parametro $form_id.

Bien, ahora porque te digo que construye o reconstruye el formulario, básicamente es porque si estas invocando el formulario por primera vez esta función te va a retornar el formulario que se haya construido en su correspondiente función, que es por supuesto la que recibe en el parámetro $form_id, y las alteraciones que se le hayan realizado a este. Ahora bien si ya haz renderizado el formulario y se esta invocando el action de este, lo que va a pasar es que la función drupal_build_form se encargará de validar el formulario teniendo en cuenta los valores de entrada que se hayan agregado, en caso de que este no tenga errores se invocarán los submits y normalmente hará una redirección, en muchos casos a la misma pagina. Pero si el envío del formulario tiene errores o el formulario es de múltiples pasos y aun no se han completado, lo que está función hace es reconstruir el formulario teniendo en cuenta los errores o devuelve el arreglo renderizable para el paso que sigue según sea el caso.

Espero sea suficiente la explicación que te doy.

Saludos,