Antes de incluir um novo relatório em ReportDefintions.xml,
crie um novo modelo de relatório no Crystal Reports Designer.
Para incluir um novo relatório em ReportDefinitions.xml:
- Use um editor XML para abrir ReportDefinitions.xml,
localizado em <ier_install_path>\Config.
- Localize a matriz para o modelo de dados usado em seu armazenamento de objetos
de plano de arquivos (FPOS). O arquivo xml contém uma matriz para relatórios
DoD, relatórios DoD classificados, relatórios PRO e relatórios BASE.
- Inclua uma nova tag de valor (por exemplo, <value>42</value>).
Este valor é um número inteiro que identifica o relatório criado no
Crystal Reports Designer e é exclusivo para cada relatório. Este valor é
igual ao número de relatórios existentes mais 1.
- Dentro de <List key="ReportDefinitions">, inclua <object
key="reportDefinition"> para seu novo relatório. Se houver um relatório existente que seja semelhante ao relatório
criado:
- Copie a chave do objeto reportDefinition inteira do relatório
existente no arquivo XML.
- Cole a chave do objeto copiada em outro local do
arquivo XML.
- Modifique a chave do objeto reportDefinition para seu novo relatório
alterando ou incluindo valores para as seguintes tags, conforme necessário.
n é o número inserido na etapa 3 acima.
<setting
key="id">n</setting>.
<setting key="title"
localizationKey="server.report_title.n">report
name</setting>, em que report name é o
título do relatório que o IBM® Enterprise
Records
exibe.
<setting
key="desc" localizationKey="server.report_desc.n">description</setting>,
em que description é o texto que o IBM Enterprise
Records exibe, descrevendo brevemente
o propósito do relatório. Por exemplo, "Este relatório lista os
volumes que foram abertos/fechados dentro de um período específico."
<setting
key="reportName" localizationKey="server.report_name.n">filename.rpt</setting>,
em que filename é o nome do modelo de relatório criado
no Crystal Reports Designer.
<setting key="img">relative
path to image file</setting> Este é um valor opcional para inserir um
gráfico. Por exemplo, images/action/report.gif.
- Para excluir seu novo relatório de um armazenamento de objetos
de plano de arquivos (FPOS) específico, insira as seguintes tags:
<array key="excludedObjectStores">
<value>fpos</value> </array>
em que fpos é o nome do FPOS no qual o novo relatório
será excluído. É possível incluir tags de valor adicionais para excluir
o relatório de mais de um FPOS.
- Inclua critérios de relatório, tais como locais, ações, eventos,
planejamentos e datas de FPOS.
- Sob <object key="reportDefinition">, inclua <list
key="properties">, se necessário. Se você copiou a chave do objeto
reportDefinition de um relatório existente, então <list key="properties:>
já existe.
- Sob a chave da lista de propriedades, inclua ou modifique a chave de
configuração do nome simbólico, conforme necessário para cada um dos critérios
do relatório. Se você criou algum novo critério, inclua as chaves de
configuração do nome simbólico para os novos critérios aqui também.
Acompanhe cada chave de configuração de nome simbólico com esta tag:
<setting key="required"> 0 ou 1 </setting>, para
indicar se um valor é necessário. 0 indica que o usuário não
precisa fazer uma seleção nem inserir um valor, enquanto 1 indica
que é necessário fazê-lo.
Coloque cada par de nomes simbólicos e chaves de configuração necessárias nesta
tag: <object key="property"> </object>.
Por exemplo:
<object key="property"> <setting
key="symbolicname">symbolic name</setting>
<setting key="required">1</setting> </object>
em que symbolic name é o novo critério criado ou
qualquer uma das chaves de configuração a seguir:
- fileplan_browse - Instrui o IBM Enterprise
Records para
permitir que o usuário navegue até um local no armazenamento de objetos de plano de arquivos.
- ros_browse - Instrui o IBM Enterprise
Records para
permitir que o usuário navegue até um local no armazenamento de objetos dos registros.
- start_date - A data de início dos critérios de relatório.
- end_date - A data de encerramento dos critérios de relatório.
- application_type - O tipo de registro a usar como critério,
tal como PDF, DOC, XLS e outros.
- security_category - A marcação de segurança, tal como classificado,
secreto, confidencial e outros, dependendo do modelo de dados.
- review_decision - A decisão de uma revisão, incluindo Aprovar ou Rejeitar.
- action - A ação em uma entidade, tal como abrir ou fechar.
- disposal_schedule - O planejamento da disposição associado com uma
entidade.
- disposal_action - A ação de descarte em uma entidade, tal como
transferir, revisar, transferência temporária ou destruir.
- disposal_action_export - A ação de descarte em uma entidade
após uma exportação.
- report_type - Instrui o IBM Enterprise
Records
para exibir os botões de opções Resumido ou Detalhado.
- disposal_trigger - O evento que aciona a disposição de uma entidade, tal como
uma data, o fechamento de um contêiner ou um evento externo
Para ros_browse,
security_category, disposal_action, disposal_action_export, review_decision e acionador
de descarte, o IBM Enterprise
Records recupera os valores
padrão do Content Engine no tempo de execução e os exibe em um menu a partir do
qual é possível selecionar um valor.
- Se seu relatório usa tipos de entidade como critérios:
- Sob a chave da lista de propriedades, inclua o nome simbólico entity_type,
acompanhado pela chave de configuração "required" (1=required, 0=not required).
Por exemplo:
<object key="property">
<setting key="symbolicname">entity_type</setting>
<setting key="required">1</setting>
- Inclua <list key="values"> no qual você insere os tipos de entidade
que um usuário pode selecionar para incluir no relatório. Por exemplo:
<list key="values">
<object key="value">
<setting key="id">EntityType</setting>
<setting key="value" localizationKey=serve.report_n.EntityType">Entity</setting>
</object>
onde:
- EntityType é RecordCategory, RecordFolder ou Record.
É possível incluir todos os três tipos de entidades, mas você deve colocar
cada um deles entre tags <object key="value"> separadas.
- n é o número identificado na etapa 3 acima.
- Entity é a Categoria de Registro, a Pasta de Registro ou o Registro.
Ambientes localizados requerem "localizationKey."
Por exemplo, se o seu relatório incluir estatísticas sobre Categorias de
Registro e Pastas de Registro, esta seção do arquivo XML será semelhante
ao seguinte:
<object key="property">
<setting key="symbolicname">entity_type</setting>
<setting key="required">1</setting>
<list key="values">
<object key="value">
<setting key="id">RecordCategory</setting>
<setting key="value" localizationKey=serve.report_42.RecordCategory">Record Category</setting>
</object>
<object key="value">
<setting key="id">RecordFolder</setting>
<setting key="value" localizationKey=serve.report_42.RecordFolder">Record Folder</setting>
</object>
</list>
</object>
- Se seu relatório usar ações de classificação:
Sob a chave da lista de propriedades, inclua o nome simbólico classification_action,
acompanhado pela chave de configuração "required" (1=required, 0=not required).
Por exemplo:
<object key="property">
<setting key="symbolicname">classification_action</setting>
<setting key="required">1</setting>
Inclua <list
key="values"> onde você insere as ações de classificação que um usuário pode
selecionar para incluir em um relatório. Por exemplo:
<list key="values">
<object key="value">
<setting key="id">ClassificationAction</setting>
<setting key="value" localizationKey=serve.report_n.ClassificationAction">ClassificationAction</setting>
</object>
em que:
- ClassificationAction é Atualizando, Fazendo Downgrade
ou Desclassificação. É possível incluir todas as três ações de
classificação, mas você deve colocar cada uma delas entre tags
<object key="value"> separadas.
- n é o valor "id" deste relatório na matriz para o modelo
de dados.
Ambientes localizados requerem "localizationKey."
Por exemplo, se seu relatório incluir estatísticas sobre ações de downgrade
e desclassificação, esta seção do arquivo XML será semelhante ao seguinte:
<object key="property">
<setting key="symbolicname">classification_action</setting>
<setting key="required">1</setting>
<list key="values">
<object key="value">
<setting key="id">Downgrading</setting>
<setting key="value" localizationKey=serve.report_42.Downgrading">Downgrading</setting>
</object>
<object key="value">
<setting key="id">Declassification</setting>
<setting key="value" localizationKey=serve.report_42.Declassification">Declassification</setting>
</object>
</list>
</object>
- Após ter inserido todos os critérios de relatório:
- Feche <list key="properties"> com </list>.
- Feche <object key="reportDefinition"> com </object>
- Salve o arquivo XML.
- Reinicie o servidor de aplicativos da Web no qual o
IBM Enterprise
Records é executado para
que as mudanças entrem em vigor.
Quando tiver concluído as modificações, a seção da chave do objeto
reportDefinition deve ser semelhante ao seguinte:
<object key="reportDefinition">
<setting key="id">22</setting>
<setting key="title" localizationKey="server.report_title.42">Records
Manager Classification Update Report</setting>
<setting key="desc" localizationKey="server.report_desc.42">This report lists entities
that have changed classification within a specific period.</setting>
<setting key="url">RMViewReport.jsp</setting>
<setting key="img">images/action/report.gif</setting>
<setting key="reportName" localizationKey="server.report_name.42">Classification Update.rpt</setting>
<list key="properties">
<object key="property">
<setting key="symbolicName">fileplan_browse</setting>
<setting key="required">0</setting>
</object>
<object key="property">
<setting key="symbolicName">start_date</setting>
<setting key="required">1</setting>
</object>
<object key="property">
<setting key="symbolicName">end_date</setting>
<setting key="required">1</setting>
</object>
<object key="property">
<setting key="symbolicName">report_type</setting>
<setting key="required">0</setting>
</object>
<object key="property">
<setting key="symbolicname">entity_type</setting>
<setting key="required">1</setting>
<list key="values">
<object key="value">
<setting key="id">RecordCategory</setting>
<setting key="value" localizationKey=serve.report_42.RecordCategory">Record
Category</setting>
</object>
<object key="value">
<setting key="id">RecordFolder</setting>
<setting key="value" localizationKey=serve.report_42.RecordFolder">Record Folder</setting>
</object>
<object key="property">
<setting key="symbolicname">classification_action</setting>
<setting key="required">1</setting>
<list key="values">
<object key="value">
<setting key="id">Downgrading</setting>
<setting key="value" localizationKey=serve.report_42.Downgrading">Downgrading</setting>
</object>
<object key="value">
<setting key="id">Declassification</setting>
<setting key="value" localizationKey=serve.report_42.Declassification">Declassification</setting>
</object>
</list>
</object>
</list>
</object>
</list>
</object>