Documenta migração de documentos de 2.5 p 3.1

Fix #971

docs/importacao_25_31.rst

@@ -29,3 +29,54 @@ Posteriormente rodar a seguinte sequencia de comandos estando no ambiente virtua
    %run sapl/legacy/migration.py
 
    migrate()
+
+
+Migração de documentos do sapl 2.5
+----------------------------------
+
+No sapl 2.5 todos os documentos ficavam armazenados no ZODB (o banco do Zope).
+No sapl 3.1 eles ficam no sistema de arquivos convencional e portanto precisam:
+
+1. ser exportados para o sistema de arquivos
+2. ser vinculados ao novo banco importado para o sapl 3.1
+
+
+Exportar os documentos para o sistema de arquivos
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Siga os seguintes passos:
+
+1. Instale o `Products.FSDump` no sapl 2.5.
+
+   Para isso basta colocar a pasta `Products/FSDump` do projeto https://github.com/zopefoundation/Products.FSDump na pasta `Products` da instalação do sapl 2.5 e reiniciar o Zope.
+
+   A pasta a ser instalada é a seguinte:
+   https://github.com/zopefoundation/Products.FSDump/tree/master/Products/FSDump
+
+2. Na ZMI, na pasta `sapl_documentos`, adicione um objeto do tipo `Dumper`:
+
+   - Em `Filesystem path` escolha uma pasta do sistema de arquivos local para onde os arquivos serão copiados
+   - Desmarque a opção `Use .metadata file`
+   - Clique no botão `Add`
+
+3. Use o objeto `Dumper` criado para exportar os arquivos:
+
+   - Clique no objeto `Dumper` criado para ver suas opções
+   - Confira seus parametros e clique em `Change and Dump`
+   - Aguarde a exportação dos arquivos e verifique que foram copiados para a pasta indicada
+
+
+Vincular os documentos ao novo banco do sapl 3.1
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+1. Primeiramente migre o banco do sapl 2.5 para o sapl 3.1
+
+2. Copie a pasta exportada `sapl_documentos` dentro da pasta `media` da instalação do sapl 3.1
+
+3. De forma semelhante ao realizado na migração do banco, dentro no mesmo ambiente virtual, rode os seguintes comandos::
+
+    ./manage.py shell --settings=sapl.legacy_migration_settings
+
+    %run sapl/legacy/migracao_documentos.py
+
+    migrar_documentos()