You can run a BIX extract manually from within your application.
-
In the navigation panel, click
and select the Extract rule that you want to use.
-
On the rule form, click
Run.
-
Extract to .csv and .xml output:
-
Provide the
Number of Records to Update at a Time. To run
the extract in non-batch mode for a single record at a time, set the number of records
to update at a time to 1.
-
Provide a
Unique Identifier
for the extract.
-
Click
Perform Extract
to begin extracting data from your
application. A progress bar informs you when the extract is complete.
-
Configure schema for extracting to a database before you run an extraction for the
first time:
Before extracting data to a target database, create a schema to match the extracted
data.
-
Provide the
Number of Records to Update at a Time. To run
the extract in non-batch mode, a single record at a time, set the number of records to
update at a time to 1.
-
Provide a
Unique Identifier
for the extract.
-
Click
Generate Schema DDL.
-
Provide a location and a name to use when saving the DDL.
-
Click
Perform Extract
to generate the DDL and save it in the
specified location.
-
Run the generated DDL manually in the required database to create the table.
CAUTION:
If the names of any selected properties correspond to reserved
keywords in the destination database, manually update the DDL file to either change
the property names or surround them with quotation marks. If you do not update the
DDL, a database error will occur.
-
Extracting to a database after schema has been created:
-
Provide the
Number of Records to Update at a Time. To run
the extract in non-batch mode, a single record at a time, set the number of records to
update at a time to 1.
-
Provide a
Unique Identifier
for the extract.
-
Clear the
Generate Schema DDL
check box.
-
Click
Perform Extract
to begin extracting data from your
application into the created table. A progress bar informs you when the extract is
complete.
Result:
After the extract is complete, you can access the output data at the location (or
locations, for XML output) that you specified in the
File Specifications
tab of the rule.
Note: For Pega Cloud
applications, BIX is an add-on service that Pega configures if you choose it as part of your
subscription. For on-premises applications, BIX is available when you purchase and install
the BIX application.