aspose-tasks-for-net Olá amigos! No blog de hoje, farei um tour pela mais recente API Aspose.Tasks. A coisa boa sobre a equipe Aspose é que ela publica simultaneamente .NET e API baseada em Java para Aspose.Tasks todos os meses. As variantes baseadas em .NET e Java estão no mesmo nível em termos de recursos e ambos os usuários da API podem explorar os novos recursos em seus respectivos ambientes. Na seção a seguir, discutirei sobre novos recursos e melhorias realizadas na API.
Escrevendo metadados para arquivos do Microsoft Project em C# e Java
Aspose.Tasks fornece um recurso para gravar metadados em arquivos MPP para calendários, tarefas, links de tarefas, recursos e atribuições de recursos. O exemplo a seguir descreve como gravar informações de metadados em arquivos MPP.
A implementação semelhante baseada em Java para o mesmo é como abaixo:
// O caminho para o diretório de documentos.
String dataDir = Utils.getDataDir(WriteMetadata.class);
long OneSec = 10000000;
long OneMin = 60 * OneSec;
long OneHour = 60 * OneMin;
long OneDayEightHour = 8 * OneHour;
long OneDayTwentyFourHour = 24 * OneHour;
Project project = new Project(dataDir + "New project 2010.mpp");
java.util.Calendar calendar = java.util.Calendar.getInstance(TimeZone.getTimeZone("GMT"));
calendar.set(2012, java.util.Calendar.DECEMBER, 7, 0, 0, 0);
Date startDate = calendar.getTime();
calendar.set(2013, java.util.Calendar.DECEMBER, 7, 0, 0, 0);
Date toDate = calendar.getTime();
WorkingTime wt = new WorkingTime();
wt.setFromTime(startDate);
wt.setToTime(toDate);
WeekDay day = project.get(Prj.CALENDAR).getWeekDays().toList().get(1);
day.getWorkingTimes().add(wt);
project.get(Prj.CALENDAR).setName("CHANGED NAME!");
Task task = project.getRootTask().getChildren().add("Task 1");
task.set(Tsk.DURATION_FORMAT, TimeUnitType.Day);
task.set(Tsk.DURATION, project.getDuration(3));
task.set(Tsk.CONTACT, "Rsc 1");
// novos campos
task.set(Tsk.IS_MARKED, true);
task.set(Tsk.IGNORE_WARNINGS, true);
Task task2 = project.getRootTask().getChildren().add("Task 2");
task2.set(Tsk.DURATION_FORMAT, TimeUnitType.Day);
task2.set(Tsk.CONTACT, "Rsc 2");
project.getTaskLinks().add(task, task2, TaskLinkType.FinishToStart, project.getDuration(-1, TimeUnitType.Day));
calendar.set(2013, java.util.Calendar.DECEMBER, 13, 9, 0, 0);
startDate = calendar.getTime();
project.set(Prj.START_DATE, startDate);
Resource rsc = project.getResources().add("Rsc 1");
rsc.set(Rsc.TYPE, ResourceType.Work);
rsc.set(Rsc.INITIALS, "WR");
rsc.set(Rsc.ACCRUE_AT, CostAccrualType.Prorated);
rsc.set(Rsc.MAX_UNITS, 1d);
rsc.set(Rsc.CODE, "Code 1");
rsc.set(Rsc.GROUP, "Workers");
rsc.set(Rsc.E_MAIL_ADDRESS, "1@gmail.com");
rsc.set(Rsc.WINDOWS_USER_ACCOUNT, "user_acc1");
rsc.set(Rsc.IS_GENERIC, new NullableBool(true));
rsc.set(Rsc.ACCRUE_AT, CostAccrualType.End);
rsc.set(Rsc.STANDARD_RATE, BigDecimal.valueOf(10));
rsc.set(Rsc.STANDARD_RATE_FORMAT, RateFormatType.Day);
rsc.set(Rsc.OVERTIME_RATE, BigDecimal.valueOf(15));
rsc.set(Rsc.OVERTIME_RATE_FORMAT, RateFormatType.Hour);
rsc.set(Rsc.IS_TEAM_ASSIGNMENT_POOL, true);
rsc.set(Rsc.COST_CENTER, "Cost Center 1");
ResourceAssignment assn = project.getResourceAssignments().add(task, rsc);
assn.set(Asn.UID, 1);
assn.set(Asn.WORK, task.get(Tsk.DURATION));
assn.set(Asn.REMAINING_WORK, assn.get(Asn.WORK));
assn.set(Asn.REGULAR_WORK, assn.get(Asn.WORK));
task.set(Tsk.WORK, assn.get(Asn.WORK));
rsc.set(Rsc.WORK, task.get(Tsk.WORK));
assn.set(Asn.START, task.get(Tsk.START));
assn.set(Asn.FINISH, task.get(Tsk.FINISH));
// Adicionar atributo estendido para projeto e tarefa
ExtendedAttributeDefinition attr = ExtendedAttributeDefinition.createTaskDefinition(CustomFieldType.Flag,
ExtendedAttributeTask.Flag1, "My Flag Field");
project.getExtendedAttributes().add(attr);
ExtendedAttribute taskAttr = attr.createExtendedAttribute();
taskAttr.setFlagValue(true);
task2.getExtendedAttributes().add(taskAttr);
project.save(dataDir + "updated.mpp", SaveFileFormat.MPP);
Lendo e escrevendo fórmulas
A API Aspose.Tasks suporta leitura/escrita de fórmulas para arquivos de projeto MPP. A propriedade Formula do ExtendedAttributeDefinition fornece a interface para ler o valor da fórmula. Os exemplos a seguir descrevem como ler fórmulas de atributos estendidos locais e corporativos do arquivo MPP. Ele também mostra como escrever fórmulas no arquivo MPP.
Lendo fórmulas em atributos estendidos locais e corporativos do arquivo MPP
A implementação semelhante baseada em Java para o mesmo é como abaixo:
// O caminho para o diretório de documentos.
String dataDir = Utils.getDataDir(WriteReadFormula.class);
Project proj = new Project(dataDir + "FormulaField.mpp"); // attached test mpp
ExtendedAttributeDefinition attr = proj.getExtendedAttributes().get(0);
System.out.println("Attribute Formula: " + attr.getFormula());
Escrevendo Fórmulas em Atributos Estendidos para Formatos de Arquivo MPP
A implementação semelhante baseada em Java para o mesmo é como abaixo:
// O caminho para o diretório de documentos.
String dataDir = Utils.getDataDir(WriteReadFormula.class);
Project project = new Project(dataDir + "New project 2010.mpp");
project.set(Prj.NEW_TASKS_ARE_MANUAL, new NullableBool(false));
// crie um novo campo personalizado (Task Text1) com fórmula que dobrará o custo da tarefa
ExtendedAttributeDefinition attr = ExtendedAttributeDefinition.createTaskDefinition(CustomFieldType.Text,
ExtendedAttributeTask.Text1, "Custom");
attr.setAlias("Double Costs");
attr.setFormula("[Cost]*2");
project.getExtendedAttributes().add(attr);
// adicione uma tarefa para ver o resultado no MSP
Task task = project.getRootTask().getChildren().add("Task");
// definir o custo da tarefa
task.set(Tsk.COST, BigDecimal.valueOf(100));
// veja o resultado na captura de tela anexada (result.jpg)
project.save(dataDir + "saved.mpp", SaveFileFormat.MPP);
Implementando o prefixo de recurso para recursos aninhados
Aspose.Tasks fornece a propriedade ResourceSavingArgs.NestedUri que permite salvar recursos aninhados (por exemplo, PNG dentro de arquivos SVG) na pasta separada. Nos exemplos a seguir, demonstramos o caso de uso para usar o recurso.
A implementação semelhante baseada em Java para o mesmo é como abaixo:
public class ResourcePrefixForNestedResources implements IFontSavingCallback, ICssSavingCallback, IImageSavingCallback {
public static String dataDir = Utils.getDataDir(ResourcePrefixForNestedResources.class);
public static void main(String[] args) throws IOException {
FileInputStream fs = new FileInputStream(dataDir + "Project1.mpp");
Project project = new Project(fs);
HtmlSaveOptions options = GetSaveOptions(1);
FileOutputStream stream = new FileOutputStream(dataDir + "document.html");
project.save(stream, options);
}
public void cssSaving(CssSavingArgs args) {
FileOutputStream stream;
try {
stream = new FileOutputStream(dataDir + "css/" + args.getFileName());
args.setStream(stream);
args.setKeepStreamOpen(false);
args.setUri(dataDir + "css/" + args.getFileName());
} catch (FileNotFoundException e) {
e.printStackTrace();
}
}
public void fontSaving(FontSavingArgs args) {
FileOutputStream stream;
try {
stream = new FileOutputStream(dataDir + "fonts/" + args.getFileName());
args.setStream(stream);
args.setKeepStreamOpen(false);
args.setUri(dataDir + "fonts/" + args.getFileName());
} catch (FileNotFoundException e) {
e.printStackTrace();
}
}
public void imageSaving(ImageSavingArgs args) {
if (args.getFileName().endsWith("png")) {
FileOutputStream stream1;
try {
stream1 = new FileOutputStream(dataDir + "resources/nestedResources/" + args.getFileName());
args.setStream(stream1);
args.setKeepStreamOpen(false);
args.setUri(dataDir + "resources/" + args.getFileName());
args.setNestedUri(dataDir + "nestedResources/" + args.getFileName());
} catch (FileNotFoundException e) {
e.printStackTrace();
}
} else {
FileOutputStream stream2;
try {
stream2 = new FileOutputStream(dataDir + "resources/" + args.getFileName());
args.setStream(stream2);
args.setKeepStreamOpen(false);
args.setUri(dataDir + "resources/" + args.getFileName());
} catch (FileNotFoundException e) {
e.printStackTrace();
}
}
}
private static HtmlSaveOptions GetSaveOptions(int pageNumber) {
HtmlSaveOptions saveOptions = new HtmlSaveOptions();
saveOptions.setIncludeProjectNameInPageHeader(false);
saveOptions.setIncludeProjectNameInTitle(false);
saveOptions.setPageSize(PageSize.A3);
saveOptions.setTimescale(Timescale.ThirdsOfMonths);
saveOptions.setReduceFooterGap(true);
saveOptions.setFontFaceTypes(FontFaceType.Ttf);
saveOptions.setExportCss(ResourceExportType.AsFile);
saveOptions.setExportFonts(ResourceExportType.AsFile);
saveOptions.setExportImages(ResourceExportType.AsFile);
ResourcePrefixForNestedResources program = new ResourcePrefixForNestedResources();
saveOptions.setFontSavingCallback(program);
saveOptions.setCssSavingCallback(program);
saveOptions.setImageSavingCallback(program);
saveOptions.getPages().clear();
saveOptions.getPages().add(pageNumber);
File dirFonts = new File(dataDir + "fonts");
if (!dirFonts.exists()) {
dirFonts.mkdir();
}
File dirResources = new File(dataDir + "resources");
if (!dirResources.exists()) {
dirResources.mkdir();
}
File dirNResources = new File(dataDir + "nestedResources");
if (!dirNResources.exists()) {
dirNResources.mkdir();
}
File dirCSS = new File(dataDir + "css");
if (!dirCSS.exists()) {
dirCSS.mkdir();
}
return saveOptions;
}
}
Trabalhando com atributos estendidos
O Microsoft Project (MSP) possui um extenso esquema de intercâmbio de dados XML que facilita a troca de informações entre aplicativos e a programação com arquivos de projeto. O esquema permite adicionar atributos estendidos a tarefas, recursos e atribuições. Este artigo mostra como trabalhar com atributos estendidos em Aspose.Tasks.
A propriedade ExtendedAttribute exposta pela classe Resource pode ser usada para gerenciar os atributos estendidos de um recurso. Essa propriedade lê e grava um ArrayList dos objetos ExtendedAttribute para lidar com os atributos estendidos de um recurso. O objeto ExtendedAttribute expõe ainda mais as propriedades relevantes
A implementação semelhante baseada em Java para o mesmo é como abaixo:
// O caminho para o diretório de documentos.
String dataDir = Utils.getDataDir(ExtendedResourceAttributes.class);
Project prj = new Project(dataDir + "project5.mpp");
// Definir atributo estendido
ExtendedAttributeDefinition myNumber1 = prj.getExtendedAttributes()
.getById((int) ExtendedAttributeTask.Number1);
if (myNumber1 == null) {
myNumber1 = ExtendedAttributeDefinition.createResourceDefinition(ExtendedAttributeResource.Number1, "Age");
prj.getExtendedAttributes().add(myNumber1);
}
// Crie um atributo estendido e defina seu valor
ExtendedAttribute number1Resource = myNumber1.createExtendedAttribute();
number1Resource.setNumericValue(BigDecimal.valueOf(30.5345));
// Adicionar um novo recurso e seu atributo estendido
Resource rsc = prj.getResources().add("R1");
rsc.getExtendedAttributes().add(number1Resource);
prj.save(dataDir + "Project5.xml", SaveFileFormat.XML);
// Exibe o resultado da conversão.
System.out.println("Process completed Successfully");
Melhorias de renderização
Nesta versão, o foco também foi definido na melhoria do desempenho de renderização da API. Os problemas de renderização de PDF e HTML também foram resolvidos. Outras melhorias incluem a resolução de problemas relacionados à abertura e salvamento de arquivos MPP, IDs de tarefas e cronogramas incorretos.
Espere, há muitos outros recursos, aprimoramentos e correções de bugs incluídos nesta versão. Aqui você pode obter os detalhes!
Também mantivemos os exemplos de exemplo de trabalho para APIs baseadas em .NET e Java no Github para que os usuários possam imediatamente usar diferentes exemplos e explorar os recursos da API. Você também pode falar sobre problemas relacionados à API conosco em nosso suporte ao produto fórum.