<chapter id="advanced">
<title
>Uso avançado</title>

<sect1 id="command-line">
<title
>Opções de Linha de Comando</title>

<para
>Ao executar o &appname; a partir da linha de comando, existem várias opções para abrir os arquivos de dados. Elas poderão ser consultadas com o comando <userinput
>tellico --help</userinput
>. </para>

<programlisting
>Uso: tellico [opções do Qt] [opções do KDE] [opções] [arquivo]

Tellico - um gerenciador de coleções para o KDE

Opções:
  --nofile                  Não reabrir o último arquivo aberto
  --bibtex                  Importar o &lt;arquivo&gt; como um arquivo bibtex
  --mods                    Importar o &lt;arquivo&gt; como um arquivo MODS
  --ris                     Importar o &lt;arquivo&gt; como um arquivo RIS

Argumentos:
  arquivo                  O arquivo a abrir
</programlisting>

</sect1>

<sect1 id="dbus-interface">
<title
>Interface &DBus;</title>

<para
>O &appname; tem uma interface mínima de &DBus;, que pode ser usada para programar ou interagir com uma aplicação em execução, a partir da linha de comando. Como acontece com todas as chamadas de &DBus;, você terá que indicar a aplicação com que deseja interagir, assim como a interface em particular. O nome do serviço de &DBus; é <constant
>org.kde.tellico</constant
>. </para>

<sect2 id="dbus-commands">
<title
>Comandos do &DBus;</title>

<para
>Estão disponíveis dois objetos &DBus; na interface do Tellico: <constant
>Tellico</constant
> e <constant
>Collections</constant
>.</para>

<sect3 id="dbus-tellico">
<title
>O Objeto <constant
>Tellico</constant
></title>

<para
>A lista completa de comandos de &DBus; do objeto <constant
>tellico</constant
> encontra-se disponível abaixo:</para>

<programlisting
>bool importTellico(QString arquivo, QString ação)
bool importBibtex(QString arquivo, QString ação)
bool importMODS(QString arquivo, QString ação)
bool importRIS(QString arquivo, QString ação)
bool exportXML(QString arquivo)
bool exportZip(QString arquivo)
bool exportBibtex(QString arquivo)
bool exportHTML(QString arquivo)
bool exportCSV(QString arquivo)
bool exportPilotDB(QString arquivo)
QList&lt;int&gt; selectedEntries()
QList&lt;int&gt; filteredEntries()
void openFile(QString arquivo)
void setFilter(QString texto)
bool showEntry(int id)
</programlisting>

<para
>Para os quatro comandos de importação, o primeiro argumento é o arquivo a importar, e o segundo é a ação de importação. Três ações estão disponíveis: <emphasis
>replace</emphasis
> (substituir), <emphasis
>append</emphasis
> (adicionar), e <emphasis
>merge</emphasis
> (mesclar). Quatro formatos de arquivo são suportados para importação: arquivos &XML; Tellico, arquivos Bibtex, arquivos MODS e arquivos RIS. </para>

<para
>A coleção atualmente aberta no &appname; poderá ser exportada para um arquivo, sendo no formato &XML; do Tellico, no formato ZIP do mesmo, em Bibtex, &HTML;, valores separados por vírgulas (CSV) ou no formato PilotDB. </para>

<para
>Uma lista dos ID's dos elementos atualmente selecionados ou filtrados permite facilitar a apresentação ou atualização dos itens na janela.</para>

<para
>Você poderá abrir um novo arquivo de dados com o comando <command
>openFile()</command
>. Deverá indicar a localização completa.</para>

<para
>Poderá definir um novo filtro com o comando <command
>setFilter()</command
>, o qual é o equivalente a escrever o mesmo filtro no campo respectivo da janela principal.</para>

<para
>Fornecido um ID de um elemento, o <command
>showEntry()</command
> irá selecionar esse item e mostrar os seus detalhes na janela principal.</para>
</sect3>

<sect3 id="dbus-collection">
<title
>O Objeto <constant
>Collections</constant
></title>

<para
>A lista completa de comandos &DBus; do objeto <constant
>Collections</constant
> encontra-se descrita abaixo:</para>

<programlisting
>int addEntry()
bool removeEntry(int idItem)
QStringList allValues(QString nomeCampo)
QStringList entryValues(int idItem, QString nomeCampo)
QStringList selectedBibtexKeys()
QString entryBibtexKey(int idItem)
bool setEntryValue(int idItem, QString nomeCampo, QString valor)
bool addEntryValue(int idItem, QString nomeCampo, QString valor)
</programlisting>

<para
>Você poderá criar um novo elemento vazio na coleção actual, usando o comando <command
>addEntry()</command
>. O valor devolvido é o ID do elemento, que poderá ser usado para definir os valores dos campos do mesmo elemento. Você poderá apagar um elemento da coleção com o comando <command
>removeEntry()</command
>. </para>

<para
>Se invocar o <command
>allValues()</command
> com apenas um nome de campo, irá devolver todos os valores desse campo, para os itens selecionados no momento. Se não for selecionado nenhum elemento, é devolvida uma lista vazia. Se for incluído um ID de elemento no comando, são devolvidos os valores dos campos para esse elemento em particular. </para>

<para
>Se a coleção actual for uma bibliografia, a invocação do <command
>selectedBibtexKeys()</command
> irá devolver a citação do Bibtex para todos os itens selecionados. A 'bibtexKey' de um item específico poderá ser obtida com o comando <command
>entryBibtexKey()</command
>. </para>

<para
>Você poderá editar os elementos diretamente com a interface &DBus;. Fornecido um ID de elemento, o <command
>setEntryValue()</command
> irá configurar o valor do campo diretamente. Para adicionar um valor, sem afetar os valores existentes, use o <command
>addEntryValue()</command
>. O novo valor é adicionado ao fim da lista existente. </para>
</sect3>

</sect2>

<sect2 id="dbus-examples">
<title
>Exemplos de &DBus;</title>

<para
>Aqui estão alguns exemplos de programação do &appname; usando a interface &DBus;. Uma vez que o <emphasis
>pid</emphasis
> deve ser conhecido, a maneira mais fácil de descobrí-lo em um comando do console é a seguinte: <userinput
>dbus $(dbus | grep tellico) tellico</userinput
>. </para>

<screen width="40"
><emphasis
>Abrir um arquivo do Bibtex</emphasis>
<prompt
>%</prompt
> <userinput
>qdbus org.kde.tellico /Tellico org.kde.tellico.importBibtex "/home/roberto/referência.bib" "replace"</userinput>
<computeroutput
>true</computeroutput
>
</screen>

<screen width="40"
><emphasis
>Exportar um arquivo do Bibtex</emphasis>
<prompt
>%</prompt
> <userinput
>qdbus org.kde.tellico /Tellico org.kde.tellico.exportBibtex ~/documentos/referência.bib</userinput>
<computeroutput
>true</computeroutput
>
</screen>

<screen width="40"
><emphasis
>Apresentar a chave de citação da seleção atual</emphasis>
<prompt
>%</prompt
> <userinput
>qdbus org.kde.tellico /Collections org.kde.tellico.selectedBibtexKeys</userinput>
<computeroutput
>stephenson2004</computeroutput
>
</screen>

<screen width="40"
><emphasis
>Adicionar um novo elemento e modificar o título</emphasis>
<prompt
>%</prompt
> <userinput
>o_meu_id=`qdbus org.kde.tellico /Collections org.kde.tellico.addEntry`</userinput>
<prompt
>%</prompt
> <userinput
>qdbus org.kde.tellico /Collections org.kde.tellico.setEntryValue $meu_id título "Meu Livro Novo"</userinput>
<computeroutput
>true</computeroutput
>
</screen>

</sect2>

</sect1>

</chapter>