1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
|
/* -*- 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_configuration_backend_DataImporter_idl__
#define __com_sun_star_configuration_backend_DataImporter_idl__
#include <com/sun/star/task/XJob.idl>
module com { module sun { module star { module configuration { module backend {
/**
allows importing data from one configuration repository into another.
@since OOo 1.1.2
*/
published service DataImporter
{
/** allows running an import job
<p> The source and destination repositories are selected by arguments
passed to
com::sun::star::task::XJob::execute().
The names and meanings of such arguments depend on
the implementation. Each implementation must document such arguments.
</p>
<p> Implementations may return a value from
com::sun::star::task::XJob::execute()
that indicates the status of job execution. The type and meaning of
such status indicators depend on the implementation.
</p>
<p>If `VOID` or `TRUE` is returned, this indicates successful
execution. If an
com::sun::star::uno::Exception is returned,
it represents an error condition encountered during execution.
</p>
<p> The following arguments to
com::sun::star::task::XJob::execute()
should be supported by implementations. Implementations must document
a failure to support any of these arguments:
<dl>
<dt><code>ImporterService</code> : `string`</dt>
<dd>A service or implementation name used to instantiate the
Importer to use for importing. If this parameter
is missing, the implementation selects an appropriate importer.
By default, a MergeImporter should be used.
</dd>
<dt><code>OverwriteExisting</code> : `boolean`</dt>
<dd>If `TRUE`, specifies that no existing data should be
overwritten by the import. If the Importer used
does not support such protection, an error may be raised.
If some data is not imported, because there is existing
data, this is indicated by returning an appropriate exception.
</dd>
<dt><code>TruncateExisting</code> : `boolean`</dt>
<dd>If `TRUE`, specifies that existing data should be
discarded and replaced by the imported data.
If the Importer used does not support this
operation, an error may be raised.
By default, a CopyImporter is used to perform
truncating import.
</dd>
<dt><code>Entity</code> : `string`</dt>
<dd>An identifier for the entity in the destination backend for
which the imported data should apply. The value will be passed
to XLayerImporter::importLayerForEntity().
If this parameter is missing, the implementation uses
XLayerImporter::importLayer() instead.
</dd>
<dt><code>Component</code> : `string`</dt>
<dd>Names the component for which to import data. If this
parameter is missing, the selection of data to import depends
on implementation-specific parameters.
</dd>
<dt><code>LayerFilter</code> : LayerFilter</dt>
<dd>A filter to transform data during import. This parameter is
optional. If this parameter is missing, data will be imported
unaltered. <em>Support for this parameter is optional.</em>
If the implementation does not support a filter it will raise an
com::sun::star::lang::IllegalArgumentException.
</dd>
</dl>
</p>
*/
interface com::sun::star::task::XJob ;
} ;
} ; } ; } ; } ; } ;
#endif
/* vim:set shiftwidth=4 softtabstop=4 expandtab: */
|
