V10 ResourcesGuides
ResourcesGuides
Guides
Back | List of Articles

How to set up the Collection Terminal extensibility?

Last changed in 20/07/2023

The PRIMAVERA Collection Terminal allows extensibility by using a Kalipso project with specific characteristics.

Before starting, to open this project, Kalipso 5.0 will be necessary. In this project, a set of “Global Action Sets” is available with the prefix EXT, that includes the desired code for each event. You can download the base extensibility project here.

Note: By clicking the menu Custom, the function “Global Action Sets” EXT_MenuCustom is activated, for which parameters, such as the ones identifying the selected Workstation, Operator and Work Center, are transferred.

ERP Extensibility Configuration

It is possible to set up the extensibility using the Kalipso project, by specifying the menus and records you wish to make available. After setting up the ERP extensibility, you must assign it to workstations.

The information flow is bidirectional, that is, the information retrieved in the extensibility is considered on the terminal. For example, at the end of a work log, if the modified quantity returned on the corresponding table is changed, that will be the quantity being considered.

To set up the ERP extensibility, follow these steps:

Step 1: Set up the ERP extensibility

  1. Access Production | Tools | Extensibility Configurations;
  2. Enter a code and a description;
  3. Enter the menus you wish to make available;
  4. To enter the records, double-click on the column “Code” or right-click, and select the option Insert Row;
    Note: The description will be presented on the Terminal menu Custom and the code is the form identifier in Kalipso;
  5. Specify the extensibility project (*.KZP). The extensibility project version is automatic and allows to send the project to the terminal only when the loaded extensibility version is different from the version specified on the ERP;
  6. Define the events being executed. For each process, define if you wish to execute the existing code on the extensibility project.

Step 2: Assign the extensibility to the workstations

  1. Access Production | Tables | Organization | Business Stations;
  2. Edit the station and select the tab Collection Terminal;
  3. Identify the desired extensibility configuration.

Available events

For each event, tasks are made available with contextual information. These tables allow to retrieve the relevant information on the operation in progress. The flow is bidirectional, that is, the information retrieved in the extensibility is considered on the terminal, for example, at the end of a work log, if the modified quantity returned on the corresponding table is changed, that will be the quantity being considered.

The events made available are the following:

  • EXT_1001_AntesInicioPicagem - Event presented before the work log start;
  • EXT_1001_DepoisInicioPicagem - Event presented after the work log start;
  • EXT_1001_SubstituiInicioPicagem - Event presented to replace the work log start;
  • EXT_1002_AntesInicioPicagemQuantidade - Event presented before recording quantities on the work log start;
  • EXT_1002_DepoisInicioPicagemQuantidade - Event presented after recording quantities on the work log start;
  • EXT_1002_SubstituiInicioPicagemQuantidade - Event presented to replace the recording quantities on the work log start;
  • EXT_2001_AntesFimPicagem - Event presented before the work log end;
  • EXT_2001_DepoisFimPicagem - Event presented after the work log end
  • EXT_2001_SubstituiFimPicagem - Event presented to replace the work log end;
  • EXT_2002_AntesFimPicagemQuantidade - Event presented before recording quantities on the work log end;
  • EXT_2002_DepoisFimPicagemQuantidade - Event presented after recording quantities on the work log end;
  • EXT_2002_SubstituiFimPicagemQuantidade - Event presented to replace the recording quantities on the work log end;
  • EXT_2003_AntesFimPicagemConsumo - Event presented before the manual component consumption on the work log end;
  • EXT_2003_DepoisFimPicagemConsumo - Event presented after the manual component consumption on the work log end;
  • EXT_2003_SubstituiFimPicagemConsumo - Event presented to replace the manual component consumption on the work log end;
  • EXT_2004_AntesFimPicagemQualidade - Event presented before the quality record on the work log end;
  • EXT_2004_DepoisFimPicagemQualidade - Event presented after the quality record on the work log end;
  • EXT_2004_SubstituiFimPicagemQualidade - Event presented to replace the quality record on the work log end;
  • EXT_2005_AntesFimPicagemClique - Event presented by clicking the finish button;
  • EXT_3001_AntesConsumoManual - Event presented before the manual component consumption;
  • EXT_3001_DepoisConsumoManual - Event presented after the manual component consumption;
  • EXT_3001_SubstituiConsumoManual - Event presented to replace the manual component consumption;
  • EXT_4001_AntesInicioParagem - Event presented before the stoppage start;
  • EXT_4001_DepoisInicioParagem - Event presented after the stoppage start;
  • EXT_4001_SubstituiInicioParagem - Event presented to replace the stoppage start;
  • EXT_4002_AntesFimParagem - Event presented before the stoppage end;
  • EXT_4002_DepoisFimParagem - Event presented after the stoppage end;
  • EXT_4002_SubstituiFimParagem - Event presented to replace the stoppage end;
  • EXT_9001_AntesAplicacaoAoAbrir - Event presented when opening the app.

Included processes

For each process, there can be three types of events:

  • Before: These events occur before starting an operation;
  • Replace: These events replace the terminal implementation for operation, specifying that the operation will be performed on the extensibility project and the terminal code will not be executed;
  • After: These events are executed after finishing the operation.

This way, it is possible to intervene before, after or as a replacement, and when intervening as a replacement, the terminal will not perform any action. The necessary code to execute the operation will be implemented on the extensibility project.

Important note: The EXT_2005_AntesFimPicagemClique and EXT_9001_AntesAplicacoAoAbrir events only allow to intervene on the type of event before.

It is worth noting that, when clicking the menu Custom “GAS” “EXT_MenuCustom” is executed, and you must specify in this function the desired code for the action. You can download the base extensibility project here.

The tables made available on the extensibility project are the following:

Work log start and end (EXT_Picagem)

IDCentroTrabalhoINT
IDOperadorINT
IDOrdemFabricoINT
IDDiarioTrabalhoPendenteINT
QuantidadeFabricadaDECIMAL
QuantidadeRejeitadaDECIMAL
EntradaStockDECIMAL
OperacaoTerminadaBIT
EntradaStockArmazemSTRING
EntradaStockLocalizacaoSTRING
EntradaStockLoteSTRING
IDOrdemFabricoOperacaoINT

Component consumption (EXT_Consumos)

IDOperadorINT
IDOrdemFabricoOperacaoINT
IDOrdemFabricoComponenteINT
IDOrdemFabricoComponenteGuidSTRING
ArtigoSTRING
DescricaoArtigoSTRING
UnidadeSTRING
ArmazemSTRING
LocalizacaoSTRING
LoteSTRING
EstadoInventarioSTRING
IDReservaStockSTRING
QuantidadePrevistaDECIMAL
QuantidadeConsumidaDECIMAL
TrataNumerosSerieBIT

Quality records (EXT_Qualidade)

IDOrdemFabricoOperacaoINT
IDGamaINT
FactorSTRING
DescricaoFactorSTRING
PosicaoINT
TipoINT
ValorObservadoSTRING
ArmazemSTRING
LoteSTRING

Table user fields GPR_DiarioTrabalho (EXT_CamposUtilDT)

IDOperadorINT
IDOrdemFabricoOperacaoINT
NomeSTRING
ValorSTRING
TipoSTRING

Documents resulting from the work log (EOF+SOF) (EXT_Documentos)

IDOrdemFabricoOperacaoINT
IDDocumentoEntradaOrdemFabricoSTRING
IDDocumentoSaidaOrdemFabricoSTRING
IDDiarioTrabalhoINT
IDOperadorINT

Serial number consumption (EXT_ConsumosNumerosSerie)

IDOperadorINT
IDOrdemFabricoComponenteGuidSTRING
IDOrdemFabricoOperacaoINT
IDNumeroSerieSTRING
NumeroSerieSTRING
ArmazemSTRING
LocalizacaoSTRING
LoteSTRING
EstadoStockSTRING
IDReservaSTRING

Paragens (EXT_Paragens)

IDParagemINT
IDCentroTrabalhoINT
IDOrdemFabricoINT
IDTipoAvariaINT
IDTipoParagemINT
DataInicioDATETIME
DataFimPrevistaDATETIME
DataFimDATETIME
DuracaoINT

Update Extensibility Project

To allow you to update the extensibility project without having to redo all the specific developments in the new version, we recommend the following procedure:

  1. Copy the KZC file from the main project (TR_PMV10.kzc), provided in the Components folder of the new extensibility project to the Components folder of the extensibility project currently in use;
  2. Open the extensibility project currently in use to update the database;
  3. Copy the new functions in the new extensibility project to the extensibility project in use and implement them (you only need to copy the functions you want to implement).
Bookmark or share this article
Esta página foi útil?
Obrigado pelo seu voto.

login para deixar a sua opinião.

Obrigado pelo seu feedback. Iremos analisá-lo para continuarmos a melhorar!
Artigos Relacionados
Começar a Usar Como criar um projeto de integração com Visual Studio? Como criar um projeto de extensibilidade de interface (PEX) com Visual Studio? Como criar um projeto de extensibilidade de API (Motor) com Visual Studio? Como criar separadores do utilizador com Visual Studio?