Merge branch 'staging' of https://github.com/aspose-tasks/Aspose-Task-Reference-Tutorials into staging

Author: adilfazal-aspose

content/english/java/formulas/_index.md

@@ -10,5 +10,8 @@ url: /java/formulas/
 
 ## Formulas Tutorials
 ### [Support Evaluation Functions in Aspose.Tasks Formulas](./evaluation-functions/)
-### [Work with Formulas in Aspose.Tasks](./work-with-formulas/)
-### [Write and Read Formulas in Aspose.Tasks](./write-read-formulas/)
+Learn how to support evaluation of MS Project functions in Aspose.Tasks formulas using Java. Boost your productivity with Aspose.Tasks.
+### [MS Project Formulas with Aspose.Tasks for Java](./work-with-formulas/)
+Learn how to manipulate MS Project files in Java using Aspose.Tasks library. Create, modify, and calculate attributes with ease.
+### [Writing and Reading MS Project Formulas in Aspose.Tasks](./write-read-formulas/)
+Learn to write and read MS Project formulas efficiently with Aspose.Tasks for Java. Enhance your project management skills.

content/english/java/formulas/evaluation-functions/_index.md

@@ -2,210 +2,66 @@
 title: Support Evaluation Functions in Aspose.Tasks Formulas
 linktitle: Support Evaluation Functions in Aspose.Tasks Formulas
 second_title: Aspose.Tasks Java API
-description: 
+description: Learn how to support evaluation of MS Project functions in Aspose.Tasks formulas using Java. Boost your productivity with Aspose.Tasks.
 type: docs
 weight: 10
 url: /java/formulas/evaluation-functions/
 ---
 
-## Complete Source Code
+## Introduction
+Aspose.Tasks for Java is a powerful library that enables developers to manipulate Microsoft Project files programmatically. One of its key features is the ability to support evaluation of MS Project functions within Aspose.Tasks formulas. This capability allows users to perform complex calculations and analysis directly within their Java applications.
+## Prerequisites
+Before getting started with integrating MS Project functions into Aspose.Tasks formulas, ensure you have the following:
+1. Java Development Environment: Make sure you have Java installed on your system along with a compatible IDE for Java development such as IntelliJ IDEA or Eclipse.
+2. Aspose.Tasks for Java Library: Download and include the Aspose.Tasks for Java library in your Java project. You can download it from the [Aspose.Tasks for Java download page](https://releases.aspose.com/tasks/java/).
+## Import Packages
+To begin, import the necessary packages in your Java class to utilize Aspose.Tasks functionalities:
 ```java
-/*
- * Copyright 2001-2022 Aspose Pty Ltd. All Rights Reserved.
- *
- * This file is part of Aspose.Tasks. The source code in this file
- * is only intended as a supplement to the documentation, and is provided
- * "as is", without warranty of any kind, either expressed or implied.
- */
-
-
-
 import com.aspose.tasks.*;
+```
 
-public class SupportEvaluationFunctions {
-    public static void main(String[] args) {
-        CalculationOfMathExpressions();
-
-        EvaluateChoose();
-        EvaluateIsNumeric();
-        EvaluateSwitch();
-
-        CalculationOfTextFunctions();
-        CalculationOfDateTimeFunctions();
-
-        //Display result of conversion.
-        System.out.println("Process completed Successfully");
-    }
-
-    private static Project CreateTestProjectWithCustomField() {
-        Project project = new Project();
-        ExtendedAttributeDefinition attr = ExtendedAttributeDefinition.createTaskDefinition(CustomFieldType.Number, ExtendedAttributeTask.Number1, "Sine");
-        project.getExtendedAttributes().add(attr);
-
-        Task task = project.getRootTask().getChildren().add("Task");
-
-        ExtendedAttribute a = attr.createExtendedAttribute();
-        task.getExtendedAttributes().add(a);
-        return project;
-    }
-
-    public static void CalculationOfMathExpressions() {
-        //ExStart: CalculationOfMathExpressions
-        Project project = CreateTestProjectWithCustomField();
-
-        // Set formula Sin(pi/2)
-        project.getExtendedAttributes().get(0).setFormula("Sin(3.1415926/2)");
-
-        // Print Calculated value
-        Task task = project.getRootTask().getChildren().getById(1);
-        System.out.println("Sin(pi/2): " + task.getExtendedAttributes().get(0).getNumericValue());
-        //ExEnd: CalculationOfMathExpressions
-    }
-
-    //ExStart: CalculationOfGeneralFunctions
-    public static void EvaluateChoose() {
-        Project project = CreateTestProjectWithCustomField();
-
-        // Set Formula
-        project.getExtendedAttributes().get(0).setFormula("Choose(3, \"This is a\", \"right\", \"choice\")");
-
-        // Print extended attribute value
-        Task task = project.getRootTask().getChildren().getById(1);
-        System.out.println(task.getExtendedAttributes().get(0).getNumericValue());
-    }
-
-    public static void EvaluateIsNumeric() {
-        String[] numericFormulas = {
-                "IsNumeric('AAA')",
-                "IsNUmeric(1)",
-                "IsNumeric(1<0)",
-                "IsNumeric(\"1.1\")",
-                "IsNumeric(Choose((2 + Sgn(2^-3)), 123, \"one two three\"))"
-        };
-
-        Project project = CreateTestProjectWithCustomField();
-
-        for (String numericFormula : numericFormulas) {
-            // Set Formula
-            project.getExtendedAttributes().get(0).setFormula(numericFormula);
-
-            // Print extended attribute value
-            Task task = project.getRootTask().getChildren().getById(1);
-            System.out.println(task.getExtendedAttributes().get(0).getNumericValue());
-        }
-    }
-
-    public static void EvaluateSwitch() {
-        Project project = CreateTestProjectWithCustomField();
-
-        // Set Formula
-        project.getExtendedAttributes().get(0).setFormula("Switch( 0 < 1, \"0 is lesser than 1\", 0 > 1, \"0 is greater than 1\")");
-
-        // Print extended attribute value
-        Task task = project.getRootTask().getChildren().getById(1);
-        System.out.println(task.getExtendedAttributes().get(0).getNumericValue());
-    }
-    //ExEnd: CalculationOfGeneralFunctions
-
-    public static void CalculationOfTextFunctions() {
-        //ExStart: CalculationOfTextFunctions
-        Project project = CreateTestProjectWithCustomField();
-        Task task = project.getRootTask().getChildren().getById(1);
-
-        // EvaluateStrConv
-        // Set formulas and print extended attribute value
-        project.getExtendedAttributes().get(0).setFormula("StrConv(\"sTring and sTRINg\",3)");
-        System.out.println(task.getExtendedAttributes().get(0).getNumericValue());
-
-        project.getExtendedAttributes().get(0).setFormula("StrConv(\"sTring and sTRINg\",1)");
-        System.out.println(task.getExtendedAttributes().get(0).getNumericValue());
-
-        project.getExtendedAttributes().get(0).setFormula("StrConv(\"sTring and sTRINg\",2)");
-        System.out.println(task.getExtendedAttributes().get(0).getNumericValue());
-
-        // EvaluateStringFunction
-        // Set formulas and print extended attribute value
-        project.getExtendedAttributes().get(0).setFormula("String(5, 40)");
-        System.out.println(task.getExtendedAttributes().get(0).getNumericValue());
-
-        project.getExtendedAttributes().get(0).setFormula("String(5, \"A\")");
-        System.out.println(task.getExtendedAttributes().get(0).getNumericValue());
-
-        project.getExtendedAttributes().get(0).setFormula("String(-5, \"A\")");
-        // #Error
-        System.out.println(task.getExtendedAttributes().get(0).getNumericValue());
-        //ExEnd: CalculationOfTextFunctions
-    }
-
-    public static void CalculationOfDateTimeFunctions() {
-        //ExStart: CalculationOfDateTimeFunctions
-        Project project = CreateTestProjectWithCustomField();
-        Task task = project.getRootTask().getChildren().getById(1);
-
-        ExtendedAttributeDefinition numberDefinition = ExtendedAttributeDefinition.createTaskDefinition(ExtendedAttributeTask.Number1, null);
-        project.getExtendedAttributes().add(numberDefinition);
-
-        ExtendedAttribute numberAttribute = numberDefinition.createExtendedAttribute();
-        task.getExtendedAttributes().add(numberAttribute);
-
-        // Set ProjDateDiff formula and print extended attribute value
-        numberDefinition.setFormula("ProjDateDiff(\"03/23/2015\",\"03/18/2015\")");
-        System.out.println(task.getExtendedAttributes().get(0).getNumericValue());
-
-        numberDefinition.setFormula("ProjDateDiff(\"03/23/2015\",\"03/25/2015\")");
-        System.out.println(task.getExtendedAttributes().get(0).getNumericValue());
-
-        ExtendedAttributeDefinition dateDefinition = ExtendedAttributeDefinition.createTaskDefinition(ExtendedAttributeTask.Date1, null);
-        project.getExtendedAttributes().add(dateDefinition);
-        ExtendedAttribute dateAttribute = dateDefinition.createExtendedAttribute();
-        task.getExtendedAttributes().add(dateAttribute);
-
-        ExtendedAttributeDefinition durationDefinition = ExtendedAttributeDefinition.createTaskDefinition(ExtendedAttributeTask.Duration4, "Custom duration field");
-        project.getExtendedAttributes().add(durationDefinition);
-        ExtendedAttribute durationAttribute = durationDefinition.createExtendedAttribute();
-        task.getExtendedAttributes().add(durationAttribute);
-
-        ExtendedAttributeDefinition textDefinition = ExtendedAttributeDefinition.createTaskDefinition(ExtendedAttributeTask.Text5, "Custom text field");
-        project.getExtendedAttributes().add(textDefinition);
-        ExtendedAttribute textAttribute = textDefinition.createExtendedAttribute();
-        task.getExtendedAttributes().add(textAttribute);
-
-        // Set ProjDateSub formula and print extended attribute value
-        dateDefinition.setFormula("ProjDateSub(\"3/19/2015\", \"1d\")");
-        System.out.println(dateAttribute.getDateValue());
-
-        // We can set ProjDurConv formula to duration-valued attribute as well as to text-valued attribute.
-
-        // Set ProjDurConv formula to duration-valued extended attribute and print its value.
-        durationDefinition.setFormula("ProjDurConv([Duration], pjHours)");
-        System.out.println(durationAttribute.getDurationValue());
-
-        // Set ProjDurConv formula to text-valued extended attribute and print its value.
-        textDefinition.setFormula("ProjDurConv([Duration], pjHours)");
-        System.out.println(task.getExtendedAttributes().get(0).getNumericValue());
-
-        textDefinition.setFormula("ProjDurConv([Duration], pjWeeks)");
-        System.out.println(task.getExtendedAttributes().get(0).getNumericValue());
-
-        // Set Second formula and print extended attribute value
-        numberDefinition.setFormula("Second(\"4/21/2015 2:53:41 AM\")");
-        System.out.println(task.getExtendedAttributes().get(0).getNumericValue());
-
-        // Set Weekday formula and print extended attribute value
-        numberDefinition.setFormula("Weekday(\"24/3/2015\", 1)");
-        System.out.println(task.getExtendedAttributes().get(0).getNumericValue());
-
-        numberDefinition.setFormula("Weekday(\"24/3/2015\", 2)");
-        System.out.println(task.getExtendedAttributes().get(0).getNumericValue());
-
-        numberDefinition.setFormula("Weekday(\"24/3/2015\", 3)");
-        System.out.println(task.getExtendedAttributes().get(0).getNumericValue());
-        //ExEnd: CalculationOfDateTimeFunctions
-    }
-}
-
-
-
-
-
+## Step 1: Create a New Project Object
+First, create a new `Project` object to work with:
+```java
+Project project = new Project();
+```
+This initializes a new empty project.
+## Step 2: Define an Extended Attribute for Tasks
+Next, define an extended attribute for tasks. This attribute will hold custom data associated with tasks:
+```java
+ExtendedAttributeDefinition attr = ExtendedAttributeDefinition.createTaskDefinition(CustomFieldType.Number, ExtendedAttributeTask.Number1, "Sine");
+```
+Here, we create an extended attribute of type `Number` with the name "Sine" for tasks.
+## Step 3: Add the Extended Attribute to the Project
+Add the extended attribute definition to the project's list of extended attributes:
+```java
+project.getExtendedAttributes().add(attr);
+```
+This adds the custom attribute to the project.
+## Step 4: Create a New Task
+Now, let's create a new task within the project:
+```java
+Task task = project.getRootTask().getChildren().add("Task");
+```
+This adds a new task named "Task" to the project.
+## Step 5: Associate the Extended Attribute with the Task
+Associate the extended attribute created earlier with the task:
+```java
+ExtendedAttribute a = attr.createExtendedAttribute();
+task.getExtendedAttributes().add(a);
 ```
+This associates the "Sine" extended attribute with the task.
+
+## Conclusion
+In conclusion, integrating MS Project functions into Aspose.Tasks formulas in Java is a straightforward process. By following the provided steps, you can effectively utilize the powerful capabilities of Aspose.Tasks for Java to manipulate and analyze Microsoft Project files programmatically.
+## FAQ's
+### Q: Can Aspose.Tasks for Java handle complex MS Project formulas?
+A: Yes, Aspose.Tasks for Java supports evaluation of a wide range of MS Project functions, allowing for complex calculations within Java applications.
+### Q: Is Aspose.Tasks for Java compatible with different versions of Microsoft Project files?
+A: Yes, Aspose.Tasks for Java supports various versions of Microsoft Project files, including MPP, MPT, and XML formats.
+### Q: Can I try Aspose.Tasks for Java before purchasing?
+A: Yes, you can download a free trial version of Aspose.Tasks for Java from the website [here](https://purchase.aspose.com/buy).
+### Q: How can I get support for Aspose.Tasks for Java?
+A: You can get support from the Aspose.Tasks community forum [here](https://forum.aspose.com/c/tasks/15).
+### Q: Is there a temporary license available for Aspose.Tasks for Java?
+A: Yes, you can obtain a temporary license for testing purposes from the Aspose website [here](https://purchase.aspose.com/temporary-license/).