cs-excel/src/main/java/io/cloudslang/content/excel/actions/AddCell.java
/*
* Copyright 2019-2024 Open Text
* This program and the accompanying materials
* are made available under the terms of the Apache License v2.0 which accompany this distribution.
*
* The Apache License is available at
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package io.cloudslang.content.excel.actions;
import com.hp.oo.sdk.content.annotations.Action;
import com.hp.oo.sdk.content.annotations.Output;
import com.hp.oo.sdk.content.annotations.Param;
import com.hp.oo.sdk.content.annotations.Response;
import io.cloudslang.content.constants.ReturnCodes;
import io.cloudslang.content.excel.entities.AddCellInputs;
import io.cloudslang.content.excel.entities.ExcelCommonInputs;
import io.cloudslang.content.excel.services.AddCellService;
import io.cloudslang.content.utils.OutputUtilities;
import io.cloudslang.content.utils.StringUtilities;
import java.util.List;
import java.util.Map;
import static com.hp.oo.sdk.content.plugin.ActionMetadata.MatchType.COMPARE_EQUAL;
import static com.hp.oo.sdk.content.plugin.ActionMetadata.ResponseType.ERROR;
import static com.hp.oo.sdk.content.plugin.ActionMetadata.ResponseType.RESOLVED;
import static io.cloudslang.content.constants.OutputNames.EXCEPTION;
import static io.cloudslang.content.constants.OutputNames.RETURN_CODE;
import static io.cloudslang.content.constants.OutputNames.RETURN_RESULT;
import static io.cloudslang.content.constants.ResponseNames.FAILURE;
import static io.cloudslang.content.constants.ResponseNames.SUCCESS;
import static io.cloudslang.content.excel.utils.Constants.BOOLEAN_FALSE;
import static io.cloudslang.content.excel.utils.Constants.DEFAULT_COLUMN_DELIMITER;
import static io.cloudslang.content.excel.utils.Constants.DEFAULT_ROW_DELIMITER;
import static io.cloudslang.content.excel.utils.Constants.DEFAULT_WORKSHEET;
import static io.cloudslang.content.excel.utils.Constants.NEW_LINE;
import static io.cloudslang.content.excel.utils.Descriptions.AddCell.COLUMN_DELIMITER_DESC;
import static io.cloudslang.content.excel.utils.Descriptions.AddCell.COLUMN_INDEX_DESC;
import static io.cloudslang.content.excel.utils.Descriptions.AddCell.EXCEPTION_DESC;
import static io.cloudslang.content.excel.utils.Descriptions.AddCell.FAILURE_DESC;
import static io.cloudslang.content.excel.utils.Descriptions.AddCell.HEADER_DATA_DESC;
import static io.cloudslang.content.excel.utils.Descriptions.AddCell.OVERWRITE_DATA_DESC;
import static io.cloudslang.content.excel.utils.Descriptions.AddCell.RETURN_RESULT_DESC;
import static io.cloudslang.content.excel.utils.Descriptions.AddCell.ROW_DATA_DESC;
import static io.cloudslang.content.excel.utils.Descriptions.AddCell.ROW_DELIMITER_DESC;
import static io.cloudslang.content.excel.utils.Descriptions.AddCell.ROW_INDEX_DESC;
import static io.cloudslang.content.excel.utils.Descriptions.AddCell.SUCCESS_DESC;
import static io.cloudslang.content.excel.utils.Descriptions.Common.EXCEL_FILE_NAME_DESC;
import static io.cloudslang.content.excel.utils.Descriptions.Common.RETURN_CODE_DESC;
import static io.cloudslang.content.excel.utils.Descriptions.Common.WORKSHEET_NAME_DESC;
import static io.cloudslang.content.excel.utils.Inputs.AddCell.COLUMN_DELIMITER;
import static io.cloudslang.content.excel.utils.Inputs.AddCell.COLUMN_INDEX;
import static io.cloudslang.content.excel.utils.Inputs.AddCell.HEADER_DATA;
import static io.cloudslang.content.excel.utils.Inputs.AddCell.OVERWRITE_DATA;
import static io.cloudslang.content.excel.utils.Inputs.AddCell.ROW_DATA;
import static io.cloudslang.content.excel.utils.Inputs.AddCell.ROW_DELIMITER;
import static io.cloudslang.content.excel.utils.Inputs.AddCell.ROW_INDEX;
import static io.cloudslang.content.excel.utils.Inputs.CommonInputs.EXCEL_FILE_NAME;
import static io.cloudslang.content.excel.utils.Inputs.CommonInputs.WORKSHEET_NAME;
import static io.cloudslang.content.excel.utils.InputsValidation.verifyAddExcelData;
import static io.cloudslang.content.utils.OutputUtilities.getFailureResultsMap;
import static org.apache.commons.lang3.StringUtils.EMPTY;
import static org.apache.commons.lang3.StringUtils.defaultIfEmpty;
public class AddCell {
@Action(name = "Add Cell",
outputs = {
@Output(value = RETURN_RESULT, description = RETURN_RESULT_DESC),
@Output(value = RETURN_CODE, description = RETURN_CODE_DESC),
@Output(value = EXCEPTION, description = EXCEPTION_DESC),
},
responses = {
@Response(text = SUCCESS, field = RETURN_CODE, value = ReturnCodes.SUCCESS, matchType = COMPARE_EQUAL, responseType = RESOLVED, description = SUCCESS_DESC),
@Response(text = FAILURE, field = RETURN_CODE, value = ReturnCodes.FAILURE, matchType = COMPARE_EQUAL, responseType = ERROR, description = FAILURE_DESC)
})
public Map<String, String> execute(@Param(value = EXCEL_FILE_NAME, required = true, description = EXCEL_FILE_NAME_DESC) String excelFileName,
@Param(value = WORKSHEET_NAME, description = WORKSHEET_NAME_DESC) String worksheetName,
@Param(value = HEADER_DATA, description = HEADER_DATA_DESC) String headerData,
@Param(value = ROW_DATA, required = true, description = ROW_DATA_DESC) String rowData,
@Param(value = ROW_INDEX, description = ROW_INDEX_DESC) String rowIndex,
@Param(value = COLUMN_INDEX, description = COLUMN_INDEX_DESC) String columnIndex,
@Param(value = ROW_DELIMITER, description = ROW_DELIMITER_DESC) String rowDelimiter,
@Param(value = COLUMN_DELIMITER, description = COLUMN_DELIMITER_DESC) String columnDelimiter,
@Param(value = OVERWRITE_DATA, description = OVERWRITE_DATA_DESC) String overwriteData) {
excelFileName = defaultIfEmpty(excelFileName, EMPTY);
worksheetName = defaultIfEmpty(worksheetName, DEFAULT_WORKSHEET);
headerData = defaultIfEmpty(headerData, EMPTY);
rowData = defaultIfEmpty(rowData, EMPTY);
rowIndex = defaultIfEmpty(rowIndex, EMPTY); //its default depends on the document so it will be set later
columnIndex = defaultIfEmpty(columnIndex, EMPTY); //its default depends on the document so it will be set later
rowDelimiter = defaultIfEmpty(rowDelimiter, DEFAULT_ROW_DELIMITER);
columnDelimiter = defaultIfEmpty(columnDelimiter, DEFAULT_COLUMN_DELIMITER);
overwriteData = defaultIfEmpty(overwriteData, BOOLEAN_FALSE);
final List<String> exceptionMessages = verifyAddExcelData(excelFileName, rowData, rowIndex, columnIndex, overwriteData);
if (!exceptionMessages.isEmpty()) {
return getFailureResultsMap(StringUtilities.join(exceptionMessages, NEW_LINE));
}
try {
return AddCellService.addExcelData(AddCellInputs.builder()
.commonInputs(ExcelCommonInputs.builder()
.excelFileName(excelFileName)
.worksheetName(worksheetName)
.build())
.headerData(headerData)
.rowData(rowData)
.rowIndex(rowIndex)
.columnIndex(columnIndex)
.rowDelimiter(rowDelimiter)
.columnDelimiter(columnDelimiter)
.overwriteData(overwriteData)
.build());
} catch (Exception exception) {
return OutputUtilities.getFailureResultsMap(exception);
}
}
}