FRAMEWORK - Framework (Línea Protheus) - MI - Componentes - Función POSICIONE()

Tiempo aproximado de lectura: 00:05:00 min

Duda
Como utilizo la función POSICIONE() ?

Ambiente
FRAMEWORK - Framework (Línea Protheus) - MI - Componentes - Todas las versiones 12

Solución

Sintaxis

POSICIONE( <cAlias>, <nOrdem>, <cChave>, <cCampo> )

Propósito

Devuelve el contenido del campo de un archivo de datos, de acuerdo con una clave de búsqueda.

Argumentos

<cAlias>

Define el alias del archivo cuyo campo tendrá su contenido devuelto.

<nOrdem>

Define el índice que se utilizará para la búsqueda. Se informa el orden del índice.

<cChave>

Clave de búsqueda utilizada para encontrarse el registro del cual se devolverá el contenido de un determinado campo.

<cCampo>

Define el nombre del campo cuyo contenido se devolverá.

Utilización

Se recomienda que la utilización de la función POSICIONE() se proteja con la utilización de las funciones GETAREA() y RESTAREA(), dependiendo de la aplicación. Con ello, se graba el entorno anterior, pues la función POSICIONE() desmarca el puntero del archivo.

Ejemplos

En este ejemplo, la función POSICIONE()busca el archivo SB1, en el orden 1, para retornar el contenido del campo B1_DESC.

LOCAL cDesc := “”

cDesc := POSICIONE(“SB1”, 1, xFilial(“SB1”) + AB2->AB2_CODPRO, “B1_DESC”)