Ir al contenido principal

Lanzar una solicitud de ejecución por lotes

Origen: Sage X3 https://online-help.sageerpx3.com/erp/12/technical-online-help/

El siguiente subprograma lanza la ejecución de una solicitud por lotes V6 desde el código nativo V7.

Principios principales de una tarea por lotes V6

Una tarea por lotes V6 está asociada con una función X3 que ejecuta una acción utilizando la plantilla de procesamiento estándar . A continuación, se define una ventana de criterios con máscaras asociadas. Debe proporcionar todos los parámetros necesarios para la ejecución de la tarea por lotes completando todos los campos de estas máscaras.

Por estas razones, llamar al ASYRMNGTREQ.CRERQTsubprograma requiere que defina los campos de máscara completando los valores correspondientes.

Definición de subprograma

La API se llama con el funprog correspondiente:

Func ASYRMNGTREQ.CRERQT(ACTX,FOLD,USER,TASK,DAT,TIM,ARYPAR,ARYVAL,NBPAR,REQUEST,MESSAGE)

Los parámetros son los siguientes:
* ACTXes el contexto actual.
* FOLDes el nombre de la carpeta.
* USERes el código de usuario para la ejecución.
* TASKes el nombre de la tarea.
* DATes la fecha de la ejecución solicitada y TIM es una cadena que contiene la hora solicitada con el formato hh:mmo hhmm.
* ARYPARes una matriz de cadena que contiene el nombre de los campos que se deben completar en la máscara de parámetro. El valor del parámetro correspondiente se proporciona en formato de cadena en el mismo índice de la matriz ARYVAL. El número de parámetros viene dado por el valor entero NBPAR.

El formato de cadena para los ARYVALvalores es el siguiente:
* Una cadena que contiene dígitos para los menús locales (por ejemplo, "12").
* Una cadena que contiene una representación numérica de números enteros o decimales (por ejemplo, "-2" o "3,1415926").
* Una cadena que contiene una fecha en formato AAAAMMDD (por ejemplo, "19590529").
* Si espera que una cadena o un clob supere los 250 caracteres, puede tener varias entradas sucesivas ARYPARcon el mismo nombre de variable y dividir los valores de la cadena en trozos de 250 caracteres o menos. Los diferentes valores se concatenarán para obtener el valor completo del parámetro.

El valor devuelto por esta API es 0 si la solicitud se ha lanzado correctamente. En este caso, REQUESTdevuelve el ID de solicitud. Si ocurre un error, el valor devuelto será diferente de 0 y el MESSAGEvalor devolverá el mensaje de error correspondiente.

Esta API se puede iniciar desde dentro de una transacción de base de datos en ejecución. No se crea ningún archivo de registro.

Ejemplo

# Create a request in folder X3 to revalidate the current folder today at 23:00
Funprog VALID_MY_FOLDER
Local Integer ASTATUS , NBPAR , REQUESTID
Local Char TBPAR(30)(1..10) , TBVAL(250)(1..10) , TIM(8) , MESSAGE(250) , TACHE(30) , DOSSIER(30) , USER(10)
Local Date DAT

  DAT = date$
  TIM = "23:00"
  TASKNAME = "VALDOS"
  FOLDER = "X3"
  USER = GACTX.USER
  NBPAR  = 1 : TBPAR(NBPAR) = "DOSSIER(0)" : TBVAL(NBPAR) = GACTX.AFOLDER
  NBPAR += 1 : TBPAR(NBPAR) = "NBDOS"      : TBVAL(NBPAR) = "1"
  NBPAR += 1 : TBPAR(NBPAR) = "TRADIF"     : TBVAL(NBPAR) = "1"
  NBPAR += 1 : TBPAR(NBPAR) = "VALDIF"     : TBVAL(NBPAR) = "2"
  ASTATUS = func CRERQT(GACTX,FOLDER,USER,TASKNAME,DAT,TIM,TBPAR,TBVAL,NBPAR,REQUESTID,MESSAGE)

  If ASTATUS=0
    MESSAGE="Request #"+num$(REQUESTID)+" launched successfully"
  Else
    MESSAGE="Error #"+num$(ASTATUS)+": "+MESSAGE
  Endif

End MESSAGE

Entradas populares de este blog

SAGE X3 SILENT IMPORT (IMPORTSIL) WITH ERROR CATCHING

FUENTE ORIGINAL: https://pluginx3.com/en/blog/post/sage-x3-silent-import-importsil-with-error-catching.html You already know how to manually generate a CSV file in order to import it threw a template in Sage X3. But If you wonder how to catch detailed errors after a silent import here is the solution. Sometimes you need to catch the incoming errors in order to alert the end-user regarding an issue. Closed period, wrong date etc …. Unfortunalty the standard Sage X3 silent import function doesn’t natively show the detailed errors during the import process. Call IMPORTSIL([M:IMP2]MODIMP,[M:IMP2]NOMIMP) From GIMPOBJ And the standard function ERR_IMPORT will only show the overall status of the importation and not the detailed errors. IMPORTSIL function is pushing all the log data into a tracefile in order to avoid any popup on end-user screen. So you have a log file available in order to search for errors in it. Sage X3 runtime is using the same principals standards as any shell for log...
Leer más

Valores de fstat

Fstat fstat  is a numeric status that is returned upon execution of a database operation, a sequential file operation, or a lock instruction. Syntax fstat Examples # MYTABLE is a table with a key called KEY1, that has a unique component called KEYVAL # Create a record in the table MYTABLE with they key value 1 if it doesn't exist Local File MYTABLE [MYT] Read [MYT]KEY1=1 If fstat [MYT]KEYVAL=1 : Write [MYT] If fstat MSG="The key was created in the mean time" Else MSG="Key created" Endif Else MSG="Key already exists" Endif Details fstat  is always set to '0' if the operation is successfully completed, and has a non-null value if there is an error: In a sequential read ( Getseq  and  Rdseq ),  fstat  is set to '1' at the end of the file. On  Lock ,  fstat  is set to '1' if the lock could not be performed. For a database operation ( Read ,  Look ,  Readlock ,  For ,  Write ,  ...
Leer más

How To Add a Custom Selector for the Screen Field

Fuente original del artículo:   https://www.rklesolutions.com/blog/how-to-add-a-custom-selector-for-the-screen-field January 5, 2022 By RKL Team Leave a Comment There may be times when you want to add a pop-up window to select a field for a screen. Sometimes this can be handled automatically if the field is a standard X3 object field (i.e. when selecting a product with a type of ITM from the ITMMASTER table). There may be other times where a standard look-up is not available, and some custom code is required to do the selection window. We'll show you how to add a custom selector of your choosing to the screen field. ADD SELECT ON SCREEN FIELD The first step is to add the appropriate code to the field on the screen in Sage X3: Go to  Development > Script Dictionary > Screens Select Your Screen Select the field to have the lookup for  by moving your cursor to it on the screen. The field should show with a blue background. Select a type of "Selection" , and an  ac...
Leer más