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

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 create an additional line text (ACLOB) on purchase orders for internal notes

Sin conexión Kyle Klinger hace 1 día Origen:  https://www.sagecity.com/support_communities/sage_erp_x3/f/sage-x3-general-discussion-forum/143870/how-to-create-an-additional-line-text-aclob-on-purchase-orders-for-internal-notes I was trying to add internal notes to the purchase orders at a line level and was thought I would share a how to.  If you have a better way, please share.     Add column to PORDERQ; YLINTEX2, Type TXC   Save and validate table This is where the ID of the text will be stored at the record level, i.e. POQ~00000007, this is similar to field LINTEX  On screen POH2 Add column YLINTEX2, to Block 1. Most likely you will want this field to be hidden. On column NBLIG add a button action ACLOB2, description "Text internal" This button action will require an action parameter "CODE2", it will not be available until after save. Set the parameter "CODE2" to [M:POH2]YLINTEX2(nolign-2), the field that was just added....
Leer más

3 ways to send a mail from code in Sage X3, with more attachments too

Origen Fuente:  https://en.sagedev.it/sagex3/send-mail-from-code-with-attachments-sage-x3/ Autor:  https://en.sagedev.it/category/sagex3/ In this post I’ll show you how to send a mail from adonix code in Sage X3. The points we will face are: 1) Meladx/Send introduction 2) Sending  through  meladx (the best way for me: at the end with just a single code line you send a mail!) 3) Sending  through  Workflow 4) Sending  through  ENVOI_MAIL(…) From AWRKMEL Sending mail from code in Sage X3: Send vs meladx Sage X3 has two native ways for sending mails. The first way is  meladx  executable file, that you can find in  runtime\bin  directory. The seconde one is Send instruction, that was used to send mail through an application of the client station (for more information on “Send GSERMES”  go here ). The Meladx executable Meladx send messages through SMTP/POP3 protocols by means of the mail  ...
Leer más