Detailed Description of Create Postal Address

Based on the input data (address components or address id) this step creates a uniform address to be printed on an envelope. There are two ways of specifying the address components: either component values given directly as columns or address id to be queried in the address reference data for components. If some fields are missing, this situation is reported by means of NULL flags, although this reporting is not generally applied to all components. There are several components that are required for generating addresses, so these must be non-empty, regardless of how they are defined. The other components may or may not be reported as missing, depending on the way how they were acquired. If the address is to be generated from the reference data, these are not reported as missing since it is assumed that this is the correct situation, whereas if defined directly, they are reported as missing. Additionally, if any of the required components are missing, the step will not generate an address . The required components are:

Components that can be missing are:

If the address cannot be generated, the CPA_CANNOT_GENERATE flag is set on.


Top of page

Example: Example
<step className="cz.adastra.cif.tasks.addresses.CreatePostalAddress" id="alg">

  <properties>
    <street>uir_street</street>
    <streetNumber>uir_sn</streetNumber>
    <landRegistryNumber>uir_lrn</landRegistryNumber>
    <localityPart>uir_locality_part</localityPart>
    <locality>uir_locality</locality>
    <postalCode>uir_postal_code</postalCode>
    <postOffice>uir_post_office</postOffice>
    <cityPart>uir_city_part</cityPart>
    <topRow>envelope_top</topRow>
    <middleRow>envelope_middle</middleRow>
    <bottomRow>envelope_bottom</bottomRow>
    <scorer scoreColumn='score_postal_address' explanationColumn='expl'>
      <scoringEntries>
                <scoringEntry key='CPA_STREET_NULL' score='100' explain='true' />
                <scoringEntry key='CPA_LRN_NULL' score='100' explain='true' />
                <scoringEntry key='CPA_SN_NULL' score='100' explain='true' />
                <scoringEntry key='CPA_LOCALITY_PART_NULL' score='100' explain='true' />
                <scoringEntry key='CPA_LOCALITY_NULL' score='100' explain='true' />
                <scoringEntry key='CPA_ZIP_NULL' score='100' explain='true' />
                <scoringEntry key='CPA_POST_OFFICE_NULL' score='100' explain='true' />
                <scoringEntry key="CPA_ADDR_ID_NULL" score="0" explain="true"/>
                <scoringEntry key="CPA_INVALID_ADDR_ID" score="0" explain="true"/>
                <scoringEntry key="CPA_CITY_PART_NULL" score="0" explain="true"/>
                <scoringEntry key="CPA_CANNOT_GENERATE" score="0" explain="true"/>
          </scoringEntries>
    </scorer>
  </properties>
</step>

// =============================================================================

<step className="cz.adastra.cif.tasks.addresses.CreatePostalAddress" id="alg">
  <binding name='addressId' column='uir_address_id' />

  <binding name='topRow' column='envelope_top' />
  <binding name='middleRow' column='envelope_middle' />
  <binding name='bottomRow' column='envelope_bottom' />

  <properties>
    <scorer scoreColumn='score_postal_address' explanationColumn='expl'>
      <scoringEntries>
                <scoringEntry key='CPA_ADDR_ID_NULL' score='100' explain='true' />
                <scoringEntry key='CPA_INVALID_ADDR_ID' score='100' explain='true' />
          </scoringEntries>
    </scorer>
  </properties>
</step>

iWay Software