One or more recipient data can be passed to the recipient dialog. The schema for ContactList or ContactItem is not part of this specification.

<?xml version="1.0" encoding="UTF-8"?>
<OneOffixxConnectBatch xmlns="http://schema.oneoffixx.com/OneOffixxConnectBatch/1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <Entries>
    <OneOffixxConnect>
      <Arguments>
        <TemplateId>6bb49520-1ebd-4f68-bb5f-02f46a9e1ec8</TemplateId>
        <LanguageLcid>2055</LanguageLcid>
      </Arguments>
      <Function name="Recipient" id="b9e8ec94-bec0-418a-b985-c565ac3bec23">
        <Settings>
          <Value key="ShowDialog">false</Value>
        </Settings>
        <!-- Passing the actual values take place within the tag argument -->
        <Arguments>
          <!-- List of all recipients -->
          <ContactList>
            <!-- Single recipient -->
            <ContactItem Selected="true" id="123456789">
              <!-- Address type (description below)-->
              <AddressType>CompanyAndPersonData</AddressType>
              <!-- Business data -->
              <Company>
                <CompanyName>
                  <Line>PrimeSoft AG</Line>
                </CompanyName>
                <Supplement>CUSTOM SOFTWARE SOLUTIONS AND TEMPLATE MANAGEMENT SOFTWARE</Supplement>
                <Department>Department</Department>
                <Address>
                  <Street>Bahnhofstrasse 4</Street>
                  <CareOf>c/o</CareOf>
                  <Apartment>Apartment</Apartment>
                  <Floor>Floor</Floor>
                  <City ZipCode="8360">Eschlikon TG</City>
                  <PostOfficeBox>PostOfficeBox</PostOfficeBox>
                  <PostOfficeBoxCity />
                  <Country ShortCode="CH">Switzerland</Country>
                </Address>
                <!-- business communication data -->
                <Communication Type="Language" Prefered="false">Deutsch</Communication>
                <Communication Type="Mobile" Prefered="false">0041715110511</Communication>
                <Communication Type="Email_direct" Prefered="false">info@oneoffixx.com</Communication>
                <Communication Type="Email_central" Prefered="false" />
                <Communication Type="Phone_direct" Prefered="false">0041715110511</Communication>
                <Communication Type="Phone_central" Prefered="false">0041715110511</Communication>
                <Communication Type="Fax_central" Prefered="false">0041715110512</Communication>
                <Communication Type="Homepage" Prefered="false">www.oneoffixx.ch</Communication>
              </Company>
              <!-- Personal data -->
              <Person>
                <Title>Title</Title>
                <LastName>Doe</LastName>
                <FirstName>John</FirstName>
                <!-- SecondName stands for another surname. 
                     Complete name is composed like this:
                     FirstName LastName SecondName
                -->
                <SecondName>Pete</SecondName>
                <NickName>NickName</NickName>
                <Birthday>1980-12-10</Birthday>
                <Profession>Profession</Profession>
                <Position>Position</Position>
                <Initials>JD</Initials>
                <SalutationShort>Mr.</SalutationShort>
                <Salutation>Dear Mr.</Salutation>
                <Greeting>Best regards</Greeting>
                <Address>
                  <Street>Bahnhofstrasse 4</Street>
                  <CareOf>c/o</CareOf>
                  <Apartment>Apartment</Apartment>
                  <Floor>Floor</Floor>
                  <City ZipCode="8360">Eschlikon TG</City>
                  <PostOfficeBox>PostOfficeBox</PostOfficeBox>
                  <PostOfficeBoxCity />
                  <Country ShortCode="CH">Schweiz</Country>
                </Address>
                <!-- private communication data -->
                <Communication Type="Language" Prefered="false">Deutsch</Communication>
                <Communication Type="Email_direct" Prefered="false">j.doe@gmail.com</Communication>
                <Communication Type="Phone_direct" Prefered="false">0041712449005</Communication>
              </Person>
              <!-- Address supplier's information -->
              <AddressProviderData Id="urn:uuid:b4f420fda52419f2">
                <ProviderName>tel.search.ch</ProviderName>
                <Label Type="text">Doe, John/nBahnhofstrasse 4/n8360 Eschlikon/TG/n*071 511 05 12</Label>
                <Links>
                  <Link Type="WebPage">tel.search.ch</Link>
                </Links>
              </AddressProviderData>
              <!-- Transmission information -->
              <Transmission Text="Eingeschrieben">
                <DocumentLanguage>English</DocumentLanguage>
                <TypeOfDistribution>Registered</TypeOfDistribution>
              </Transmission>
              <ExtendentFields>
                <Item Key="Dynamic.Test">Field for internal data</Item>
              </ExtendentFields>
              <!-- Display settings (description below) -->
              <ContactViewOptions SelectedAddress="Business" />
            </ContactItem>
          </ContactList>
        </Arguments>
      </Function>
    </OneOffixxConnect>
  </Entries>
</OneOffixxConnectBatch>

AddressType

CAUTION
To specify whether the private or the business address is used, SelectedAddress in ContactViewOptions must be used.

Value	Description

Value	Description
CompanyData	Company-only address (legal person) without contact person (business contact)
PersonData	Person-only address (natural person) without company data (private contact)
CompanyAndPersonData	Company address incl. contact person (private and business data available)

ContactViewOptions

Attribute	Description	Allowed values

Attribute	Description	Allowed values
SelectedAddress	Controls whether business or private addressing is used.	Business, Private
AddressingType	Controls whether the recipient receives the document directly or as a copy.	An, Cc, Bcc
ShowProviderLayout	Controls whether the address layout is created by primedocs or the address provider's layout is used.	true, false
PersonOverFirm	Controls whether the name of the contact person is displayed above the company name in the address. → for a personal / confidential addressing	true, false
CountryView	Controls whether the country is displayed in the address.	true, false
CountryCodeView	Controls whether the country abbreviation is displayed in the address.	true, false
SalutationView	Controls whether the salutation is displayed in the address.	true, false
SalutationSeparatetLine	Controls whether the salutation is displayed on a separate line.	true, false
SecondNameView	Controls whether the second name is displayed.	true, false
PositionView	Controls whether the position respectively the function of the person is displayed.	true, false

primedocs: technical documentation

Recipient in Connect

AddressType

ContactViewOptions