Development > Utilities > Patches > Automatic patch creation 

This function is used to create a patch file including all the elements created or modified between two dates, if required marked by an activity code.

There is the possibility to define the elements that are to be patched and proceed in two different fashions :

  • either by a direct file generation (the number of elements present by type being listed).
  • or by generation of a patch file containing only the list of the elements. In this case, this file will be re-read in the patch function to change the complete list of elements involved and make possible any modification.

Screen management

Preliminary selection window

Presentation

On starting the function, a first window is displayed, which is used to define the search criteria for the elements to be patched.

Close

 

Fields

The following fields are present on this tab :

Criteria

  • Start date (field DATDEB1)

Used to define an interval for the date to be selected for the elements to be patched. The date of the last modification is used for the modified elements and the creation date is used for the newly created elements.

  • End date (field DATFIN1)

 

 

Block number 3

  • Script to run (field TRT)

If a process is entered here, it will be added, in the form of an execution request (EXE) in the patch file to be created. Thus, on the integration of the patch, the process in question will be executed in each folder to be processed.

Table Objects

  • Code (field CODE1)

Defines the different element types likely to be integrated in the patch file.

  • Object title (field LIBEL1)

Title associated to the previous code.

  • Y/N (field PATCH1)

The search for the number of objects to patch is made uniquely for elements where this field is set to Yes.

Table number 2

This field is used to define the language that should be patched. If it is entered, only the texts in this language will be extracted on the generation of the patch.

Table number 3

If an activity code is entered, it is used as a filter on the search for elements to be patched.

Close

 

 

Functions accessed by right click on the grid

Detail
Yes to all the rest

When there is an grid with multiple choice entries with a choice of response Yes / Noon each line, this function is used to respond Yes to all the lines from this line.

No to all the rest

When there is an grid with multiple choice entries with a choice of response Yes / Noon each line, this function is used to respond No to all the lines from this line.

Standard rerouting action
Standard rerouting action

Validation window

Presentation

Once the first window is entered and validated, the selection process is executed (a progress window displays the selection in process), and after a few moments, a second window opens. The information relative to the search result is displayed in this window and there is then the possibility to complete this entry to directly create the patch file.

Close

 

Fields

The following fields are present on this tab :

Type of patch

  • Type of patch (field TYPPTC)

The patch type can take the following values :

  • Standard : this is a patch that is likely to be installed in a list of folders that will be given on the integration, this list integrating in principle the supervisor folder. In the majority of cases (including the specific/custom and vertical developments), it is the type of patch to be used. In fact, the delivery of specific/custom or vertical developments is not conditioned by the type of patch, but by the list of activity codes that are given in the corresponding grid.
  • Supervisor  : this is a patch that will only be integrated in the supervisor folder. This type is used in order to integrate pre-parameterization elements (import/export templates, automatic journals, Workflow rules...) that may have been modified in the different folders. To avoid the deletion of the modification carried out, only the supervisor folder will be updated. This is used to have the pararmeterization values up to date in the case of the creation of a new folder and also used to manually update by copy in each folder after having used the existing comparison utilities.
  • Vertical : this is a patch identical to the standard patch, but it is used, when a screen is patched, to delete specific/custom actions (SPV) not present in the patch.
  •  Specific : this is a patch identical to the standard patch, but it is used, when a screen is patched, to delete specific/custom actions (SPE) not present in the patch.

In the previous versions, a patch of the type SPX is used to delete an SPE action present in a screen. From version 150, these last two types of patch, much more flexible, are used to update the SPE actions (which previously existed) and the SPV action (which are new).

Important note : The patches containing the documentation elements are processed in a particular fashion, described in the corresponding appendix.

File

  • field AW

 

  • Destination type (field TYPEXP)

 

  • Patch (field VOLFIL)

 

  • Direct generation (field FLAGPAT)

If the box is checked, the extraction will be made on the list of selected elements without any other filter being possible. If this box is not checked, the patch file that will be created will only contain a header with the list of elements to be patched. Recall the file in manual patch creation, in order to generate this file and its contents. The question Load object? will then be asked. By responding Yes to this question, the patch header will be loaded in its entirety. It will be possible to manually modify the detailed list of object to patch, to complete it and to finally launch the extraction of patch elements to re-write the patch file with, at the same time, the header file listing the elements and their contents.

Block number 3

  • Start date (field DATDEB)

Used to define an interval for the date to be selected for the elements to be patched. The date of the last modification is used for the modified elements and the creation date is used for the newly created elements.

  • End date (field DATFIN)

 

  • Minimum version (field VERSION)

This minimum version code is used to avoid the integration of the patch with an inferior version in an application.

Table Objects

  • Code (field CODE)

Define the codes for the element types likely to be written in the patch file.

  • Object title (field LIBEL)

Title associated to the previous code.

  • Number (field NB)

Indicate the number of the element for each type found during the preliminary search for the elements to be patched. The detail can be viewed by right click on the line.

  • Y/N (field PATCH)

Final possibility to refuse or to select the objects to patch.

Close

 

Functions accessible by right click on the
Detail

Used to view the detailed list of patched elements on the line, where only the number is given.

Yes to all the rest

When there is an grid with multiple choice entries with a choice of response Yes / Noon each line, this function is used to respond Yes to all the lines from this line.

No to all the rest

When there is an grid with multiple choice entries with a choice of response Yes / Noon each line, this function is used to respond No to all the lines from this line.

 

Fermer

 

List of possible elements in automatic patch

All the elements likely to be patched can be in automatic patch. The grid shown below gives the list :

Code

Meaning

Name

Rank

AAA

 Lines arising from a setup model

Specific format, see corresponding section

100 

ABA

Batch recurring task

Recurring task code

46

 ABF

BI Fact table

Table code

54

ABG

Group of tasks

Group code

47

ABI

BI Dimension

Dimension code

55

ABM

BI Datamart

Datamart code

56

ABO

Report Business Objects

Report code

58

ABT

Batch task

Task code

45

ABV

BI Synchronization rule

Code of the rule

57

ACL

Control table

Table code

18

ACN

Inquiry

Inquiry code

36

ACS

Access codes

Dealt with in the form of a condition (CODACS="value")

14

ACT

Action

Action code

16

ACV

Definition of an activity code

Activity code

1

ADC

Description of a processing (dictionary)

Processing name

9

ADF

Documentation links

Type ~ Element code

50

ADI

Contents of a miscellaneous table

Table number

24

ADO

Functional help (all paragraphs)

Type ~ Help code

49

ADP

Parameter (both its definition and value if they exist at the general level)

Parameter code

32

Sales Management

Setup of a miscellaneous table

Table number

23

ADX

Processing (only in its compiled form)

Processing name

11

ADZ

Field help

Help code

48

AEN

Import/export sequencing

Dealt with in the form of a condition (CODE="value")

35

AFC

Function

Function code

17

AGB

Global variable

Variable name

20

AHH

BI Hierarchy

Hierarchy code

59

AHI

Purge formulas

Formula code

7

AII

BI predefined condition

Condition code

60

ALH

Query tool

Code for the query

51

ALQ

SQL query tool

Code of the SQL query

52

ALT

Graphical requester

Code for the query

53

AMK

Screen

Screen code

28

AML

Local menu

Local menu number

2

ANG

Navigation

Navigation code

10

ANM

Definition of a counter:

Code of the counter

15

ANT

Widget Netvibes setups

Object code for widget

65

AOB

Definition of an object

Code of the object

30

AOE

Import/export template

Template code

34

AOP

Object properties

Code of the object

31

APH

Setup models

Model code

100

APR

Graphical process

Process code

63

ARP

Report definition in the dictionary

Report code

29

ASL

Conditioned style

Dealt with in the form of a condition (COD="value")

19

ASU

Description of a sub-program in the dictionary

Name of the sub-program

21

ASY

Presentation style

Style code

61

ATB

Table definition (the contents are not transferred, the update of the structure is made without losing common data)

Table code

25

ATN

Transactions

Transaction code

8

ATY

Data type

Code of the type

22

AUR

URL

URL code

27

AVW

View

Code of the view

26

AWA

Workflow rule

Code of the Workflow rule

43

AWE

Web service

Publication name

64

AWI

Window definition

Code of the window

33

AWM

Workflow data model

Model code

41

AWR

Workflow assignment rule

Code of the assignment rule

42

AWW

Setup of the Workflow workbench

Code of the workbench

44

BIA

 BIAR objects

Object code

4

ELT

Element of the client interface (xsl, image, miscellaneous file)

File path

3

ETA

Crystal Reports report (file with .rpt extension)

Report name

13

EXE

Request to run a processing

Processing name

6

GAU

Automatic journals

Document code

40

PS1

Statistical trigger

Trigger code

37

PS2

Statistical code

Statistical code

38

TAB

Complete structure and contents of a table (excluding its "dictionary" definition).
The global patch of a table is a flat backup of this file: similar to a .dat file of a table backup in the SVG directory. Not all the links to this table are taken into account and especially the translatable texts contained in the ATEXTRA table.

Table code

39

TFO

Formula table

Formula code

62

TRT

Source of a processing (the processing will be compiled on patch installation)

Processing name

12

TXT

Text file (in the TXT directory)

Text name

5

Table abbreviation

Partial contents of the table

Extraction condition (expressed in the form of a Where clause)

100

Error messages

The only error messages are the generic ones.

Tables used

SEEREFERTTO Refer to documentation Implementation