com.sap.cloud.sdk.s4hana.datamodel.odata.services.CostCenterService Maven / Gradle / Ivy

Go to download
/*
 * Copyright (c) 2019 SAP SE or an SAP affiliate company. All rights reserved.
 */

package com.sap.cloud.sdk.s4hana.datamodel.odata.services;

import java.time.LocalDateTime;

import javax.annotation.Nonnull;

import com.sap.cloud.sdk.s4hana.datamodel.odata.helper.batch.BatchService;
import com.sap.cloud.sdk.s4hana.datamodel.odata.namespaces.costcenter.CostCenterByKeyFluentHelper;
import com.sap.cloud.sdk.s4hana.datamodel.odata.namespaces.costcenter.CostCenterFluentHelper;
import com.sap.cloud.sdk.s4hana.datamodel.odata.namespaces.costcenter.CostCenterTextByKeyFluentHelper;
import com.sap.cloud.sdk.s4hana.datamodel.odata.namespaces.costcenter.CostCenterTextFluentHelper;
import com.sap.cloud.sdk.s4hana.datamodel.odata.namespaces.costcenter.batch.CostCenterServiceBatch;

/**
 * 
 * This service enables you to display cost center master data to be consumed in SAP Fiori apps and on other user
 * interfaces.
 * 
 * 
 * Business
 * Documentation
 * 
 * 
 * Reference: SAP API
 * Business Hub
 * 
 * Details:
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * OData Service: API_COSTCENTER_SRV
API Version: 1
Communication Scenario: SAP Analytics Cloud for Planning Integration (SAP_COM_0087)
Scope Items: Integration between SAP S/4HANA Cloud and SAP Analytics Cloud
 * (1YB)
Authentication Methods: Basic, x509
 * 
 */
public interface CostCenterService extends BatchService
{

    /**
     * If no other path was provided via the {@link #withServicePath(String)} method, this is the default service path
     * used to access the endpoint.
     * 
     */
    String DEFAULT_SERVICE_PATH = "/sap/opu/odata/sap/API_COSTCENTER_SRV";

    /**
     * Overrides the default service path and returns a new service instance with the specified service path. Also
     * adjusts the respective entity URLs.
     * 
     * @param servicePath
     *            Service path that will override the default.
     * @return A new service instance with the specified service path.
     */
    @Nonnull
    CostCenterService withServicePath( @Nonnull final String servicePath );

    /**
     * Fetch multiple {@link com.sap.cloud.sdk.s4hana.datamodel.odata.namespaces.costcenter.CostCenter CostCenter}
     * entities.
     * 
     * @return A fluent helper to fetch multiple
     *         {@link com.sap.cloud.sdk.s4hana.datamodel.odata.namespaces.costcenter.CostCenter CostCenter} entities.
     *         This fluent helper allows methods which modify the underlying query to be called before executing the
     *         query itself. To perform execution, call the
     *         {@link com.sap.cloud.sdk.s4hana.datamodel.odata.namespaces.costcenter.CostCenterFluentHelper#execute
     *         execute} method on the fluent helper object.
     */
    @Nonnull
    CostCenterFluentHelper getAllCostCenter();

    /**
     * Fetch a single {@link com.sap.cloud.sdk.s4hana.datamodel.odata.namespaces.costcenter.CostCenter CostCenter}
     * entity using key fields.
     * 
     * @param costCenter
     *            A key that uniquely identifies a cost center.
     *            
     *            Constraints: Not nullable, Maximum length: 10
     *            
     * @param controllingArea
     *            Uniquely identifies a controlling area.
     *            
     *            Constraints: Not nullable, Maximum length: 4
     *            
     * @param validityEndDate
     *            Date indicating up to when an entry is valid.
     *            
     *            Constraints: Not nullable, Precision: 0
     *            
     * @return A fluent helper to fetch a single
     *         {@link com.sap.cloud.sdk.s4hana.datamodel.odata.namespaces.costcenter.CostCenter CostCenter} entity using
     *         key fields. This fluent helper allows methods which modify the underlying query to be called before
     *         executing the query itself. To perform execution, call the
     *         {@link com.sap.cloud.sdk.s4hana.datamodel.odata.namespaces.costcenter.CostCenterByKeyFluentHelper#execute
     *         execute} method on the fluent helper object.
     */
    @Nonnull
    CostCenterByKeyFluentHelper getCostCenterByKey(
        final String controllingArea,
        final String costCenter,
        final LocalDateTime validityEndDate );

    /**
     * Fetch multiple {@link com.sap.cloud.sdk.s4hana.datamodel.odata.namespaces.costcenter.CostCenterText
     * CostCenterText} entities.
     * 
     * @return A fluent helper to fetch multiple
     *         {@link com.sap.cloud.sdk.s4hana.datamodel.odata.namespaces.costcenter.CostCenterText CostCenterText}
     *         entities. This fluent helper allows methods which modify the underlying query to be called before
     *         executing the query itself. To perform execution, call the
     *         {@link com.sap.cloud.sdk.s4hana.datamodel.odata.namespaces.costcenter.CostCenterTextFluentHelper#execute
     *         execute} method on the fluent helper object.
     */
    @Nonnull
    CostCenterTextFluentHelper getAllCostCenterText();

    /**
     * Fetch a single {@link com.sap.cloud.sdk.s4hana.datamodel.odata.namespaces.costcenter.CostCenterText
     * CostCenterText} entity using key fields.
     * 
     * @param costCenter
     *            A key that uniquely identifies a cost center.
     *            
     *            Constraints: Not nullable, Maximum length: 10
     *            
     * @param language
     *            The language key indicates
     *            
     *            Constraints: Not nullable, Maximum length: 2
     *            
     * @param controllingArea
     *            Uniquely identifies a controlling area.
     *            
     *            Constraints: Not nullable, Maximum length: 4
     *            
     * @param validityEndDate
     *            Date indicating up to when an entry is valid.
     *            
     *            Constraints: Not nullable, Precision: 0
     *            
     * @return A fluent helper to fetch a single
     *         {@link com.sap.cloud.sdk.s4hana.datamodel.odata.namespaces.costcenter.CostCenterText CostCenterText}
     *         entity using key fields. This fluent helper allows methods which modify the underlying query to be called
     *         before executing the query itself. To perform execution, call the
     *         {@link com.sap.cloud.sdk.s4hana.datamodel.odata.namespaces.costcenter.CostCenterTextByKeyFluentHelper#execute
     *         execute} method on the fluent helper object.
     */
    @Nonnull
    CostCenterTextByKeyFluentHelper getCostCenterTextByKey(
        final String costCenter,
        final String controllingArea,
        final String language,
        final LocalDateTime validityEndDate );

}
OData Service:	API_COSTCENTER_SRV
API Version:	1
Communication Scenario:	SAP Analytics Cloud for Planning Integration (SAP_COM_0087)
Scope Items:	Integration between SAP S/4HANA Cloud and SAP Analytics Cloud * (1YB)
Authentication Methods:	Basic, x509