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

How to Call an External Program from Sage ERP X3

Origen fuente:   https://www.rklesolutions.com/blog/sage-x3-call-external-program November 20, 2014 By Denise Hartman Leave a Comment It is sometimes useful to be able to access external programs, such as .exe files, from the  Sage ERP X3   menu. Below are instructions for adding a menu item to Sage X3 that references a .Net .exe. COPY THE .EXE FILE TO THE SAGE X3 DIRECTORY The example used here uses the  Callui  function in the Sage X3 code to call OpenFile, and references the .exe program using the parameter UILocalDir. The program being executed must reside in a pre-defined list of directories available to this function. Depending on the parameter used for UILocalDir, the .exe should be copied to one of the 3 directories below. Temp Report RtsTemp Below is an excerpt from the X3 Help, which defines where each of these directories resides within the Sage ERP X3 client installation. In this example, the Temp directory is used. Bel...
Leer más

Sage X3 Create a new CLOB Text

Here how to create a CLOB text Funprog F_CRELOB ( YABRFIC , YTEXTE ) Value Char YABRFIC Value Char YTEXTE Local Char XXRTFTXT ( 250 ) ( 3 ) XXRTFTXT ( 0 ) = "{\rtf1\ansi\ansicpg1252\deff0\deflang1033{\fonttbl{\f0\fswiss\fprq2\fcharset0 MS Sans Serif;}}\viewkind4\uc1\pard\f0\fs17 " XXRTFTXT ( 1 ) = YTEXTE XXRTFTXT ( 2 ) = "\par}" Local Char X_RET Local Integer XXOK Local Char XCHAMPLIEN : XCHAMPLIEN = "YYYY" Global Char YYYY : YYYY = YABRFIC Local Clbfile WWCLOB Local Mask ACLOB [ M :ACL ] Setlob WWCLOB With XXRTFTXT [ M :ACL ] CLOB = WWCLOB Call CRE_CLOB_ACL ( XCHAMPLIEN , XXOK ) From TRTX3TEX Close Local Mask [ M :ACL ] X_RET = YYYY Kill YYYY End X_RET
Leer más