/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */ /* * This file is part of the LibreOffice project. * * This Source Code Form is subject to the terms of the Mozilla Public * License, v. 2.0. If a copy of the MPL was not distributed with this * file, You can obtain one at http://mozilla.org/MPL/2.0/. * * This file incorporates work covered by the following license notice: * * Licensed to the Apache Software Foundation (ASF) under one or more * contributor license agreements. See the NOTICE file distributed * with this work for additional information regarding copyright * ownership. The ASF licenses this file to you under the Apache * License, Version 2.0 (the "License"); you may not use this file * except in compliance with the License. You may obtain a copy of * the License at http://www.apache.org/licenses/LICENSE-2.0 . */ #ifndef __com_sun_star_text_MailMerge_idl__ #define __com_sun_star_text_MailMerge_idl__ #include #include #include #include #include #include #include #include module com { module sun { module star { module text { /** Gives access to mail merge functionality. @since OOo 1.1.2 */ published service MailMerge { /** interface to execute the mail merge action.

The com::sun::star::task::XJob::execute() method of the interface accepts exactly the same properties as provided by this service in its argument sequence.

The default values for the properties to be used in the method call are those given by this service. If a property is also listed in the argument sequence that value will be used for the call. The value of the property in this service will remain unchanged by that.

*/ interface com::sun::star::task::XJob; /** interface to cancel the current mail merge job. @since LibreOffice 4.3 */ [optional] interface com::sun::star::util::XCancellable; /** interface to access the services properties. */ interface com::sun::star::beans::XPropertySet; /** interface to notify mail merge listeners. */ [optional] interface com::sun::star::text::XMailMergeBroadcaster; /* database properties */ /** allows to specify the data which the mail merge should be based on.

This service describe the interaction between all data access related properties, namely #DataSourceName, #Command, #CommandType, #ActiveConnection, #Selection, #ResultSet, #Filter and #EscapeProcessing */ service com::sun::star::sdb::DataAccessDescriptor; /** contains the name of the data source that is to be used for merging.

For the interaction of this property with other data access relevant properties, see the com::sun::star::sdb::DataAccessDescriptor service.

*/ [property] string DataSourceName; /** determines the type of the database command as described in com::sun::star::sdb::CommandType

For the interaction of this property with other data access relevant properties, see the com::sun::star::sdb::DataAccessDescriptor service.

*/ [property] long CommandType; /** contains the database command.

For the interaction of this property with other data access relevant properties, see the com::sun::star::sdb::DataAccessDescriptor service.

*/ [property] string Command; /** provides access to a com::sun::star::sdbc::XResultSet of a com::sun::star::sdbc::ResultSet service.

Note that any superservices of com::sun::star::sdbc::ResultSet are also allowed. Especially, this member can denote an instance of the com::sun::star::sdb::RowSet, or an instance obtained by calling com::sun::star::sdb::XResultSetAccess::createResultSet() on such a com::sun::star::sdb::RowSet. This becomes important in conjunction with the #Selection property.

For the interaction of this property with other data access relevant properties, see the com::sun::star::sdb::DataAccessDescriptor service.

*/ [property] com::sun::star::sdbc::XResultSet ResultSet; /** contains the connection to the database.

For the interaction of this property with other data access relevant properties, see the com::sun::star::sdb::DataAccessDescriptor service.

*/ [property] com::sun::star::sdbc::XConnection ActiveConnection; /** contains a selection that refers to bookmarks of the ResultSet.

This property is relevant in conjunction with the #ResultSet only. A single element of this array describes a bookmark relative to the result set.
Note that this implies that the #ResultSet needs to support the com::sun::star::sdbcx::XRowLocate interface.

If this array is empty, the whole result set, as described by #ResultSet respectively the triple (#DataSourceName, #CommandType, #Command).

For the interaction of this property with other data access relevant properties, see the com::sun::star::sdb::DataAccessDescriptor service.

*/ [property] sequence< any > Selection; /** returns if escape processing is on or off.

For the interaction of this property with other data access relevant properties, see the com::sun::star::sdb::DataAccessDescriptor service.

*/ [property] boolean EscapeProcessing; /** contains a filter expression for an SQL statement.

For the interaction of this property with other data access relevant properties, see the com::sun::star::sdb::DataAccessDescriptor service.

*/ [property] string Filter; /* input properties */ /** contains the URL of a text document that is to be processed.

If this property is not set an empty document is created.

*/ [property] string DocumentURL; /** provides access to the model of the document to be processed.

This property will automatically be set to the documents model if a document URL was set.

*/ [property, readonly] com::sun::star::frame::XModel Model; /* output properties */ /** determines the destination of the mail merge action. @see com::sun::star::text::MailMergeType */ [property] short OutputType; /** determines whether single print jobs will be generated per output document.

This property is only evaluated for printer output.

*/ [property] boolean SinglePrintJobs; /** contains the path where generated files are created.

If "OutputURL" or "FileNamePrefix" are empty the missing value is generated from the location or title of the source documents.

This property is only evaluated for file output.

*/ [property] string OutputURL; /** determines whether file names of created files are generated using the content of a database column.

This property is only evaluated for file output.

*/ [property] boolean FileNameFromColumn; /** contains the name of the column to generate the output file names.

If FileNameFromColumn is true the content of the related column is added to the OutputURL.

If "OutputURL" or "FileNamePrefix" are empty the missing value is generated from the location or title of the source documents.

This property is only evaluated for file output.

*/ [property] string FileNamePrefix; /** Contains the password of the outgoing mail server. It is necessary to set this if the password is not already stored in the configuration for security reasons.

This property is only evaluated for e-Mail output.

@since OOo 2.0 */ [property, optional] string OutServerPassword; /** Contains the password of the incoming mail server. It is necessary to set this if the mail server configuration is set to "SMTP after POP" authentication and the password is not already stored in the configuration for security reasons.

This property is only evaluated for e-Mail output.

@since OOo 2.0 */ [property, optional] string InServerPassword; /** contains the subject of the e-Mail message.

This property is only evaluated for e-Mail output.

@since OOo 2.0 */ [property, optional] string Subject; /** contains the name of the data base column that contains the e-Mail address to the e-Mail to.

This property is only evaluated for e-Mail output.

@since OOo 2.0 */ [property, optional] string AddressFromColumn; /** determines that the created mail merge document is sent as body in HTML format. This property is only valid if the property "SendAsAttachment" is set to `FALSE`.

This property is only evaluated for e-Mail output.

@since OOo 2.0 */ [property, optional] boolean SendAsHTML; /** determines that the created mail merge document is sent as attachment.

This property is only evaluated for e-Mail output.

@since OOo 2.0 */ [property, optional] boolean SendAsAttachment; /** contains the text of the mail body. This property is only valid if the property "SendAsAttachment" is set to `TRUE`

This property is only evaluated for e-Mail output.

@since OOo 2.0 */ [property, optional] string MailBody; /** contains the name of the attachment. This property is only valid if "SendAsAttachment" is set to `TRUE`.

This property is only evaluated for e-Mail output.

@since OOo 2.0 */ [property, optional] string AttachmentName; /** contains the name of the document filter to save the attached mail merge document. This property is only valid if "SendAsAttachment" is set to `TRUE`.

This property is only evaluated for e-Mail output.

@since OOo 2.0 */ [property, optional] string AttachmentFilter; /** contains a list of e-Mail addresses to

This property is only evaluated for e-Mail output.

@since OOo 2.0 */ [property, optional] sequence< string > CopiesTo; /**

This property is only evaluated for e-Mail output.

@since OOo 2.0 */ [property, optional] sequence< string > BlindCopiesTo; /** determines that the output of the mail merge is save in one single file.

This property is only evaluated for file output.

@since OOo 2.0 */ [property, optional] boolean SaveAsSingleFile; /** contains the name of the document filter to save the output file(s).

This property is only evaluated for file output.

@since OOo 2.0 */ [property, optional] string SaveFilter; /** contains the properties that are defined in .

This property is only evaluated for printer output.

@since OOo 2.0 */ [property, optional] sequence< com::sun::star::beans::PropertyValue > PrintOptions; }; }; }; }; }; #endif /* vim:set shiftwidth=4 softtabstop=4 expandtab: */